ApsaraVideo Live:署名付きインジェスト URL とストリーミング URL

署名付き URL の構成要素

署名付き URL は、PC、モバイルデバイス、およびサードパーティ製のインジェスト・再生ツールに適しています。これらは、インジェスト URL またはストリーミング URL + アクセストークンで構成されます。以下に例を示します。

rtmp://push.aliyundoc.com/app/stream?auth_key=1740562218-0-0-183e22e*********

auth_key パラメーターは[アクセストークン]です。

timestamp-rand-uid-md5hash

使用方法

署名付き URL を使用するには、ドメイン名に対して URL 署名機能を有効にする必要があります。初めてドメイン名を追加する場合、URL 署名はデフォルトで有効になっています。詳細については、「URL 署名の設定」をご参照ください。署名付き URL は、ApsaraVideo Live コンソールで生成するか、連結ルールを使用して生成できます。詳細については、「インジェスト URL とストリーミング URL の生成」をご参照ください。

仕組み

URL 署名が有効になると、サーバーは次の操作を実行してリクエストを検証します。

1. サーバーは、リクエスト内のtimestamp が現在時刻より前かどうかをチェックします。

   • timestamp が現在時刻より前の場合、サーバーは署名付き URL が期限切れであると判断し、HTTP ステータスコード 403 を返します。

   • timestamp が現在時刻より後の場合、サーバーは次のsstring 式を使用して文字列を構築し、署名を検証します。

2. サーバーは MD5 アルゴリズムを使用して文字列のハッシュ値を計算し、そのハッシュ値をリクエストに含まれるハッシュ値と比較します。

   • 2 つの値が同じ場合、認証は成功します。サーバーはライブストリームを返します。

   • 2 つの値が異なる場合、認証は失敗します。サーバーは HTTP ステータスコード 403 を返します。

sstring = "URI-timestamp-rand-uid-PrivateKey"
HashValue = md5sum(sstring)

注意事項

• デフォルトでは、URL 署名は有効になっています。コンテンツの不正コピーを防ぐため、この機能を有効にしておくことを推奨します。URL 署名を無効にする場合は、リソースの不正使用のリスクを理解した上で、ApsaraVideo Live コンソールの URL 署名 ページにある「URL署名無効化に関する免責事項」に同意してください。

• auth_key フィールドは手動で設定する必要があります。ApsaraVideo Live は、auth_key フィールドの値を計算するための API を提供していません。

• URL 署名を有効にした後、インジェスト URL とストリーミング URL にauth_key フィールドを追加する必要があります。そうしないと、ライブストリームを再生できません。インジェスト URL またはストリーミング URL のどちらか一方だけに署名することはできません。両方に署名する必要があります。

• 署名付き URL は、有効期限のタイムスタンプまで有効です。期限切れになる前であれば、いつでも署名付き URL にアクセスできます。ApsaraVideo Live は、ワンタイムの署名付き URL をサポートしていません。

• auth_key フィールドの値は、queryString フィールドを含まない URI の MD5 値です。詳細については、URL 署名パラメーターの設定に関する前のセクションをご参照ください。インジェスト URL とストリーミング URL の両方の URI はAppName/StreamName です。インジェスト URL が機密情報でない場合は、有効期限のタイムスタンプをできるだけ短く設定することを推奨します。これにより、ストリーミング URL への悪意のあるアクセスを防ぐことができます。

• Real-Time Messaging Protocol (RTMP)、FLV、Real-Time Streaming (RTS) 形式のインジェスト URL およびストリーミング URL の場合、リクエストはストリームインジェストまたはストリーミングの開始時にのみ認証されます。処理中に署名付き URL の有効期限が切れても、進行中のストリームインジェストまたはストリーミングは中断されません。

• M3U8 形式のストリーミング URL の場合、リクエストはストリーミングの開始時とストリーミング中に認証されます。処理中に署名付き URL の有効期限が切れると、進行中のストリーミングは中断されます。

• 署名付き URL の有効期間を動的に制御したい場合は、関連する SDK を使用してAppName およびStreamName パラメーターを動的に指定できます。詳細については、「URL 署名のサンプルコード」をご参照ください。

• セキュリティと再利用の要件に基づいて、auth_key 生成戦略を選択します。厳格なセキュリティ制御が不要で、有効期間中にストリーミング URL を再利用できる場合は、現在時刻に 7,200 秒を加えた値に設定された timestamp のように、有効期間が長い事前生成された auth_key を使用します。個々のリクエストへのアクセスを制御したり、URL 漏洩のリスクを低減したりするには、現在時刻に 300 秒を加えた値に設定された timestamp のように、リクエストごとに短い有効期間で auth_key をリアルタイムで生成します。M3U8 ストリーミング URL はストリーミング中に継続的に認証されるため、auth_key をリアルタイムで生成し、再生中に有効期限が切れないようにします。

• カメラなど、設定をリモートで更新できない固定 IP のインジェストデバイスの場合、署名の有効期間が切れるとストリームが切断される可能性があります。有効期間を設定する際にはセキュリティと可用性のバランスを取るか、URL 署名の代わりにインジェスト IP ホワイトリストを使用することを推奨します。

• ApsaraVideo Real-Time Communication (ARTC) の場合、本番環境で ARTC を使用する際には、リソースの盗用や追加コストの発生を防ぐため、URL 署名を有効にすることを推奨します。テスト再生のためにのみ URL 署名を一時的に無効にすることで、URL がアクセス可能であることを確認できます。

• インジェストドメインのプライマリキーとストリーミングドメインのプライマリキーを同じ値に設定できます。これは、インジェスト URL とストリーミング URL の URL 署名、または通常のストリームインジェストと再生には影響しません。ベストプラクティスとして、少なくとも 16 文字の長さのプライマリキーを使用してください。ApsaraVideo Live コンソールは 8 文字未満のプライマリキーを拒否し、セキュリティリスクメッセージを表示します。

よくある質問

$args = isset($matches[4]) ? $matches[4] : '';