Basic preauthorization flow performed within primary application basic-preauthorization-flow-performed-within-primary-application
The Preauthorization flow within Adobe Pass Authentication entitlement allows the streaming application to determine whether an MVPD may permit or deny the user’s access to a list of resources. This verification ensures the application can present accurate information to the user about the content they might be eligible to view.
Retrieve preauthorization decisions using specific mvpd retrieve-preauthorization-decisions-using-specific-mvpd
Prerequisites prerequisites-retrieve-preauthorization-decisions-using-specific-mvpd
Before retrieving preauthorization decisions using a specific MVPD, ensure the following prerequisites are met:
-
The streaming application must have a valid regular profile that has been successfully created for the MVPD using one of the basic authentication flows:
-
The streaming application wants to retrieve preauthorization decisions to display a list of resources along with their associated statuses.
Workflow workflow-retrieve-preauthorization-decisions-using-specific-mvpd
Follow the given steps to implement the basic preauthorization flow using a specific MVPD performed within a primary application as shown in the following diagram.
Retrieve preauthorization decisions using specific mvpd
-
Retrieve preauthorization decisions: The streaming application gathers all the necessary data to obtain preauthorization decisions for a list of resources by calling the Decisions Preauthorize endpoint.
note important IMPORTANT Refer to the Retrieve preauthorization decisions using specific mvpd API documentation for details on: - All the required parameters, like
serviceProvider,mvpd, andresources - All the required headers, like
AuthorizationandAP-Device-Identifier - All the optional parameters and headers
- All the required parameters, like
-
Find regular profile: The Adobe Pass server identifies a valid profile based on the received parameters and headers.
-
Retrieve MVPD decisions for requested resources: The Adobe Pass server calls the MVPD preauthorization endpoint to obtain a
PermitorDenydecision for each resource received from the streaming application. -
Return preauthorization decisions: The Decisions Preauthorize endpoint response contains a
PermitorDenydecision for each resource:- A
Permitdecision means the resource is playable. The response does not include a media token, as the preauthorization flow must not be used to play resources. - A
Denydecision means the resource is not playable. The response includes an error payload which adheres to the Enhanced Error Codes documentation.
note important IMPORTANT Refer to the Retrieve preauthorization decisions using specific mvpd API documentation for details on the information provided in a decision response. The Decisions Preauthorize endpoint validates the request data to ensure that basic conditions are met: - The required parameters and headers must be valid.
- The integration between the provided
serviceProviderandmvpdmust be active.
If validation fails, an error response will be generated, providing additional information that adheres to the Enhanced Error Codes documentation. - A
-
Handle preauthorization decisions: The streaming application processes the response and can use it to optionally display the appropriate status for each resource on the user interface.