決定 decisions
決定は、ユーザーのAdobe Pass認証または事前認証の問い合わせに基づいて、MVPD認証 REST API V2 によって生成され、「保護されたコンテンツ へのアクセスが許可されているか拒否されているかを判定しす。
提供される決定には、呼び出された API に応じて 2 つのタイプがあります。
事前認証の決定 preauthorization-decisions
事前認証の決定とは、 保護されたリソースに対するユーザーのアクセスを、MVPDが許可するか拒否するかをクライアントアプリケーションに通知するための有益な決定です。
事前認証(プリフライト認証)の目的は、ユーザーが表示する資格のあるコンテンツに関する正確な情報をアプリケーションに表示できるようにすることです。 これを実現するには、アクセスステータスを反映するロック済みアイコンやロック解除されたアイコンなどのインジケーターでユーザーインターフェイスを強化します。
事前認証 API の使用は必須ではありません。フィルタリングを行わずにリソースのカタログを表示する場合は、クライアントアプリケーションでこれをスキップできます。
クライアントアプリケーションでこの機能を使用する場合は、事前認証の決定は、API リクエストごとに限られた数のリソース(通常は 5 つまで)でのみ取得できることに注意が必要です。
MVPD は、パフォーマンスと 1 つの API リクエストで処理できる最大リソース数に明確な影響を与える、様々なメカニズムを通じて事前認証をサポートできます。
事前認証をサポートする既存のメカニズムについて詳しくは、MVPD Preflight Authorization ドキュメントを参照してください。
認証の決定 authorization-decisions
認証決定とは、 保護されたリソースに対するユーザーのアクセスを許可または拒否するMVPD決定に、クライアントアプリケーションが準拠できるようにする、権限のある決定です。
認証の目的は、MVPDでの権限検証やAdobe Pass Authentication からのメディアトークンの受信に従って、ユーザーから要求されたリソースをアプリケーションが再生できるようにすることです。
認証 API の使用は必須です。クライアントアプリケーションは、ユーザーがリクエストするリソースを再生する場合、このフェーズをスキップできません。ストリームをリリースする前に、ユーザーが権限を持っていることをMVPDで確認する必要があるからです。
承認の決定は、API リクエストごとに限られた数のリソース(通常は 1)に対してのみ取得できます。
認証有効期間(TTL)管理 authorization-ttl-management
認証有効期間(TTL)は、リソースが再認証される必要があるまでに、承認されたままになっている期間を定義します。 この期間は制限されており、MVPDの担当者と合意する必要があります。 TTL 値は、以下に基づいて変化する可能性があります。
- プラットフォームカテゴリ(デスクトップ、モバイル、TV 接続デバイスなど)
- 特定のプラットフォーム(iOS、Android、tvOS、Roku、FireTV など)
認証(authZ) TTL の表示や変更は、Adobe PassTVE ダッシュボードを通じて、組織管理者の 1 人が、またはAdobe Pass認証担当者が代理で行うことができます。
詳しくは、TVE ダッシュボード統合ユーザーガイドドキュメントを参照してください。
保護されたリソース protected-resources
保護されたリソースとは、ストリーミング可能なコンテンツを指し、MVPD と参加プログラマーの間の契約を通じて定義された一意の値によって識別されます。
保護されたリソースは階層ツリー構造に従い、各レベルでコンテンツ認証の精度が向上します。
- ネットワーク
- チャネル
- 表示
- エピソード
- アセット
- エピソード
- 表示
- チャネル
CDATA
セクションを含む識別子を持つリソースを使用することはお勧めしません。主に、MRSS によって定義されるアセットレベルのリソースに使用されるからです。リソース識別子 resource-identifier
リソースの一意の ID には、次の 2 つの形式があります。
- チャネル(ブランド)の一意の ID などの単純な文字列形式。
- タイトル、規制、保護者による制限のメタデータなどの追加情報を含むメディア RSS (MRSS)形式。
「REF30」などの単純なリソース識別子(チャネルを表すと想定)の場合は、次のように RSS リソース識別子に変換できます。
<rss version="2.0">
<channel>
<title>REF30</title>
</channel>
</rss>
より複雑なリソース識別子の場合、RSS リソース識別子には次のような追加の評価情報を含めることができます。
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
<channel>
<title>REF30</title>
<media:rating scheme="urn:mpaa">pg</media:rating>
</channel>
</rss>
一意の ID は主にAdobe Pass Authentication に対して不透明ですが、トランスフォーマーはMVPDの機能と要件に基づいて適用される場合があります。 MVPDがリソース ID を認識または解析できない場合は、Adobe Pass Authentication にエラーを返し、その後、Enhanced Error Code を使用してエラーをクライアントアプリケーションにリレーします。
REST API V2 rest-api-v2
事前認証の決定は、次の API を使用して取得できます。
認証決定は、次の API を使用して取得できます。
事前認証と認証決定の構造を理解するには、上記の API の Response および Samples の節を参照してください。
上記の API を統合する方法とタイミングについて詳しくは、次のドキュメントを参照してください。