ドキュメントAdobe PassAdobe Pass 認証

認証の開始 initiate-authorization

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。
NOTE
REST API の実装には、 スロットルメカニズムという制限があります。

REST API エンドポイント clientless-endpoints

< レジストリ_FQDN>:

<SP_FQDN>:

説明 description

認証応答を取得します。

エンドポイント
呼び出
元
入力
パラメーター
HTTP
メソッド
応答
HTTP
Response
<SP_FQDN>/api/v1/authorize
ストリーミングアプリ

プログラマ

サービス
1. リクエスター（必須）
2. deviceId （必須）
3. resource （必須）
4. device_info/X-Device-Info （必須）
5. deviceType
6. deviceUser （非推奨）
7. appId （非推奨）
8。 追加のパラメーター（オプション）
GET
認証の詳細またはエラーの詳細を含む XML または JSON （失敗した場合）。 以下のサンプルを参照してください。
200 – 成功
403 – 成功なし
入力パラメーター
説明
要求者
この操作が有効なプログラマ requestorId です。
deviceId
デバイス ID のバイト。
resource
resourceId （または MRSS フラグメント）を含む文字列は、ユーザーからリクエストされたコンテンツを識別し、MVPD 認証エンドポイントによって認識されます。
device_info/

X-Device-Info
ストリーミングデバイス情報。

注意：これは device_info を URL パラメーターとして渡す場合がありますが、このパラメーターの潜在的なサイズとGET URL の長さに関する制限により、http ヘッダーで X-Device-Info として渡す必要があります。

詳しくは、「デバイスと接続情報の受け渡し を参照してください。
deviceType
デバイスタイプ（Roku、PC など）。

このパラメーターが正しく設定されている場合、ESM では、クライアントレスの使用時に デバイスタイプごとに分類される指標を提供し、Roku、AppleTV、Xbox など、様々なタイプの分析を実行できるようにします。

パス指標の クライアントレスデバイスタイプパラメーターのメリット

注意:device_info はこのパラメーターを置き換えます。
deviceUser
デバイスユーザー識別子。
appId
アプリケーション ID/名前。

注意：このパラメーターは device_info に置き換えられます。
追加のパラメーター
また、この呼び出しには、次のような他の機能を有効にするオプションのパラメーターが含まれる場合もあります。

* generic_data - Promotion TempPass

Example: generic_data=("email":"email@domain.com")
CAUTION
ストリーミングデバイスの IP アドレス

クライアントからサーバーへの実装の場合、ストリーミングデバイスの IP アドレスは、この呼び出しで暗黙的に送信されます。 regcode 呼び出しが、ストリーミングデバイスではなく、プログラマーサービスによって行われるサーバー間実装の場合、ストリーミングデバイスの IP アドレスを渡すには、次のヘッダーが必要です。
code language-none 
X-Forwarded-For : <streaming\_device\_ip>
ここで、<streaming\_device\_ip> はストリーミングデバイスのパブリック IP アドレスです。


例：
code language-none 
POST /reggie/v1/{req_id}/regcode HTTP/1.1
X-Forwarded-For:203.45.101.20

応答のサンプル sample-response

  • ケース 1：成功

    • XML:
    code language-xml 
    &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; standalone=&quot;yes&quot;?>
&lt;authorization>
&lt;expires>1348148289000&lt;/expires>
&lt;mvpd>sampleMvpdId&lt;/mvpd>
&lt;requestor>sampleRequestorId&lt;/requestor>
&lt;resource>sampleResourceId&lt;/resource>
&lt;/authorization>

  • JSON:

    code language-json 
    {
  "mvpd": "sampleMvpdId",
  "resource": "sampleResourceId",
  "requestor": "sampleRequestorId",
  "expires": "1348148289000"
}
IMPORTANT
プロキシ MVPD からの応答の場合、proxyMvpd という名前の追加の要素が含まれる場合があります。

  • ケース 2：認証が拒否される

    code language-json 
    <error>
  <status>403</status>
  <message>User not authorized</message>
  <details>Your subscription package does not include the "ASFAFD" channel.
  Please go to http://www.ca.ble/upgrade in order to upgrade your subscription.</details>
</error>
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b