TempPass機能 temp-pass-feature

TempPassは、プログラマーが有効なMVPDアカウント資格情報を持たないユーザーに、保護されたコンテンツへの一時的なアクセスを提供できるようにする汎用性の高い機能です。 基本的なアクセスシナリオでも、ターゲットを絞ったプロモーションキャンペーンでも、視聴者を惹きつけるための効果的なツールとして機能します。

TempPassは、プログラマーが次のことを行うための強力なソリューションです。

TempPass機能は、Adobe Pass Authentication Server Configuration内に疑似MVPD（さらに「Temp Pass」という名前）を導入し、関連するプログラマーとの統合として提供されます。 TempPass機能は、次の2つの構成で利用できます。

次の表に、基本TempPass機能とプロモーション TempPass機能の簡単な比較を示します。

TempPassでは、コンテンツライブラリを存分に活用したい場合にも、マーキーイベントを宣伝したい場合にも、アクセス制御を維持しながらオーディエンスを拡大するためのツールを提供しています。

基本TempPass basic-temp-pass

基本的なTempPass機能により、プログラマーは、さまざまなシナリオに対応したコンテンツへの時間制限付きアクセスを提供できます。

特定のイベントでは、最初の無料利用期間の延長（4時間など）、その後の毎日の無料利用期間の短縮（毎日10分など）など、コンテンツへの段階的な無料アクセスが必要になる場合があります。 このシナリオを実装するには、プログラマーはAdobeの担当者と連携して、ニーズに合わせて2つのTempPass MVPDを設定する必要があります。

例えば、最初の4時間の無料セッションの後に毎日10分の無料セッションを提供するために、Adobeはプログラマーに対して次のように設定できます。

毎日アクセスするための適切な機能を確保するために、TempPass2は、毎日00:00時間にすべてのデバイスでリセットする必要があります。

機能について basic-temp-pass-feature-details

設定パラメーター：

ユーザーID:

基本的なTempPass機能では、デバイス識別子をユーザー識別パラメーターとして使用します。

次の表は、ユーザー識別パラメーターがユーザートライアル体験にどのような影響を与えるかを理解するのに役立ちます。

表示時間の計算：

TTLは、コンテンツを実際に表示した時間に関係なく、最初の認証リクエスト時間から有効期限までの時間を表します。 今後の各リクエストは、現在のサーバー時間を、保存された有効期限と比較して確認し、アクセスを承認します。

認証：

Basic TempPassでは、認証は必要ありません。認証ステップに直接進むことができます。

認証：

実際のMVPDとのインタラクションがないので、TempPassが有効な場合、基本の「Temp Pass」MVPDはリソースを認証します。 承認が成功した場合、メディアトークン検証ライブラリは、コンテンツ再生を開始する前に、メディアトークンを検証し、リソース検証を確保するために引き続き適用されます。

認証の決定は、ユーザー識別パラメーターと設定されたTTLに基づいて行われます。 リソースの認証を成功させるには、次の条件を有効なリクエストで満たす必要があります。

ユーザーが設定されたTTLを超えた場合、TempPassがリセットされない限り、同じデバイスでコンテンツを表示できなくなります。

事前認証：

基本的な「Temp Pass」MVPDに対して事前認証リクエストを行うと、リクエストからリクエストのリスト全体が正常に事前承認された状態で返されます。 この動作は、認証条件が特定のリソースではなく時間制限に基づいていることを考えると、認証ロジックを反映します。 時間制約が有効である限り、リクエストされたリソースは許可されます。

ログアウト：

Basic TempPassでは、ログアウトは必要ありません。これにより、実際のユーザーMVPDを使用して認証ステップに直接切り替えることができます。

データと分析の追跡：

基本的なTempPass フローでは、トラッキングデータはデバイス IDのハッシュ化されたバージョンを使用し、MVPD IDは「Temp Pass」に設定されます。 プログラマーは、アナリティクス実装において、TempPass指標をMVPDの標準的な指標と区別する必要があります。

プロモーション TempPass promotional-temp-pass

プロモーション TempPass機能は、プロモーションキャンペーンの実行に特化して設計された基本的なTempPassの機能を拡張します。 この機能を使用すると、電子メールアドレスなどの有効なユーザーIDを収集した後、指定された期間にわたって定義済みの数のVOD タイトルにアクセスできるため、ユーザーをエンゲージできます。

プロモーション TempPassには、基本的なTempPassのすべての機能が含まれており、次のような柔軟性が追加されています。

ユーザーが事前定義されたアクセス制限（VODのタイトル数または期間）を超えると、TempPassがリセットされない限り、同じデバイスまたは同じユーザーIDを使用してコンテンツを表示できなくなります。

機能について promotional-temp-pass-feature-details

設定パラメーター：

ユーザーID:

プロモーション TempPass機能では、デバイス識別子の上にユーザーが指定した識別子のハッシュをユーザー識別パラメーターとして使用します。

