Proxy-Status HTTP 응답 헤더 필드

error 매개변수의 값은 프록시 오류 유형을 나타내는 Token입니다. 존재할 경우 중개자가 이 응답을 얻는 동안 문제를 만났음을 나타냅니다.

일부 프록시 오류 유형의 존재는 응답이 원본 서버에서 전달된 것이 아니라 중개자 자체에 의해 생성되었음을 나타냅니다. 예를 들어 원본 서버에 접속할 수 없어 프록시가 자체적으로 응답을 생성해야 하는 경우가 이에 해당합니다.

다른 프록시 오류 유형은 원본 서버나 다른 인바운드 서버가 생성한(부분적일 수 있는) 응답에 추가될 수 있습니다. 예를 들어 포워드 연결이 갑자기 닫힌 경우 중개자는 트레일러 필드로 적절한 오류를 포함한 Proxy-Status를 추가할 수 있습니다.

'Response only generated by intermediaries' 값이 'true'로 등록된 프록시 오류 유형은 중개자에 의해 생성된 응답에서만 발생할 수 있음을 나타냅니다. 값이 'false'이면 응답이 중개자 또는 인바운드 서버에 의해 생성될 수 있습니다.

섹션 2.3은 이 문서에서 정의된 프록시 오류 유형을 나열하며; 새로운 유형은 섹션 2.4의 절차에 따라 정의할 수 있습니다.

HTTP/1.1 504 Gateway Timeout
Proxy-Status: ExampleCDN; error=connection_timeout

이는 이 504 응답이 포워드 시 연결 시간 초과로 인해 ExampleCDN에 의해 생성되었음을 나타냅니다.

HTTP/1.1 429 Too Many Requests
Proxy-Status: r34.example.net; error=http_request_error, ExampleCDN

이는 이 429 응답이 CDN이나 원본이 아니라 r34.example.net에 의해 생성되었음을 나타냅니다.

error 매개변수를 보낼 때는 오류 상태를 정확히 나타낼 수 있다면 가장 구체적인 프록시 오류 유형을 보내는 것이 권장됩니다(SHOULD). 적절한 유형이 정의되어 있지 않으면 proxy_internal_error, http_protocol_error 같은 일반적인 오류 유형을 사용할 수 있습니다. 이들도 적합하지 않으면 새로운 프록시 오류 유형을 등록하는 것을 고려하세요(섹션 2.4 참조).

각 프록시 오류 유형에는 권장 HTTP 상태 코드가 있습니다. error를 포함하는 HTTP 응답을 생성할 때 그 HTTP 상태 코드는 권장 코드로 설정하는 것이 바람직합니다(SHOULD). 다만 이전 동작과의 호환성 등으로 이미 상태 코드가 전송된 경우 다른 상태 코드를 사용할 수 있습니다.

프록시 오류 유형은 그 유형과 함께 사용할 수 있는 임의의 추가 매개변수를 정의할 수 있습니다. 이들의 사용은 선택 사항이며, 따라서 특정 프록시 오류 유형에 대해 정의되지 않은 추가 매개변수가 사용되면 무시됩니다.

next-hop 매개변수의 값은 이 응답을 얻기 위해 선택(및 접촉된 경우 사용)된 중개자 또는 원본 서버를 식별하는 String 또는 Token입니다. 호스트명, IP 주소 또는 별칭일 수 있습니다.

Proxy-Status: cdn.example.org; next-hop=backend.example.org:8001

이는 cdn.example.org가 이 요청의 next hop으로 backend.example.org:8001을 사용했음을 나타냅니다.

next-protocol 매개변수의 값은 중개자가 이 응답을 얻기 위해 next hop에 연결할 때 사용한 Application-Layer Protocol Negotiation (ALPN) 프로토콜 식별자를 나타냅니다(참조: [RFC7301]).

값은 TLS ALPN Protocol ID를 나타내는 Token 또는 Byte Sequence여야 하며(MUST). 프로토콜 식별자가 ASCII 인코딩으로 Token으로 표현될 수 있다면 그 형태를 사용해야 합니다(MUST).

Proxy-Status: "proxy.example.org"; next-protocol=h2

여기서는 ALPN 식별자가 사용 중인 프로토콜을 식별하는 데 사용됨을 주의하세요; 실제로 프로토콜 협상에서 사용되었는지 여부와는 무관할 수 있습니다.

received-status 매개변수의 값은 중개자가 이 응답을 얻을 때 next-hop 서버로부터 수신한 HTTP 상태 코드를 나타냅니다.

