ドキュメントAdobe PassAdobe Pass 認証

Amazon FireOS Native Client API リファレンス amazon-fireos-native-client-api-reference

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
このページのコンテンツは情報提供のみを目的としています。 この API を使用するには、Adobeから現在のライセンスが必要です。 無許可の使用は許可されていません。

概要 intro

このドキュメントでは、Adobe Pass Authentication でサポートされる、Adobe Pass認証用のAmazon FireOS SDK によって公開されるメソッドとコールバックについて詳しく説明します。 ここで説明するメソッドとコールバック関数は、AccessEnabler.h および EntitlementDelegate.h ヘッダーファイルで定義されます。

最新のAmazon FireOS AccessEnabler SDK については、https://tve.zendesk.com/hc/en-us/articles/115005561623-fire-TV-Native-AccessEnabler-Library を参照してください。

NOTE
Adobe Pass認証チームは、Adobe Pass認証 パブリック API のみを使用することをお勧めします。
  • パブリック API は、サポートされているすべてのクライアントタイプで利用可能 かつ完全にテスト済み です。 すべての公開機能で、各クライアントタイプに、関連するメソッドの対応するバージョンがあることを確認します。
  • 公開 API は、後方互換性をサポートし、パートナー統合が損なわれないようにするために、できるだけ安定している必要があります。 ただし、非 公開 API の場合、当社は将来の時点で署名を変更する権利を留保します。 現在のパブリック Adobe Pass認証 API 呼び出しの組み合わせではサポートできない特定のフローが発生した場合は、お知らせいただくのが最善の方法です。 お客様のニーズを考慮して、公開 API を変更し、今後も安定したソリューションを提供できます。

Amazon FireOS SDK API api

Factory.getInstance getInstance

説明： Access Enabler オブジェクトをインスタンス化します。 アプリケーション・インスタンスごとに 1 つの Access Enabler インスタンスが必要です。

API 呼び出し：コンストラクター
public static AccessEnabler getInstance(Context appContext, String softwareStatement, String redirectUrl)<br> throws AccessEnablerException
public static AccessEnabler getInstance(Context appContext, String env_url, String softwareStatement, String redirectUrl) throws AccessEnablerException

提供： v3.0 以降

パラメーター：

  • appContext:Amazon Fire OS アプリケーションコンテキスト。
  • softwareStatement
  • redirectUrl :FireOS の場合、パラメーター値は無視され、デフォルトに設定されます：adobepass://android.app
  • env_url: Adobeのステージング環境を使用してテストする場合は、env_url を「sp.auth-staging.adobe.com」に設定できます

非推奨：

    public static AccessEnabler getInstance(Context appContext)
        throws AccessEnablerException

setRequestor setRequestor

説明： プログラマーの ID を確立します。 各プログラマーには、Adobe Pass Authentication System のAdobeに登録すると、一意の ID が割り当てられます。 この設定は、アプリケーションのライフサイクル中に 1 回だけ実行する必要があります。

サーバー応答には、MVPD のリストと、プログラマーの ID に添付されたいくつかの設定情報が含まれています。 サーバ応答は、アクセス イネーブラ コードによって内部的に使用されます。 setRequestorComplete （） コールバックを使用すると、操作のステータス（SUCCESS/FAIL）のみがアプリケーションに表示されます。

urls パラメーターを使用しない場合、生成されるネットワーク呼び出しは、デフォルトのサービスプロバイダー URL （Adobeリリース/実稼動環境）をターゲットにします。

urls パラメーターに値を指定すると、結果として得られるネットワーク呼び出しは、urls パラメーターで指定されるすべての URL をターゲットにします。 すべての設定要求が、別々のスレッドで同時にトリガーされます。 MVPD のリストをコンパイルする場合は、最初のレスポンダーが優先されます。 Access Enabler は、リスト内の各 MVPD に対して、関連するサービス プロバイダの URL を記憶します。 以降のすべての使用権限リクエストは、設定段階でターゲット MVPD とペアになったサービスプロバイダーに関連付けられた URL に送られます。

API 呼び出し：リクエスター設定
public void setRequestor(String requestorId)

提供： v3.0 以降

API 呼び出し：リクエスター設定
public void setRequestor(String requestorId, ArrayList<String> urls)

提供： v3.0 以降

