プラットフォーム ID フローを使用したシングルサインオン single-sign-on-platform-identity-full-flows

IMPORTANT
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
IMPORTANT
REST API V2の実装は、​ スロットル メカニズム ​のドキュメントによって制限されています。

Platform Identity メソッドを使用すると、複数のアプリケーションで一意のPlatform IDを使用して、Adobe Pass サービスを使用する際に、デバイスまたはプラットフォームレベルでシングルサインオン(SSO)を実現できます。

アプリケーションは、Adobe Pass システム以外のデバイス固有のID サービスまたはライブラリを使用して、一意のプラットフォーム ID ペイロードを取得する責任があります。

アプリケーションは、この一意のプラットフォーム識別子ペイロードを、それを指定するすべてのリクエストのAdobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーの一部として含める責任があります。

Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。

プラットフォーム IDを使用したシングルサインオンによる認証の実行 perform-authentication-through-single-sign-on-using-platform-identity

前提条件 prerequisites-perform-authentication-through-single-sign-on-using-platform-identity

プラットフォーム IDを使用してシングルサインオンの認証フローを実行する前に、次の前提条件が満たされていることを確認します。

  • プラットフォームは、同じデバイスまたはプラットフォーム上のすべてのアプリケーションでJWSまたはJWE ペイロードとして一貫した情報を返すID サービスまたはライブラリを提供する必要があります。
  • 最初のストリーミングアプリケーションは、一意のプラットフォーム IDを取得し、それを指定するすべてのリクエストに対してAdobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーの一部としてJWSまたはJWE ペイロードを含める必要があります。
  • 最初のストリーミングアプリケーションでMVPDを選択する必要があります。
  • 選択したMVPDでログインするには、最初のストリーミングアプリケーションで認証セッションを開始する必要があります。
  • 最初のストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証する必要があります。
  • 2番目のストリーミングアプリケーションは、一意のプラットフォーム IDを取得し、それを指定するすべてのリクエストに対してAdobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーの一部としてJWSまたはJWE ペイロードを含める必要があります。
IMPORTANT
前提条件
  • 最初のストリーミングアプリケーションは、MVPDを選択するためのユーザーインタラクションをサポートしています。
  • 最初のストリーミングアプリケーションは、ユーザーエージェントで選択したMVPDで認証するためのユーザーインタラクションをサポートしています。

ワークフロー workflow-perform-authentication-through-single-sign-on-using-platform-identity

次の図に示すように、プラットフォーム IDを使用してシングルサインオンによる認証フローを実装するには、次の手順を実行します。

​ プラットフォーム IDを使用してシングルサインオンによる認証を実行

