本文へスキップ
HLSのセキュリティと保護

HLSストリームを保護する:トークン認証と署名付きURLの解説

有料動画サービスではHLSコンテンツの保護が重要です。単純なReferer確認に頼らず、トークン認証と署名付きURLを使って、M3U8プレイリストとTS/fMP4セグメントの両方をCDNエッジで保護する方法を説明します。

HLSの標準的な配信では、.m3u8マスタープレイリストのURLを知っている人なら、ブラウザーやVLCなどで読み込めます。放送事業者、教育サービス、有料VODでは、無断視聴や帯域の不正利用、収益減につながります。

HTTP Refererの確認やCORS制限だけでは、ヘッダーを偽装するクライアントを防げません。ストリームを保護するには、エッジで暗号学的に検証するトークン認証と署名付きURLが必要です。

Referer確認だけでは不十分な理由

直リンク対策をRefererやOriginヘッダーだけに頼るのは危険です。CDNでRefererがyourdomain.comのリクエストだけを許可しても、piratesite.comなどからの不正利用を確実には防げません。

Refererはクライアント側で設定できます。スクリプトやcurl、yt-dlp、ffmpegなどで偽のRefererを送れます。

M3U8を保護するには、偽造が難しく、有効期限のある認可情報が必要です。トークン認証がその役割を担います。

トークン認証の仕組み

トークン認証では、アプリケーションのバックエンドとNginx、AWS CloudFront、Cloudflareなどのエッジサーバーで秘密鍵を共有します。一般的な流れは次のとおりです。

  • ユーザー認証:正規ユーザーがサイトにログインして動画を再生します。
  • 署名の生成:バックエンドがユーザーのIPアドレス、有効期限、ストリームのパス、共有秘密鍵からハッシュ(通常はHMAC-SHA256)を生成します。
  • 署名付きURLの作成:生成したハッシュと期限をM3U8 URLのクエリパラメーターに付けます。
  • CDNでの検証:プレーヤーがM3U8を要求すると、CDNは共有秘密鍵からハッシュを再計算します。一致し、有効期限内なら配信し、そうでなければ403 Forbiddenを返します。

HLS特有の課題:マスター、メディア、セグメント

単一のMP4ならURLに署名するだけですが、HLSは複数のファイルから成るため保護が複雑です。

プレーヤーがマスタープレイリスト(例:master.m3u8)を要求すると、メディアプレイリスト(720p.m3u8、1080p.m3u8など)の一覧を受け取ります。さらに720p.m3u8から、segment1.tsやsegment2.tsなどのセグメントのパスを取得します。

マスターだけに署名する場合

マスターだけを保護しても、そこからメディアプレイリストのURLを取り出し、TSセグメントを直接取得される可能性があります。

Cookieを使うトークン

各TSファイルにトークンを付ける代わりに、マスター取得時に署名付きJWTや安全なCookieを発行できます。ブラウザーは後続のプレイリストとセグメントへのリクエストにもCookieを送るため、M3U8本文を書き換えずに済みます。

パス単位のワイルドカード署名

URLベースのトークンでディレクトリ全体(例:/video/12345/*)へのアクセスを許可できます。マスターM3U8にトークンを付ける場合は、プレーヤーが後続の全リクエストにも同じトークンを付けるか、M3U8内の各URLにトークンを含める必要があります。

配信元サーバーを管理しているなら、ngx_http_secure_link_moduleでURLの署名と有効期限を検証できます。

HLSディレクトリを保護するNginx設定例です。

location /hls/ {
    secure_link $arg_md5,$arg_expires;
    secure_link_md5 "$secure_link_expires$uri$remote_addr my_secret_key";

    if ($secure_link = "") {
        return 403; # Invalid hash
    }
    if ($secure_link = "0") {
        return 410; # Link expired
    }

    # Serve the M3U8 or TS files
    alias /var/www/streaming/hls/;
    
    # Standard HLS Headers
    add_header Cache-Control no-cache;
    add_header Access-Control-Allow-Origin *;
}

このNginx設定に対応するURLをPythonで生成する例です。

import time
import hashlib
import base64

secret = "my_secret_key"
uri = "/hls/stream_720p.m3u8"
ip = "192.168.1.100"
expires = int(time.time()) + 3600 # Valid for 1 hour

raw_str = f"{expires}{uri}{ip} {secret}"
md5_hash = hashlib.md5(raw_str.encode('utf-8')).digest()
b64_hash = base64.urlsafe_b64encode(md5_hash).decode('utf-8').rstrip('=')

signed_url = f"https://media.example.com{uri}?md5={b64_hash}&expires={expires}"
print(signed_url)

トークン認証でよくある問題の対処

M3U8の署名付きURLを導入すると、次の問題で再生が止まることがあります。

  • CORSとCookie:Cookieを使うなら、hls.jsやVideo.jsをwithCredentials: trueで初期化します。サーバー側ではAccess-Control-Allow-Origin: *を使えません。要求元のオリジンを明示し、Access-Control-Allow-Credentials: trueを返す必要があります。
  • 再生途中での期限切れ:有効期限が1時間のトークンで2時間の動画を見ると、途中で再生が止まります。動画の最大再生時間をカバーする期限を設定するか、プレーヤーで定期的にトークンを更新します。
  • モバイル回線でのIP固定:トークンを$remote_addrに結び付けるとURL共有を抑制できますが、LTE/5Gでは移動中にIPアドレスが変わる場合があります。再生中に変わるとCDNがトークンを拒否するため、モバイル利用が多い場合は署名対象からIPを外すことを検討します。
  • 動的マニフェストのキャッシュ:.m3u8内の各.tsにトークンを付ける場合、生成したマニフェストをCDNにキャッシュさせないでください。他のユーザーに別人のトークンが配られ、403 Forbiddenになる可能性があります。

まとめと次のステップ

トークン認証と署名付きURLにより、認可されたユーザーやアプリだけにHLSを配信できます。.m3u8と.tsの配信前に署名を検証し、無断利用を防ぎます。

さらに保護が必要なら、トークン認証とHLS暗号化(AES-128、SAMPLE-AES)やDRM(Widevine、FairPlay)を組み合わせます。トークンは配信へのアクセスを制限し、DRMは動画データ自体を保護します。