パラメーター：

  • requestorID：プログラマーに関連付けられた一意の ID。 Adobe Pass Authentication サービスに初めて登録したときに、Adobeによって割り当てられた一意の ID をサイトに渡します。
  • urls：オプションのパラメーターです。デフォルトでは、Adobe サービスプロバイダーが使用されます（http://sp.auth.adobe.com/）。 この配列を使用すると、Adobeが提供する認証サービスと承認サービスのエンドポイントを指定できます（デバッグ目的で別のインスタンスを使用することもできます）。 これを使用して、複数のAdobe Pass Authentication サービスプロバイダーインスタンスを指定できます。 その場合、MVPD リストはすべてのサービスプロバイダーのエンドポイントで構成されます。 各 MVPD は、最速のサービスプロバイダー、つまり、最初に応答し、その MVPD をサポートするプロバイダーに関連付けられます。

コールバックがトリガーされました： setRequestorComplete()

非推奨：

    public void setRequestor(String requestorId, String signedRequestorId)

    public void setRequestor(String requestorId, String signedRequestorId, ArrayList<String> urls)

setRequestorComplete setRequestorComplete

説明： 構成フェーズが完了したことをアプリケーションに通知する Access Enabler によってトリガーされるコールバック。 これは、アプリが使用権限リクエストの発行を開始できることを示すシグナルです。 設定フェーズが完了するまで、アプリケーションが使用権限リクエストを発行することはできません。

コールバック：リクエスターの設定完了
public void setRequestorComplete(int status)

提供： v1.0 以降

パラメーター：

  • ステータス：次のいずれかの値を取ることができます。

    • AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS – 設定
      フェーズは正常に完了しました
    • AccessEnabler.ACCESS_ENABLER_STATUS_ERROR – 設定
      フェーズに失敗しました

Trigger by: setRequestor()

setOptions fire_setOption

説明： グローバル SDK オプションを設定します。 Map&lt;String, String> を引数として受け入れます。 マップからの値は、SDK が行うすべてのネットワーク呼び出しと共にサーバーに渡されます。

これらの値は、現在のフロー（認証/承認）とは無関係にサーバーに渡されます。 値を変更する場合は、このメソッドをいつでも呼び出すことができます。

API 呼び出し：setOptions
public void setOptions(HashMap<String,String> options)

提供： v3.0 以降

パラメーター：

  • options：グローバル SDK オプションを含む Map&lt;String, String>。 現在、次のオプションを使用できます。

    • applicationProfile – この値に基づいてサーバーを設定するために使用できます。
    • ap_vi -Experience CloudID サービス。 この値は、後で高度な分析レポートに使用できます。
    • device_info - デバイス情報クックブックの受け渡し に記載されているデバイス情報

checkAuthentication checkAuthN

説明： 認証ステータスを確認します。 これを行うには、ローカルトークンのストレージスペースで有効な認証トークンを検索します。 このメソッドを呼び出しても、ネットワーク呼び出しは実行されません。 アプリケーションがユーザーの認証ステータスをクエリし、それに応じて UI を更新するために使用されます（例：ログイン/ログアウト UI を更新）。 認証状態は、setAuthenticationStatus （） コールバックを介してアプリケーションに伝えられます。

MVPD が「Authentication per Requestor」機能をサポートしている場合、1 つのデバイスに複数の認証トークンを格納できます。

API 呼び出し：認証ステータスの確認
public void checkAuthentication()

提供： v1.0 以降

パラメーター： なし

コールバックがトリガーされました： setAuthenticationStatus()

getAuthentication getAuthN

説明： 完全認証ワークフローを開始します。 まず、認証ステータスを確認します。 まだ認証されていない場合は、認証フロー state-machine が起動します。

  • 最後の認証試行が成功した場合、MVPD 選択フェーズはスキップされ、WebView コントロールによって MVPD のログイン ページがユーザーに表示されます。
  • 最後の認証の試行が失敗した場合、またはユーザーが明示的にログアウトした場合、displayProviderDialog （） コールバックがトリガーされます。 アプリケーションは、このコールバックを使用して MVPD 選択 UI を表示します。 また、setSelectedProvider （）メソッドを使用して Access Enabler ライブラリにユーザーの MVPD 選択を通知することにより、認証フローを再開する必要があります。

MVPD が「要求者ごとの認証」機能をサポートしている場合、1 台のデバイスに複数の認証トークンを格納できます（プログラマごとに 1 つ）。

