サービストークンのフローを使用したシングルサインオン single-sign-on-service-token-full-flows
サービストークンを使用すると、複数のアプリケーションで一意のユーザーIDを使用して、Adobe Pass サービスを使用する際に、複数のデバイスやプラットフォームをまたいでシングルサインオン（SSO）を実現できます。
アプリケーションは、次のようなAdobe Pass システム以外の外部ID サービスを使用して、一意のユーザーID ペイロードを取得する責任があります。
- ユーザーが同じ資格情報を使用して各デバイスにログインし、同じユーザーIDまたはユーザーアカウント名に関連付けられているDTC （消費者直販）サービス。
- GoogleやFacebookなどのサードパーティ認証サービス。ユーザーは同じ資格情報を使用して各デバイスにログインし、同じメールアドレスに関連付けられます。
アプリケーションは、この一意のユーザーID ペイロードを指定するすべてのリクエストのAD-Service-Token ヘッダーの一部として含める責任があります。
AD-Service-Token ヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。
サービストークンを使用したシングルサインオンによる認証の実行 performing-authentication-flow-using-service-token-single-sign-on-method
前提条件 prerequisites-scenario-performing-authentication-flow-using-service-token-single-sign-on-method
サービストークンを使用してシングルサインオンによる認証フローを実行する前に、次の前提条件が満たされていることを確認します。
- 外部ID サービスは、複数のデバイスとプラットフォームを介して、すべてのアプリケーションで
JWSペイロードとして一貫した情報を返す必要があります。 - 最初のストリーミングアプリケーションは、一意のユーザーIDを取得し、それを指定するすべてのリクエストのAD-Service-Token ヘッダーの一部として
JWSペイロードを含める必要があります。 - 最初のストリーミングアプリケーションでMVPDを選択する必要があります。
- 選択したMVPDでログインするには、最初のストリーミングアプリケーションで認証セッションを開始する必要があります。
- 最初のストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証する必要があります。
- 2番目のストリーミングアプリケーションは、一意のユーザーIDを取得し、それを指定するすべてのリクエストのAD-Service-Token ヘッダーの一部として
JWSペイロードを含める必要があります。
- 最初のストリーミングアプリケーションは、MVPDを選択するためのユーザーインタラクションをサポートしています。
- 最初のストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証するためのユーザーインタラクションをサポートしています。
ワークフロー workflow-steps-scenario-performing-authentication-flow-using-service-token-single-sign-on-method
次の図に示すように、サービストークンを使用してシングルサインオンを介した認証フローを実装するには、次の手順を実行します。
サービストークンを使用してシングルサインオンによる認証を実行
-
ID サービスで認証：最初のストリーミングアプリケーションは、Adobe Pass システム以外のID サービスを呼び出して、一意のユーザーIDに関連付けられた
JWSペイロードを取得します。 -
JWS:として一意のユーザーIDを返します。最初のストリーミングアプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。
- ペイロードの有効期限が切れていません。
- ペイロードが署名されています。
-
認証セッションの作成：最初のストリーミングアプリケーションは、セッションエンドポイントを呼び出して、認証セッションを開始するために必要なすべてのデータを収集します。
note important IMPORTANT 詳細については、認証セッションの作成 API ドキュメントを参照してください。 serviceProvider、mvpd、domainName、redirectUrlなど、必須のすべてのパラメーターAuthorization、AP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
ストリーミングアプリケーションは、リクエストを行う前に、一意のユーザーIDの有効な値が含まれていることを確認する必要があります。 AD-Service-Tokenヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。 -
次のアクションを示します： セッションエンドポイントの応答には、次のアクションに関する最初のストリーミングアプリケーションを導くために必要なデータが含まれています。
note important IMPORTANT セッション応答で提供される情報について詳しくは、認証セッションの作成 API ドキュメントを参照してください。 セッションエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderと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に到達するのを待ち、通常のプロファイルが正常に生成され、保存されたかどうかを確認する必要があります。 -
通常のプロファイルを検索： Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。
-
通常のプロファイルに関する情報を返します： プロファイル エンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられた見つかったプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報の詳細については、特定のコードのプロファイルの取得 API ドキュメントを参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行：最初のストリーミングアプリケーションは、後続の決定フローで続行できます。
note important IMPORTANT ストリーミングアプリケーションは、リクエストを行う前に、一意のユーザーIDの有効な値が含まれていることを確認する必要があります。 AD-Service-Tokenヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。 -
ID サービスで認証： 2番目のストリーミングアプリケーションは、Adobe Pass システム以外のID サービスを呼び出して、一意のユーザーIDに関連付けられた
JWSペイロードを取得します。 -
JWS:として一意のユーザーIDを返します。2番目のストリーミングアプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。
- ペイロードの有効期限が切れていません。
- ペイロードが署名されています。
-
プロファイルの取得： 2番目のストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信して、すべてのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳細については、 プロファイルの取得 API ドキュメントを参照してください。 serviceProviderなど、すべての_必須_ パラメーターAuthorization、AP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
ストリーミングアプリケーションは、リクエストを行う前に、一意のユーザーIDの有効な値が含まれていることを確認する必要があります。 AD-Service-Tokenヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。 -
シングルサインオンプロファイルを検索： Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、有効なシングルサインオンプロファイルを識別します。
-
シングルサインオンプロファイルに関する情報を返します： プロファイルエンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられた見つかったプロファイルに関する情報が含まれます。
note important IMPORTANT プロファイル応答で提供される情報について詳しくは、 プロファイルの取得 API ドキュメントを参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行： 2番目のストリーミングアプリケーションは、後続の決定フローで続行できます。
note important IMPORTANT ストリーミングアプリケーションは、リクエストを行う前に、一意のユーザーIDの有効な値が含まれていることを確認する必要があります。 AD-Service-Tokenヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。
サービストークンを使用したシングルサインオンによる承認決定の取得 performing-authorization-flow-using-service-token-single-sign-on-method
前提条件 prerequisites-scenario-performing-authorization-flow-using-service-token-single-sign-on-method
サービストークンを使用してシングルサインオンを通じて認証フローを実行する前に、次の前提条件が満たされていることを確認します。
- 外部ID サービスは、複数のデバイスとプラットフォームを介して、すべてのアプリケーションで
JWSペイロードとして一貫した情報を返す必要があります。 - 最初のストリーミングアプリケーションは、一意のユーザーIDを取得し、それを指定するすべてのリクエストのAD-Service-Token ヘッダーの一部として
JWSペイロードを含める必要があります。 - 2番目のストリーミングアプリケーションは、ユーザーが選択したリソースを再生する前に、認証決定を取得する必要があります。
ワークフロー workflow-steps-scenario-performing-authorization-flow-using-service-token-single-sign-on-method
次の図に示すように、サービストークンを使用してシングルサインオンを介した認証フローを実装するには、次の手順を実行します。
サービストークンを使用して、シングルサインオンを通じて承認決定を取得
-
ID サービスで認証： 2番目のストリーミングアプリケーションは、Adobe Pass システム以外のID サービスを呼び出して、一意のユーザーIDに関連付けられた
JWSペイロードを取得します。 -
JWS:として一意のユーザーIDを返します。2番目のストリーミングアプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。
- ペイロードの有効期限が切れていません。
- ペイロードが署名されています。
-
承認決定の取得： 2番目のストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
ストリーミングアプリケーションは、リクエストを行う前に、一意のユーザーIDの有効な値が含まれていることを確認する必要があります。 AD-Service-Tokenヘッダーについて詳しくは、AD-Service-Token ドキュメントを参照してください。 -
シングルサインオンプロファイルを検索： Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、有効なシングルサインオンプロファイルを識別します。
-
要求されたリソースに対するMVPDの決定を取得： Adobe Pass サーバーは、MVPD認証エンドポイントを呼び出して、ストリーミングアプリケーションから受信した特定のリソースに対する
PermitまたはDenyの決定を取得します。 -
メディアトークンを使用して
Permitの決定を返します：決定承認エンドポイント応答には、Permitの決定とメディアトークンが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
メディアトークンを使用してストリームを開始： 2番目のストリーミングアプリケーションは、メディアトークンを使用してコンテンツを再生します。
-
詳細を含む
Denyの決定を返します： 「決定を承認」エンドポイント応答には、Denyの決定と、拡張エラーコード ドキュメントに準拠するエラーペイロードが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
検証が失敗すると、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
Handle
Deny決定の詳細： 2番目のストリーミングアプリケーションは、応答からエラー情報を処理し、オプションでユーザーインターフェイスに特定のメッセージを表示するために使用できます。