プログラマーのユースケース programmer-use-cases
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
概要 overview
このドキュメントでは、Adobe Pass認証でサポートされるプログラマー統合のユースケースの概要を説明します。 統合プロジェクトを開始する前にこのページを確認すると、現在サポートされている機能を確認できます。
ユースケース use-cases
基本統合：単一チャネルネットワーク用のフェデレーション認証および承認 basic-integration
優先度 – 高
分類 - エクスペリエンス内でホストされる 1 つのチャネルネットワークを備えた、単一のプログラマーブランドの TVE アプリ
これにより、プログラマーは、自社ブランドの TVE アプリ*で、MVPD に対するフェデレーションの使用権限チェックを使用して、プレミアムコンテンツを提供できます。 requestorID は、ビューアにコンテンツを提供するアプリケーションのブランドに一致するように調整する必要があります。 このシナリオでは、Adobe Pass認証依頼者 ID とリソース ID の間に、使用権限が確認される 1 ～ 1 の関係があります。
NOTE
TVE アプリは、このドキュメントで、様々なタイプのアプリケーション（Web アプリ、モバイルアプリなど）をまとめて参照するために使用されます。 Adobe Pass認証でサポートされます。 以下の「プラットフォーム」列には、特定のユースケースでサポートされるプラットフォームの詳細が含まれる場合があります。
具体的な使用例（ほとんどの統合に共通） sp-use-cases-basic-int
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
高
プログラマ TVE アプリからの MVPD 検出
ユーザーは、プログラマーのブランドの TVE アプリから開始し、MVPD プロバイダーを選択するように求められます。
Web （SWF/JS） モバイル （iOS/Android） クライアントレス API （2 画面目）
高
プログラマー TVE アプリからの連合認証
ユーザーは、プログラマーのブランドの TVE アプリから開始し、MVPD プロバイダーを選択した後、MVPD 独自のログインページに移行して、資格情報を入力します。
Web （SWF/JS） モバイル （iOS/Android）
高
プログラマー TVE アプリからの認証
ユーザーが認証されると、プログラマーの TVE アプリは MVPD にバックチャネル認証リクエストを送信して、ユーザーの使用権限を確認できます。 通常、これはチャネルネットワークがユーザー MVPD サブスクリプションパッケージ内にあるかどうかをチェックするだけです。 この場合、リクエスター ID とリソース ID は 1:1 で一致します。
すべてのプラットフォーム
Medium
プログラマー TVE アプリからのログアウト
Adobe Pass認証の AuthN/AuthZ トークンのログアウトおよびクリアを有効にします。 多くの場合、これも MVPD からユーザーをログアウトします。 ただし、MVPD は、これがサポートされるかどうかによって異なります。 Adobe Pass認証セッションとトークンは常にクリアされます。
XBox Native を除くすべてのプラットフォーム
いくつかの MVPD はこれをサポートしていません。
高
サイトとアプリをまたいだシングルサインオン
ユーザーが、再度ログインしなくてもサイトやアプリ間でログインセッションを共有できるようになります。
クライアントレス API を除くすべてのプラットフォーム
一部の MVPD には SDK 1.7 以降が必要です。
複数のチャネルネットワークをホストする単一の TVE アプリ single-app-multi-channel
優先度 – 高
プログラマーが、同じブランドの宛先に属する複数のチャネルネットワークをビューアに集約できるようにします。
具体的な使用例 sp-use-cases-singl-tve-app
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
高
ユニークチャネル認証
ユーザーは、同じ TVE アプリ内の複数のチャネルネットワークのコンテンツを視聴できます。 プログラマーは、各チャネルネットワークに固有の認証呼び出しを行い、ユーザーの使用権限を確認できます。
すべてのプラットフォーム
すべての MVPD は、何らかの形でこれをサポートするようになりました。
低
プリフライト認証クエリ
これにより、プログラマーは 1 回の API 呼び出しで、パッケージに含まれているユーザーのチャネルを確認できます。 これは、ユーザーがアクセス権を持たないユーザーインターフェイスからコンテンツをフィルタリングするために、実際の AuthZ 呼び出しの前に行われます。
ほとんどの MVPD は、まだこのデータをユーザ属性として公開していないので、Adobeは実際にそれを取得するために AuthZ を呼び出します。 また、ほとんどの MVPD は、1 回の呼び出しで複数のチャネルをサポートしないので、一度に 5 つに制限されます。 プログラマーがプリフライトチェックに必要なチャネル数を確認することは非常に重要です。 MVPD の数に関わらず、MVPD で OK であることを確認する必要があります。 ほとんどの MVPD は、現在（2013 年第 3 四半期）は 5 つ以上のチャネルをサポートしていません。
アセットレベルの認証 asset-level-authz
優先度 – 低
分類 – 認証リクエストにアセット識別子を渡します
プラットフォーム – すべてのプラットフォーム
具体的な使用例 sp-use-cases-asset-lvl-authz
MVPD が各 AuthZ 呼び出しでアセットレベル分析を取得できるようにします。 これには、Adobe Pass認証 AuthZ キャッシュを無効にするデメリットがあります。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
低
認証リクエストにアセット識別子を渡す
MVPD が各 AuthZ 呼び出しでアセットレベル分析を取得できるようにします。 には、Adobe Pass認証 AuthZ キャッシュを否定する欠点があります。
すべてのプラットフォーム
現在これをサポートしている MVPD は 1 つだけです。
保護者による制限 parental-controls
優先度 – 低
プログラマの TVE アプリで MVPD ユーザーアカウントの制限を適用できるようにします。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
低
ユーザー属性に基づくコンテンツのフィルタリング
ユーザーに対して使用可能なコンテンツのリストをレンダリングする前に、プログラマーがユーザーに許可されている最大評価を確認できるようにします。
Web （Flash/JS） モバイル （iOS/Android）
現在、1 つの MVPD でのみ動作します。
低
AuthZ リクエストでコンテンツ評価を渡す
AuthZ 要求の一部としてユーザーが監視するコンテンツの特定の評価を、プログラマーが MVPD に渡せるようにします 評価は通常、資産レベルで行われるので、#3 に関連しています。
すべてのプラットフォーム
現在、1 つの MVPD でのみ動作します。
プログラマーブランドごとの MVPD 統合のカスタマイズ mvpd-int-cust-prog-brand
優先度 - Medium
AuthN 中または AuthZ エラーメッセージのカスタムエクスペリエンスを有効にします。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
Medium
AuthN リクエストでサービスプロバイダー識別子を渡します。
サービスプロバイダーに固有の MVPD ログインページで固有のブランディングを有効にします。 また、オーディエンスに合わせてデフォルトの設定を自動的に選択するようにすることもできます（例：Univision のスペイン語）。
すべてのプラットフォーム
MVPD によって異なります。 サポートされていないものもあります。
Medium
AuthZ 応答のカスタムエラーメッセージ
MVPD からのプログラマまたはブランド固有のエラーメッセージを有効にします。このエラーメッセージには、パッケージをアップグレードするリンクを使用したアップセル用の特定のメッセージを含めることができます。
Web、Android、iOS
MVPD によって異なります。 サポートされていないものもあります。
接続デバイスのユースケース connected-devices
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
Medium
アプリケーションおよびコンソール間の XBox LiveID SSO
ユーザーは、アプリ間および異なるゲーム コンソール間で LiveID アカウントに関連付けられた AuthN セッションを共有できます。
XBox ネイティブ SDK
ほとんどの MVPD は、典型的なモデルはユーザーではなくデバイスにトークンをバインドすることであるため、これを好みません。 この方法は、可能であれば推奨しません。
高
デバイス上の appID にバインドされたトークンを持つ接続デバイス
プログラマーが、トークン内の MVPD 使用権限を、発行先のデバイスの appID にバインドできるようにします。
クライアントレス API
これにより、接続されたデバイスがトークンの標準パス実装により近くなります。 それでも、デバイス全体の ID である必要があります。
デバイス固有の AuthN TTL 長 authn-ttl-length
通常のチャネルなど、MVPD 使用権データベースにあるリソースではない可能性のある特別なイベントに対して、TVE 使用権を有効にします。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
高
プラットフォームごとに異なる TTL 値を設定
プログラマーが web、モバイルおよび接続デバイスに対して異なる TTL 長を確立できるようにします。 現在、Adobe Pass認証は、次の 3 つの個別の TTL 値を持つ機能をサポートしています。 Web （Flash） モバイル/HTML5 クライアントレス – 接続デバイス
一部の MVPD では、TTL が動的に設定されます。 Adobeは、必要に応じて、設定を使用してこれらの動的設定を上書きできます。
特別なイベントベースのアプリケーション special-event
優先度 – 低
通常のチャネルなど、MVPD 使用権データベースにあるリソースではない可能性のある特別なイベントに対して、TVE 使用権を有効にします。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
低
イベントのプロキシとしての複数のチャネル
これは、加入者がアクセスするためにパッケージに 2 つの異なるチャネルを含める必要があるオリンピックのために行われました。 この場合、Adobe Pass Authentication は新しい resourceID を作成し、すべての MVPD に端の特定のチャネルへのマッピングを行わせました。 それは前もって通知すれば十分にうまく機能した。 ほとんどの MVPD は複数のリソース呼び出しをサポートしていないため、これは重要でした。
すべてのプラットフォーム
適切な通知を行ってすべての MVPD でサポートされます。
低
既存のチャネルリソースを使用した、特別な新しいイベントアプリケーション
これは 3 月の狂気のために行われました。 コンテンツプロバイダーが、新しい requestorID で新しいアプリを作成しました。 すべての MVPD は、自分のシステムに新しい requestorID のサポートを追加する必要がありました。 resourceID は通常のチャネルでした。 また、一部の MVPD では、新しいリクエスターでチャネルを有効としてマッピングする必要があったため、これらの場合にはさらに時間が必要でした。
すべてのプラットフォーム
適切な通知を行ってすべての MVPD でサポートされます。
低
既存のリクエスター ID、リソース ID
これはマスターのゴルフウィークエンドトーナメントのために行われた。 数日間の小さなイベントで、マスターはコンテンツを表示できる独自のモバイルアプリを持っていました。 プログラマーは、Adobe Pass認証トラフィックの支払いを行い、標準の requestorID と resourceID のみを使用する予定でした。 唯一のコツは、プログラマーにマスターと署名する requestorID のモバイル証明書を共有させ、その週末にバックアップ証明書として設定に追加することでした。
すべてのプラットフォーム
MVPD への影響なし
Content server の統合 content-server-integration
優先度 - Medium
ビデオストリームをクライアントプレーヤーにリリースする前に、メディアトークンの検証を有効にします。
優先度
ユースケース
説明
プラットフォーム
MVPD メモ
高
プログラマー向け Federated Player - ページレベルの認証を使用
Adobe Pass認証 API は、ページのJavaScriptで実行され、トークンが Player に渡されます。 トークンは、次の 2 つの方法で検証サービスに渡すことができます。 検証サービス URL のパラメーターを取得 ストリーム URL のクエリ文字列で渡された URL パラメーター 外部インターフェイス API FlashVars
Medium
プログラマー向けフェデレーテッド プレーヤー – 内部プレーヤー認証付き
Adobe Pass認証 API は PlayerSWFのActionScriptでおこなわれるので、コールバックから Player がトークンを使用できます。
高
シンジケートプレーヤー – iFrame を使用してプレーヤーをラップするページレベルの認証を持つ MVPD ポータルでホスト
ページレベルの権限を持つプレーヤーと似ていますが、プレーヤーページのラッパーが MVPD ポータルに組み込まれています。 認証は、MVPD ポータルで別途行う必要があります。
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b