プライマリアプリケーション内で実行される基本プロファイルフロー basic-profiles-flow-primary-application
Adobe Pass認証使用権内の プロファイルフロー により、ストリーミングアプリケーションはアクティブなユーザーログインに関する情報にアクセスできます。
基本プロファイルフローを使用すると、次のシナリオについてクエリを実行できます。
プロファイルの取得 retrieve-profiles
前提条件 prerequisites-retrieve-profiles
プロファイルを取得する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションは、すべての通常のプロファイルを取得しようとしています。
ワークフロー workflow-retrieve-profiles
次の図に示すように、プライマリ アプリケーション内で実行される基本的なプロファイル取得フロー実装するには、上記の手順に従います。
プロファイルの取得
-
プロファイルの取得: ストリーミング アプリケーションは、プロファイル エンドポイントにリクエストを送信して、すべてのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次について詳しくは、 プロファイルの取得API ドキュメントを参照してください。 serviceProvider
のようなすべての 必須 パラメーターAuthorization
、AP-Device-Identifier
などのすべての 必須 ヘッダー- すべての オプション パラメーターおよびヘッダー
-
標準プロファイル検索文字列: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、すべての有効なプロファイルを識別します。
-
通常のプロファイルに関する情報を返します Profiles エンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられている見つかったプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報の詳細については、 プロファイルの取得 API ドキュメントを参照してください。 プロファイルエンドポイントは、基本条件が満たされていることを確認するために、リクエストデータを検証します。 - required パラメーターおよびヘッダーは有効である必要があります。
検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。 -
プロファイルを選択し、決定フローを続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションは(最終的にエンドユーザーとやり取りすることで)内部ロジックを使用して、使用可能なプロファイルの 1 つを選択し、後続の決定フローを続行します。
-
新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、ストリーミングアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。
特定の mvpd のプロファイルの取得 retrieve-profile-for-specific-mvpd
前提条件 prerequisites-retrieve-profile-for-specific-mvpd
特定の MVPD のプロファイルを取得する前に、次の前提条件が満たされていることを確認します。
- 選択されたまたはキャッシュされた
mvpd
識別子を持つストリーミングアプリケーションは、特定の MVPD の通常のプロファイルを取得したいと考えています。
ワークフロー workflow-retrieve-profile-for-specific-mvpd
次の図に示すように、プライマリ・アプリケーション内で実行される特定の MVPD の基本的なプロファイル取得フローを実装するには、次の手順に従います。
特定の mvpd のプロファイルを取得する
-
特定の mvpd のプロファイルを取得する: ストリーミング アプリケーションは、プロファイル エンドポイントにリクエストを送信して、その特定の MVPD のプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次について詳しくは、 特定の mvpd のプロファイルを取得API ドキュメントを参照してください。 serviceProvider
やmvpd
など、すべての 必須 パラメーターAuthorization
、AP-Device-Identifier
などのすべての 必須 ヘッダー- オプションの パラメーターとヘッダーすべてを選択
-
通常のプロファイル検索文字列: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
通常のプロファイルに関する情報を返す: Profiles エンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられている見つかったプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報の詳細については、 特定の mvpd のプロファイルの取得 API ドキュメントを参照してください。 プロファイルエンドポイントは、リクエストデータを検証して、基本条件が満たされていることを確認します。 - required パラメーターおよびヘッダーは有効である必要があります。
- 指定した
serviceProvider
とmvpd
の統合はアクティブである必要があります。
検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。 -
決定フローで続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションはプロファイル情報を使用して、後続の決定フローを続行します。
-
新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、ストリーミングアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。
特定のコードのプロファイルを取得する retrieve-profile-for-specific-code
前提 条件 prerequisites-retrieve-profile-for-specific-code
特定の認証コードのプロファイルを取得する前に、次の前提条件が満たされていることを確認してください。
- MVPD との対話型認証を実行するために使用される
code
を持つストリーミング アプリケーションは、特定の認証コードのプロファイルを取得する必要があります。
ワークフロー workflow-retrieve-profile-for-specific-code
次の図に示すように、プライマリ・アプリケーション内で実行される特定の認証コードに対して基本プロファイル取得フローを実装するには、次の手順に従います。
特定のコードのプロファイルを取得
-
特定のコードのプロファイルを取得: ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信して、その特定の認証コードのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 以下について詳しくは、 特定のコードについてはプロファイルを取得 API ドキュメントを参照してください。 serviceProvider
などの_必須_パラメーターすべてを選択、code
Authorization
のようなすべての 必須 ヘッダー- すべての オプション パラメーターおよびヘッダー
-
標準プロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
通常のプロファイルに関する情報を返す: プロファイルエンドポイント応答には、受信したパラメーターとヘッダーに関連付けられた、見つかったプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報について詳しくは、 特定のコードのプロファイルの取得API ドキュメントを参照してください。 プロファイルエンドポイントは、基本条件が満たされていることを確認するために、リクエストデータを検証します。 - required パラメーターおよびヘッダーは有効である必要があります。
検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。 -
決定フローで続行: プロファイルエンドポイント応答にプロファイルが含まれている場合、ストリーミングアプリケーションはプロファイル情報を使用して、後続の決定フローを続行します。
-
新しい基本認証フローを指定: プロファイルエンドポイント応答にプロファイルが含まれていない場合、プライマリアプリケーションは新しい基本認証フローを開始するようにユーザーに指示します。