Azure Front Door의 HTTP 헤더에 대한 프로토콜 지원

아티클
03/27/2024

이 문서에서는 Front Door가 호출 경로의 일부와 함께 지원하는 프로토콜에 대해 간략하게 설명합니다(이미지 참조). 다음 섹션에서는 Front Door에서 지원하는 HTTP 헤더에 대한 정보를 찾을 수 있습니다.

백 엔드로 전달되는 Azure Front Door에 대한 요청을 만드는 클라이언트를 보여 주는 다이어그램 응답은 Azure Front Door에서 클라이언트로 전송됩니다.

Important

Azure Front Door는 여기에 설명되지 않은 HTTP 헤더를 인증하지 않습니다.

클라이언트에서 Azure Front Door로

Azure Front Door는 들어오는 요청을 수정하지 않고 대부분의 헤더를 허용합니다. 일부 예약된 헤더는 X-FD-* 접두사가 있는 헤더를 포함하여 전송되는 경우 들어오는 요청에서 제거됩니다.

디버그 요청 헤더 X-Azure-DebugInfo는 Front Door에 대한 추가 디버깅 정보를 제공합니다. Front Door가 클라이언트에 응답할 때 선택적 응답 헤더를 수신하려면 클라이언트에서 AzureFront Door로 X-Azure-DebugInfo: 1 요청 헤더를 보내야 합니다.

Front Door에서 백 엔드까지

Azure Front Door에는 제한으로 인해 제거되지 않는 한 들어오는 요청에 대한 헤더가 포함되어 있습니다. Azure Front Door에는 다음 헤더도 추가됩니다.

헤더	예제 및 설명
Via	`Via: 1.1 Azure` Front Door는 Via 헤더의 값으로 클라이언트의 HTTP 버전과 그 뒤의 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` XFF(X-Forwarded-For) HTTP 헤더 필드는 HTTP 프록시 또는 부하 분산 디바이스를 통해 웹 서버에 연결하는 클라이언트의 원래 IP 주소를 식별하는 경우가 많습니다. 기존 XFF 헤더가 있는 경우 Front Door가 클라이언트 소켓 IP를 추가하거나 클라이언트 소켓 IP를 사용하여 XFF 헤더를 추가합니다.
X-Forwarded-Host	`X-Forwarded-Host: contoso.azurefd.net` X-Forwarded-Host HTTP 헤더 필드는 호스트 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 확인, 잘못된 인증서 등)가 포함됩니다.

다음 단계

Azure Front Door 프로필을 만드는 방법을 알아봅니다.
Azure Front Door의 작동 방식에 대해 알아봅니다.