最後に、setAuthenticationStatus （） コールバックを介して認証ステータスがアプリケーションに伝えられます。

API 呼び出し：認証フローを開始します
public void getAuthentication()

提供： v1.0 以降

API 呼び出し：認証フローを開始します
public void getAuthentication(boolean forceAuthN, Map<String, Object> genericData)

提供： v1.0 以降

パラメーター：

  • forceAuthn：ユーザーが既に認証されているかどうかに関係なく、認証フローを開始する必要があるかどうかを指定するフラグ。
  • data：有料テレビパスサービスに送信されるキーと値のペアで構成されるマップ。 Adobeはこのデータを使用して、SDK を変更せずに将来の機能を有効にできます。

コールバックがトリガーされました： setAuthenticationStatus(), displayProviderDialog(), sendTrackingData()

displayProviderDialog displayProviderDialog

説明 アクセスイネーブラによってトリガーされるコールバック。これにより、ユーザーが目的の MVPD を選択できるように、適切な UI 要素をインスタンス化する必要があることがアプリケーションに通知されます。 コールバックは、MVPD オブジェクトのリストに、選択 UI パネルを正しく構築するのに役立つ追加情報（MVPD のロゴを指す URL、わかりやすい表示名など）を提供します。

ユーザーが目的の MVPD を選択したら、上位レイヤーのアプリケーションは setSelectedProvider （）を呼び出して ユーザーの選択に対応する MVPD の ID を渡すことによって、認証フローを再開する必要があります。

Callback:MVPD 選択 UI を表示する
public void displayProviderDialog(ArrayList<Mvpd> mvpds)

提供： v1.0 以降

パラメーター:

  • mvpds: MVPD 選択 UI 要素を構築するためにアプリケーションが使用できる、MVPD 関連の情報を保持する MVPD オブジェクトのリスト。

Trigger by: getAuthentication(), getAuthorization()

setSelectedProvider setSelectedProvider

説明： このメソッドは、ユーザーの MVPD 選択をアクセス イネーブラに通知するためにアプリケーションによって呼び出されます。 null をパラメーターとして渡すと、アクセス イネーブラによって現在の MVPD が null 値にリセットされます。

API 呼び出し：現在選択されているプロバイダーを設定する
public void setSelectedProvider(String mvpdId)

提供： ​v 1.0 以降

パラメーター： なし

コールバックがトリガーされました： setAuthenticationStatus(), sendTrackingData()

説明： Android SDK 上のアクセスイネーブラによってトリガーされたコールバック。 Amazon FireOS SDK では無視する必要があります。

Callback:MVPD ログインページを表示する
public void navigateToUrl(String url)

提供： v1.0 以降

パラメーター：

  • url:MVPD のログインページを指す URL

Trigger by: getAuthentication(), setSelectedProvider()

getAuthenticationToken getAuthNToken

説明： バックエンドサーバーに認証トークンをリクエストして、認証フローを完了します。

API 呼び出し：認証トークンの取得
public void getAuthenticationToken(String cookies)

提供： v1.0 以降

パラメーター：

  • cookie：ターゲットドメインに設定される cookie （参照実装については、SDK のデモアプリケーションを参照してください）。

コールバックがトリガーされました： setAuthenticationStatus(), sendTrackingData()

setAuthenticationStatus setAuthNStatus

説明： 認証のステータスをアプリケーションに通知するアクセスイネーブラによってトリガーされたコールバック。 ユーザーの操作の結果として、または他の予期しないシナリオ（ネットワーク接続の問題など）が原因で、認証フローが失敗する可能性がある場所は多くあります。 このコールバックは、アプリケーションに認証の成功/失敗ステータスを通知すると同時に、必要に応じて失敗の理由に関する追加情報も提供します。

このコールバックは、ログアウトフローが完了したときにもシグナルを送信します。

Callback：認証フローのステータスをレポート
public void setAuthenticationStatus(int status, String errorCode)

提供： v1.0 以降

