連携
TVE ダッシュボードの統合 セクションでは、チャネルとMVPD間の統合の設定を表示および管理できます。 要件に応じて新しい統合を作成することもできます。
左側のパネルの「統合」タブには、既存の統合のリストと次の詳細が表示されます。
- 統合が現在アクティブか非アクティブかを示すステータス
- 特定のチャネルをそれぞれのMVPDにリンクする統合
- チャネル IDを持つチャネル名
- MVPDの表示名とMVPD ID
既存の統合のリスト
リストの上にある検索 バーにチャネルまたはMVPDの名前を入力して、統合について詳しく確認します。
統合設定の管理 manage-integration-conf
特定の統合を管理するには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
提供されたリストから統合を選択して、次のセクションで様々な設定を表示および編集します。
エンドポイントの選択 endpoint-selection
このセクションでは、認証、認証、ログアウトフローに使用するMVPDのエンドポイントを、それぞれのドロップダウンメニューから選択できます。
認証、認証、ログアウトフローのエンドポイント
プラットフォーム設定 platform-settings
このセクションでは、すべての プラットフォーム で統合設定を表示および編集できます。 個々のプラットフォームに基づいて、これらの設定を変更できます。 例えば、別のプラットフォームのデフォルト値を維持しながら、Androidで認証TTL期間を調整できます。
Platform設定の各プロパティは、MVPDで設定されたデフォルト値を継承しますが、必要に応じて調整できます。
プラットフォーム設定は、継承チェーンの各レベルの設定を上書きするために使用されます。 チェーン内で使用可能なレベルは、次のようにグループ化されます。
-
すべてをデフォルト: プログラマーの実装に関係なく、特定のプラットフォーム値が定義されていない場合に、すべてのプラットフォームで一般的に適用されるプロパティの値を設定します。
-
デスクトップデバイス: プログラミング方法(JS SDKまたはREST API)に関係なく、すべてのデスクトップおよびラップトップのコンピューターに適用されるプロパティの値を設定します。
-
モバイルデバイス: プログラミングアプローチ(SDKまたはREST API)に関係なく、iOS、Androidなど、すべてのモバイルデバイスに適用されるプロパティの値を設定します。
-
テレビ接続デバイス: プログラミング方式(SDKまたはREST API)に関係なく、tvOS、Roku、FireTVなど、すべてのテレビ接続デバイスに適用されるプロパティの値を設定します。
-
未特定のデバイス:現在のメカニズムでプラットフォームを正確に識別できない、すべてのデバイスに適用されるプロパティの値を設定します。 そのような場合は、MVPDで定義されている最も制限的なルールを適用します。
プラットフォームとそのデバイスのカテゴリ
Select 各プロパティの右側にある
最もよく使用されるビジネスフロー most-used-flows
「プラットフォーム設定」セクションには、様々なビジネスフローで使用される様々なプロパティが用意されています。 実際のプロパティは、特定の統合で選択したMVPDによって異なる場合があります。 以下は、最も使用されるフローです。
すべてのプラットフォームでのAuthN TTLおよびAuthZ TTL
特定の統合のために、すべてのプラットフォームで認証および認証TTLを変更するには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
AuthN TTL値とAuthZ TTL値を変更する統合機能を選択します。
-
「プラットフォーム設定」セクションに移動します。
-
「プラットフォーム設定」の「すべて」タブで「 デフォルト」を選択します。
note NOTE プラットフォームカテゴリまたは特定のプラットフォームの AuthN TTL と AuthZ TTL の期間を変更する場合は、それに応じてプラットフォームを選択します。
すべてのプラットフォームでAuthN TTL AuthZ TTL期間を変更
A.認証TTL プロパティ B.認証TTL プロパティ
-
上向き矢印と下向き矢印を選択して、AuthN TTLおよびAuthZ TTL プロパティの日数、時間、分、秒数を調整します。
すべてのプラットフォームの AuthN TTL および AuthZ TTL の期間は、 レビューおよびプッシュの変更後にのみ更新されます。
プラットフォーム SSOを有効にする
特定の統合およびプラットフォームに対してSSOを有効または無効にするには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
シングルサインオンを有効または無効にする統合を選択します。
-
「プラットフォーム設定」セクションに移動します。
-
プラットフォーム設定でシングルサインオンを有効にする特定のプラットフォームまたはプラットフォームのカテゴリを選択します。
特定のプラットフォームのシングルサインオンを有効にする
A. シングル サインオン プロパティ B. プラットフォーム権限の適用プロパティ
-
「はい」を選択して有効にするか、「シングルサインオンを有効にする」ドロップダウンメニューから「いいえ」を無効にします。
-
「はい」を選択して有効にするか、「プラットフォーム権限を強制」ドロップダウンメニューから「いいえ」を無効にします。
プラットフォーム権限を強制 プロパティは、許可または拒否 プラットフォームによるTV プロバイダーのサブスクリプションへのアクセスをユーザーが許可するかどうかを制御します。
例えば、Enable Single Sign Onと Enforce Platform Permission の両方が有効になっていて、ユーザーがTV プロバイダーのサブスクリプションへのプラットフォームアクセスを拒否することを選択した場合、それぞれのアプリケーション(channel)は、別のアプリケーション(channel)によって取得されたAdobe Pass Authentication トークンを使用できません。
選択したプラットフォームのシングルサインオン プロパティは、のレビューと変更のプッシュ後にのみ有効または無効になります。
ホームベース認証を有効にする
OAuth2 ベースのMVPDのホームベース認証を有効または無効にするには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
ホームベース認証を有効または無効にする統合を選択します。
-
「プラットフォーム設定」セクションに移動します。
-
プラットフォーム設定でホームベース認証を有効にする特定のプラットフォームまたはプラットフォームのカテゴリを選択します。
特定のプラットフォームに対してホームベース認証を有効にする
A.試行HBA プロパティ B. HBA AuthN TTL プロパティ
-
「はい」を選択して有効にし、「試行HBA」ドロップダウンメニューから「いいえ」を無効にします。
特定のMVPDの試行HBA プロパティは、 レビューおよびプッシュの変更後にのみ有効または無効になります。
さらにプロパティを追加 add-more-properties
さらにプロパティを追加すると、特に一般的でないフローの場合は、統合のために特定のプロパティを追加できます。
次のプロパティを追加できます。
- すべてのプラットフォームの場合は、左側の「」タブで「 デフォルト」を選択します。
- プラットフォームのカテゴリについては、左側の「デスクトップデバイス、モバイルデバイス」または「テレビ接続デバイス」タブを選択します。
- 特定のデバイスの場合は、左側の「iOS」、「Android」、「tvOS」、「Roku」または「FireTV」タブを選択します。
以下に、これらのプロパティを追加して有効にできる様々なフローの例を示します。
事前承認済みリソースの数を変更
ほとんどのMVPDは、デフォルトで最大5つのリソース IDを使用するプリフライト認証Z呼び出しをサポートしています。
ただし、MVPDがこの制限を引き上げることに同意する場合は、さらにプロパティを追加に移動し、オプションメニューから「最大リソース数」を選択できます。
Preflight Max Resourcesは、MVPDで合意された制限を指定できる新しい属性を追加します。
プリフライトの最大リソース数プロパティを追加
Preflight Max Resources プロパティは、のレビューと変更のプッシュ後にのみ追加されます。
MVPDの表示名またはロゴ URLを変更
MVPD ピッカーを構築せず、指定された設定に依存するプログラマーアプリケーションの場合は、さらにプロパティを追加に移動し、表示名または ロゴ URL を選択して、オプションメニューから各MVPDに必要な表示名またはロゴ URLを追加できます。
これらのプロパティの値は、デバイスプラットフォームと目的のユーザーエクスペリエンスに応じて、同じMVPDに異なります。
表示名またはロゴ URL プロパティを追加
表示名またはロゴ URL プロパティは、 レビューおよびプッシュの変更後にのみ追加されます。
アプリ(チャネル)の切り替え時に新しい認証フローをリクエスト
ユーザーがアプリを切り替えるときに新しい認証を強制する場合。 その場合、さらにプロパティを追加に移動し、アグリゲーターごとの認証 プロパティを選択できます。
アグリゲーター ごとに 認証を追加すると、各チャネルのシングルサインオンが効果的に解除されます。
アグリゲーターごとの認証プロパティを追加
アグリゲーターごとのAuth プロパティは、 レビューおよびプッシュの変更後にのみ追加されます。
追加したら、はいを選択して、選択した統合に対してアグリゲーター プロパティごとに認証を有効にします。
プロパティを削除 delete-properties
Select 各プロパティの右側にある
プロパティは、のレビューと変更のプッシュ後にのみ、プラットフォーム設定 セクションから削除されます。
ユーザーメタデータ user-metadata
このセクションでは、MVPDで共有されている各ユーザーメタデータパラメーターの設定を更新できます。
「ユーザーのメタデータ」セクションには、次の列が表示されます。
キー: APIで値を抽出するために使用する実際のユーザーメタデータパラメーターを表します。
説明:各ユーザーメタデータパラメーターの簡単な説明を提供します。
暗号化:この列では、ドロップダウンメニューからそれぞれ はい または いいえ を選択して、APIのパラメーターを有効または無効にできます。 Yesを選択すると、パラメーター値がAPIで暗号化されます。 暗号化は、ユーザーメタデータ スコープで定義された証明書を使用して実行されます。
利用可能な証明書について詳しくは、 プログラマーおよび チャネル の節を参照してください。
有効:この列では、ドロップダウンメニューからそれぞれ はい または いいえ を選択して、APIのパラメーターを有効または無効にできます。
ユーザーメタデータに使用できるパラメーター
新しい統合を作成 create-new-integration
現在の設定で新しいMVPDとの新しい統合を作成するには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
「統合」セクションの右上にある「新しい統合を作成」を選択します。
新しい統合を作成
次のセクションが表示されます。
チャネルとMVPDを選択
「チャネルを選択」ドロップダウンメニューから「チャネル」を選択して、新しい統合を追加します。 チャネルを選択したら、MVPDを選択 ドロップダウンメニューから必要な MVPD を選択し、選択したチャネルと統合します。
チャネルとMVPDを選択
エンドポイントを選択
必要なMVPDを選択した後、Select endpoint セクションには、特定のMVPD用に設定されたデフォルトのエンドポイントが事前に入力されます。
note important IMPORTANT MVPDで特に指定されていない限り、フローのデフォルトエンドポイントを変更しないでください。
エンドポイントを選択
追加情報
このセクションには、チャネルとMVPDの選択セクションで選択したMVPDに設定する必要がある様々なプロパティが含まれています。
note NOTE 実際のプロパティは、チャンネルを選択およびMVPD セクションで選択したMVPDによって異なる場合があります。 例えば、次の画像のMVPD ログインページで、AuthN TTLまたはPartner ID (Channel ID)を共同ブランディング用に編集できます。
追加情報を編集
「新しい統合を作成」セクションの右上にある「統合を保存」を選択します。
新しい統合は、 レビューして変更をプッシュした後にのみ作成されます。
連携を無効にする disable-integration
統合を無効にするには、次の手順に従います。
-
左側のパネルで「統合」タブを選択します。
-
無効にする統合を選択します。
-
選択した統合の右上にある切り替えスイッチを無効にします。
統合を無効にする
統合は、 レビューして変更をプッシュした後にのみ無効になります。
統合を無効にすると、エンドユーザーは特定のMVPDを使用して認証または認証できなくなります。