URL 変換とは?
URL 変換は、メディア処理の設定をリクエスト URL に記述し、配信時に派生アセットを生成または取得できるようにします。Signature とパラメーター検証により、許可する操作を制限できます。
URL 変換の仕組み
URL 変換サービスは、使用するソースアセットと実行する処理の二つをリクエスト URL から読み取ります。キャッシュミス時にはソースを取得し、処理を実行して結果を保存し、返します。キャッシュヒット時には再処理せず、保存済みの結果を返します。Cloudflare は画像変換についてこの流れを説明しており、Cloudinary は変換 URL への初回アクセス時に派生ファイルを作成します。つまり、URL は処理内容を表し、キャッシュキーの起点にもなります。ただし、二つの留意点があります。サービスが先に URL を正規化する場合があることと、自動形式選択のように出力がリクエストヘッダーにも依存する場合、一つの URL から複数のキャッシュ結果が生成されることです。構文はサービスによって異なります。Cloudinary と imgproxy は処理をパスセグメントに記述し、imgix はクエリパラメーターを使います。Transloadit の Smart CDN は、保存済みの Template をパスで指定し、その変数をクエリパラメーターとして渡します。処理の記述順序に意味があるかどうかも異なります。Cloudinary はスラッシュで区切られた各要素を、直前の要素の処理結果に対して実行します。一方、imgproxy と Fastly Image Optimizer は任意の順序でオプションを受け付け、内部の固定順序で適用します。
要点
- 何千種類ものサイズをリクエストされるのを防ぐものはあるのでしょうか。有効な URL を制限しない限り、何もありません。Thumbor のドキュメントはこれを URL 改ざんと呼び、寸法を変えて繰り返しリクエストするループを攻撃例として示しています。署名検証がデフォルトでは無効の imgproxy も、同じ理由から本番環境での有効化を推奨しています。一般的な対策は、オプションとソースに対する署名、または許可する変換の許可リストです。imgproxy は署名より後のパス全体に、Thumbor はオプションと画像 URL に署名します。許可リストの例には Cloudinary の厳格な変換設定があります。少数の変数を公開する保存済みテンプレートで制限できるのは、呼び出し元が変更できるオプションであり、各変数が受け付ける値の数ではありません。幅の変数に制限がなければ、ループは依然として可能です。署名または固定の許可値リストと組み合わせてください。署名には秘密鍵が必要なため、署名付き URL はブラウザーのコードで組み立てるのではなく、サーバーで発行する必要があります。署名ですべてのオプションを保護して初めて、新たな派生版の生成を阻止できます。imgix は、署名されていない
expiresの値はクエリ文字列内で自由に変更できると説明しています。 - 同じ出力を生成する二つの URL は、キャッシュエントリーを共有するのでしょうか。そうとは限りません。サービスのキャッシュキーと、URL を正規化するかどうかによって異なります。CloudFront のドキュメントによると、クエリ文字列パラメーターに基づいてキャッシュする場合、
?color=red&size=largeと?size=large&color=redは別々に取得・キャッシュされ、大文字と小文字の違いも同様に扱われます。Cloudflare の CDN キャッシュは、デフォルトでは順序の異なるクエリ文字列を別物として扱います。また、キャッシュ検索前に並べ替えるオプションの Query String Sort 設定があります。課金には独自のルールが適用されます。Cloudinary は、同じパラメーターでも順序が異なるなど記述が異なる変換を、結果が同一でも別々の変換として数えます。Cloudflare はソース画像とパラメーターの一意な組み合わせごとに、別々にキャッシュして課金します。パラメーターの順序と大文字・小文字を固定する単一のヘルパーから URL を生成し、リクエストされた幅は、少数のサイズ候補に丸めてください。 - ソースファイルを置き換えると、既存の派生版はどうなるのでしょうか。URL が変わらないため、配信され続ける可能性があります。Cloudinary によると、アセットを上書きした後も、変換の有無にかかわらず、配信済みのバージョンは無効化しない限り CDN サーバーにキャッシュされたままになることがあります。また、ネットワーク外のブラウザーやプロキシにもコピーが残る可能性があります。最新ファイルを直ちに配信する必要がある場合は、URL にバージョン要素を含めることを推奨しています。URL に署名も付ける場合は、署名付き URL も無効化の対象になることを確認してください。Cloudinary はデフォルトでは署名付き URL を無効化しません。imgproxy には、処理を変えずに URL を変更する
cachebusterオプションがあります。署名できるため、クエリ文字列よりもこのオプションを推奨しています。公開前に、URL またはソースパスへのバージョンの組み込みか、明示的な無効化処理のいずれかを計画してください。
URL 変換が重要になる場面
レスポンシブ表示用のサイズやバリエーションをすべて事前に予測して生成できない場合は、URL 変換を使用します。寸法に制限がない場合やパラメーターに署名がない場合、処理の悪用、キャッシュの断片化、予期しないコストにつながる可能性があります。
Transloadit による URL 変換の支援
Transloadit の Smart CDN は、Template を基盤とする URL 変換サービスです。tlcdn.com の URL では、ホスト名が Workspace を、パスが保存済みの Template とソースファイルを指定します。クエリパラメーターは、幅を指定する ${fields.w} など、Template が読み取る Assembly Variable に値を設定します。処理手順そのものは Template に保存されるため、呼び出し元が変更できるのは Template が公開する値だけです。ドキュメントの例では、クエリパラメーター w をリサイズ幅にそのまま渡しています。したがって、変数を公開するだけでは、呼び出し元が指定するサイズをページで使うサイズに制限できません。Transloadit は、呼び出し元が変更できるパラメーターを定義し、署名付き URL でリクエストを認可するよう案内しています。署名は Workspace、Template 名、ファイルパス、ソート済みのクエリパラメーターを対象とする HMAC で、パラメーターの改ざんを防ぎます。Auth Secret を使うため、バックエンドで生成する必要があります。
署名はオプションとされており、リンク先のページには署名のない URL を拒否する仕組みの説明がありません。署名によって新しいバリエーションをブロックできると判断する前に、自分の Workspace で確認してください。また、キャッシュのパージ操作や、同じパスのソースファイルを置き換えた場合にキャッシュ済みの結果がどうなるかも説明されていません。置き換え用のファイルを新しいパスに保存すると URL が変わります。パスを変えずに置き換える運用に依存する前に、自分の Workspace でそのケースをテストしてください。
出典
- Cloudflare Images:変換の概要(キャッシュヒット、キャッシュミス、課金)
- Cloudinary:画像変換(URL 構造、変換の連鎖、カウント方法)
- Cloudinary:変換のカウント方法(URL の変更、自動形式選択)
- Cloudinary:メディアへのアクセス制御(厳格な変換設定、署名付き URL)
- Cloudinary:キャッシュ済みアセットとアセットバージョンの無効化
- imgproxy:URL への署名
- imgproxy:cachebuster を含む処理オプション
- imgproxy:処理パイプラインについて
- imgproxy:外部キャッシュ(キャッシュキー内のリクエストヘッダー)
- Thumbor:セキュリティと URL 改ざん
- imgix:アセットの保護
- Fastly Image Optimizer リファレンス:処理順序
- Amazon CloudFront:クエリ文字列パラメーターに基づくコンテンツのキャッシュ
- Cloudflare Cache: Query String Sort