값은 정수여야 합니다(MUST).

Proxy-Status: ExampleCDN; received-status=200

details 매개변수의 값은 다른 곳에 캡처되지 않은 추가 정보를 포함하는 String입니다. 구현별 또는 배포별 정보가 포함될 수 있습니다.

Proxy-Status: proxy.example.net; error="http_protocol_error";
              details="Malformed response header: space before colon"

Name:

dns_timeout

Description:

중개자가 next-hop 호스트 이름의 IP 주소를 찾는 동안 타임아웃이 발생했습니다.

Extra Parameters:

없음

Recommended HTTP Status Code:

504

Response Only Generated by Intermediaries:

true

Reference:

RFC 9209

Name:

dns_error

Description:

중개자가 next-hop 호스트 이름의 IP 주소를 찾는 동안 DNS 오류를 만났습니다.

Extra Parameters:

rcode:

오류 유형을 나타내는 DNS RCODE를 전달하는 String입니다. 자세한 내용은 [RFC8499]의 Section 3을 참조하세요.

info-code:

Extended DNS Error Code INFO-CODE를 전달하는 Integer입니다. 자세한 내용은 [RFC8914]을 참조하세요.

Recommended HTTP Status Code:

502

Response Only Generated by Intermediaries:

true

Reference:

RFC 9209

이름:

destination_not_found

설명:

중개자가 이 요청에 사용할 적절한 다음 홉(next hop)을 결정할 수 없습니다. 예를 들어 구성되지 않았을 수 있습니다. 이 오류는 일반적으로 백엔드 서버를 식별하기 위한 특정 구성이 필요한 게이트웨이에 특화된 오류임에 유의하십시오; 포워드 프록시는 오리진 서버를 식별하기 위해 인밴드 정보를 사용합니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

500

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

destination_unavailable

설명:

중개자가 다음 홉을 사용할 수 없다고 판단합니다. 예: 최근의 통신 시도가 실패했거나 헬스 체크 결과 해당 홉이 다운된 것으로 나타날 수 있습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

503

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

destination_ip_prohibited

설명:

중개자가 다음 홉의 IP 주소로의 연결을 금지하도록 구성되어 있습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

destination_ip_unroutable

설명:

중개자가 다음 홉 IP 주소로 가는 경로를 찾을 수 없습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

connection_refused

설명:

중개자가 다음 홉으로의 연결을 시도했지만 거부되었습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

connection_terminated

설명:

중개자가 다음 홉과의 연결을 닫았으며, 완전한 응답을 받기 전에 종료되었습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

connection_timeout

설명:

중개자가 다음 홉으로의 연결을 열려고 시도했으나 시간 초과가 발생했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

504

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

connection_read_timeout

설명:

중개자가 연결(예: 응답의 일부)에서 데이터를 기대하고 있었으나 구성된 시간 내에 새로운 데이터를 받지 못했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

504

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

connection_write_timeout

설명:

중개자가 연결에 데이터를 쓰려고 시도했으나 (예: 버퍼가 가득 참) 쓸 수 없었습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

504

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

connection_limit_reached

설명:

중개자가 다음 홉으로의 연결 수를 제한하도록 구성되어 있으며, 그 한도가 초과되었습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

503

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

tls_protocol_error

설명:

중개자가 다음 홉과 통신할 때 핸드셰이크 중이거나 이후에 TLS 오류를 만났습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

주석:

TLS 경고를 수신했을 때는 적절하지 않습니다; tls_alert_received를 참조하세요.

이름:

tls_certificate_error

설명:

중개자가 다음 홉이 제시한 인증서를 검증하는 동안 오류를 만났습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

tls_alert_received

설명:

중개자가 다음 홉으로부터 TLS 경고(alert)를 수신했습니다.

추가 매개변수:

alert-id:

"TLS Alerts" 레지스트리의 해당 값을 포함하는 Integer입니다. TLS를 참조하세요.

alert-message:

"TLS Alerts" 레지스트리의 해당 설명 문자열을 포함하는 Token 또는 String입니다. TLS를 참조하세요.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_request_error

설명:

중개자가 오리진을 대신하여 클라이언트(4xx) 응답을 생성하고 있습니다. 적용 가능한 상태 코드는 400, 403, 405, 406, 408, 411, 413, 414, 415, 416, 417, 429 등을 포함하되 이에 국한되지 않습니다.

추가 매개변수:

status-code:

생성된 상태 코드를 포함하는 Integer입니다.

