サーバー連携用の認証情報を作成
Environment ID, Site Key, Access Key, Content ID を検索します。信頼できるバックエンドに 認証情報 を続けてください。
Published のコンテンツがDRM-X Web Player で再生できることを確認してから、これらの認証情報を作成します。バックエンドが権限のある視聴者の再生を要求するために使用します。サイトのログインやパッケージ化用プロファイルの代わりにはなりません。
再生 API クライアントを作成する#
- 環境を選択します。DRM-X Console にサインインし、Published のコンテンツを含む開発環境を選択します。
- クライアントを作成します。Integrations を開き、サイトのバックエンド用に再生 API クライアントを作成します。許可する権限は
license-tokens:createのみです。 - サーバー設定値をコピーします。Site ID、Site Key、1度だけ表示される Access Key を保護されたサーバー設定に保存します。Site ID は環境を識別します。Published の保護ファイルから Content ID をコピーします。
- サンプルを設定してテストします。バックエンド用のキットを使用し、下のプレースホルダー、サンプルのログイン処理、視聴権限チェックを置き換えます。権限のある視聴者は再生でき、権限のない視聴者は拒否されることを確認します。
クイックスタートに必要な4つの値をコピーする#
Console → Integrations で再生 API クライアントを作成し、license-tokens:create だけを許可します。Console → Package content で作成した Published の保護ファイルから Content ID を取得します。
連携に必要な設定値を確認する
DRM-X Console からこれらの値をコピーします。認証情報はサーバーで管理してください。
- Environment ID / Site ID
公開済み動画がある環境を選択します。
- Site Key/クライアントID
再生用 API クライアントの識別子をコピーします。
- Access Key
このシークレットが初めて表示されたときに安全に保存してください。ブラウザーには送信しないでください。
- Content ID
ステータスが Published の動画の Content ID をコピーします。
PHP コード優先設定
return [
'platformApi' => 'https://api6.drm-x.com',
'siteId' => 'your-development-environment-uuid',
'siteKey' => 'drmx_your_environment_scoped_client_id',
'accessKey' => 'paste-your-one-time-access-key',
'applicationId' => 'customer-php-website',
'content' => [
'id' => 'your-published-content-id',
'title' => 'Your protected title',
'type' => 'vod',
],
'licensePolicyTemplate' => 'multi-tier-standard',
'licensePolicy' => null,
'licenseDeliveryMode' => 'direct-token',
];
ダウンロードしたクイックスタートは環境変数なしで実行できます。本番向けに環境変数やシークレット管理サービスから値を渡す例も、コメントで記載されています。
アプリやバックエンドサービスごとに別の API クライアントを使用します。1つの認証情報を更新・失効しても他の統合を中断せずに済みます。
パッケージ化と再生の認証情報を分ける#
| 用途 | 設定値 | 使用場所 |
|---|---|---|
| パッケージ化と公開 | Site ID, Packager Access Key, Packager KMS Token | Packager に保存したプロファイル、または保護された自動化環境 |
| 視聴者に再生を許可 | Site ID, Site Key, Access Key | 認証済みのバックエンドのみ |
| 許可された項目を1つ再生 | 有効期間の短い DRM License Token と Contract v1 | プレーヤーで、返された制限付きルートを使用 |
Packager KMS Token を再生用の Access Key の代わりには使用できません。視聴者の DRM License Token ではコンテンツを公開できません。統合作業には開発環境の認証情報を使用し、本番用は別に管理します。漏えいしたシークレットは更新または失効させ、対象アプリケーションの設定も更新してください。
最初にサインイン済みの Web Player で Published Content ID を確認します。その後、バックエンド用キットに同じ環境と信頼できる Content ID を設定します。
DRM-X 6.0