URL 書き換え

[アーティクル]
06/08/2023

Azure Front Door では、配信元にルーティングされる要求パスを変更するために URL 書き換えがサポートされます。 URL 書き換えでは、条件を設定することで、特定の条件が満たされた場合にのみ、URL または指定したヘッダーが書き換えられるようにすることができます。これらの条件は、要求と応答の情報に基づいています。

この機能を使用すると、エンドユーザーをデバイスの種類または要求されたファイルの種類に基づいて、別の配信元にリダイレクトできます。 URL 書き換えアクションは、ルールセットの構成で確認できます。

ルールセット構成の URL 書き換えアクションのスクリーンショット。

ソースパターン

ソースパターンとは、置換する最初の要求の URL パスです。現在、ソースパターンではプレフィックスに基づく一致が使用されます。すべての URL パスを一致させるために、ソースパターン値としてスラッシュ (/) を定義できます。

URL 書き換えアクションのソースパターンの場合、ルート構成の "照合するパターン" の後のパスのみが考慮されます。たとえば、contoso.com/pattern-to-match/source-pattern という受信 URL 形式の場合、/source-pattern のみがルールセットによって書き換えられるソースパターンと見なされます。 URL 書き換えが適用された後の送信 URL の形式は contoso.com/pattern-to-match/destination になります。

URL の /pattern-to-match セグメントを削除する必要がある場合は、ルート構成の配信元グループの配信元パス を / に設定します。

到着地

宛先パスは、ソースパターンを置き換えるために使用されます。たとえば、要求 URL パスが contoso.com/foo/1.jpg で、ソースパターンが /foo/ で、宛先が /bar/ である場合、コンテンツは配信元の contoso.com/bar/1.jpg から提供されます。

一致しないパスを保持する

[一致しないパスを保持する] を指定すると、ソースパターンの後に残っているパスを新しいパスに追加できます。一致しないパスの保持が [いいえ] (既定値) に設定されている場合、ソースパターンの後の残りのパスは削除されます。

一致しないパスを保持する	ソースパターン	到着地	着信要求	配信元から提供されるコンテンツ
はい	/	/foo/	contoso.com/sub/1.jpg	/foo/sub/1.jpg
はい	/sub/	/foo/	contoso.com/sub/image/1.jpg	/foo/image/1.jpg
いいえ	/sub/	/foo/2.jpg	contoso.com/sub/image/1.jpg	/foo/2.jpg

重要

Azure Front Door (クラシック) は、2027 年 3 月 31 日に廃止されます。サービスの中断を回避するには、2027 年 3 月までに Azure Front Door の Standard または Premium レベルに Azure Front Door (クラシック) プロファイルを移行することが重要です。詳細については、Azure Front Door (クラシック) の廃止に関するページを参照してください。

転送ルーティングの種類の規則を構成するときにカスタム転送パスを構成すると、Azure Front Door (クラシック) で URL の書き換えがサポートされます。既定では、スラッシュ (/*) のみが定義されている場合、Front Door により、転送された要求で使用される URL に受信 URL パスがコピーされます。転送された要求で使用されるホストヘッダーは、選択されたバックエンド用に構成されています。詳細については、「バックエンドホストヘッダー」を参照してください。

URL 書き換えの堅牢な部分としては、カスタム転送パスによって、転送されたパスに、ワイルドカードパスと一致する受信パスの任意の部分がコピーされることです。

次の表は、ワイルドカードを含む一致パスに対して、カスタム転送パスの /fwd/ を使用する場合の受信要求および対応する転送パスの例を示しています。パスの a/b/c の部分は、ワイルドカードを置き換える部分を表します。

受信 URL パス	一致パス	カスタム転送パス	転送パス
/foo/a/b/c	/foo/*	/fwd/	/fwd/a/b/c