次の方法で共有


Azure Front Door での HTTP ヘッダー プロトコルのサポート

この記事では、呼び出しパスの各部で Front Door がサポートするプロトコルの概要を示します (画像を参照)。 次のセクションでは、Front Door がサポートする HTTP ヘッダーについて情報を提供します。

バックエンドに転送される Azure Front Door への要求を行うクライアントを示す図。応答は Azure Front Door からクライアントに送信されます。

重要

ここに記載されていない HTTP ヘッダーは、Front Door では認定されません。

クライアントから Azure Front Door へ

Azure Front Door では、受信した要求のほとんどのヘッダーが変更なしで受け入れられます。 X-FD-* プレフィックスの付いたヘッダーを含め、一部の予約済みヘッダーは、送信された場合、受信した要求から削除されます。

デバッグ要求ヘッダー X-Azure-DebugInfo は、Front Door に関する追加のデバッグ情報を示します。 Azure Front Door がクライアントに応答するときにオプションの応答ヘッダーを受け取るには、クライアントから Azure Front Door に X-Azure-DebugInfo: 1 要求ヘッダーを送信する必要があります。

Front Door からバックエンドへ

Azure Front Door では、制限により削除されない限り、受信した要求のヘッダーが含められます。 Azure Front Door では、次のヘッダーも追加されます。

ヘッダー 例と説明
Via Via: 1.1 Azure
Front Door は、クライアントの HTTP バージョンを追加し、その後ろに、Via ヘッダーの値として Azure を付けます。 このヘッダーは、クライアントの HTTP バージョンを示すと共に、Front Door がクライアントとバックエンドの間での要求の中間受信者となったことを示します。
X-Azure-ClientIP X-Azure-ClientIP: 127.0.0.1
処理されている要求に関連付けられたクライアント IP アドレスを表します。 たとえば、プロキシから送信される要求では、最初の呼び出し元の IP アドレスを示すために、X-Forwarded-For ヘッダーが追加されることがあります。
X-Azure-SocketIP X-Azure-SocketIP: 127.0.0.1
TCP 接続に関連付けられた、ソケットの IP アドレス (現在の要求の送信元) を表します。 要求のクライアント IP アドレスは、ソケットの IP アドレスと同じではない場合があります。これは、ユーザーがクライアント IP を任意に上書きできるためです。
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
Azure Front Door によって提供される要求を示す一意の参照文字列。 この文字列は、アクセス ログの検索に使用されるため、トラブルシューティングにおいて重要です。
X-Azure-RequestChain X-Azure-RequestChain: hops=1
Front Door が要求ループの検出に使用するヘッダーであり、ユーザーはそれに対する依存関係を取得することはできません。
X-Azure-FDID X-Azure-FDID: 55ce4ed1-4b06-4bf1-b40e-4638452104da
特定の Front Door リソースからの要求を識別する参照文字列です。 この値は、Azure portal で確認することも、管理 API を使用して取得することもできます。 このヘッダーを IP ACL と組み合わせて使用して、特定の Front Door リソースからの要求のみを受け入れるようにエンドポイントをロック ダウンすることができます。 詳細については、FAQ を参照してください。
X-Forwarded-For X-Forwarded-For: 127.0.0.1
X-Forwarded-For (XFF) HTTP ヘッダー フィールドは、HTTP プロキシまたはロード バランサーを経由して Web サーバーに接続しているクライアントの発信元 IP アドレスを識別することがよくあります。 既存の XFF ヘッダーがあった場合、Front Door はそのヘッダーにクライアント ソケット IP を追加するか、クライアント ソケット IP を使用した XFF ヘッダーを追加します。
X-Forwarded-Host X-Forwarded-Host: contoso.azurefd.net
X-Forwarded-Host HTTP ヘッダー フィールドは、Host HTTP 要求ヘッダー内でクライアントによって要求された元のホストを識別するために一般的に使用される方法です。 これは、要求を処理するバックエンド サーバーによって Azure Front Door からのホスト名が異なる場合があるからです。 以前の値は Azure Front Door によってオーバーライドされます。
X-Forwarded-Proto X-Forwarded-Proto: http
X-Forwarded-Proto HTTP ヘッダーフィールドは、HTTP 要求の発信元のプロトコルを識別するために使用されることがよくあります。 Front Door は構成に基づいて、HTTPS を使用してバックエンドと通信する場合があります。 これは、リバース プロキシへの要求が HTTP である場合でも当てはまります。 以前の値は Front Door によってオーバーライドされます。
X-FD-HealthProbe X-FD-HealthProbe HTTP ヘッダー フィールドは、Front Door からの正常性プローブを識別するために使用されます。 このヘッダーが 1 に設定されている場合、要求は正常性プローブからのものです。 X-Forwarded-Host ヘッダー フィールドの特定の値によって Front Door からのアクセスを制限するために使用できます。

Front Door からクライアントへ

バックエンドから Azure Front Door に送信されるすべてのヘッダーも、クライアントにそのまま渡されます。 また、Front Door では、クライアントに対するすべての応答に以下のヘッダーが添付されます。

ヘッダー 例と説明
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
これは Front Door によって処理される要求を識別する一意の参照文字列です。アクセス ログの検索に使用されるため、トラブルシューティングには非常に重要です。
X-Cache X-Cache: このヘッダーは、要求のキャッシュの状態を示します。 詳細については、Azure Front Door でのキャッシュに関するページを参照してください。

省略可能なデバッグ応答ヘッダー

X-Azure-DebugInfo: 1 要求ヘッダーを送信し、次の省略可能な応答ヘッダーを有効にする必要があります。

ヘッダー 例と説明
X-Azure-OriginStatusCode X-Azure-OriginStatusCode: 503
このヘッダーには、バックエンドによって返される HTTP 状態コードが含まれています。 このヘッダーを使用すると、バックエンド ログを経由せずにバックエンドで実行中のアプリケーションによって返される HTTP 状態コードを識別できます。 この状態コードは、Front Door によってクライアントに送信される応答の HTTP 状態コードとは異なる場合があります。 このヘッダーを使用すると、バックエンドが誤動作しているかどうか、または Front Door サービスに問題があるかどうかを判断できます。
X-Azure-InternalError このヘッダーには、要求を処理するときに Azure Front Door に発生するエラー コードが含まれます。 このエラーは、問題が Azure Front Door サービス/インフラストラクチャの内部にあることを示します。 サポートに問題を報告してください。
X-Azure-ExternalError X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar
このヘッダーは、要求を処理するバックエンド サーバーへの接続を確立しているときに Front Door サーバーで発生したエラー コードを示しています。 このヘッダーは、Front Door とバックエンド アプリケーションの間の接続に関する問題を特定するのに役立ちます。 このヘッダーには、バックエンドに対する接続の問題を特定するのに役立つ詳細なエラー メッセージが含まれます (たとえば、DNS 解決、無効な証明書など)。

次のステップ