パラメーター：

  • ステータス：次のいずれかの値を取ることができます。

    • AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS – 認証フローが正常に完了しました
    • AccessEnabler.ACCESS_ENABLER_STATUS_ERROR – 認証フローが失敗しました
    • AccessEnabler.ACCESS_ENABLER_STATUS_LOGOUT - ログアウト

  • コード：提示されたステータスの理由。 status が AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS の場合、code は空の文字列です（つまり、AccessEnabler.USER_AUTHENTICATED 定数によって定義されます）。 認証されていない場合、このパラメーターは次のいずれかの値を取ります。

    • AccessEnabler.USER_NOT_AUTHENTICATED_ERROR - ユーザーが認証されていません。 ローカルトークンキャッシュに有効な認証トークンがない場合の checkAuthentication （） メソッド呼び出しに応答して。
    • AccessEnabler.PROVIDER_NOT_SELECTED_ERROR - AccessEnabler は、上位層アプリケーションが setSelectedProvider() に渡された null 後に認証ステート マシンをリセットして、認証フローを中止します。 ユーザーが認証フローをキャンセルした（つまり、「戻る」ボタンを押した）と考えられます。
    • AccessEnabler.GENERIC_AUTHENTICATION_ERROR - ネットワークが利用できないか、ユーザーが認証フローを明示的に取り消したなどの理由により、認証フローが失敗しました。
    • AccessEnabler.LOGOUT - ログアウトアクションにより、ユーザーが認証されていません。

Trigger by: checkAuthentication(), getAuthentication(), checkAuthorization()

checkPreauthorizedResources checkPreauth

説明： このメソッドは、保護された特定のリソースを表示する権限がユーザーに既にあるかどうかを判断するためにアプリケーションで使用されます。 このメソッドの主な目的は、UI の修飾に使用する情報を取得することです（例えば、ロックアイコンとロック解除アイコンでアクセスステータスを示すなど）。

API 呼び出し：現在選択されているプロバイダーを設定する
public void checkPreauthorizedResources(ArrayList<String> resources)

提供： v1.0 以降

<Parameters: resources パラメーターは、承認をチェックする必要があるリソースの配列です。 リストの各要素は、リソース ID を表す文字列である必要があります。 リソース ID には、getAuthorization() 呼び出しのリソース ID と同じ制限が適用されます。つまり、プログラマと MVPD またはメディア RSS フラグメントとの間で確立された合意値である必要があります。

コールバックがトリガーされました： preauthorizedResources()

preauthorizedResources preauthResources

説明： checkPreauthorizedResources （）によってトリガーされるコールバック。 ユーザーが既に表示を許可されているリソースのリストを提供します。

API 呼び出し：現在選択されているプロバイダーを設定する
public void checkPreauthorizedResources(ArrayList<String> resources)

提供： ​v 1.0 以降

Parameters: resources パラメーターは、ユーザーが既に表示を許可されているリソースの配列です。

Trigger by: checkPreauthorizedResources()

checkAuthorization checkAuthZ

説明： このメソッドは、承認ステータスを確認するためにアプリケーションで使用されます。 まず、認証ステータスを最初に確認します。 認証されていない場合、setTokenRequestFailed （） コールバックがトリガーされ、メソッドが終了します。 認証されたユーザーは、認証フローもトリガーします。 getAuthorization （） メソッドの詳細を参照してください。

API 呼び出し：認証ステータスの確認
public void checkAuthorization(String resourceId)

提供： v1.0 以降

API 呼び出し：認証ステータスの確認
public void checkAuthorization(String resourceId, Map<String, Object> genericData)

提供： v1.0 以降

パラメーター：

  • resourceId：ユーザーが認証をリクエストするリソースの ID。
  • data：有料テレビパスサービスに送信されるキーと値のペアで構成されるマップ。 Adobeはこのデータを使用して、SDK を変更せずに将来の機能を有効にできます。

コールバックがトリガーされました： tokenRequestFailed(), setToken(), sendTrackingData(), setAuthenticationStatus()

getAuthorization getAuthZ

説明： このメソッドは、承認フローを開始するためにアプリケーションによって使用されます。 ユーザーがまだ認証されていない場合は、認証フローも開始します。 ユーザーが認証されると、アクセス イネーブラは認証トークンの要求（有効な認証トークンがローカル トークン キャッシュに存在しない場合）と短期間有効なメディア トークンの要求を発行します。 短いメディアトークンが取得されると、認証フローは完了と見なされます。 setToken （） コールバックがトリガーされ、短いメディアトークンがパラメーターとしてアプリケーションに配信されます。 何らかの理由で認証が失敗した場合、tokenRequestFailed （） コールバックがトリガーされ、エラーコードと詳細が提供されます。

