プライマリアプリケーション内で実行される基本認証フロー basic-authentication-flow-performed-within-primary-application
Adobe Pass認証権限内の 認証フロー により、ストリーミングアプリケーションは、ユーザーが有効なMVPD アカウントを持っていることを確認できます。 このプロセスでは、ユーザーがアクティブなMVPD アカウントを持ち、MVPD ログインページに有効なログイン資格情報を入力する必要があります。
認証フローは、次の場合に必要です。
- ユーザーが初めてアプリケーションを開いたとき。
- ユーザーの以前の認証が期限切れになった場合。
- ユーザーがMVPD アカウントからログアウトすると。
- 別のMVPDで認証する場合。
これらすべての場合において、任意のプロファイルエンドポイントを呼び出すアプリケーションは、空の応答または1つ以上のプロファイルを受信しますが、異なるMVPDに対して受信します。
認証フローでは、ユーザーエージェント （ブラウザー）がアプリケーションからAdobe Pass バックエンド、次にMVPD ログインページ、最後にアプリケーションに戻る一連の呼び出しを完了する必要があります。 このフローには、MVPDシステムへの複数のリダイレクトや、各ドメインに保存されたCookieまたはセッションの管理が含まれる場合があります。これらは、ユーザーエージェントなしでは達成や保護が困難な場合があります。
MVPDを選択し、ユーザーエージェントで選択したMVPDを使用して認証するためのユーザーインタラクションをサポートするプライマリアプリケーション（ストリーミングアプリケーション）機能に基づいて、認証シナリオは次のとおりです。
プライマリアプリケーション内で認証を実行 perform-authentication-within-primary-application
前提条件 prerequisites-perform-authentication-within-primary-application
プライマリアプリケーション内でユーザーインタラクションを介して認証を実行する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションでMVPDを選択する必要があります。
- 選択したMVPDでログインするには、ストリーミングアプリケーションで認証セッションを開始する必要があります。
- ストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証する必要があります。
- ストリーミングアプリケーションは、MVPDを選択するためのユーザーインタラクションをサポートしています。
- ストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証するためのユーザーインタラクションをサポートしています。
ワークフロー workflow-perform-authentication-completed-on-primary-application
次の図に示すように、プライマリアプリケーション内で実行される基本認証フローを実装するには、次の手順に従います。
プライマリアプリケーション内で認証を実行
-
認証セッションの作成： ストリーミングアプリケーションは、Sessions エンドポイントを呼び出して、認証セッションを開始するために必要なすべてのデータを収集します。
note important IMPORTANT 詳細については、認証セッションの作成 API ドキュメントを参照してください。 serviceProvider、mvpd、domainName、redirectUrlなど、必須のすべてのパラメーターAuthorization、AP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
ストリーミングアプリケーションは、認証セッションの作成時に、1回の呼び出しで必要なすべてのパラメーターを提供する必要があります。 -
次のアクションを示します： セッションエンドポイントの応答には、次のアクションに関するストリーミングアプリケーションを導くために必要なデータが含まれています。
note important IMPORTANT セッション応答で提供される情報について詳しくは、認証セッションの作成 API ドキュメントを参照してください。 セッションエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行： セッションエンドポイントの応答には、次のデータが含まれます。
actionName属性が「authorize」に設定されています。actionType属性が「direct」に設定されています。
Adobe Pass バックエンドが有効なプロファイルを識別する場合、後続の意思決定フローに使用できるプロファイルが既に存在するため、ストリーミングアプリケーションは選択したMVPDで再認証する必要がありません。
-
ユーザーエージェントでURLを開く： セッションエンドポイントの応答には、次のデータが含まれます。
- MVPD ログインページ内でインタラクティブ認証を開始するために使用できる
url。 actionName属性が「authenticate」に設定されています。actionType属性が「インタラクティブ」に設定されています。
Adobe Pass バックエンドが有効なプロファイルを識別しない場合、ストリーミングアプリケーションはユーザーエージェントを開いて、指定された
urlを読み込み、認証エンドポイントにリクエストを行います。 このフローには複数のリダイレクトが含まれる場合があり、最終的にはユーザーがMVPD ログインページに移動し、有効な資格情報を提供します。 - MVPD ログインページ内でインタラクティブ認証を開始するために使用できる
-
MVPD認証を完了：認証フローが成功した場合、ユーザーエージェントのインタラクションはAdobe Pass バックエンドに通常のプロファイルを保存し、指定された
redirectUrlに到達します。 -
特定のコードのプロファイルの取得： ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、プロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次の詳細については、特定のコードの プロファイルの取得 API ドキュメントを参照してください。 serviceProvider、codeなど、必須のすべてのパラメーターAuthorization、AP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
note tip TIP ストリーミングアプリケーションは、ユーザーエージェントが指定された redirectUrlに到達するのを待ち、通常のプロファイルが正常に生成され、保存されたかどうかを確認する必要があります。 -
通常のプロファイルに関する情報を返します： プロファイル エンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられた通常のプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報の詳細については、特定のコードのプロファイルの取得 API ドキュメントを参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。