事前署名付き URL とは何ですか?
署名付き URL は、単一オブジェクトのダウンロードやアップロードなど、特定のストレージ操作一つに対して、期限付きの認可を付与します。受信者に署名者の秘密の認証情報を渡す必要はありません。署名によって、操作、オブジェクト、有効期限が固定されます。
署名付き URL の仕組み
署名付き URL を生成するサービスは、保持している認証情報を使ってストレージリクエストの署名を計算し、生成した認可情報を URL のクエリ文字列に格納します。ストレージサービスは URL の使用時に署名を再計算し、メソッド、オブジェクト、署名対象のヘッダー、有効期限を検証します。そのため、秘密情報をブラウザーやダウンロードを行うクライアントに渡す必要はありません。リクエストは署名者の権限で実行されます。Amazon S3 の説明によると、署名付き URL は、生成したプリンシパルの認証情報を使用し、そのプリンシパルのアクセス許可によって制限されます。Amazon S3 では presigned URL、Google Cloud Storage では signed URL と呼ばれ、Azure Storage では共有アクセス署名(SAS)がこれに相当します。この項目のストレージ固有の詳細は、これら三つのサービスのドキュメントに基づいています。他のプロバイダーの S3 互換サービスについては、そのプロバイダーのドキュメントを確認してください。CDN の署名付き URL は別の仕組みです。CDN に設定されたキーを使って CDN が検証し、ストレージサービスはその検証に関与しません。配信アーキテクチャでは、アプリケーションが URL の受信者を決定し、署名付き URL がクライアントとオブジェクトストレージの間に一時的な直接アクセス経路を作ります。
要点
- 署名付き URL は誰が使えますか?完全な URL を持っている人なら、有効でなくなるまで誰でも使えます。AWS は署名付き URL を Bearer トークンと説明しています。Google も、署名付き URL を持っていれば、アカウントの有無にかかわらず、有効な間は誰でも使えると説明しています。S3 の署名付き URL は、有効期限まで繰り返し使用できます。期限より前にアクセスを終了する方法の一つは、URL の署名に使った認証情報やキーを無効化することです。これにより、同じ認証情報やキーで署名したすべての URL が使えなくなります。S3 の URL は署名に使った認証情報が取り消し、削除、または無効化されると使えなくなり、Google の署名付き URL は署名キーがローテーションされると使えなくなります。その他の制御方法はサービスによって異なります。S3 の署名付き URL は署名者のアクセス許可によって制限されます。AWS は、署名付き URL への 403 Forbidden レスポンスの原因の一つとして、オブジェクトへのアクセスを明示的に拒否するバケットポリシーを挙げています。そのため、このような拒否設定では、認証情報を無効化せずにポリシーの対象範囲内のリクエストを阻止できます。Azure は、アカウントキーを再生成せずに取り消せるよう、サービス SAS を保存済みアクセスポリシーに関連付けることを推奨しています。
- 署名付き URL が、設定された有効期限より前に使えなくなるのはなぜですか?署名に使用した認証情報が有効な間しか、URL も有効ではないためです。AWS のドキュメントによると、引き受けたロールやインスタンスロール、コンテナロールなどの一時的な認証情報で署名した S3 の URL は、それより後の有効期限を指定していても、その認証情報の期限が切れると失効します。その後のリクエストは
ExpiredTokenで失敗します。リンクの有効期間を約束する前に、署名に使う認証情報の有効期間を確認してください。AWS では、コンソール、CLI、API を通じて引き受ける IAM ロールの最大セッション期間を、1 時間から 12 時間の間で設定できます。値を設定しない場合は 1 時間です。また、インスタンスロールとコンテナロールの認証情報は、通常、最長で約 6 時間有効と説明されています。一方、IAM ユーザーの認証情報では、Signature Version 4 を使って、最長 7 日間有効な S3 の URL に署名できます。AWS が示す対処方法は、認証情報を更新して新しい URL を生成するか、適切な場合には、より有効期間の長い認証情報で署名することです。S3 はリクエストの開始時に有効期限を確認します。期限前に開始したダウンロードは継続しますが、期限後に再開するリクエストは失敗します。 - 有効期限が切れていない URL で署名エラーが発生するのはなぜですか?リクエストが署名時の内容と一致しなくなっているためです。S3 では、URL の生成時と使用時で、HTTP メソッド、署名対象のヘッダー、クエリ文字列が完全に一致している必要があります。Signature Version 4 で署名した S3 の URL では、署名対象のヘッダーが
X-Amz-SignedHeadersに列挙されます。AWS は、host ヘッダーと、リクエストで送信するすべてのx-amz-*ヘッダーを、その一覧に含めることを必須としています。AWS はSignatureDoesNotMatchの原因として、署名時に指定したものと異なるコンテンツタイプ、変更された URL、誤ったリージョン、署名用マシンの時計のずれ、ヘッダーやクエリ文字列を変更するプロキシを挙げています。Google の署名付き URL では、リクエストに含める必要があるヘッダーをX-Goog-SignedHeadersで指定します。 - 有効な署名付き URL がブラウザーの JavaScript で失敗するのはなぜでしょうか。ストレージの認可と CORS は別々に検証されます。バケットの CORS 設定では、ページのオリジン、HTTP メソッド、リクエストヘッダーを許可する必要があります。Amazon S3 は、CORS を有効にしても ACL とポリシーは引き続き適用されると説明しています。設定でリクエストが許可されていない場合、ブラウザーはプリフライトの失敗時点で停止し、実際のリクエストを送信しません。ただし、プリフライトが不要なリクエスト(フォームのコンテンツタイプを使う POST など)では、リクエストを送信したうえで、スクリプトにレスポンスを渡しません。したがって、CORS エラーだけでは、何もアップロードされなかったとは判断できません。CORS はブラウザー内のスクリプトによるクロスオリジンリクエストを制限するため、同じ URL でもサーバー側クライアントでは成功し、ウェブページでは失敗することがあります。
- 署名付きアップロード URL は、アップロードする内容を制限するのでしょうか。制限されるのは署名した内容だけです。S3 の署名付きアップロード URL は、バケット、オブジェクトキー、HTTP メソッド、有効期限から作成されます。すでに存在するキーにアップロードすると、そのオブジェクトが置き換わります。Azure は、書き込み権限を持つクライアントが非常に大きな BLOB(例では 200 GB)をアップロードする可能性を警告し、書き込み後、使用前にデータを検証することを推奨しています。ストレージサービス側でサイズ制限を強制する必要がある場合、ドキュメントで示されている手段はフォームベースの POST アップロードです。Google Cloud Storage と Amazon S3 の署名付きポリシードキュメントは、
content-length-range条件を受け付けます。AWS SDK for Python では、generate_presigned_postを使ってこのような署名付きフォームを作成します。一回のリクエストに対するストレージサービス自体の上限も引き続き適用されます。S3 の署名付き URL によるアップロードは PUT であり、Amazon S3 は単一の PUT の上限を 5 GB としています。それより大きなオブジェクトには、オブジェクトをパートに分けて送信するマルチパートアップロードを使用します。Amazon S3 の POST Object リファレンスには単一の POST のサイズ上限が記載されていないため、フォームベースのアップロードを利用する前に、想定される最大サイズのファイルでテストしてください。
署名付き URL が重要になる場面
アプリケーションサーバーを経由させずに通信する必要がある場合、ブラウザーからの直接アップロードや非公開ダウンロード用に発行します。有効期間が長すぎる場合、許可する操作が広すぎる場合、または URL が漏えいした場合には、参照先のオブジェクトが有効期限まで第三者にアクセスされるおそれがあります。
署名付き URL に関する Transloadit の支援機能
Transloadit は、Amazon S3 にエクスポートしたファイルの署名付きダウンロード URL を返せます。Robot /s3/store で sign_urls_for を設定すると、結果に signed_url と signed_ssl_url が追加され、パラメーターの値が秒単位の有効期間になります。URL の署名には Robot に渡した AWS 認証情報が使われるため、ドキュメントでは、その認証主体にアップロード用の書き込み権限に加え、対象オブジェクトの読み取り権限も必要としています。
/s3/store が返す URL によって非公開オブジェクトが公開されることはありませんが、Robot の acl パラメーターのデフォルト値は public-read です。非公開バケットについては、ドキュメントで acl を bucket-default に設定し、ACL ヘッダーも grant ヘッダーも指定せず、S3 Block Public Access を有効に保つよう説明しています。一時的な AWS 認証情報を使用する場合、Robot はその認証情報を更新しません。AWS のドキュメントによると、署名付き URL は署名に使った認証情報とともに失効するため、認証情報の有効期間と sign_urls_for の値を比較してください。Transloadit の Signature Authentication と Smart CDN の署名付き URL は別の仕組みであり、ストレージの認証情報ではなく、Transloadit の Auth Secret を使用します。
出典
- Amazon S3:署名付き URL によるオブジェクトのダウンロードとアップロード
- Amazon S3:署名付き URL によるオブジェクトのアップロード
- Amazon S3:オブジェクトのアップロード(単一の PUT とマルチパートアップロードのサイズ制限)
- Amazon S3:クエリパラメーターによるリクエスト認証(署名付き URL 内の署名対象ヘッダー)
- Amazon S3:POST ポリシーとその条件
- Amazon S3:POST Object(フォームベースのアップロード)
- AWS IAM:ロールの最大セッション期間
- Google Cloud Storage:署名付き URL
- Google Cloud Storage:署名とポリシードキュメント
- Azure Storage:共有アクセス署名(SAS)の概要とベストプラクティス
- Amazon S3:オリジン間リソース共有(CORS)の使用
- MDN:オリジン間リソース共有(CORS)
- AWS SDK for Python(Boto3):generate_presigned_post とそのポリシー条件
- Amazon CloudFront:署名付き URL の仕組み(比較対象となる CDN の署名付き URL)