API 呼び出し：認証フローの開始
public void getAuthorization(String resourceId)

提供： v1.0 以降

API 呼び出し：認証フローの開始
public void getAuthorization(String resourceId, Map<String, Object> genericData)

提供： v1.0 以降

パラメーター：

  • resourceId：ユーザーが認証をリクエストするリソースの ID。
  • data：有料テレビパスサービスに送信されるキーと値のペアで構成されるマップ。 Adobeはこのデータを使用して、SDK を変更せずに将来の機能を有効にできます。

コールバックがトリガーされました： tokenRequestFailed(), setToken(), sendTrackingData()

追加のコールバックがトリガーされました
このメソッドは、次のコールバックもトリガーできます（認証フローも開始されている場合）: setAuthenticationStatus （）, displayProviderDialog （）

注意：可能な限り、getAuthorization （）の代わりに checkAuthorization （）を使用してください。 getAuthorization （） メソッドは完全な認証フローを開始します（ユーザーが認証されていない場合）。これにより、プログラマ側の実装が複雑になる可能性があります。

setToken setToken

説明： 認証フローが正常に完了したことをアプリケーションに通知する、アクセス イネーブラによってトリガーされたコールバック。 短時間のみ有効なメディアトークンもパラメーターとして配信されます。

コールバック：認証フローが正常に完了しました
public void setToken(String token, String resourceId)

提供： ​v 1.0 以降

パラメーター：

  • token：短時間のみ有効なメディアトークン
  • resourceId：認証が取得されたリソース

Trigger by: checkAuthorization(), getAuthorization()

tokenRequestFailed tokenRequestFailed

説明： 認証フローが失敗したことを上位層アプリケーションに通知するアクセス イネーブラによってトリガーされたコールバック。

コールバック：認証フローが失敗しました
public void tokenRequestFailed(String resourceId, <br> String errorCode, String errorDescription)

提供： v1.0 以降

パラメーター：

  • resourceId：認証が取得されたリソース
  • errorCode：失敗シナリオに関連付けられたエラーコード。 使用可能な値：
    • AccessEnabler.USER_NOT_AUTHORIZED_ERROR – 指定されたリソースをユーザーが承認できませんでした
  • errorDescription：失敗シナリオに関する追加の詳細。 何らかの理由でこの記述文字列が使用できない場合、Adobe Pass認証は空の文字列 >（"） を送信します。 この文字列は、MVPD がカスタム エラーメッセージやセールス関連のメッセージを渡すために使用できます。 例えば、サブスクライバーがリソースの認証を拒否された場合、MVPD は次のようなメッセージを送信する場合があります。「現在、パッケージ内のこのチャネルにはアクセスできません。 パッケージをアップグレードする場合は、ここをクリックしてください。」です。 メッセージは、このコールバックを通じてAdobe Pass認証によってプログラマーに渡され、プログラマーは表示または無視のオプションを持ちます。 Adobe Pass認証では、このパラメーターを使用して、エラーを引き起こした可能性のある条件の通知を提供することもできます。 例えば、「プロバイダーの認証サービスと通信する際にネットワークエラーが発生しました」などです。

Trigger by: checkAuthorization(), getAuthorization()

ログアウト logout

説明： このメソッドを使用して、ログアウトフローを開始します。 ログアウトは、ユーザーがAdobe Pass認証サーバーと MVPD の両方のサーバーからログアウトする必要があるために、一連の HTTP リダイレクト操作の結果です。

API 呼び出し：ログアウトフローの開始
public void logout()

提供： v1.0 以降

パラメーター： なし

コールバックがトリガーされました： なし

getSelectedProvider getSelectedProvider

説明： このメソッドを使用して、現在選択されているプロバイダを確認します。

API 呼び出し：現在選択されている MVPD を特定します
public void getSelectedProvider()

提供： v1.0 以降

パラメーター： なし

コールバックがトリガーされました： selectedProvider()

selectedProvider selectedProvider

説明： 現在選択されている MVPD に関する情報をアプリケーションに提供するアクセス イネーブラによってトリガーされたコールバック。

Callback：現在選択されている MVPD に関する情報
public void selectedProvider(Mvpd mvpd)

提供： v1.0 以降

パラメーター：

  • mvpd：現在選択されている MVPD に関する情報を含むオブジェクト

Trigger by: getSelectedProvider()

getMetadata getMetadata

