포워드 프록시가 사용자 정의 API 헤더를 처리하는 방식

API는 API-Version 같은 사용자 정의 요청 필드에 자신의 버전을 담을 수 있습니다. 일반적인 포워드 프록시는 이름이 낯설다는 이유만으로 그 필드를 버려서는 안 됩니다. HTTP는 정의된 예외나 구성된 정책이 적용되지 않는 한 인식되지 않는 필드를 전달하도록 요구합니다.

Connection 필드는 그러한 예외 가운데 하나입니다. 다음 예시 요청을 비교해 보십시오.

API-Version: 2026-10
Connection: keep-alive

여기서 API 필드는 이 연결에 국한된 것으로 지정되지 않았습니다. 다음 예시에서는 송신자가 그 범위를 명시적으로 바꿉니다.

API-Version: 2026-10
Connection: API-Version

포워드 프록시는 전달 전에 Connection이 지명한 필드를 제거하고, 연결에 특정된 지시 자체도 제거하거나 교체합니다. 따라서 오리진을 위해 의도된 애플리케이션 헤더는 그 토큰 목록에 나타나지 않아야 합니다.

필드가 바뀌는 지점을 찾으십시오

클라이언트가 구성한 요청, 프록시가 받아서 전달한 필드, 그리고 오리진이 받은 내용을 비교하십시오. 클라이언트는 프록시가 보기 전에 헤더를 생략할 수 있고, 구성된 필터는 의도적으로 이를 제거할 수 있으며, 서버는 헤더 한도를 초과했다는 이유로 요청을 거부할 수 있습니다.

오래된 배포에서 보고된 헤더 크기 임계값만으로 조용한 제거를 추론하지 마십시오. 한도와 거부 동작은 실제 구성 요소와 설정에 속합니다. HTTP 응답과 관련 로그를 관찰 내용과 함께 보관하십시오.

일반 CONNECT 터널 안에서 종단 간 HTTPS를 쓰는 경우, 프록시는 내부 API 필드를 읽거나 선택적으로 제거할 수 없습니다. 그때 헤더 검사는 TLS 종단이나 명시적으로 신뢰된 검사 중간자에 속합니다.