本文へ移動
HLSの暗号化

HLSのAES-128暗号化の仕組みと復号方法

多くの動画配信サービスでは、コンテンツの保護が欠かせません。HTTP Live Streaming(HLS)はセグメントの暗号化に対応しており、AES-128は広く使われる方式の一つです。このガイドでは、HLSにおけるAES-128の仕組み、プレーヤーによる復号鍵の取得と利用、OpenSSLやFFmpegを使った暗号化ストリームの調査と手動復号を説明します。

信頼できないネットワークを通じてメディアセグメントを配信する場合、HTTPSは通信経路を保護します。ただし、セグメントを直接取得できれば、その内容は読めてしまいます。AES-128で暗号化すると、正しい共通鍵を持つクライアントだけが映像や音声を復号できます。

HLSにおけるAES-128

128ビット鍵を使うAES(Advanced Encryption Standard)は共通鍵暗号方式で、暗号化と復号に同じ16バイトの鍵を使います。HLSでAES-128を使う場合、各メディアセグメント全体をCBC(Cipher Block Chaining)モードとPKCS7パディングで暗号化します。

セグメントが暗号化されていることは、個々の.tsまたは.m4sファイルを列挙するメディアプレイリスト(M3U8ファイル)の#EXT-X-KEYタグでプレーヤーに伝えます。

#EXT-X-KEYタグ

このタグは、適用対象のセグメントより前に置きます。典型的な例は次のとおりです。

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:10
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-KEY:METHOD=AES-128,URI="https://api.example.com/keys/key1.key",IV=0x00000000000000000000000000000005
#EXTINF:10.0,
segment_0.ts
#EXTINF:10.0,
segment_1.ts

#EXT-X-KEYタグの各属性を見てみましょう。

  • METHOD=AES-128: 暗号化方式を指定します。ほかに、メディアの一部だけを暗号化するSAMPLE-AESや、後続セグメントの暗号化を解除するNONEもあります。
  • URI: 16バイトの共通鍵を取得するURLを引用符で囲んで指定します。プレーヤーはセグメントを再生する前に、このURIへHTTP GETリクエストを送ります。
  • IV(初期化ベクトル): 任意で指定できる128ビットの16進数です。CBCモードでは、IVによって同じ平文でも異なる暗号文になります。IVを省略した場合は、HLSの仕様に従い、メディアセグメントのシーケンス番号を先頭ゼロ埋めで16バイトにして使用します。

プレーヤーによるストリームの復号

ブラウザーやメディアプレーヤーは、暗号化されたセグメントを扱う際、次の順序で処理します。

  1. 鍵の取得: URI属性を読み、ネットワークリクエストを送ります。鍵へのアクセスには認証Cookie、ヘッダー内のBearerトークン、クエリ文字列のセッション情報が必要な場合があります。CORS(オリジン間リソース共有)で遮断されたり、401 Unauthorizedが返されたりすると、再生は停止します。
  2. IVの決定: 明示的なIV属性を探します。なければ現在のセグメントの#EXT-X-MEDIA-SEQUENCE番号を16バイトのビッグエンディアン整数に変換し、IVとして使用します。
  3. セグメントの取得: 暗号化された.tsファイルを通常のGETリクエストでダウンロードします。
  4. データの復号: 取得した鍵と決定したIVを使い、セグメントのバッファーをAES-128 CBCで復号します。復号後のトランスポートストリームをデマルチプレクサーとデコーダーに渡し、映像や音声を出力します。

CORSに関する注意

鍵のURIとセグメントのURIは、異なるドメインにある場合があります。hls.jsやvideo.jsなどのWebプレーヤーでは、鍵を配信するサーバーが適切なAccess-Control-Allow-Originヘッダーを返す必要があります。そうしないと、ブラウザーはJavaScriptから鍵のバイト列にアクセスさせません。

鍵のローテーション

プレイリストには複数の#EXT-X-KEYタグを置き、暗号鍵を定期的に切り替えられます。これにより、一つの鍵が漏れても動画全体に影響が及ぶのを防げます。

OpenSSLを使った手動復号

問題を調べる際は、セグメントが正しく暗号化され、鍵とIVの組み合わせが有効か確認する必要があります。標準的なopensslコマンドを使えば、AES-128で暗号化されたHLSセグメントを手動で復号できます。

暗号化されたセグメント(segment.ts.enc)と16バイトの鍵ファイル(decryption.key)を取得済みなら、hexdumpで鍵を16進数表示できます。