説明： このメソッドを使用して、Access Enabler ライブラリによってメタデータとして公開された情報を取得します。 アプリケーションは、複合 MetadataKey オブジェクトを提供することでこの情報にアクセスできます。

API 呼び出し：AccessEnabler でメタデータをクエリする
public void getMetadata(MetadataKey metadataKey)

提供： v1.0 以降

プログラマーが使用できるメタデータには次の 2 種類があります。

  • 静的メタデータ（認証トークン TTL、認証トークン TTL およびデバイス ID）
  • ユーザーメタデータ（ユーザー ID や郵便番号など、ユーザー固有の情報。認証フローや承認フローの実行中に MVPD からユーザーのデバイスに渡される）

パラメーター：

  • metadataKey：キーと args 変数をカプセル化したデータ構造。意味は次のとおりです。

    • キーが METADATA_KEY_TTL_AUTHN の場合、クエリが実行されて認証トークンの有効期限が取得されます。

    • キーが METADATA_KEY_TTL_AUTHZ で、引数に name = METADATA_ARG_RESOURCE_ID、value = [resource_id] の SerializableNameValuePair オブジェクトが含まれる場合、クエリは、指定されたリソースに関連付けられた認証トークンの有効期限を取得するために実行されます。

    • キーが METADATA_KEY_DEVICE_ID の場合、現在のデバイス ID を取得するためにクエリが実行されます。 この機能はデフォルトで無効になっており、プログラマーはイネーブルメントと料金についてAdobeに問い合わせる必要があります。

    • キーが METADATA_KEY_USER_META で、引数に name = METADATA_KEY_USER_META、value = [metadata_name] の SerializableNameValuePair オブジェクトが含まれる場合、ユーザーメタデータに対するクエリが実行されます。 使用可能なユーザーメタデータタイプの現在のリスト：

      • zip – 郵便番号
      • householdID – 世帯の識別子。 MVPD がサブアカウントをサポートしていない場合、これは userID と同じです。
      • maxRating - ユーザーの保護者による制限の上限
      • userID - ユーザー ID。 MVPD がサブ勘定科目をサポートし、ユーザーがメイン勘定科目でない場合、
      • channelID - ユーザーが表示できるチャネルのリスト

プログラマーが使用できる実際のユーザーメタデータは、MVPD が提供する内容によって異なります。 このリストは、新しいメタデータが利用可能になり、Adobe Pass認証システムに追加されると、さらに拡張されます。

コールバックがトリガーされました： setMetadataStatus()

詳細情報： ​ ユーザーメタデータ

setMetadataStatus setMetadaStatus

説明： getMetadata （） 呼び出しを介して要求されたメタデータを配信するアクセス イネーブラによってトリガーされたコールバック。

コールバック：メタデータ取得リクエストの結果
public void setMetadataStatus(MetadataKey key, MetadataStatus result)

提供： v1.0 以降

パラメーター：

  • key：メタデータ値がリクエストされるキーと関連パラメーターを含む MetadataKey オブジェクト（参照実装についてはデモアプリケーションを参照してください）。

  • result：リクエストされたメタデータを含む複合オブジェクト。 オブジェクトには次のフィールドがあります。

    • simpleResult：認証 TTL、認証 TTL、デバイス ID のいずれかに対してリクエストが行われたときのメタデータ値を表す文字列。 ユーザーメタデータに対してリクエストが行われた場合、この値は null です。

    • userMetadataResult:JSON ユーザーメタデータペイロードの Java 表現を含むオブジェクト。 例：

      code language-json 
      {
"street": "Main Avenue",
"buildings": ["150", "320"]
}

      は、次のように Java に翻訳されます。

      code language-java 
      Map("street" -> "Main Avenue", "buildings" -> List("150", "320")))

      ユーザーメタデータオブジェクトの実際の構造は、次のようになります。

      code language-json 
      {
    updated: 1334243471,
    encrypted: ["encryptedProp"],
    data: {
        zip: ["12345", "34567"],
        maxRating: {
            "MPAA": "PG-13",
            "VCHIP": "TV-Y",
            "URL": "http://exam.pl/e/manage/ratings"
        },
        householdID: "3456",
        userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
        channelID: ["channel-1", "channel-2"]
    }
}

