--- title: "ライセンスクライアント連携" slug: "license-client-bind" updated: 2026-09-17T09:58:18Z published: 2026-09-17T09:58:18Z canonical: "api.ncloud-docs.com/license-client-bind" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # ライセンスクライアント連携 Classic/VPC環境で利用できます。 DRMライセンスをクライアント(プレイヤー)に連携させる例を説明します。 参考 - DRMタイプによってライセンス発行リクエスト情報が異なります。DRMタイプ別ライセンス発行ガイドをご参照ください。 - [ライセンスの発行(Widevine/PlayReady)](/docs/ja/license-request) - [ライセンスの発行(FairPlay)](/docs/ja/fairplay-streaming-license-request) - すべてのライセンスリクエストは、DRMコンテンツを再生する端末機器情報とプレイヤーの実装を通じてリクエストする必要があります。 - One Click Multi DRMサービスは、NAVERクラウドの Video Player Enhancementサービスとの簡単な連携をサポートしています。詳細は、[VPEコンテンツ認証](https://guide.ncloud-docs.com/docs/ja/vpe-example-auth#one-click-multi-drm)をご参照ください。 ## リクエスト リクエスト形式を説明します。 ### リクエストヘッダ One Click Multi DRM APIで共通して使用されるヘッダの詳細は、[One Click Multi DRMのリクエストヘッダ](/docs/ja/one-click-multi-drm-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 #### `X-DRM-TOKEN`ヘッダの作成 One Click Multi DRMサービスから APIでライセンスを発行するには、`X-DRM-TOKEN`ヘッダが必要です。このヘッダは、リクエストユーザーの権限を検証し、選択したサイトのセキュリティポリシーに基づいて DRMライセンスを発行するのに使用されます。ヘッダ値が無効な場合、ライセンスは発行されません。`X-DRM-TOKEN`ヘッダを作成する方法は次の通りです。 1. `siteId`、`contentId`、`drmType`、`responseFormat`、`userId`の JSONデータを入力します。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `siteId` | String | Required | ライセンス発行用サイト ID - [サイトリストの照会](/docs/ja/site-list)を参照 | | `contentId` | String | Required | 再生しようとするコンテンツの固有 ID - 英数字、記号の「-」、「_」を組み合わせて3~100文字以内で入力 - Live/VOD Stationサービスでチャンネルに設定した Multi DRM Content IDを入力 | | `drmType` | String | Required | ライセンスをリクエストする DRMタイプ - `WIDEVINE` \| `PLAYREADY` \| `FAIRPLAY` | | `responseFormat` | String | Required | レスポンスデータの形式 - `ORIGINAL` (デフォルト) \| `JSON` - `ORIGINAL`: リクエストしたバイナリデータでレスポンス。一般的なマルチ DRM連携クライアント(HTML5、Video.js、Shaka)のサポート形式 - `JSON`: ライセンスデータと追加情報(クライアント機器 IDなど)を含む JSONで応答。トークンプロキシまたはクライアント SDKを使用する場合にのみ適用可能 | | `userId` | String | Required | コンテンツを再生しようとするユーザーの固有 ID - サービスサイトで管理するユーザー IDまたは DRMコンテンツを再生するユーザーアカウント | - 入力例 ``` {"siteId":"{サイト ID}","contentId":"{コンテンツ ID}","drmType":"{DRMタイプ}","responseFormat":"{レスポンス形式}","userId":"{ユーザーの固有 ID}"} ``` 2. JSONデータを Base64文字列に変換します。 - 変換例 ``` eyJzaXRlSWQiOiJkcm0tMjAyMzExMTUxNDIzMjYtbkh5TnciLCJjb250ZW50SW...dXNlcklkIjoiZDQxZDhjZDk4ZjAwYjIwNGU5ODAwOTk4ZWNmODQyN2UifQ== ``` 参考 JSONデータを入力する際、余分な空白や改行が含まれないようにご注意ください。 ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` //Widevineライセンスのリクエスト例 'com.widevine.alpha': { src: 'https://uz1urqjj2471.edge.naverncp.com/live/video/ls-20231031105925-*****/live.mpd', //DRM暗号化が適用されたコンテンツ再生経路 licenseUri: 'https://multi-drm.apigw.ntruss.com/api/v1/license', //DRMライセンス発行リクエスト経路 licenseRequestHeader: { 'X-NCP-REGION_CODE': 'KR', 'X-ncp-apigw-timestamp': 1698832564997, 'X-ncp-iam-access-key': 'ft1GKEpjSc**********', 'x-ncp-apigw-signature-v2': 'Z0LjTbqFjWtxlRskM8vDj**********************=', 'X-DRM-TOKEN': 'eyJyZXNwb25zZUZvcm1hdCI6Im9yaWdpbmFsIiwic2l0ZUlkIjoiZHJtLTIwMjMxMTAxMDgyMzE2LWRKREdhIiwiY29udGVudElkIj**************************************************' } //One Click Multi DRMサービス利用のための apigw必須認証と X-DRM-TOKENヘッダ値 }, //PlayReadyライセンスのリクエスト例 'com.microsoft.playready': { src: 'https://uz1urqjj2471.edge.naverncp.com/live/video/ls-20231031105925-*****/live.mpd', //DRM暗号化が適用されたコンテンツ再生経路 licenseUri: 'https://multi-drm.apigw.ntruss.com/api/v1/license', //DRMライセンス発行リクエスト経路 licenseRequestHeader: { 'X-NCP-REGION_CODE': 'KR', 'X-ncp-apigw-timestamp': 1698832564997, 'X-ncp-iam-access-key': 'ft1GKEpjSc**********', 'x-ncp-apigw-signature-v2': 'Z0LjTbqFjWtxlRskM8vDj**********************=', 'X-DRM-TOKEN': 'eyJyZXNwb25zZUZvcm1hdCI6Im9yaWdpbmFsIiwic2l0ZUlkIjoiZHJtLTIwMjMxMTAxMDgyMzE2LWRKREdhIiwiY29udGVudElkIj**************************************************' } //One Click Multi DRMサービス利用のための apigw必須認証と X-DRM-TOKENヘッダ値 }, //FairPlay Streamingライセンスのリクエスト例 'com.apple.fps': { src: 'https://uz1urqjj2471.edge.naverncp.com/live/video/ls-20231031105925-*****/playlist.m3u8', //DRM暗号化が適用されたコンテンツ再生経路 certificateUri: 'https://multi-drm.apigw.ntruss.com/api/v1/license/fairPlay', //DRMライセンス発行に必要な FPS証明書リクエスト経路 certificateRequestHeader: { 'X-NCP-REGION_CODE': 'KR', 'X-ncp-apigw-timestamp': 1698832564997, 'X-ncp-iam-access-key': 'ft1GKEpjSc**********', 'x-ncp-apigw-signature-v2': 'Z0LjTbqFjWtxlRskM8vDj**********************=', 'X-DRM-TOKEN': 'eyJyZXNwb25zZUZvcm1hdCI6Im9yaWdpbmFsIiwic2l0ZUlkIjoiZHJtLTIwMjMxMTAxMDgyMzE2LWRKREdhIiwiY29udGVudElkIj**************************************************' }, //One Click Multi DRMサービス利用のための apigw必須認証と X-DRM-TOKENヘッダ値 licenseUri: 'https://multi-drm.apigw.ntruss.com/api/v1/license', //DRMライセンス発行リクエスト経路 licenseRequestHeader: { 'X-NCP-REGION_CODE': 'KR', 'X-ncp-apigw-timestamp': 1698832564997, 'X-ncp-iam-access-key': 'ft1GKEpjSc**********', 'x-ncp-apigw-signature-v2': 'Z0LjTbqFjWtxlRskM8vDj**********************=', 'X-DRM-TOKEN': 'eyJyZXNwb25zZUZvcm1hdCI6Im9yaWdpbmFsIiwic2l0ZUlkIjoiZHJtLTIwMjMxMTAxMDgyMzE2LWRKREdhIiwiY29udGVudElkIj**************************************************' } //One Click Multi DRMサービス利用のための apigw必須認証と X-DRM-TOKENヘッダ値 } ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスステータスコード One Click Multi DRM APIで共通して使用されるレスポンスステータスコードの詳細は、[One Click Multi DRMのレスポンスステータスコード](/docs/ja/one-click-multi-drm-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンス成功時、`200 OK`とともに DRMライセンスがクライアント(プレイヤー)と連携します。