署名付き URL とは?
署名付き URL には、権限を持つ主体がリソースへのアクセスや変換を許可したことを示す暗号学的な証明が含まれます。通常、署名の対象には有効期限と、リクエスト固有のパスまたはクエリパラメーターが含まれます。
署名付き URL の仕組み
鍵を持つ署名者は、許可するリクエストの構成要素から文字列を組み立て、その文字列の署名を計算して URL に追加します。通常、対象となる構成要素は、パス、選択したクエリパラメーター、有効期限です。サービスは、何かを配信する前に署名を検証し、有効期限を確認します。一般的な鍵のモデルは二つあります。HMAC では、署名者とサービスが同じ秘密情報を保持します。Google Cloud CDN と Transloadit の Smart CDN はこの方式です。鍵ペアでは、署名者が秘密鍵を保持し、サービスには公開鍵だけが必要です。Amazon CloudFront は、信頼されたキーグループ内の公開鍵を使って RSA または ECDSA 署名を検証します。どちらも認可の委任であり、暗号化ではありません。AWS は事前署名付き URL を Bearer トークンと説明しています。Google も、署名付き URL を持つ人は誰でも、その有効期間中は利用できるとしています。事前署名付き URL は、オブジェクトストレージで使われるものです。Amazon S3 では、一つのバケット、一つのオブジェクトキー、一つの HTTP メソッドに対する作成者の認証情報を含む URL をこの名前で呼びます。たとえば、GET によるダウンロードや PUT によるアップロードです。Google Cloud Storage では、同等のものを署名付き URL と呼びます。
要点
- 署名後にクエリパラメーターを追加または変更できますか?署名方式でそのパラメーターが署名対象外になっているか、署名済みポリシーで許可されている場合に限られます。CloudFront は、署名後の署名付き URL にクエリ文字列を追加すると、HTTP 403 を返します。CloudFront のカスタムポリシーでは、この許容範囲を広げられます。ポリシーの
ResourceURL にはワイルドカードを含められ、CloudFront はリクエストされた URL をそのパターンと照合します。パス末尾のアスタリスクは、クエリ文字列にも一致します。imgix は、sパラメーターの設定後にパスやパラメーターが変更されると、403 を返します。正規化リクエストに署名する方式では、リクエストの送信方法も影響します。S3 と Google Cloud Storage V4 の署名は、HTTP メソッド、パス、ソート済みクエリ文字列、hostヘッダーを対象とするため、あるメソッドやホスト名向けに署名した URL は、別のものでは検証に通りません。Google Cloud CDN には意図的な例外があります。完全な URL ではなくURLPrefixに署名すると、クエリパラメーターは署名対象外となり、自由に含められます。また、一つの署名が、そのプレフィックスで始まるすべての URL で有効です。 - 事前署名付き URL が、設定した有効期限より前に使えなくなるのはなぜですか?通常は、元の認証情報が先に失効したためです。AWS によると、S3 の事前署名付き URL は、設定した有効期限と、作成に使った認証情報の有効期限のうち、早い方で失効します。そのため、一時的なロール認証情報で署名した URL は、より長い有効期間を指定していても、ロールセッションの終了とともに失効します。Google Cloud Storage の署名付き URL も、署名に使った鍵がローテーションされると使えなくなります。AWS は、署名を行うマシンの時刻のずれや、ヘッダーやクエリ文字列を変更するプロキシも、署名不一致の原因として挙げています。URL より長く有効な認証情報で署名するか、セッションより有効期間の短い URL を発行してください。
- 有効期限が切れた時点で、ダウンロードや再生が続いている場合はどうなりますか?有効期限は、各 HTTP リクエストの到着時に確認され、レスポンスの送信中には確認されません。S3 と CloudFront はどちらも、有効期限の直前に開始したダウンロードは継続し、期限後にクライアントが再接続すると失敗すると説明しています。CloudFront では、期限後に発行された Range GET もすべて失敗します。そのため、大きなファイルを範囲ごとに取得するプレーヤーや、ダウンロードを再開するダウンロードマネージャーには、セッション全体をカバーする有効期間、または新しい URL を取得する手段が必要です。
- CDN で署名付き URL を必須にするとオリジンも保護されるのでしょうか。また、署名付きレスポンスもキャッシュされるのでしょうか。CDN は署名を検証しますが、オリジンは別のエントリーポイントです。AWS は、S3 バケットを CloudFront 経由でのみ読み取れるように制限することを推奨していますが、必須ではありません。Google は、Cloud CDN が署名のないリクエストをブロックしないと警告しているため、その背後にある Cloud Storage のオリジンは非公開にする必要があります。キャッシュについては、CloudFront と Google Cloud CDN はリクエストをオリジンに転送する前に署名パラメーターを削除します。Google は最初に署名を検証してからキャッシュから配信し、署名付きリクエストと署名なしリクエストへのレスポンスを別々に保存します。ただし、この分離によって、コンテンツが公開されていた間のキャッシュが消去されるわけではありません。Cloud CDN は、署名なしリクエストでもキャッシュヒット時にはキャッシュから配信します。そのため、オリジンを非公開にした後は、以前キャッシュされたレスポンスを無効化するか、有効期限が切れるまで待ってください。サービスによってはキャッシュの保持期間を有効期限に連動させます。imgix は
Cache-Controlをexpiresまでの残り時間に置き換えます。
署名付き URL が重要になる場面
署名付き URL を使うと、ストレージの認証情報を渡したりオリジンを公開したりせずに、ブラウザー、プレーヤー、パートナーに非公開メディアへの期限付きアクセスを許可できます。署名付き URL がアクセスを許可するのは、特定のユーザーではなく、その URL を持つ人です。転送されたリンクでも許容できる有効期間を選び、アクセスを特定の一人に限定し続ける必要がある場合は、追加の確認処理を設けてください。
Transloadit による署名付き URL の活用支援
Transloadit の Smart CDN は署名付き URL を受け付けます。バックエンドで、ミリ秒単位のタイムスタンプ exp と auth_key を追加し、クエリパラメーターを並べ替えます。次に、Workspace、Template 名、ファイルパス、並べ替えたパラメーターを対象に、Auth Secret で HMAC-SHA256 を計算し、結果を sig として付加します。変換パラメーターも署名対象の文字列に含まれるため、署名付き URL を編集して別のバリアントをリクエストすることはできません。有効期限は署名付きレスポンスをキャッシュできる期間の上限にもなるため、exp を短くするとアクセス制限が厳しくなり、キャッシュの再利用率が下がります。独自のバケットにエクスポートしたファイルについては、Robot /s3/store のパラメーター sign_urls_for を通じて署名付き URL を取得できます。
署名に使用する Auth Key は Smart CDN 用に有効化する必要があります。また、署名には Auth Secret が必要なため、バックエンドで実行しなければなりません。ドキュメントでは exp は省略可能とされていますが、常に設定することが推奨されています。リンク先のページには URL の署名方法は記載されていますが、同じ Template への署名なしリクエストの扱いや、exp を過ぎてから届いた範囲リクエストが拒否されるかどうかは記載されていません。署名をアクセス制御として扱う前、または再生セッションより短い有効期間を選ぶ前に、自分の Workspace で両方の動作をテストしてください。
出典
- Amazon S3:事前署名付き URL によるオブジェクトのダウンロードとアップロード(有効期限、認証情報、FAQ)
- AWS Signature Version 4 :正規リクエストの構成要素
- Amazon CloudFront:署名付き URL の使用(検証手順と有効期限の確認)
- Amazon CloudFront:カスタムポリシーによる署名付き URL の作成(Resource 内のワイルドカード)
- Amazon CloudFront:キャッシュとオリジン内のファイルへのアクセス制限
- Amazon CloudFront:署名付き URL で削除されるクエリ文字列パラメーター
- Google Cloud CDN:署名付き URL の使用(キー、URL プレフィックス、オリジンでの検証)
- Google Cloud CDN:キャッシュ無効化の概要
- Google Cloud Storage:署名付き URL の概要
- Google Cloud Storage:V4 署名の正規リクエスト
- imgix:署名付き URL と有効期限付き URL によるアセットの保護