プログラマーの使用例 programmer-use-cases
Last update: Wed Sep 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
このページのコンテンツは、情報提供の目的でのみ提供されます。 この API を使用するには、Adobeの現在のライセンスが必要です。 不正な使用は許可されていません。
概要 overview
このドキュメントでは、Adobe Pass Authentication でサポートされるプログラマー統合の使用例についてまとめます。 統合プロジェクトを開始する前に、このページを確認して、現在サポートされている機能を確認できます。
使用例 use-cases
基本的な統合：単一チャネルネットワークに対するフェデレーテッド認証と承認 basic-integration
優先度 — 高
分類 — エクスペリエンス内で 1 つのチャネルネットワークがホストされる、単一のプログラマーブランドの TVE アプリ
これにより、プログラマーは、MVPD に対するフェデレーテッドエンタイトルメントチェックを使用して、独自のブランドの TVE アプリ*でプレミアムコンテンツを提供できます。 requestorID は、コンテンツをビューアに提供するアプリケーションのブランドと一致するように整列する必要があります。 このシナリオでは、Adobe Pass認証要求者 ID と、権限の検証を受けるリソース ID の間に 1 対 1 の関係があります。
このドキュメントで TVE アプリを使用して、様々な種類のアプリケーション（Web アプリ、モバイルアプリなど）をまとめて参照します。 Adobe Pass Authentication でサポートされます。 以下の「プラットフォーム」の列には、特定の使用例でサポートされるプラットフォームに関する詳細が含まれている場合があります。
特定の使用例（ほとんどの統合に共通） sp-use-cases-basic-int
優先度
使用例
説明
プラットフォーム
MVPD メモ
高
プログラマー TVE アプリからの MVPD Discovery
ユーザーは Programmer のブランド TVE アプリを起動し、MVPD プロバイダを選択するよう求められます。
Web(SWF/JS)Mobile(iOS/Android)Clientless API（2nd-Screen 用）
高
プログラマー TVE アプリからのフェデレーテッド認証
ユーザーは Programmer のブランド TVE アプリを起動し、MVPD プロバイダを選択した後、ユーザーは MVPD のログインページに移行し、自分の資格情報を入力します。
Web(SWF/JS)Mobile(iOS/Android)
高
プログラマー TVE アプリからの認証
ユーザーが認証されると、プログラマーの TVE アプリは、MVPD に対してバックチャネル認証要求を行い、ユーザーのエンタイトルメントを確認できます。 通常は、Channel Network がユーザーの MVPD 購読パッケージに含まれているかどうかを確認するだけです。 この場合、要求者 ID とリソース ID は 1 対 1 で一致します。
すべてのプラットフォーム
中
プログラマー TVE アプリからログアウト
ユーザーがログアウトし、Adobe Pass Authentication AuthN/AuthZ トークンをクリアできるようにします。 多くの場合、これはまた、ユーザーを MVPD からもログアウトします。 しかし、MVPD は、これがサポートされているかどうかによって異なります。 Adobe Pass Authentication のセッションとトークンは常にクリアされます。
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 呼び出しを行って取得します。 また、1 回の呼び出しで複数のチャネルをサポートしないため、ほとんどの MVPD は一度に 5 に制限されます。 プリフライトチェックに必要なチャネル数を確認することが非常に重要です。 番号が何であっても、MVPDs で問題がないか確認する必要があります。 ほとんどの 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
優先度 — 低
MVPD ユーザーアカウントの制限をプログラマーの TVE アプリに適用できるようにします。
優先度
使用例
説明
プラットフォーム
MVPD メモ
低
ユーザー属性に基づいてコンテンツをフィルタリング
プログラマーが、使用可能なコンテンツのリストをユーザに表示する前に、ユーザに許可される最大評価を確認できるようにします。
Web(Flash/JS)Mobile(iOS/Android)
現在、1 つの MVPD でのみ機能します。
低
AuthZ 要求でのコンテンツ評価の受け渡し
評価は通常アセットレベルにあるので、AuthZ 要求の一部としてユーザーが視聴したいコンテンツの特定の評価を#3に関連する MVPD に渡すことができます。
すべてのプラットフォーム
現在、1 つの MVPD でのみ機能します。
プログラマーブランドごとの MVPD 統合のカスタマイズ mvpd-int-cust-prog-brand
優先度 — 中
AuthN 中または AuthZ エラーメッセージのカスタムエクスペリエンスを有効にします。
優先度
使用例
説明
プラットフォーム
MVPD メモ
中
AuthN リクエストでサービスプロバイダー識別子を渡します。
サービスプロバイダー固有の MVPD ログインページで、特定のブランディングを有効にします。 また、Univision のスペイン語などのオーディエンスに一致するデフォルトを自動的に選択できるようにします。
すべてのプラットフォーム
MVPD によって異なります。 これをサポートしていない人もいます。
中
AuthZ 応答のカスタムエラーメッセージ
MVPD からのプログラマーまたはブランド固有のエラーメッセージを有効にします。このメッセージには、パッケージをアップグレードするリンクを使用して、アップセル用の特定のメッセージを含めることができます。
Web、Android、iOS
MVPD によって異なります。 これをサポートしていない人もいます。
接続されたデバイスの使用例 connected-devices
優先度
使用例
説明
プラットフォーム
MVPD メモ
中
アプリとコンソール間の XBox LiveID SSO
ユーザーが LiveID アカウントに結び付けられた、アプリ間および異なるゲームコンソール間で AuthN セッションを共有できるようにします。
XBox Native SDK
一般的なモデルは、トークンをデバイスにバインドするので、ほとんどの MVPD は、このようなことを気に入りません。ユーザーにバインドするのではありません。 可能な限り、この方法はお勧めしません。
高
デバイス上の appID にバインドされたトークンを使用して接続されたデバイス
プログラマーがトークン内の MVPD エンタイトルメントを、発行先のデバイスの appID にバインドできるようにします。
クライアントレス API
これにより、接続デバイスはトークンの標準パス実装により近くなります。 デバイス全体の ID にするには、改善が必要です。
デバイス固有の AuthN TTL の長さ authn-ttl-length
通常のチャネルのように、MVPD エンタイトルメントデータベース内のリソースでない可能性のある特別なイベントに対して、 TVE エンタイトルメントを有効にします。
優先度
使用例
説明
プラットフォーム
MVPD メモ
高
プラットフォームごとに異なる TTL 値を設定する
Web、モバイル、接続デバイスに対して、プログラマが異なる TTL 長を確立できるようにします。 現在、Adobe Pass認証では、Web(Flash) モバイル/HTML5 クライアントレス — 接続デバイスの 3 つの TTL 値を持つ機能がサポートされています。
一部の MVPD は TTL を動的に設定します。 Adobeは、必要に応じて、設定を使用して、これらの動的設定を上書きできます。
特別なイベント・ベースのアプリケーション special-event
優先度 — 低
通常のチャネルのように、MVPD エンタイトルメントデータベース内のリソースでない可能性のある特別なイベントに対して、 TVE エンタイトルメントを有効にします。
優先度
使用例
説明
プラットフォーム
MVPD メモ
低
1 つのイベントのプロキシとしての複数チャネル
これはオリンピックのために行われました。参加者は、アクセスするためにパッケージに 2 つの異なるチャネルを含める必要がありました。 この場合、Adobe Pass Authentication は新しい resourceID を作成し、すべての MVPD に対して、その終わりの特定のチャネルへのマッピングをおこなわせます。 それは十分に高度な通知でうまくいった。 ほとんどの MVPD は複数のリソース呼び出しをサポートしていないので、これは重要でした。
すべてのプラットフォーム
適切な通知を受けて、すべての MVPD でサポートされます。
低
既存のチャネルリソースを使用した特別な新しいイベントアプリケーション
これは、3 月の狂気のために行われました。 コンテンツプロバイダーが新しい requestorID を持つ新しいアプリを作成しました。 すべての MVPD は、システム内の新しい requestorID のサポートを追加する必要がありました。 resourceID は通常のチャネルでした。 また、新しい要求元の下でチャネルを有効としてマッピングする必要がある MVPD もあり、その場合はより長い時間が必要でした。
すべてのプラットフォーム
適切な通知を受けて、すべての MVPD でサポートされます。
低
既存の requestorID、resourceID
これは、マスターゴルフ週末大会で行われた。 数日間の小さなイベントで、マスターはコンテンツを表示するのに適した独自のモバイルアプリを持っていました。 プログラマーは、Adobe Pass認証トラフィックの支払いを計画し、標準の requestorID と resourceID のみを使用しました。 唯一のコツは、プログラマが requestorID 署名用のモバイル証明書をマスターと共有し、それをその週末のバックアップ用の証明書として設定に追加することでした。
すべてのプラットフォーム
MVPD に対する影響なし
コンテンツサーバーの統合 content-server-integration
優先度 — 中
ビデオストリームをクライアントプレーヤーにリリースする前に、メディアトークンの検証を有効にします。
|優先度 |ユースケース |説明 |プラットフォーム | MVPD メモ | |—|—|—|—|—| |高 |プログラマーフェデレーテッドプレーヤー — ページレベルの認証を使用 | Adobe Pass認証 API は、ページ内の JavaScript で実行され、トークンがプレーヤーに渡されます。 トークンは、いくつかの方法で検証サービスに渡すことができます。検証サービスの URL URL パラメーターの取得ストリーム URL 外部インターフェイス API FlashVars のクエリ文字列で渡される URL パラメーター | | | |中 |プログラマー Federated Player — 内部プレーヤー認証を使用 | Adobe Pass認証 API は、プレーヤーSWFでActionScriptでおこなわれるので、トークンはコールバックからプレーヤーで使用できます。 | | | |高 |シンジケートプレーヤー — iFrame を使用したページレベルの認証で、プレーヤーをラップする MVPD ポータルでホストされます。 |ページレベルの認証を持つプレーヤーと同様ですが、プレーヤーページラッパー iFramed を使用して MVPD ポータルに組み込まれます。 認証は、MVPD ポータルで別々におこなう必要があります。 | | |