status-phrase:

생성된 상태 구문(status phrase)을 포함하는 String입니다.

권장 HTTP 상태 코드:

해당되는 4xx 상태 코드

중개자만 생성하는 응답:

true

참조:

RFC 9209

주석:

이 유형은 중개자가 생성한 응답과 오리진이 생성한 응답을 구별하는 데 도움이 됩니다.

이름:

http_request_denied

설명:

중개자가 구성 및/또는 정책 설정에 따라 HTTP 요청을 거부했습니다. 요청은 다음 홉으로 전달되지 않았습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

403

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

http_response_incomplete

설명:

중개자가 다음 홉으로부터 요청에 대한 불완전한 응답을 수신했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_header_section_size

설명:

중개자가 수신한 응답의 헤더 섹션이 너무 크다고 판단되었습니다.

추가 매개변수:

header-section-size:

수신된 헤더의 크기를 나타내는 Integer입니다. 헤더가 완전하지 않을 수도 있다는 점에 유의하세요; 즉 중개자가 추가 데이터를 폐기하거나 거부했을 수 있습니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_header_size

설명:

중개자가 수신한 응답에 포함된 개별 헤더 필드 라인이 너무 크다고 판단되었습니다.

추가 매개변수:

header-name:

오류를 유발한 헤더 필드의 이름을 나타내는 String입니다.

header-size:

오류를 유발한 헤더 필드의 크기를 나타내는 Integer입니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_body_size

설명:

중개자가 수신한 응답의 본문이 너무 크다고 판단되었습니다.

추가 매개변수:

body-size:

수신된 본문의 크기를 나타내는 Integer입니다. 본문이 완전하지 않을 수 있다는 점에 유의하세요; 즉 중개자가 추가 데이터를 폐기하거나 거부했을 수 있습니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_trailer_section_size

설명:

중개자가 수신한 응답의 트레일러 섹션이 너무 크다고 판단되었습니다.

추가 매개변수:

trailer-section-size:

수신된 트레일러의 크기를 나타내는 Integer입니다. 트레일러가 완전하지 않을 수 있다는 점에 유의하세요; 즉 중개자가 추가 데이터를 폐기하거나 거부했을 수 있습니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_trailer_size

설명:

중개자가 수신한 응답에 포함된 개별 트레일러 필드 라인이 너무 크다고 판단되었습니다.

추가 매개변수:

trailer-name:

오류를 유발한 트레일러 필드의 이름을 나타내는 String입니다.

trailer-size:

오류를 유발한 트레일러 필드의 크기를 나타내는 Integer입니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_transfer_coding

설명:

중개자가 응답의 전송 인코딩(transfer coding)을 디코딩하는 중에 오류를 만났습니다.

추가 매개변수:

coding:

오류를 발생시킨 특정 인코딩(“HTTP Transfer Coding Registry”의 값)을 포함하는 Token입니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_content_coding

설명:

중개자가 응답의 콘텐츠 인코딩(content coding)을 디코딩하는 중에 오류를 만났습니다.

추가 매개변수:

coding:

오류를 발생시킨 특정 인코딩(“HTTP Content Coding Registry”의 값)을 포함하는 Token입니다.

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_response_timeout

설명:

중개자가 완전한 응답을 기다리는 동안 구성된 시간 한도에 도달했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

504

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

http_upgrade_failed

설명:

중개자와 다음 홉 간의 HTTP 버전 업그레이드 협상이 실패했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

http_protocol_error

설명:

중개자가 다음 홉과 통신할 때 HTTP 프로토콜 오류를 만났습니다. 더 구체적인 오류가 정의되어 있지 않을 때에만 이 오류를 사용해야 합니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

false

참조:

RFC 9209

이름:

proxy_internal_response

설명:

중개자가 다음 홉에 연결하려 시도하지 않고 스스로 응답을 생성했습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

응답에 적합한 가장 적절한 상태 코드

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

proxy_internal_error

설명:

중개자가 오리진과 관련 없는 내부 오류를 만났습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

500

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

proxy_configuration_error

설명:

중개자가 구성과 관련된 오류를 만났습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

500

중개자만 생성하는 응답:

true

참조:

RFC 9209

이름:

proxy_loop_detected

설명:

중개자가 요청을 자기 자신으로 전달하려 했거나, 다른 방식(예: RFC8586)으로 루프가 감지되었습니다.

추가 매개변수:

없음

권장 HTTP 상태 코드:

502

중개자만 생성하는 응답:

true

참조:

RFC 9209