決定 decisions

決定は、ユーザーのAdobe Pass認証または事前認証の問い合わせに基づいてMVPD認証REST API V2によって生成され、保護されたコンテンツ ​へのアクセスが許可されるか拒否されるかを判断します。

呼び出されるAPIに応じて、2種類の決定が提供されます。

事前認証の決定 preauthorization-decisions

事前認証の決定は、クライアントアプリケーションに対して、MVPDが保護されたリソース ​へのユーザーのアクセスを許可するか拒否するかを知らせるための有益な決定です。

事前認証（プリフライト認証）の目的は、ユーザーが表示できる可能性のあるコンテンツに関する正確な情報をアプリケーションが表示できるようにすることです。 これは、アクセスステータスを反映するために、ロックされたアイコンやロック解除されたアイコンなどのインジケーターでユーザーインターフェイスを強化することで実現されます。

事前認証APIの使用は必須ではありません。クライアントアプリケーションがフィルタリングなしでリソースカタログを表示する場合は、これをスキップできます。

クライアントアプリケーションがこの機能を使用する場合は、事前認証の決定は、API リクエストごとに限られた数（通常は最大5）のリソースに対してのみ取得できることに注意してください。

MVPDは、パフォーマンスに対する明確な意味と、単一のAPI リクエストで処理できるリソースの最大数を持つ、様々なメカニズムを通じて事前認証をサポートする場合があります。

事前認証をサポートする既存の仕組みについて詳しくは、MVPD Preflight Authorizationのドキュメントを参照してください。

認証の決定 authorization-decisions

承認決定は、クライアントアプリケーションがMVPDの決定に準拠し、保護されたリソース ​へのユーザーのアクセスを許可または拒否することを許可する権限のある決定です。

認証の目的は、MVPDでの使用権限検証およびAdobe Pass Authenticationからのメディアトークンの受信に従って、ユーザーが要求したリソースをアプリケーションが再生できるようにすることです。

認証APIの使用は必須です。クライアントアプリケーションは、ユーザーがリクエストしたリソースを再生する場合、このフェーズをスキップできません。ユーザーがストリームをリリースする前に、MVPDで権限があることを確認する必要があるからです。

認証の決定は、API リクエストごとに限られた数のリソース（通常は1）に対してのみ取得できることに注意してください。

Authorization Time-to-Live （TTL）管理 authorization-ttl-management

Authorization Time-to-Live （TTL）は、リソースが再認証を必要とする前に許可された状態を維持する期間を定義します。 この期間は限られており、MVPDの担当者と合意する必要があります。 TTL値は、次の要素によって異なります。

認証（authZ） TTLは、Adobe Pass TVE ダッシュボード ​を通じて、組織管理者の1人またはAdobe Pass認証担当者が代理で表示および変更できます。

詳しくは、TVE ダッシュボード統合ユーザーガイド ​のドキュメントを参照してください。

保護されたリソース protected-resources

保護されたリソースとは、MVPDと参加プログラマー間の合意によって定義された一意の値によって識別される、ストリーミング可能なコンテンツを指します。

保護されたリソースは階層的なツリー構造に従い、各レベルでコンテンツの認証をより詳細に行うことができます。

リソース識別子 resource-identifier

リソースの一意のIDには、次の2つの形式を使用できます。

「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認証に対して不透明ですが、MVPDの機能と要件に基づいてトランスフォーマが適用される場合があります。 MVPDがリソース IDを認識または解析できない場合、Adobe Pass Authenticationにエラーを返し、その後拡張エラーコード ​を使用してクライアントアプリケーションにエラーをリレーします。

REST API V2 rest-api-v2

事前認証の決定は、次のAPIを使用して取得できます。

認証の決定は、次のAPIを使用して取得できます。

事前認証と認証の決定の構造については、上記のAPIの​ 応答 ​および​ サンプル ​のセクションを参照してください。

上記のAPIを統合する方法とタイミングについて詳しくは、次のドキュメントを参照してください。