はじめに
ポリシーキーは、Playback API を使用して Video Cloud ライブラリから動画およびプレイリスト コンテンツを取得するために使用されます。ポリシーキーはプレーヤーに設定されるため、プレーヤーレベルでコンテンツへのアクセスを制限することが可能です。また、Video Cloud Studio Media モジュールを使用して動画レベルでコンテンツの公開可否を管理することもできます。
Brightcove Player を作成すると、各プレーヤーに対してポリシーキーが自動的に生成されます。このキーは Brightcove アカウントに紐づけられ、Video Cloud に保存されている動画について、どの動画をいつ再生できるかを制御します。たとえば、以下の基準でアクセスを制限するためにポリシーキーが必要となります:
- アカウント
- 利用している場合のドメイン制限
- 利用している場合の地域制限
ポリシーキーに関するより詳しい情報は、概要: ポリシーキー を参照してください。
ポリシーキーの取得
ポリシーキーは自動的に生成および管理されるため、ほとんどの場合は自分で管理したり、リクエストしたりする必要はありません。最も簡単な取得方法は次のとおりです:
- PLAYERS モジュールを開き、新しいプレーヤーを作成するか、プラグインを追加したいプレーヤーを選択します。
- 該当するプレーヤーのリンクを選択してプロパティを開きます。
- 左側のナビゲーションメニューから JSON エディタ を選択します。
- 表示された JSON コード内にポリシーキーが記載されています:
プレーヤーのポリシーキー
すべての Video Cloud アカウントにはデフォルト プレーヤーが含まれているため、アカウントでプレーヤーを作成していなくても、そのデフォルト プレーヤーのポリシーキーを使用できます。
また、Policy API を使用してポリシーキーを作成することもできます。特に 検索対応のポリシーキー を作成する場合には Policy API が必要です。
ポリシーキーの使用
ポリシーキーは Playback API へのリクエストを認証するために使用されます。Playback API は、Web ページやモバイル アプリにおいて、一般的なメディア管理や他システムとの連携に利用されます。詳細については、Playback API のインデックス ページを参照してください。
ポリシーキーと API 認証情報の違い
ポリシーキーは Playback API へのアクセスに使用されるのに対し、API 認証情報はその他の Video Cloud API を使用してコンテンツへアクセスするために利用されます。
ポリシーキー
ポリシーキーは Video Cloud ライブラリのアセットをクライアント側で取得するために使用されます。主な特徴は次のとおりです:
- Playback API を使用して動画/プレイリスト データにアクセス
- 読み取り専用
- Playback API によってサーバー上に動画/プレイリスト データがキャッシュされる
- Policy API を使用して以下を実行:
- ポリシーキーの作成（キーの失効にはカスタマーサポートへの問い合わせが必要）
- ポリシー レベルでのドメイン制限および地理的制限の設定。制限はポリシーキーを使用するプレーヤーによって適用される。
API 認証情報
API 認証情報（クライアント認証情報とも呼ばれます）は、サーバー側アプリケーションが Video Cloud ライブラリのアセットを管理するために使用されます。主な特徴は次のとおりです:
- Video Cloud API を使用してデータにアクセス。利用するアカウントおよび API に対するクライアント認証情報が必要。
- 読み取り、追加、更新、削除
- CMS API では動画/プレイリスト データがサーバー側でキャッシュされない
- Video Cloud の API 認証 UI で API 認証情報を作成および管理
ポリシーキーの管理
ポリシーキーは次の方法で管理できます:
取得
ポリシーキーを更新する方法はありません。Video Cloud アカウント内の既存のプレーヤーからポリシーキーを取得するか、Policy API を使用してポリシーキーを作成します。
失効
ポリシーキーを失効させるには、カスタマーサポートに問い合わせる必要があります。