一時的なアクセスフロー temporary-access-flows
TempPassを使用すると、ユーザーに有効なMVPD アカウントでの認証を依頼することなく、保護されたコンテンツに一時的にアクセスできます。
TempPass機能について詳しくは、TempPassのドキュメントを参照してください。
一時アクセス フローでは、次のシナリオについてクエリを実行できます。
基本的なTempPassを使用して認証の決定を取得する retrieve-authorization-decisions-using-basic-temppass
前提条件 prerequisites-retrieve-authorization-decisions-using-basic-temppass
基本的なTempPassを使用して認証の決定を取得する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションは、ユーザーに認証を依頼することなく、コンテンツを再生するための一時的なアクセスを提供したいと考えています。
- ストリーミングアプリケーションは、ユーザーが選択したリソースを再生する前に、認証決定を取得する必要があります。
- 指定された
serviceProviderとmvpdの間の統合に適用される基本的なTempPassの有効な設定が必要です。 - 基本的なTempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていません。
ワークフロー workflow-retrieve-authorization-decisions-using-basic-temppass
次の図に示すように、基本的なTempPassを使用して認証フローを実装するには、次の手順に従います。
基本的なTempPassを使用して認証の決定を取得
-
承認決定の取得： ストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
-
基本的なTempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合に適用された基本的なTempPassの有効な設定が存在するかどうかを確認します。 -
メディアトークンを使用して
Permitの決定を返します：決定承認エンドポイント応答には、Permitの決定とメディアトークンが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 決定承認エンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - 基本的なTempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていない必要があります。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
メディアトークンを使用してストリームを開始： ストリーミングアプリケーションは、メディアトークンを使用してコンテンツを再生します。
プロモーション TempPassを使用して認証の決定を取得 retrieve-authorization-decisions-using-promotional-temppass
前提条件 prerequisites-retrieve-authorization-decisions-using-promotional-temppass
プロモーション TempPassを使用して認証の決定を取得する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションは、ユーザーに認証を依頼することなく、最大のリソースを再生するための一時的なアクセスを提供したいと考えています。
- ストリーミングアプリケーションは、承認決定を取得する際に、ユーザーのIDに関する一意の情報を含める必要があります。
- ストリーミングアプリケーションは、ユーザーが選択したリソースを再生する前に、認証決定を取得する必要があります。
- 指定された
serviceProviderとmvpdの間の統合に適用されるプロモーション TempPassの有効な設定が必要です。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていません。
- プロモーション TempPass用に設定されたリソースの最大数が消費されていません。
ワークフロー workflow-retrieve-authorization-decisions-using-promotional-temppass
次の図に示すように、プロモーション TempPassを使用して認証フローを実装するには、次の手順に従います。
プロモーション TempPassを使用して承認決定を取得
-
承認決定の取得： ストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
決定承認エンドポイントでは、プロモーション TempPassを使用する際に AP-TempPass-Identityヘッダーが必要です。 ヘッダーには、コンテンツにアクセスするユーザーのIDに関する一意の情報が含まれます。AP-TempPass-Identityヘッダーについて詳しくは、AP-TempPass-Identityのドキュメントを参照してください。 -
プロモーション TempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合にプロモーション TempPassの有効な設定が適用されているかどうかを確認します。 -
メディアトークンを使用して
Permitの決定を返します：決定承認エンドポイント応答には、Permitの決定とメディアトークンが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 決定承認エンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）は、期限切れにしないでください。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
メディアトークンを使用してストリームを開始： ストリーミングアプリケーションは、メディアトークンを使用してコンテンツを再生します。
プロモーション TempPassを使用してリソースの最大数を消費する consume-maximum-number-of-resources-using-promotional-temppass
前提条件 prerequisites-consume-maximum-number-of-resources-using-promotional-temppass
プロモーション TempPassを使用して最大リソース数を消費する前に、次の前提条件を満たしていることを確認してください。
- ストリーミングアプリケーションは、ユーザーに認証を依頼することなく、最大のリソースを再生するための一時的なアクセスを提供したいと考えています。
- ストリーミングアプリケーションは、承認決定を取得する際に、ユーザーのIDに関する一意の情報を含める必要があります。
- ストリーミングアプリケーションは、ユーザーが選択したリソースを再生する前に、認証決定を取得する必要があります。
- 指定された
serviceProviderとmvpdの間の統合に適用されるプロモーション TempPassの有効な設定が必要です。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていません。
- プロモーション TempPass用に設定されたリソースの最大数は1です。
ワークフロー workflow-consume-maximum-number-of-resources-using-promotional-temppass
次の図に示すように、プロモーション TempPassを使用して最大数のリソースを消費する場合に認証フローを実装するには、指定した手順に従います。
プロモーション TempPassを使用してリソースの最大数を消費します
-
プロモーション TempPassのプロファイルの取得： ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、プロモーション TempPassのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次の詳細については、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 serviceProviderやmvpdなど、すべての_必須_ パラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
プロファイルエンドポイントクエリはオプションで、プロモーション用TempPassを使用して引き続きどれだけのリソースを再生できるかを決定するために使用できます。 -
プロモーション TempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合にプロモーション TempPassの有効な設定が適用されているかどうかを確認します。 -
一時プロファイルに関する情報を返します： プロファイル エンドポイントの応答には、一時プロファイルに関する情報が含まれており、属性
typeが「一時」に設定されています。note important IMPORTANT プロファイル応答で提供される情報について詳しくは、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 プロファイルエンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）は、期限切れにしないでください。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行： プロファイル エンドポイント応答にプロファイルが含まれている場合、ストリーミング アプリケーションは一時的なプロファイル情報を使用して、後続の決定フローを続行します。
-
承認決定の取得： ストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
決定承認エンドポイントでは、プロモーション TempPassを使用する際に AP-TempPass-Identityヘッダーが必要です。 ヘッダーには、コンテンツにアクセスするユーザーのIDに関する一意の情報が含まれます。AP-TempPass-Identityヘッダーについて詳しくは、AP-TempPass-Identityのドキュメントを参照してください。 -
プロモーション TempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合にプロモーション TempPassの有効な設定が適用されているかどうかを確認します。 -
メディアトークンを使用して
Permitの決定を返します：決定承認エンドポイント応答には、Permitの決定とメディアトークンが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 決定承認エンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）は、期限切れにしないでください。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
承認決定の取得： ストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
決定承認エンドポイントでは、プロモーション TempPassを使用する際に AP-TempPass-Identityヘッダーが必要です。 ヘッダーには、コンテンツにアクセスするユーザーのIDに関する一意の情報が含まれます。AP-TempPass-Identityヘッダーについて詳しくは、AP-TempPass-Identityのドキュメントを参照してください。 -
プロモーション TempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合にプロモーション TempPassの有効な設定が適用されているかどうかを確認します。 -
詳細を含む
Denyの決定を返します： 「決定を承認」エンドポイント応答には、Denyの決定と、拡張エラーコード ドキュメントに準拠するエラーペイロードが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 決定承認エンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）は、期限切れにしないでください。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
Handle
Deny決定の詳細： ストリーミングアプリケーションは、応答からのエラー情報を処理し、オプションでユーザーインターフェイスに特定のメッセージを表示するために使用できます。note tip TIP ストリーミングアプリケーションは、リソースの最大数を超えたことをユーザーに通知し、通常のMVPDを使用して基本認証フローを開始するようユーザーにアドバイスして、引き続き視聴できるようにします。
基本またはプロモーションのTempPassの有効期限が切れた場合に、認証の決定を取得します retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
前提条件 prerequisites-retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
基本またはプロモーションのTempPassの有効期限が切れた場合に認証の決定を取得する前に、次の前提条件を満たしていることを確認してください。
- 基本的なTempPass🔗を使用して認証の決定を取得する前の前提条件。
- プロモーション用TempPassを使用して認証の決定を取得する前の前提条件。
- 指定された
serviceProviderとmvpdの間の統合に適用される基本またはプロモーション TempPassの有効な設定が必要です。 - 基本またはプロモーション用に設定された有効期間（TTL）一時的なアクセス期間の制限を超えました。
ワークフロー workflow-retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
次の図に示すように、基本またはプロモーションのTempPassが期限切れになる場合に認証フローを実装するには、指定した手順に従います。
基本またはプロモーションのTempPassの有効期限が切れた場合に認証の決定を取得
-
承認決定の取得： ストリーミングアプリケーションは、「決定の承認」エンドポイントを呼び出して、特定のリソースの承認決定を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 詳しくは、特定のmvpd🔗 API ドキュメントを使用した承認決定の取得を参照してください。 serviceProvider、mvpd、resourcesなど、必須のすべてのパラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
決定承認エンドポイントでは、プロモーション TempPassを使用する際に AP-TempPass-Identityヘッダーが必要です。 ヘッダーには、コンテンツにアクセスするユーザーのIDに関する一意の情報が含まれます。AP-TempPass-Identityヘッダーについて詳しくは、AP-TempPass-Identityのドキュメントを参照してください。 -
基本またはプロモーション用のTempPassを検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合に適用された基本またはプロモーション用のTempPassの有効な設定が存在するかどうかを確認します。 -
詳細を含む
Denyの決定を返します： 「決定を承認」エンドポイント応答には、Denyの決定と、拡張エラーコード ドキュメントに準拠するエラーペイロードが含まれています。note important IMPORTANT 決定応答で提供される情報について詳しくは、特定のmvpd API ドキュメントを使用した承認決定の取得を参照してください。 決定承認エンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 決定承認エンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - 基本TempPassまたはプロモーション TempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていない必要があります。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
Handle
Deny決定の詳細： ストリーミングアプリケーションは、応答からのエラー情報を処理し、オプションでユーザーインターフェイスに特定のメッセージを表示するために使用できます。note tip TIP ストリーミングアプリケーションは、一時的なアクセスの有効期限が切れたことをユーザーに通知し、通常のMVPDを使用して基本的な認証フローを開始するようユーザーにアドバイスして、引き続き視聴できます。
基本TempPassのプロファイルを取得 retrieve-profile-for-basic-temppass
前提条件 prerequisites-retrieve-profile-for-basic-temppass
基本的なTempPassのプロファイルを取得する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションは、一時的なアクセスが期限切れになっていないことを確認するために、一時的なプロファイルを取得します。
- 指定された
serviceProviderとmvpdの間の統合に適用される基本的なTempPassの有効な設定が必要です。 - 基本的なTempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていない必要があります。
ワークフロー workflow-retrieve-profile-information-for-basic-temppass
次の図に示すように、基本的なTempPassのプロファイル取得フローを実装するには、次の手順に従います。
基本的なTempPassのプロファイルを取得
-
基本的なTempPassのプロファイルの取得： ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、基本的なTempPassのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次の詳細については、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 serviceProviderやmvpdなど、すべての_必須_ パラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
-
基本的なTempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合に適用された基本的なTempPassの有効な設定が存在するかどうかを確認します。 -
一時プロファイルに関する情報を返します： プロファイル エンドポイントの応答には、一時プロファイルに関する情報が含まれており、属性
typeが「一時」に設定されています。note important IMPORTANT プロファイル応答で提供される情報について詳しくは、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 プロファイルエンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - 基本的なTempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていない必要があります。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行： プロファイル エンドポイント応答にプロファイルが含まれている場合、ストリーミング アプリケーションは一時的なプロファイル情報を使用して、後続の決定フローを続行します。
プロモーション TempPassのプロファイルの取得 retrieve-profile-for-promotional-temppass
前提条件 prerequisites-retrieve-profile-for-promotional-temppass
プロモーション TempPassのプロファイルを取得する前に、次の前提条件が満たされていることを確認します。
- ストリーミングアプリケーションは、一時的なアクセスが期限切れになっていないことを確認したり、まだ再生できるリソース数を決定したりするために、一時的なプロファイルを取得する必要があります。
- 指定された
serviceProviderとmvpdの間の統合に適用されるプロモーション TempPassの有効な設定が必要です。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）の有効期限が切れていません。
- プロモーション TempPass用に設定されたリソースの最大数が消費されていません。
ワークフロー workflow-retrieve-profile-information-for-promotional-temppass
次の図に示すように、プロモーションテンプパスのプロファイル取得フローを実装するには、次の手順に従います。
プロモーション TempPassのプロファイルを取得
-
プロモーション TempPassのプロファイルの取得： ストリーミングアプリケーションは、プロファイルエンドポイントにリクエストを送信することで、プロモーション TempPassのプロファイル情報を取得するために必要なすべてのデータを収集します。
note important IMPORTANT 次の詳細については、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 serviceProviderやmvpdなど、すべての_必須_ パラメーターAuthorizationやAP-Device-Identifierなど、必須 ヘッダーすべて- すべての_optional_ パラメーターとヘッダー
-
プロモーション TempPassの検証： Adobe Pass サーバーは、指定された
serviceProviderとmvpdの間の統合にプロモーション TempPassの有効な設定が適用されているかどうかを確認します。 -
一時プロファイルに関する情報を返します： プロファイル エンドポイントの応答には、一時プロファイルに関する情報が含まれており、属性
typeが「一時」に設定されています。note important IMPORTANT プロファイル応答で提供される情報について詳しくは、特定のmvpd🔗 API ドキュメントの プロファイルの取得を参照してください。 プロファイルエンドポイントは、基本的な条件が満たされていることを確認するために、リクエストデータを検証します。 - 必須 パラメーターとヘッダーは有効である必要があります。
- 指定された
serviceProviderとmvpdの統合はアクティブである必要があります。
基本的な検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 プロファイルエンドポイントは、リクエストデータを使用して、一時的なアクセス条件が満たされているかどうかを確認します。 - プロモーション TempPass用に設定されたTime-To-Live （TTL）は、期限切れにしないでください。
- プロモーション TempPass用に設定されたリソースの最大数を消費することはできません。
一時的なアクセス検証が失敗した場合は、エラー応答が生成され、拡張エラーコード のドキュメントに準拠する追加情報が提供されます。 -
決定フローで続行： プロファイル エンドポイント応答にプロファイルが含まれている場合、ストリーミング アプリケーションは一時的なプロファイル情報を使用して、後続の決定フローを続行します。