Non-Apple Single Sign-On TV Provider Authentication Flow

Explore the steps required to be followed when handling the authentication flow, when a non-Apple Single Sign-On (SSO) supported Pay-TV provider is selected from the MVPD Picker.

Description :headding-anchor:description

Environment

Adobe Pass

Issue/Symptoms

How to handle the authentication flow when a non-Apple Single Sign-On (SSO) supported Pay-TV provider (Multichannel Video Programming Distributor - MVPD) is selected from the MVPD Picker?

Resolution :headding-anchor:resolution

Steps
After the user selects an unsupported TV Provider, programmer’s app receives the following callbacks:

  • dismissTvProviderDialog  - At this point, programmer should hide Apple’s  viewController  (it contains the picker).

  • sendTrackingData  - This is just an MVPD selection event.

  • status  - This contains a dictionary that looks like:

    table 0-row-1
    2018-02-23 13:29:14.228410+0200 APIExplorer-tvos[ 252:11681] {

        errorId = REGCODE;

        expires = 1519387154016;

        level = success;

        message = 6ANC6PH; //SAMPLE_7_DIGIT_CODE}
  • At this point, the programmer should present the user with the message contained in this dictionary. In this case, it can be similar to:  Please go to < network-site> /activate and enter the following code: 6ANC6PH.

  • During this time, the Software Development Kit (SDK) polls Adobe servers for the status of the above-mentioned registration code. Once the user uses that registration code to authenticate, the SDK gets a 200 status code from Adobe servers and the next callback is fired.

  • setAuthenticationStatus  - If the status is 1, the authentication was successful.

  • sendTrackingData  - This is just an authentication detection event.

Additional information

More on: iOS/tvOS SDK Cookbook.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f