> For the complete documentation index, see [llms.txt](https://catenoid-support.gitbook.io/kollus-vod-console-v2-jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://catenoid-support.gitbook.io/kollus-vod-console-v2-jp/serviceguide/features/security/jwt.md).
# メディア認証
このページにはKollus VODメディア認証について説明します。
> ### **メディア認証**
>
> Kollus VODのメディア認証は顧客が保有したユニークなセキュリティーキーとユーザーのキーを利用して暗号化されたJWT(JSON Web Token)を生成します。動画リンクを介して動画再生を要請する時、ユーザーに発行されたトークンを引き渡され暗号化データーを復号化しその後、今接続したアカウント情報を確認して動画を再生します。
### **メディア認証用語**
* セキュリティーキー(security key)：メディアトークンを生成するため必要な情報です。セキュリティーキーはサービスアカウント毎に基本設定されています。
* ユーザーキー(user key)：会員として認証されたユニークなキーとして、Kollus VODサーバーに要請後、発行された文字列です。各セッション毎に新しいユーザーキーが生成されます。
* メディアコンテンツキー(media content key)：Kollus VODの転送チャンネルに保存されたコンテンツに付与するユニークなキーです。
{% hint style="info" %}
**参考**
Kollus VODコンソールに**サービスアカウント**>**ユーザーキー**でセキュリティーキーとユーザーキーが確認できます。
{% endhint %}
### **JWTとは**
JWT(Json Web Token)はウェブサーバーでユーザー認証(authentication)と権限付与(authorization)のため使用されている技術の一つです。トークン基盤認証方法を使用してJWTトークン(Acess token) を生成し、HTTPヘッダーに含ませて、サーバーがクライアントを識別できるようにします。
JSON ウェブトークンは以下の三つの部分に分かれております。
## aaaaaaa.bbbbbb.cccccc
(Header) (Payload) (Signature)
* ヘッダー(header): どのアルゴリズムで暗号化するか、トークンはどのタイプを使用するかなどのトークン関連情報が含まれています。
* ペイロード(payload): トークンに含める情報が記載されています。主にクライアントの固有ID値や有効期限などが含まれる領域です。key-value形式で構成された一対の情報をクレーム(claim)と呼びます。
* 署名(signature): エンコードされたヘッダーとペイロードを使用して、サーバーが発行したキーで暗号化します。ヘッダーとペイロードは単にエンコードされた値であるため、第3者が復号および改ざんする可能性がありますが、署名はサーバー側で管理される秘密鍵が流出しない限り復号することはできません。したがって、署名はトークンの改ざん有無を確認するために使用されます。
### **JWT 認証仕組み**
JSONウェブトークンはheader, payload, signature三つの部分で構成されています。Kollus VODはpayload部分に特定なデーターを挿入してトークンを生成します。
暗号化アルゴリズムはHMAC SHA256 (HS256)を用いられ、secret keyは秘密キー、payloadにはJASON stringを加えてJWTを生成します。
**生成されたJWTを利用してビデオゲートウェイに要請する方法**
生成したJWTとユーザーキーを以下のような形式URLを生成して呼び出します。
```
https://v.jp.kollus.com/s?jwt=生成された JWT&custom_key=ユーザーキー
```
**認証プロセス**
1. クライアントからログイン要請が入ると、サーバーは検証後クライアントユニークID等の情報をpayloadに盛り込みます。
2. 暗号化に必要な秘密キーを用いられてJWTを発行します。
3. ユーザーはもらったJWTをサーバー送ります。
4. サーバーはトークンのsignatureを秘密キーで復号化後、改ざんと偽装及び有効期間の確認を行われます。
5. 有効なトークンであれば要請を応答します。
**JWT 例**
'catenoid'といったIDを用いたユーザーがメディアコンテンツキー‘vnCVPVyV’を再生する場合。
```
{
"cuid": “catenoid”,
"expt": 1703980800,
"mc": [{
"mckey": “vnCVPVyV“
}]
}
```
* cuid:データベースに保存されたユーザーのID
* expt:動画再生トークン満了時間
* exp: JWTトークン満了時間
* mc:メディアコンテンツキー(media\_content\_key)
{% hint style="info" %}
**参考**
JWTに関する詳細な内容は Developer GuideのJWT文章にも確認できます。
{% endhint %}