プラットフォーム IDを使用してシングルサインオンによる認証を実行

  1. プラットフォーム IDの取得:​最初のストリーミングアプリケーションは、Adobe Pass システム以外のID サービスまたはライブラリを呼び出して、一意のプラットフォーム IDに関連付けられたJWSまたはJWE ペイロードを取得します。

  2. JWSまたはJWE:​として一意のプラットフォーム IDを返す最初のストリーミング アプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。

    • ペイロードの有効期限が切れていません。
    • ペイロードは署名または暗号化されています。
  3. 認証セッションの作成:​最初のストリーミングアプリケーションは、セッションエンドポイントを呼び出して、認証セッションを開始するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    詳細については、認証セッションの作成 API ドキュメントを参照してください。
    • serviceProvider、mvpd、domainName、redirectUrlなど、必須​のすべてのパラメーター
    • Authorization、AP-Device-Identifierなど、必須 ヘッダーすべて
    • すべての​_optional_ パラメーターとヘッダー
    ストリーミングアプリケーションは、リクエストを行う前に、一意のプラットフォーム識別子の有効な値が含まれていることを確認する必要があります。
    Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。
  4. 次のアクションを示します: セッションエンドポイントの応答には、次のアクションに関する最初のストリーミングアプリケーションを導くために必要なデータが含まれています。

    note important
    IMPORTANT
    セッション応答で提供される情報について詳しくは、認証セッションの作成 API ドキュメントを参照してください。
    セッションエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。
    • 必須 パラメーターとヘッダーは有効である必要があります。
    • 指定されたserviceProviderとmvpdの統合はアクティブである必要があります。
    検証が失敗すると、エラー応答が生成され、拡張エラーコード ​のドキュメントに準拠する追加情報が提供されます。
  5. ユーザーエージェントでURLを開く: セッションエンドポイントの応答には、次のデータが含まれます。

    • MVPD ログインページ内でインタラクティブ認証を開始するために使用できるurl。
    • actionName属性が「authenticate」に設定されています。
    • actionType属性が「インタラクティブ」に設定されています。

    Adobe Pass バックエンドが有効なプロファイルを識別しない場合、最初のストリーミングアプリケーションはユーザーエージェントを開いて、指定されたurlを読み込み、認証エンドポイントにリクエストを行います。 このフローには複数のリダイレクトが含まれる場合があり、最終的にはユーザーがMVPD ログインページに移動し、有効な資格情報を提供します。

  6. MVPD認証を完了:​認証フローが成功した場合、ユーザーエージェントのインタラクションはAdobe Pass バックエンドに通常のプロファイルを保存し、指定されたredirectUrlに到達します。

  7. 特定のコードのプロファイルの取得:​最初のストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、プロファイル情報を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    次の詳細については、特定のコードの​ プロファイルの取得 API ドキュメントを参照してください。
    • serviceProvider、codeなど、必須​のすべてのパラメーター
    • Authorization、AP-Device-Identifierなど、必須 ヘッダーすべて
    • すべての​_optional_ パラメーターとヘッダー
    note tip
    TIP
    ストリーミングアプリケーションは、ユーザーエージェントが指定されたredirectUrlに到達するのを待ち、通常のプロファイルが正常に生成され、保存されたかどうかを確認する必要があります。
  8. 通常のプロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて有効なプロファイルを識別します。

  9. 通常のプロファイルに関する情報を返します: プロファイル エンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられた見つかったプロファイルに関する情報が含まれます。

    note important
    IMPORTANT
    プロファイル応答で提供される情報の詳細については、特定のコードのプロファイルの取得 API ドキュメントを参照してください。
    プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。
    • 必須 パラメーターとヘッダーは有効である必要があります。
    検証が失敗すると、エラー応答が生成され、拡張エラーコード ​のドキュメントに準拠する追加情報が提供されます。
  10. 決定フローで続行:​最初のストリーミングアプリケーションは、後続の決定フローで続行できます。

    note important
    IMPORTANT
    ストリーミングアプリケーションは、リクエストを行う前に、一意のプラットフォーム識別子の有効な値が含まれていることを確認する必要があります。
    Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。
  11. プラットフォーム IDの取得: 2番目のストリーミング アプリケーションは、Adobe Pass システム以外のID サービスまたはライブラリを呼び出して、一意のプラットフォーム IDに関連付けられたJWSまたはJWE ペイロードを取得します。

  12. JWSまたはJWE:​として一意のプラットフォーム IDを返します。2番目のストリーミング アプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。

    • ペイロードの有効期限が切れていません。
    • ペイロードは署名または暗号化されています。
  13. プロファイルの取得: 2番目のストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信して、すべてのプロファイル情報を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    詳細については、​ プロファイルの取得 API ドキュメントを参照してください。
    • serviceProviderなど、すべての​_必須_ パラメーター
    • Authorization、AP-Device-Identifierなど、必須 ヘッダーすべて
    • すべての​_optional_ パラメーターとヘッダー
    ストリーミングアプリケーションは、リクエストを行う前に、一意のプラットフォーム識別子の有効な値が含まれていることを確認する必要があります。
    Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。
  14. シングルサインオンプロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、有効なシングルサインオンプロファイルを識別します。

  15. シングルサインオンプロファイルに関する情報を返します: プロファイルエンドポイントの応答には、受信したパラメーターとヘッダーに関連付けられた見つかったプロファイルに関する情報が含まれます。

    note important
    IMPORTANT
    プロファイル応答で提供される情報について詳しくは、​ プロファイルの取得 API ドキュメントを参照してください。
    プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。
    • 必須 パラメーターとヘッダーは有効である必要があります。
    検証が失敗すると、エラー応答が生成され、拡張エラーコード ​のドキュメントに準拠する追加情報が提供されます。
  16. 決定フローで続行: 2番目のストリーミングアプリケーションは、後続の決定フローで続行できます。

    note important
    IMPORTANT
    ストリーミングアプリケーションは、リクエストを行う前に、一意のプラットフォーム識別子の有効な値が含まれていることを確認する必要があります。
    Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。

プラットフォーム IDを使用したシングルサインオンによる認証決定の取得 performing-authorization-flow-using-platform-identity-single-sign-on-method

