プログラマー統合ガイド programmer-integration-guide

この統合ガイドは、Adobe® Pass Authenticationとの統合を計画しているコンテンツプロバイダー（プログラマー）を対象としています。

今日のデジタル環境では、視聴者はいつでもどこでもインターネットにアクセスし、保護されたコンテンツへのアクセスを要求することができます。 1回限りのイベントでの視聴を検討している場合や、TV シリーズ全体のストリーミング権を求めている場合などです。

保護されたコンテンツへのアクセス権を付与する前に、ビューアに権限があるかどうかを判断する必要があります。 主な質問は次のとおりです。

TV Everywhere向けAdobe Pass認証 adobe-pass-authentication-for-tv-everywhere

プログラマーにとって、使用権限の決定は必ずしも簡単ではありません。 MVPDは、顧客の識別データとアクセス権限を管理する役割を果たします。 さらに複雑な問題は、プログラマーの視聴者は、それぞれ独自のシステムで動作する多種多様なMVPDを購読する可能性があります。 これらの複雑さにより、資格情報の検証は技術的に困難で、リソースを集約する必要があります。

{align="center"}

ユーザーの使用権限がプログラマーによって直接決定されました

Adobe Pass認証により、プログラマーとMVPD間のエンタイトルメント取引が安全に促進され、保護されたコンテンツを対象視聴者に迅速かつ容易に提供できます。

{align="center"}

Adobe Pass認証を介したユーザー使用権限

Adobe Pass Authenticationは、プロキシとして機能し、両当事者に安全で一貫性のあるインターフェイスを提供することで、プログラマーとMVPD間の資格フローを促進します。

プログラマーの場合、Adobe Pass Authenticationは​ Standard ​または​ Premium ​層の一部としてAPIを提供します。

ユースケース use-cases

この節では、Adobe Pass Authenticationでサポートされるプログラマー統合のユースケースの概要を説明します。

使用権限のフロー entitlement-flow

エンタイトルメントフローは、保護されたコンテンツをストリーミングするためにプログラマー（TVE）アプリケーションが完了する必要がある一連の手順です。 フローは次のフェーズで構成されます。

ユーザーがプログラマー（TVE）アプリケーションに初めてアクセスすると、エンタイトルメントフローは概説されたシーケンスに従います。 ただし、その後の訪問では、登録または認証のステータスと該当する視聴ポリシーに基づいて、アプリケーションが特定の手順をバイパスする場合があります。

エンタイトルメントフローとそのフェーズについて詳しくは、このドキュメントを引き続き読み、付随するクッキーブックガイドを参照して追加のインサイトを得てください。

登録フェーズ registration-phase

登録フェーズの目的は、Dynamic Client Registration （DCR） ​ プロセスを通じて、Adobe Pass Authenticationに対してクライアントアプリケーションを登録することです。

動的クライアント登録（DCR）プロセスでは、クライアントアプリケーションが登録フェーズの最終目標として、1組のクライアント資格情報を取得し、アクセストークンを取得する必要があります。

API

フロー

FAQ

設定フェーズ configuration-phase

設定フェーズの目的は、各MVPDのAdobe Pass Authenticationによって保存された設定の詳細と共に、クライアントアプリケーションにアクティブに統合されるMVPDのリストを提供することです。

設定フェーズは、クライアントアプリケーションがユーザーにTV プロバイダーの選択を依頼する必要がある場合に、認証フェーズの前提条件ステップとして機能します。

API

FAQ

認証フェーズ authentication-phase

認証フェーズの目的は、クライアントアプリケーションに、MVPDでユーザーのIDを検証し、ユーザーメタデータ情報を取得する機能を提供することです。

認証フェーズは、クライアントアプリケーションでコンテンツを再生する必要がある場合に、事前認証フェーズまたは認証フェーズの前提条件ステップとして機能します。

認証が成功すると、アプリケーション、デバイス、サービスプロバイダーに関連付けられたプロファイルが生成され、ユーザーメタデータ情報も含まれます。

高度な手順

次の手順は、SAML統合の場合の大まかな手順の概要です。

API

フロー

FAQ

シングルサインオン（SSO） single-sign-on

API

フロー

（オプション）事前認証フェーズ preauthorization-phase

事前認証フェーズの目的は、クライアントアプリケーションに、ユーザーがアクセスする権限を持つリソースのサブセットをカタログから提示する機能を提供することです。

事前認証フェーズでは、ユーザーが初めてクライアントアプリケーションを開いたり、新しいセクションに移動したりすると、ユーザーエクスペリエンスが向上します。

API

フロー

FAQ

承認フェーズ authorization-phase

認証フェーズの目的は、MVPDでユーザーの権利を検証した後、クライアントアプリケーションにユーザーがリクエストしたリソースを再生する機能を提供することです。

認証が成功すると、決定が生成され、セキュリティ目的でプログラマー（TVE）アプリケーションに提供されるメディアトークンも含まれます。

高度な手順

次の手順は、大まかな手順の概要を示しています。

API

フロー

FAQ

ログアウトフェーズ logout-phase

ログアウトフェーズの目的は、ユーザーリクエストに応じて、Adobe Pass認証内でユーザーの認証プロファイルを終了する機能をクライアントアプリケーションに提供することです。

API

フロー

FAQ

シングルログアウト（SLO） single-logout

フロー

使用権限について understanding-entitlements

Adobe Passの認証ソリューションでは、認証ワークフローと承認ワークフローが正常に完了したときに生成される、特定のデータであるエンタイトルメントの作成を中心に展開します。 これらの使用権限は、保護されたコンテンツへのアクセスを許可しますが、有効期間は限られています。 使用権限が期限切れになると、認証または承認プロセスを再度開始して更新する必要があります。

使用権限について詳しくは、次のドキュメントを参照してください。

プロファイルと決定の有効期間（「TTL」）値は、プログラマーと有料テレビ事業者の間の合意に基づいて設定され、関係者全員に最もサービスを提供する価値に同意します。