認証方式 V
ダウンロード
フォーカスモード
フォントサイズ
機能概要
ビデオシーンの権限制御能力を強化するために、EOはTypeV認証のソリューションをリリースしました。このソリューションが備える機能は以下の通りです：
URLに有効期限を指定できるため、他者が取得した後も長期間使用することはできません。
URLにクライアントIPを署名計算に含めることをサポートしており、他者が取得してもアクセスできません。
URLに試看時間を指定でき、試看機能を実現します。
URLでRefererの許可リストと拒否リストを指定できます。
URLで特定のUnixタイムスタンプから動画の再生を開始するよう指定でき、疑似ライブ配信機能を実現します。
開発者は鍵
KEYを使用してURLに署名し、URLに署名結果を付与します。ユーザー鍵が漏洩しない限り、他のユーザーは暗号化URLを偽造できません。EdgeOneノードは暗号化URL内のパラメータと署名を検査し、アクセスリクエストを制御します。リクエスト検査に合格しない場合は、403レスポンスコードを返します。
認証パラメータ
以下は認証URLにおける各パラメータの意味と取得方法です。
パラメータ名 | 必須 | 説明 |
KEY | はい | TypeV認証を有効にする際に入力するキーです。大文字と小文字のアルファベット（a～Z）、数字（0～9）、および特殊文字（ "と$を除く）で構成され、長さは6～40文字です。コンソールでランダムに生成できます。 |
Path | はい | 元のURLのPATH部分です。元のURLがhttp://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4の場合、Pathは/dir1/dir2/myVideo.mp4です。 |
t | はい | URLにアクセスするための有効期限タイムスタンプです。単位は秒で、Unix時間の16進数小文字形式で表されます。 有効期限が切れると、このURLは無効になり、403レスポンスコードが返されます。マシン間に時間差が存在する可能性を考慮し、認証URLの実際の有効期限は通常、指定された有効期限より5分長く設定されます。つまり、300秒の許容時間が追加で与えられます。 有効期限タイムスタンプは短すぎないように設定することをお勧めします。有効時間内にユーザーがダウンロードまたは動画再生を完了できるようにしてください。 |
exper | いいえ | 試看時間です。単位は秒で、10進数で表されます。入力しない場合、または0を入力した場合は試看なし（つまり完全な動画を返す）となります。 試看時間は動画の元の長さを超えないようにしてください。超えると再生に失敗する可能性があります。 |
us | いいえ | リンク識別子です。認証URLをランダム化し、リンクの一意性を高めるために使用されます。 認証URLを生成するたびに、ランダムなus値を指定することをお勧めします。 |
plive | いいえ | 単位は秒で、Unix時間の16進数小文字形式で表されます。疑似ライブ機能を実現するために使用され、指定した時間から動画の再生を開始できます。 例：pliveの値が669f9b40の場合、対応する暗号化リクエストのリソースは2024-07-23 20:00:00以降にのみアクセスが許可されます。 |
whref | いいえ | アクセスを許可するドメイン名のソースリストです。1件から10件まで指定でき、半角カンマで区切ります。ドメイン名の前にプロトコル名（http://およびhttps://）を付けないでください。ドメイン名は完全一致で照合されます（例：abc.comと入力した場合、abc.comのみ一致し、abc.com.cnには一致しません）。また、ワイルドカード（例：*.abc.com）もサポートされています。 |
bkref | いいえ | アクセスを禁止するドメイン名のソースリストです。1件から10件まで指定でき、半角カンマで区切ります。ドメイン名の前にプロトコル名（http://およびhttps://）を付けないでください。ドメイン名は完全一致で照合されます（例：abc.comと入力した場合、abc.comのみ一致し、abc.com.cnには一致しません）。また、ワイルドカード（例：*.abc.com）もサポートされています。 |
whip | いいえ | アクセスを許可するクライアントIPリストです。1個から10個まで指定でき、複数指定する場合は半角カンマで区切ります。クライアントIPは、IPおよびIPセグメントに対応しています。例：192.168.0.0または192.168.0.0/24。なお、0.0.0.0/0はすべてのIPv4を表し、::/0はすべてのIPv6を表します。 |
bkip | いいえ | アクセスを禁止するクライアントIPリストです。1個から10個まで指定でき、複数指定する場合は半角カンマで区切ります。クライアントIPは、IPおよびIPセグメントに対応しています。例：192.168.0.0または192.168.0.0/24。なお、0.0.0.0/0はすべてのIPv4を表し、::/0はすべてのIPv6を表します。 |
sign | はい | ホットリンク防止署名です。40文字の16進数で表され、認証URLの正当性を検証するために使用されます。署名の検証に失敗した場合は、403レスポンスコードが返されます。計算方法は署名計算式を参照してください。 |
説明：
VODオリジンサーバーの場合、上記のすべてのパラメータをサポートします。非VODオリジンサーバーの場合、us、pliveパラメータはサポートされません。
m3u8リクエストの場合、EdgeOneはtsのパスに基づいて認証パラメータを自動生成し、ts URLを書き換えます。クライアントはm3u8の認証URLを生成するだけで十分です。
署名計算式
sign = sha1(KEY + Path + t + plive + exper + us + whref + bkref + whip + bkip)
注意：
公式内の
+は文字列連結を表し、任意パラメータは空文字列にすることができます。署名計算を行う際、各パラメータは署名計算式の順序に厳密に従う必要があります。順序が正しくない場合、誤った署名が生成されます。
認証URL生成ルール
元のURLの末尾に、QueryString方式でホットリンク保護パラメータを追加します。形式は以下の通りです：
http://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4?t=[t]&exper=[exper]&us=[us]&whref=[whref]&whip=[whip]&sign=[sign]
設定サンプル
元のURLが
http://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4であると仮定します。この開発者はTypeV認証を設定し、生成されたキーは24FEQmTzro4V5u3D5epW、生成されたランダム文字列は72d4cd1101です。以下では、「動画再生アドレスの有効時間制御」、「同一認証URLで1つのクライアントIPのみ再生を許可」、「動画再生を許可するクライアントIP」の各シナリオについて、認証URLの生成方法を紹介します。
例1：再生URL有効時間制御
この動画に認証URLを生成する必要がある場合、URLの有効期限は2018年01月31日20:00（Unix時間は1517400000）です。以下の手順を参照してください。
ステップ1：認証パラメータの確定
パラメータ名 | 値 | 説明 |
KEY | 24FEQmTzro4V5u3D5epW | 開発者がKeyホットリンク保護を有効にする際に選択したキー |
Path | /dir1/dir2/myVideo.mp4 | 元のURLのPath部分 |
t | 5a71afc0 | 有効期限タイムスタンプ1517400000の16進数表現です。 |
us | 72d4cd1101 | 生成されたランダム文字列 |
ステップ2：署名の計算
sign = sha1("24FEQmTzro4V5u3D5epW/dir1/dir2/myVideo.mp45a71afc072d4cd1101") = "3ff5ab708b018fce5c3023b6d27ca938d7ab75e3"
ステップ3：認証URLの生成
認証パラメータを動画の元のURLのQueryStringに連結し、動画認証URLを取得します：
http://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4?t=5a71afc0&us=72d4cd1101&sign=3ff5ab708b018fce5c3023b6d27ca938d7ab75e3
例2：同一認証URLに対して単一クライアントIPのみアクセス許可
同一の認証URLに対して1つのクライアントIPのみアクセスを許可するよう制限する必要がある場合は、以下の手順を参照してください。
ステップ1：認証パラメータの確定
パラメータ名 | 値 | 説明 |
KEY | 24FEQmTzro4V5u3D5epW | 開発者がKeyホットリンク保護を有効にする際に選択したキー |
Path | /dir1/dir2/myVideo.mp4 | 元のURLのPath部分 |
t | 5a71afc0 | 有効期限タイムスタンプ1517400000の16進数表現です。 |
us | 72d4cd1101 | 生成されたランダム文字列 |
whip | 192.168.0.0 | アクセスを許可するクライアントIP |
ステップ2：署名の計算
sign = sha1(24FEQmTzro4V5u3D5epW/dir1/dir2/5a71afc072d4cd1101192.168.0.0) = "c8cd894ef4ee0387c99ac488f46bbe8205bc63af"
ステップ3：認証URLの生成
認証パラメータを動画の元のURLのQueryStringに連結し、動画認証URLを取得します：
http://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4?t=5a71afc0&us=72d4cd1101&whip=192.168.0.0&sign=c8cd894ef4ee0387c99ac488f46bbe8205bc63af
例3：再生許可時間の制御
試看URLを生成する必要がある場合、試看時間は動画の最初の5分間です（動画の元の長さが5分を超える場合）。以下の手順を参照してください。
ステップ1：認証パラメータの確定
パラメータ名 | 値 | 説明 |
KEY | 24FEQmTzro4V5u3D5epW | 開発者がKeyホットリンク保護を有効にする際に選択したキー |
Path | /dir1/dir2/myVideo.mp4 | 元のURLのPath部分 |
t | 5a71afc0 | 有効期限タイムスタンプ1517400000の16進数表現です。 |
exper | 300 | 試看開始前の5分間、つまり300秒です。 |
us | 72d4cd1101 | 生成されたランダム文字列 |
ステップ2：署名の計算
sign = sha1(24FEQmTzro4V5u3D5epW/dir1/dir2/myVideo.mp45a71afc030072d4cd1101) = "3a50217aff3e39fbf795b8db40925bc61735fe83"
ステップ3：認証URLの生成
認証パラメータを動画の元のURLのQueryStringに連結し、動画認証URLを取得します：
http://example.vod2.myqcloud.com/dir1/dir2/myVideo.mp4?t=5a71afc0&exper=300&us=72d4cd1101&sign=3a50217aff3e39fbf795b8db40925bc61735fe83
フィードバック