プライマリアプリケーション内で実行される基本的なログアウトフロー basic-logout-flow-performed-within-primary-application
Adobe Pass認証使用権内の ログアウトフロー により、ストリーミングアプリケーションは次の 2 つの主な手順を実行できます。
- Adobe Pass バックエンドで保存された通常のプロファイルを削除します。
- ユーザーエージェント（ブラウザー）を使用して MVPD ログアウトエンドポイントに移動し、MVPD バックエンドでクリーンアップをトリガーします。
基本的なログアウトフローを使用すると、次のシナリオについてクエリを実行できます。
ログアウトエンドポイントを持つ特定の mvpd に対してログアウトを開始します initiate-logout-for-specific-mvpd-with-logout-endpoint
前提条件 prerequisites-initiate-logout-for-specific-mvpd-with-logout-endpoint
ログアウトエンドポイントを使用して特定の MVPD のログアウトを開始する前に、次の前提条件が満たされていることを確認してください。
-
ストリーミングアプリケーションには、次のいずれかの基本認証フローを使用して MVPD に対して正常に作成された有効な標準プロファイルが必要です。
-
ストリーミングアプリケーションは、MVPD からログアウトする必要がある場合は、ログアウトフローを開始する必要があります。
- MVPD は、ログアウトフローをサポートし、ログアウトエンドポイントを持ちます。
ワークフロー workflow-initiate-logout-for-specific-mvpd-with-logout-endpoint
次の図に示すように、プライマリアプリケーション内で実行されるログアウトエンドポイントを使用して、特定の MVPD の基本的なログアウトフローを実装するには、次の手順に従います。
ログアウト エンドポイントを使用して特定の mvpd のログアウトを開始する
-
Adobe Pass ログアウトの開始： ストリーミングアプリケーションは、Adobe Pass ログアウトエンドポイントを呼び出して、ログアウトフローを開始するために必要なすべてのデータを収集します。
note important IMPORTANT 次の項目について詳しくは、 特定の mvpd のログアウトの開始API ドキュメントを参照してください。 serviceProvider、mvpd、redirectUrlなど、すべての 必須 パラメーターAuthorization、AP-Device-Identifierなどのすべての 必須 ヘッダー- すべての オプション パラメーターおよびヘッダー
-
標準プロファイルを検索： Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
標準プロファイルを削除： Adobe Pass サーバーは、識別された標準プロファイルをAdobe Pass バックエンドから削除します。
-
次のアクションを示す： Adobe Pass ログアウトエンドポイント応答には、次のアクションに関するストリーミングアプリケーションのガイドとして必要なデータが含まれます。
- MVPD がログアウトフローをサポートするので、
url属性が存在します。 actionName属性は「logout」に設定されます。actionType属性は「interactive」に設定されます。
note important IMPORTANT ログアウト応答で提供される情報について詳しくは、 特定の mvpd のログアウトの開始API ドキュメントを参照してください。 Adobe Pass ログアウトエンドポイントは、基本的な条件が満たされていることを確認するためにリクエストデータを検証します。 - required パラメーターおよびヘッダーは有効である必要があります。
- 指定した
serviceProviderとmvpdの統合はアクティブである必要があります。
検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。 - MVPD がログアウトフローをサポートするので、
-
MVPD ログアウトの開始： ストリーミングアプリケーションは
urlを読み取り、ユーザーエージェントを使用して MVPD とのログアウトフローを開始します。 フローには、MVPD システムへの複数のリダイレクトが含まれる場合があります。 それでも、結果として、MVPD が内部クリーンアップを実行し、最終的なログアウト確認をAdobe Pass バックエンドに返します。 -
ログアウト完了の指定： ストリーミングアプリケーションは、ユーザーエージェントが指定された
redirectUrlに到達するまで待機し、それをシグナルとして使用して、オプションで特定のメッセージをユーザーインターフェイスに表示できます。
ログアウトエンドポイントを使用しない特定の mvpd に対するログアウトの開始 initiate-logout-for-specific-mvpd-without-logout-endpoint
前提条件 prerequisites-initiate-logout-for-specific-mvpd-without-logout-endpoint
ログアウトエンドポイントを使用せずに特定の MVPD のログアウトを開始する前に、次の前提条件が満たされていることを確認してください。
-
ストリーミングアプリケーションには、次のいずれかの基本認証フローを使用して MVPD に対して正常に作成された有効な標準プロファイルが必要です。
-
ストリーミングアプリケーションは、MVPD からログアウトする必要がある場合は、ログアウトフローを開始する必要があります。
- MVPD はログアウト フローをサポートしておらず、ログアウト エンドポイントがありません。
ワークフロー workflow-initiate-logout-for-specific-mvpd-without-logout-endpoint
次の図に示すように、プライマリアプリケーション内でログアウトエンドポイントを実行せずに、特定の MVPD に対して基本的なログアウトフローを実装するには、次の手順に従います。
ログアウト エンドポイントを使用せずに、特定の mvpd に対してログアウトを開始する
-
Adobe Pass ログアウトの開始： ストリーミングアプリケーションは、Adobe Pass ログアウトエンドポイントを呼び出して、ログアウトフローを開始するために必要なすべてのデータを収集します。
note important IMPORTANT 次の項目について詳しくは、 特定の mvpd のログアウトの開始API ドキュメントを参照してください。 serviceProvider、mvpd、redirectUrlなど、すべての 必須 パラメーターAuthorization、AP-Device-Identifierなどのすべての 必須 ヘッダー- すべての オプション パラメーターおよびヘッダー
-
標準プロファイルを検索： Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
標準プロファイルを削除： Adobe Pass サーバーは、識別された標準プロファイルを削除します。
-
次のアクションを示す： Adobe Pass ログアウトエンドポイント応答には、次のアクションに関するストリーミングアプリケーションのガイドとして必要なデータが含まれます。
- MVPD がログアウトフローをサポートしていないため、
url属性がありません。 actionName属性は「complete」に設定されます。actionType属性は「none」に設定されます。
note important IMPORTANT ログアウト応答で提供される情報について詳しくは、 特定の mvpd のログアウトの開始API ドキュメントを参照してください。 Adobe Pass ログアウトエンドポイントは、基本的な条件が満たされていることを確認するためにリクエストデータを検証します。 - required パラメーターおよびヘッダーは有効である必要があります。
- 指定した
serviceProviderとmvpdの統合はアクティブである必要があります。
検証に失敗した場合は、エラー応答が生成され、 拡張エラーコードドキュメントに従った追加情報が提供されます。 - MVPD がログアウトフローをサポートしていないため、
-
ログアウト完了の指定： ストリーミングアプリケーションが応答を処理し、オプションでその応答を使用して、ユーザーインターフェイスに特定のメッセージを表示できます。