単純なメタデータ（認証 TTL、承認 TTL またはデバイス ID）に対してリクエストが行われた場合、この値は null になります。

  • encrypted：取得したメタデータを暗号化するかどうかを指定するブール値。 このパラメーターは、ユーザーメタデータリクエストでのみ重要で、常に暗号化されずに受信される静的メタデータ（認証 TTL など）には意味を持ちません。 このパラメーターを True に設定した場合、許可リスト登録済みの秘密鍵（setRequestor 呼び出しのリクエスター ID の署名に使用されるのと同じ秘密鍵）を使用して RSA 復号化を実行し、暗号化されていないユーザーメタデータ値を取得するかどうかは、プログラマー次第です。

Trigger by: getMetadata()

詳細情報： ​ ユーザーメタデータ

getVersion getVersion

説明： このメソッドを使用して、AccessEnabler の現在のバージョンを取得します

API 呼び出し：AccessEnabler バージョンの取得
public static String getVersion()

追跡イベント tracking

Access Enabler は、エンタイトルメント フローに必ずしも関連しない追加のコールバックをトリガーします。 sendTrackingData （） という名前のイベントトラッキングコールバック関数の実装はオプションですが、アプリケーションは特定のイベントを追跡し、認証/承認の成功/失敗の試行回数などの統計をコンパイルすることができます。 sendTrackingData （） コールバックの仕様を以下に示します。

sendTrackingData sendTrackingData

説明： アクセス イネーブラによってトリガーされたコールバックは、認証/承認フローの完了/失敗など、さまざまなイベントの発生をアプリケーションに通知します。 デバイスの種類、Access Enabler クライアントの種類、およびオペレーティング システムも sendTrackingData （）によって報告されます。

WARNING
デバイスタイプとオペレーティングシステムは、公開 Java ライブラリ（http://java.net/projects/user-agent-utils）とユーザーエージェント文字列を使用して取得されます。 この情報は、操作指標をデバイスカテゴリに分類する粗い方法としてのみ提供されますが、Adobeは誤った結果に対して責任を負うことはありません。 それに応じて新しい機能を使用してください。

  • デバイスタイプに指定可能な値：

    • computer
    • tablet
    • mobile
    • gameconsole
    • unknown

  • Access Enabler クライアント・タイプに指定可能な値：

    • flash
    • html5
    • ios
    • tvos
    • android
    • firetv
コールバック：トラッキングイベント
public void sendTrackingData(Event event, ArrayList<String> data)

提供： v1.0 以降

パラメーター：

  • event：トラッキングされるイベント。 次の 3 つのトラッキングイベントタイプが考えられます。

    • authorizationDetection: 認証トークンリクエストが返されるたびに発生します（イベントタイプは EVENT_AUTHZ_DETECTION）。
    • authenticationDetection: 認証チェックが発生するたびに（イベントタイプが EVENT_AUTHN_DETECTION）
    • mvpdSelection: ユーザーが MVPD 選択フォームで MVPD を選択したとき（イベントタイプは EVENT_MVPD_SELECTION）

  • data：レポートされたイベントに関連付けられている追加データ。 このデータは、値のリストの形式で表示されます。

data 配列の値を解釈する手順を次に示します。

  • イベントタイプが EVENT_AUTHN_DETECTIONの場合：

    • 0 - トークンリクエストが成功したかどうか（true/false）と、上記が true の場合：
    • 1 - MVPD ID 文字列
    • 2 - GUID （md5 ハッシュ化）
    • 3 - トークンは既にキャッシュにあります（true/false）
    • 4 - デバイスタイプ
    • 5:Access Enabler クライアント・タイプ
    • 6 - オペレーティングシステムの種類

  • イベントタイプ EVENT_AUTHZ_DETECTION の場合

    • 0 - トークンリクエストが成功したかどうか（true/false）と成功した場合は次の値：
    • 1 - MVPD ID
    • 2 - GUID （md5 ハッシュ化）
    • 3 - トークンは既にキャッシュにあります（true/false）
    • 4 - エラー
    • 5 – 詳細
    • 6 - デバイスタイプ
    • 7:Access Enabler クライアント・タイプ
    • 8 - オペレーティングシステムの種類

  • イベントタイプ EVENT_MVPD_SELECTION の場合

    • 0 – 現在選択されている MVPD の ID
    • 1 - デバイスタイプ
    • 2:Access Enabler クライアント・タイプ
    • 3 - オペレーティングシステムの種類

Trigger by: checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider()

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b