Adobeでは、データがAdobeに送信される前に、SHA-2 ファミリーまたはその特定の​SHA-256、SHA-512​関数を使用することをお勧めします。 例えば、"user@domain.com"​の​ SHA-256 ​は​ "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7" ​です。

次の表は、ユーザー識別パラメーターがユーザートライアル体験にどのような影響を与えるかを理解するのに役立ちます。

表示時間の計算：

TTLは、コンテンツを実際に表示した時間に関係なく、最初の認証リクエスト時間から有効期限までの時間を表します。 今後の各リクエストは、現在のサーバー時間を、保存された有効期限と比較して確認し、アクセスを承認します。

認証：

プロモーション TempPassでは、認証は必要ありません。認証ステップに直接進むことができます。

プログラマーアプリケーションの実装をサポートするために、プロモーションテンプパスは、対応するキーを介してアクセス可能な次のユーザーメタデータ情報を公開します。

認証：

実際のMVPDとのインタラクションがないので、TempPassが有効な場合、プロモーション「Temp Pass」MVPDは任意のリソースを認証します。 承認が成功した場合、メディアトークン検証ライブラリは、コンテンツ再生を開始する前に、メディアトークンを検証し、リソース検証を確保するために引き続き適用されます。

認証の決定は、ユーザー識別パラメーター、設定されたリソース数およびTTLに基づいて行われます。 リソースの認証を成功させるには、次の条件を有効なリクエストで満たす必要があります。

設定されたTTLまたはリソース数を超えるユーザーの場合、TempPassがリセットされない限り、同じデバイスまたは同じユーザーが提供した識別子でコンテンツを表示できなくなります。

事前認証：

プロモーション「Temp Pass」MVPDに対して事前承認リクエストが行われると、リクエストからリクエストのリスト全体が正常に事前承認された状態で返されます。 この動作は認証ロジックを反映します。認証条件は、特定のリソースではなく、時間制限とアクセスされるリソースの合計数に基づいています。 時間制約が有効で、リソース制限を超えていない限り、リクエストされたリソースは承認されます。

ログアウト：

プロモーションテンプパスでは、ログアウトは必要ありません。これにより、実際のユーザーMVPDを使用して認証ステップに直接切り替えることができます。

データと分析の追跡：

プロモーション用TempPass フローでは、トラッキングデータはデバイス IDのハッシュ化されたバージョンを使用し、MVPD IDは「Temp Pass」に設定されます。 プログラマーは、アナリティクス実装において、TempPass指標をMVPDの標準的な指標と区別する必要があります。

TempPass API アクセスのリセット reset-tempass-api-access

Reset TempPass APIにアクセスする前に、Dynamic Client Registration （DCR）プロセスで必要な手順を完了する必要があります。 この必須プロセスにより、Reset TempPass APIを操作するために必要なアクセストークンを取得できます。

包括的な手順については、Dynamic Client Registration Overviewのドキュメントを参照してください。

TempPass APIのリセット - DELETE /reset-tempass/v3/reset reset-tempass-v3-reset

デバイスまたはすべてのデバイスに対して特定のTempPassをリセットするには、Adobe Pass Authenticationで、BasicとPromotional TempPassの両方に対応するAPIがプログラマーに提供されます。

リクエスト reset-tempass-v3-reset-request

応答 reset-tempass-v3-reset-response

サンプル reset-tempass-v3-reset-samples

特定のデバイスのTempPassをリセット reset-tempass-v3-reset-specific-device

$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=ba23d141-d715-561c-94f4-e9e4c966b1eb"

すべてのデバイスのTempPassをリセット reset-tempass-v3-reset-all-devices

$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset?requestor_id=REF30&mvpd_id=TempPass&device_id=all"

TempPass APIのリセット - DELETE /reset-tempass/v3/reset/generic reset-tempass-v3-reset-generic

汎用キー（ユーザーが提供する識別子ハッシュ）またはすべてのキーに対して特定のTempPassをリセットするために、Adobe Pass Authenticationはプログラマーにプロモーション TempPassで動作するAPIを提供します。

リクエスト reset-tempass-v3-reset-generic-request

応答 reset-tempass-v3-reset-generic-response

サンプル reset-tempass-v3-reset-generic-samples

特定のキーのTempPassのリセット reset-tempass-v3-reset-specific-key

$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7"

すべてのキーのTempPassをリセット reset-tempass-v3-reset-all-keys

$ curl -H "Authorization: Bearer <access_token_here>" -X DELETE -v "https://mgmt.auth.adobe.com/reset-tempass/v3/reset/generic?requestor_id=REF30&mvpd_id=TempPass&key=all"

REST API V2 rest-api-v2

TempPass機能を利用するには、コードの更新を実装して、TV Everywhere （TVE） アプリケーションがAdobe Pass Authentication REST API V2とどのように連携するかを変更する必要があります。

これらの更新と関連ワークフローに関する包括的なガイドについては、一時アクセスフローのドキュメントを参照してください。