メインコンテンツまでスキップ

認証と主要キー

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

Kollus VOD システムの連携時に、API 認証、コンテンツ識別、再生権限確認のためにさまざまな固有識別キーが使用されます。 各キーの用途と確認方法を把握した上で、連携を進めてください。

キー (Key/ID)主な用途Kollus VOD コンソール確認方法
API アクセストークンAPI 呼び出し時の認証ヘッダーに使用[設定] > [API]
セキュリティーキーJWT 再生権限認証（署名および検証）[設定] > [ユーザーキー]
ユーザーキーセキュリティーキーを暗号化した値（JWT 生成時に必須）[設定] > [ユーザーキー]
サービスアカウントキーアカウント識別および FTP アドレスの構成[ワークスペース設定] > [サービス情報]
アップロードファイルキー原本コンテンツ資産の識別および管理[ライブラリ] > コンテンツ詳細 > [基本] タブ
メディアコンテンツキー配信および再生のコア識別子
(比較: アップロードファイルキー vs メディアコンテンツキー)		[チャンネル] > コンテンツ詳細 > [チャンネル] タブ
エンコーディングプロファイルキーエンコーディングポリシーおよび配信仕様の識別[設定] > [エンコーディングプロファイル]
カテゴリキーカテゴリ管理および統計算出用[ライブラリ] > カテゴリ [もっと見る]
チャンネルキーチャンネル管理および統計算出用[チャンネル] > チャンネル [もっと見る]

API アクセストークン​

  • 説明: Kollus VOD API を呼び出すための認証トークン(kollus_api_access_token)です。
  • 確認方法: Kollus VOD コンソール > [設定] > [API]
注意

新しいトークンを発行すると、既存のトークンは即時無効化されます。そのため、既存のトークンを使用しているすべてのシステムの認証情報を併せて更新する必要があります。

セキュリティーキー​

  • 説明: コンテンツ再生権限認証(JWT)の際に署名および検証に使用される秘密鍵です。
  • 確認方法: Kollus VOD コンソール > [設定] > [ユーザーキー]
  • セキュリティーキーの変更: 営業担当者(jp_sales@catenoid.net)までお問い合わせください。
  • 参考文書: 再生 URL 生成 (JWT)

ユーザーキー​

  • 説明: セキュリティーキーを暗号化した値で、セキュリティーキーとともに認証(JWT)に使用されます。
  • 確認方法: Kollus VOD コンソール > [設定] > [ユーザーキー]
    • ブラウザを更新すると値が更新される場合があります。使用時点の最新の値をコピーして適用してください。
  • 参考文書: 再生 URL 生成 (JWT)

サービスアカウントキー​

  • 説明: サービスアカウント作成時に発行されるアカウント識別キーです。変更することはできず、主にアップロードパスおよび FTP アドレスの構成時に使用されます。
  • 例: サービスアカウント名が catenoid の場合、FTP アドレスは catenoid.ftp.jp.kollus.com です。
  • 確認方法: Kollus VOD コンソール > [ワークスペース設定] > [サービス情報]

アップロードファイルキー​

  • 説明: アップロードが完了したコンテンツに付与される固有識別キーです。コンテンツ情報の修正、削除、入れ替えなど、原本資産の管理作業時に使用されます。
  • 確認方法: Kollus VOD コンソール > [ライブラリ] > コンテンツタイトルをクリック > [基本] タブ

メディアコンテンツキー​

  • 説明: コンテンツが特定のチャンネルに登録される際に発行される配信用識別キーです。同じコンテンツであっても、登録されたチャンネルが異なれば、それぞれ異なるメディアコンテンツキーが発行されます。コンテンツ再生権限認証だけでなく、Custom ID の結合など、配信サービス全般においてコア識別子として使用されます。
  • 確認方法
    • コンテンツリスト: Kollus VOD コンソール > [チャンネル] > チャンネルを選択 > コンテンツリストの [メディアコンテンツキー] 項目
    • 詳細情報パネル: Kollus VOD コンソール > [チャンネル] > チャンネルを選択 > コンテンツタイトルをクリック > [チャンネル] タブ > [メディアコンテンツキーコピー]

エンコーディングプロファイルキー​

  • 説明: サービスアカウント、デバイスタイプ、画質情報が組み合わされたプロファイル識別キーです。FTP パススルーアップロードや特定カテゴリのエンコーディングポリシー設定時に使用されます。
  • 確認方法: Kollus VOD コンソール > [設定] > [エンコーディングプロファイル]
  • 参考文書: エンコーディングプロファイル設定

カテゴリキー​

  • 説明: カテゴリ作成時に発行されるカテゴリ識別キーです。統計算出を目的として使用されており、認証(JWT)には使用されません。
  • 確認方法: Kollus VOD コンソール > [ライブラリ] > 左側のカテゴリリスト [もっと見る] > [カテゴリキーのコピー]

チャンネルキー​

  • 説明: チャンネル作成時に発行されるチャンネル識別キーです。統計算出を目的として使用されており、認証(JWT)には使用されません。
  • 確認方法: Kollus VOD コンソール > [チャンネル] > 左側のチャンネルリストまたはチャンネルカード [もっと見る] > [チャンネルキーのコピー]

比較: アップロードファイルキー vs メディアコンテンツキー​

Kollus VOD は、原本資産をさまざまなチャンネルに多角的に配信するため、識別子を二元化して管理します。

区分アップロードファイルキー (Upload File Key)メディアコンテンツキー (Media Content Key)
コアの役割資産管理: コンテンツ原本の識別配信管理: 再生パスおよびチャンネル別設定の識別
発行タイミングコンテンツのアップロードプロセス完了時アップロードされたコンテンツを特定チャンネルに登録した時
管理範囲情報修正、ファイル削除、原本入れ替え再生 URL 生成(JWT)、プレイヤー設定、統計
関係コンテンツごとに唯一の 1 個 が発行N 個のチャンネルに登録した場合 N 個 が発行