hexdump -e '16/1 "%02x"' decryption.key

出力は32文字の16進数文字列です。例:a1b2c3d4e5f60718293a4b5c6d7e8f90。

プレイリストにIVが指定されている場合(例:IV=0x0123456789abcdef0123456789abcdef)、次のコマンドで復号できます。

openssl aes-128-cbc -d -in segment.ts.enc -out decrypted_segment.ts -K a1b2c3d4e5f60718293a4b5c6d7e8f90 -iv 0123456789abcdef0123456789abcdef

マニフェストにIVがなければシーケンス番号を使います。#EXT-X-MEDIA-SEQUENCE: 5のセグメントなら、IVは00000000000000000000000000000005です。

ヒント: OpenSSLで「bad decrypt」エラーが出たら、鍵とIVの16進数文字列がそれぞれ正確に32文字か、鍵ファイルに改行が紛れ込んでいないか確認してください。

FFmpegによるダウンロードと復号

単一のセグメントにはOpenSSLが便利ですが、M3U8ストリーム全体をダウンロードしながら復号するにはFFmpegが適しています。FFmpegは#EXT-X-KEYタグを解析し、指定されたURIから鍵を取得してIVを決定し、ストリームを随時復号します。

再エンコードせずにストリームを一つのMP4ファイルへ保存するには、次のコマンドを使います。

ffmpeg -i "https://example.com/playlist.m3u8" -c copy output.mp4

認証ヘッダーの指定

鍵のURIでBearerトークンや特定のUser-Agentなどの認証ヘッダーが必要な場合、FFmpegが鍵を取得する際にHTTP 403 Forbiddenで失敗することがあります。-headers引数を使うと、任意のヘッダーを渡せます。

ffmpeg -headers "Authorization: Bearer YOUR_TOKEN_HERE" -i "https://example.com/playlist.m3u8" -c copy output.mp4

鍵の取得にセッションCookieが必要なら、次のように指定できます。

ffmpeg -cookies "session_id=12345abcde;" -i "https://example.com/playlist.m3u8" -c copy output.mp4

よくある問題と確認点

HLSのAES-128暗号化でよく起こる問題を挙げます。

  • 鍵のURIで403 Forbidden: よくある原因は、鍵へのアクセスに必要なCookieやトークンがクライアントにないことです。認証の仕組みとトークンの有効期限を確認してください。
  • 鍵サーバーのCORS設定不足: 鍵サーバーがAccess-Control-Allow-Origin: *または許可対象のドメインを返さないと、ブラウザーは鍵の取得を遮断します。開発者ツールのネットワーク欄にCORSエラーが表示されます。
  • IVの不一致: 復号後の映像が大きく乱れたり音声に雑音が入ったりする場合は、IVが誤っている可能性があります。明示的なIVを使うか、シーケンス番号を代用するかについて、エンコーダーとプレーヤーの設定を揃えてください。
  • 混在コンテンツの警告: ページがHTTPSなのに鍵のURIがHTTPだと、ブラウザーは混在コンテンツとして鍵の取得を遮断します。鍵は必ずHTTPSで配信してください。
  • パディングエラー: セグメントの暗号化が不完全(エンコード中に切り詰められたなど)か、鍵が間違っている可能性があります。AES CBCモードでは正確なPKCS7パディングが必要です。

安全な鍵配信のための対策

AES-128はデータ本体を強力に暗号化しますが、ストリーム全体の安全性は鍵の配信方法に左右されます。誰でも鍵のURIから16バイトの鍵を取得できるなら、暗号化の効果は失われます。

AES-128を安全に運用するための対策は次のとおりです。

  • 通信途中で鍵を盗み見られないよう、鍵は必ずTLS(HTTPS)で配信します。
  • 鍵を配信するエンドポイントに厳格な認可処理を実装します。ユーザーのセッション、地域別のIP制限、同時接続数などを確認してから鍵を返します。
  • リンクの共有を防ぐため、M3U8プレイリストと鍵のURIの両方に、有効期間の短い署名付きURLを使います。
  • 鍵を頻繁に切り替えます。価値の高いライブ配信では、マニフェストに新しい#EXT-X-KEYタグを追加し、10〜15分ごとにAES鍵を切り替えます。

マニフェストの解析からバイト単位の復号までAES-128の仕組みを理解すれば、HLS配信の構築、問題調査、安全性の確保に役立ちます。