前提条件 prerequisites-scenario-performing-authorization-flow-using-platform-identity-single-sign-on-method

プラットフォーム IDを使用してシングルサインオンで認証フローを実行する前に、次の前提条件が満たされていることを確認します。

  • プラットフォームは、同じデバイスまたはプラットフォーム上のすべてのアプリケーションでJWSまたはJWE ペイロードとして一貫した情報を返すID サービスまたはライブラリを提供する必要があります。
  • 2番目のストリーミングアプリケーションは、一意のプラットフォーム IDを取得し、それを指定するすべてのリクエストに対してAdobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーの一部としてJWSまたはJWE ペイロードを含める必要があります。
  • 2番目のストリーミングアプリケーションは、ユーザーが選択したリソースを再生する前に、認証決定を取得する必要があります。
IMPORTANT
前提条件

ワークフロー workflow-scenario-performing-authorization-flow-using-platform-identity-single-sign-on-method

次の図に示すように、プラットフォーム IDを使用してシングルサインオンによる認証フローを実装するには、次の手順を実行します。

​ プラットフォーム IDを使用して、シングルサインオンを通じて承認決定を取得

プラットフォーム IDを使用して、シングルサインオンを通じて承認決定を取得

  1. プラットフォーム IDの取得: 2番目のストリーミング アプリケーションは、Adobe Pass システム以外のID サービスまたはライブラリを呼び出して、一意のプラットフォーム IDに関連付けられたJWSまたはJWE ペイロードを取得します。

  2. JWSまたはJWE:​として一意のプラットフォーム IDを返します。2番目のストリーミング アプリケーションは、応答データを検証して、基本的なセキュリティ条件が満たされていることを確認します。

    • ペイロードの有効期限が切れていません。
    • ペイロードは署名または暗号化されています。
  3. 承認決定の取得: 2番目のストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。

    note important
    IMPORTANT
    詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。
    • serviceProvider、mvpd、resourcesなど、必須​のすべてのパラメーター
    • AuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて
    • すべての​_optional_ パラメーターとヘッダー
    ストリーミングアプリケーションは、リクエストを行う前に、一意のプラットフォーム識別子の有効な値が含まれていることを確認する必要があります。
    Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ヘッダーについて詳しくは、Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token ドキュメントを参照してください。
  4. シングルサインオンプロファイルを検索: Adobe Pass サーバーは、受信したパラメーターとヘッダーに基づいて、有効なシングルサインオンプロファイルを識別します。

  5. 要求されたリソースに対するMVPDの決定を取得: Adobe Pass サーバーは、MVPD認証エンドポイントを呼び出して、ストリーミングアプリケーションから受信した特定のリソースに対するPermitまたはDenyの決定を取得します。

  6. メディアトークンを使用してPermitの決定を返します:​決定承認エンドポイント応答には、Permitの決定とメディアトークンが含まれています。

    note important
    IMPORTANT
    決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。
    決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。
    • 必須 パラメーターとヘッダーは有効である必要があります。
    • 指定されたserviceProviderとmvpdの統合はアクティブである必要があります。
    検証が失敗すると、エラー応答が生成され、拡張エラーコード ​のドキュメントに準拠する追加情報が提供されます。
  7. メディアトークンを使用してストリームを開始: 2番目のストリーミングアプリケーションは、メディアトークンを使用してコンテンツを再生します。

  8. 詳細を含むDenyの決定を返します: 「決定を承認」エンドポイント応答には、Denyの決定と、拡張エラーコード ​ ドキュメントに準拠するエラーペイロードが含まれています。

    note important
    IMPORTANT
    決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。
    決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。
    • 必須 パラメーターとヘッダーは有効である必要があります。
    • 指定されたserviceProviderとmvpdの統合はアクティブである必要があります。
    検証が失敗すると、エラー応答が生成され、拡張エラーコード ​のドキュメントに準拠する追加情報が提供されます。
  9. Handle Deny決定の詳細: 2番目のストリーミングアプリケーションは、応答からエラー情報を処理し、オプションでユーザーインターフェイスに特定のメッセージを表示するために使用できます。

NOTE
事前認証フローの手順は、認証フローの手順と同じですが、使用されるエンドポイントは、特定のmvpd ドキュメントを使用した事前認証の決定の取得に記載されているエンドポイントです。
recommendation-more-help
pass-help-authentication