プライマリアプリケーション内で実行される基本的な事前認証フロー basic-preauthorization-flow-performed-within-primary-application
Adobe Pass認証権限内の 事前認証フロー により、ストリーミングアプリケーションは、MVPDがリソースのリストへのユーザーのアクセスを許可するか拒否するかを判断できます。 この検証により、アプリケーションは、表示する資格があるコンテンツに関する正確な情報をユーザーに提示できるようになります。
特定のmvpdを使用して事前承認決定を取得する retrieve-preauthorization-decisions-using-specific-mvpd
前提条件 prerequisites-retrieve-preauthorization-decisions-using-specific-mvpd
特定のMVPDを使用して事前認証の決定を取得する前に、次の前提条件を満たしていることを確認してください。
-
ストリーミングアプリケーションには、基本的な認証フローのいずれかを使用してMVPD用に正常に作成された有効な通常プロファイルが必要です。
-
ストリーミングアプリケーションは、事前承認決定を取得して、リソースのリストと関連するステータスを表示します。
ワークフロー workflow-retrieve-preauthorization-decisions-using-specific-mvpd
次の図に示すように、プライマリアプリケーション内で実行される特定のMVPDを使用して、基本的な事前認証フローを実装するには、次の手順に従います。
特定のmvpdを使用して事前承認決定を取得
-
事前認証の決定を取得: ストリーミングアプリケーションは、「決定の事前認証エンドポイント」を呼び出して、リソースのリストに対する事前認証の決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd API ドキュメントを使用した事前承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
-
通常のプロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
要求されたリソースに対するMVPDの決定を取得: Adobe Pass サーバーは、MVPD事前認証エンドポイントを呼び出して、ストリーミングアプリケーションから受信した各リソースに対する
PermitまたはDenyの決定を取得します。 -
事前承認の決定を返します: 「決定事前承認」エンドポイント応答には、各リソースに対する
PermitまたはDenyの決定が含まれています。Permitの決定は、リソースが再生可能であることを意味します。 応答にはメディアトークンが含まれていません。事前承認フローを使用してリソースを再生することはできません。Denyの決定は、リソースが再生できないことを意味します。 応答には、拡張エラーコード のドキュメントに準拠するエラーペイロードが含まれます。
note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した事前承認決定の取得を参照してください。 決定事前認証エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
事前認証の決定を処理します: ストリーミングアプリケーションは応答を処理し、オプションでユーザーインターフェイス上の各リソースの適切なステータスを表示するために使用できます。