Envoy 1.40.0 업그레이드: 빌드·인증 헤더·TLS 점검

Envoy 1.40.0의 빌드 전환과 인증 헤더 전달 변경을 반영하고 HTTP/3, 기본 PQC 키 교환, Rust 확장의 업그레이드 영향을 점검한다.

2026-10-22

업그레이드 범위를 빌드와 요청 경로에서 가른다

Envoy 1.40.0의 mcp_router는 다운스트림 요청 헤더를 백엔드에 기본 전달하지 않는다. 기존에 전달되던 authorization도 여기에 포함된다. 커스텀 빌드에서는 WORKSPACE가 제거됐다. 따라서 업그레이드 준비는 현재 배포가 어떤 빌드 설정과 헤더 전달 동작에 의존하는지 확인하는 데서 시작해야 한다.

이 글의 기준은 **envoyproxy/envoy v1.40.0 (2026-10-13)**이다. 변경 근거는 Envoy v1.40.0 릴리스 노트이며, 적용 범위는 사용하는 기능에 따라 나뉜다. Envoy를 직접 빌드한다면 빌드 전환을, mcp_router를 쓴다면 백엔드 인증 경로를, Rust 동적 모듈을 유지한다면 SDK 변경을 각각 점검해야 한다.

아래 그림은 현재 사용 방식에서 어떤 검증 경로가 필요한지 보여 준다. 여러 기능을 함께 쓴다면 해당 경로를 모두 검증 대상으로 잡는다.

⤢✕현재 배포커스텀 빌드mcp_routerRust 동적 모듈TLS와 연결 운영MODULE.bazel과 빌드 플래그백엔드별 헤더 전달HttpFilter와 내부 가변성PQC·CPU 감지·드레인

커스텀 빌드는 모듈과 도구 체인을 함께 바꾼다

WORKSPACE 기반 구성을 유지한 채 버전만 올리는 방식은 사용할 수 없다. Envoy, API, 문서가 각각 envoy, envoy_api, envoy-docs라는 Bazel 모듈로 배포되므로 다운스트림 빌드도 MODULE.bazel로 옮겨야 한다.

여기서 빠뜨리기 쉬운 조건은 레지스트리다. BCR과 함께 Envoy 커스텀 레지스트리인 https://raw.githubusercontent.com/envoyproxy/bazel-registry를 등록해야 한다. Envoy 의존성과 패치된 모듈 중 상당수가 이 레지스트리에만 배포되기 때문이다. 모듈 파일을 작성한 뒤에는 의존성 해석이 실제로 완료되는지부터 확인한다.

빌드 설정을 옮길 때는 CI와 로컬 빌드 설정에서 다음 항목을 함께 대조한다.

점검 대상 1.40.0의 변경 적용할 작업
Bazel 구성 WORKSPACE 제거, bzlmod 전환 MODULE.bazel로 이전하고 BCR과 Envoy 커스텀 레지스트리 등록
Hermetic LLVM/Clang 18에서 22로 변경 새 도구 체인으로 커스텀 빌드 검증
Clang 선택 --config=clang, clang-local 제거 Clang/libc++ 기본값에 맞춰 기존 선택 설정 제거
표준 라이브러리 선택 --@envoy//bazel:libc++, libstdc++ 플래그와 force_libcpp define 제거 제거된 설정에 대한 의존 확인
Wasm 런타임 엔진 선택 플래그 변경 새 proxy-wasm-cpp-host 엔진 선택 플래그로 교체
SSL 라이브러리 AWS-LC 선택과 --config=aws-lc-fips 제거 해당 선택을 사용하는 빌드 수정

GCC는 --config=gcc로 선택할 수 있다. 호스트 LLVM 도구 체인이 필요한 다운스트림은 릴리스 노트가 지목한 bazel/tests/codeql을 기준으로 구성을 확인한다. ppc64le 빌드는 --config=openssl을 사용해야 한다.

Wasm 엔진 선택은 단순한 권장 사항 변경이 아니다. 기존 --define wasm= 또는 --define engine= 플래그는 빌드를 실패시킨다. 자료에 명시된 새 플래그 형식은 다음과 같다. <engine>은 사용할 엔진 값으로 바꾸는 자리다.

--@proxy-wasm-cpp-host//bazel:engine=<engine>

빌드 전환의 완료 기준은 설정 파일의 수정 여부가 아니라 새 모듈 해석과 커스텀 빌드의 성공이다. 기존 플래그를 CI가 계속 주입하고 있지 않은지도 함께 확인해야 한다.

MCP 백엔드 인증은 헤더 전달 정책부터 확인한다

mcp_router를 사용하는 배포에서는 백엔드가 클라이언트의 authorization을 받아 인증하는지 먼저 확인한다. 1.40.0에서는 다운스트림 요청 헤더가 기본 전달되지 않으므로, 기존 인증 경로가 이 전달에 의존했다면 업그레이드 후 동작도 달라진다.

전달 정책은 새로 추가된 **백엔드별 header_forwarding**으로 지정한다. 릴리스 노트는 forward_all: true로 이전 동작을 복원할 수 있다고 명시한다. 다만 이 설정은 authorization만을 위한 선택이 아니라 전체 헤더 전달을 복원하는 선택이다. 백엔드마다 필요한 전달 범위를 검토한 뒤 적용해야 한다.

아래 비교는 다운스트림 요청이 같아도 백엔드가 받는 헤더는 기본값과 명시적 설정에 따라 달라진다는 점을 보여 준다.

⤢✕다운스트림 요청 헤더authorization 포함기존 동작1.40.0 기본값백엔드별 header_forwardingforward_all: true백엔드로 전달백엔드로 기본 미전달

적용 확인은 Envoy 설정을 읽는 데서 끝내지 않는다. 실제 MCP 요청으로 백엔드가 기대한 인증 헤더를 받는지, 인증 처리가 성립하는지 확인한다. 다운스트림 요청에 헤더가 존재한다는 사실만으로 백엔드 전달까지 확인한 것으로 처리해서는 안 된다.

MCP 필터 자체에도 라우트별 설정, 프로토콜 버전 강제, 필수 클라이언트 기능 지정 등이 추가됐다. JSON/REST 브리지를 사용하는 경우에는 헤더 및 프로토콜 버전 검증과 템플릿 변수를 통한 경로 탐색 방지 변경도 검증 범위에 넣는다. mcp_router의 헤더 전달 변경과 브리지의 검증 변경은 각각 사용하는 경로에서 확인해야 한다.

HTTP/3 안정화와 기본 PQC 적용을 따로 검증한다

HTTP/3와 QUIC은 1.40.0에서 stable이 됐다. 업스트림 HTTP/3와 모든 QUIC 확장도 포함된다. QUIC 리스너에는 클라이언트 인증서 기반 mTLS 지원이, 업스트림 QUIC에는 클라이언트 인증서 지원이 추가됐으며 P-384/P-521 ECDSA 곡선도 지원한다.

이 변경은 해당 기능을 도입하거나 기존 구성을 다시 평가할 근거다. 하지만 stable이라는 상태만으로 현재 인증서 구성과 연결 경로의 검증을 대신할 수는 없다. HTTP/3 또는 QUIC을 사용하는 경로에서는 실제 업스트림 연결과 클라이언트 인증서 사용 여부를 기준으로 확인 범위를 정한다.

TLS 기본값 변경도 별도로 다뤄야 한다. X25519MLKEM768 하이브리드 키 교환이 업스트림과 다운스트림 TLS의 기본 ECDH 곡선에 추가됐다. FIPS 빌드도 포함된다. HTTP/3를 새로 도입하지 않더라도 TLS 기본값 변경은 점검 대상이다.

아래 도식은 프로토콜 안정화와 TLS 기본값 변경의 적용 범위를 나란히 놓는다. HTTP/3 사용 여부만으로 PQC 점검 대상을 좁히지 않기 위한 구분이다.

⤢✕ HTTP/3 안정화와 TLS 기본값 변경의 점검 범위 비교 축: 변경 내용 · 적용 범위 · 확인 대상 HTTP/3·QUIC 변경 내용 stable 전환 적용 범위 업스트림 HTTP/3와 모든 QUIC 확장 포함 확인 대상 실제 업스트림 연결과 클라이언트 인증서 사용 여부 기본 PQC 키 교환 변경 내용 기본 ECDH 곡선에 X25519MLKEM768 추가 적용 범위 업스트림·다운스트림 TLS와 FIPS 빌드 확인 대상 양쪽 TLS 연결의 핸드셰이크 Envoy 1.40.0 업그레이드: 빌드·인증 헤더·TLS 점검

기본 PQC 적용에 대해서는 양쪽 TLS 연결의 핸드셰이크를 확인한다. 릴리스 노트에는 envoy.reloadable_features.pqc_default_ecdh_curves로 되돌릴 수 있다고 명시돼 있다. 기본 곡선 변경을 검증하는 배포에서는 이 런타임 기능 이름을 되돌림 검증 항목에도 기록해 둔다.

AWS-LC 선택 제거와 FIPS 빌드의 PQC 기본 적용은 서로 다른 변경이다. 기존 --config=aws-lc-fips 제거를 반영했다고 해서 TLS 기본값 검증까지 완료되는 것은 아니다.

Rust 필터는 수신자 변경과 가변 상태를 함께 수정한다

Rust SDK의 HttpFilter 훅은 &mut self 대신 &self를 받는다. 기존 구현이 훅 안에서 스트림별 상태를 직접 변경했다면 메서드 시그니처와 상태 보관 방식을 함께 수정해야 한다. 릴리스 노트가 요구하는 방향은 스트림별 가변 상태를 내부 가변성 뒤로 옮기는 것이다.

이 변경은 동기식 필터 체인 해제 시 발생하는 use-after-free를 막기 위한 것이다. 따라서 컴파일 오류를 없애는 작업과 필터 해제 상황의 동작 확인을 함께 잡아야 한다. 사용하는 HttpFilter 훅을 대조하고, 각 훅에서 변경하는 상태를 확인한 뒤 새 수신자 형식에 맞춰 수정한다.

검증에서는 일반 요청 처리와 함께 동기식 필터 체인 해제가 일어나는 경로를 다룬다. 수정한 상태 접근과 해제 경로가 정상 작동하는지 관찰해야 SDK 전환을 마쳤다고 볼 수 있다.

동적 모듈 전반에는 지연된 HTTP 필터 파괴, 수명 및 뷰 관련 수정, 콜아웃 재진입 수정도 포함됐다. 모듈 로딩은 RTLD_NOW를 사용하며 로드 실패가 로그에 기록된다. 업그레이드 후에는 요청 처리 전에 모듈이 실제로 로드됐는지부터 확인하고, 실패했다면 해당 로그를 확인한다.

CPU 감지와 연결 종료를 배포 검증에 넣는다

빌드와 요청 처리가 정상이어도 워커 수와 연결 종료 동작은 별도로 확인해야 한다. 1.40.0에서는 컨테이너를 고려한 CPU 감지가 --concurrency를 지정하지 않은 경우 기본 적용된다. 릴리스 노트에 따르면 1.37의 동작은 --cpuset-threads가 있을 때만 활성화됐다.

현재 배포가 --concurrency를 생략한다면 업그레이드 전후 실제 워커 수를 확인한다. 이전 버전에서 컨테이너 CPU 감지를 사용했다고 판단한 근거가 무엇이었는지도 함께 대조한다.

드레인은 응답마다 종료 여부를 조회하는 방식에서 드레인 시작 시 연결로 종료 결정을 전달하는 이벤트 기반 방식으로 바뀌었다. Mongo, Redis, Thrift, generic proxy의 인바운드 전용 드레인 수정도 포함된다. 해당 프록시를 사용한다면 드레인 시작 후 연결이 의도대로 종료되는지 검증한다.

UDP 핫 리스타트에서는 부모가 기존 UDP 프록시 세션을 유지하고, 알 수 없는 세션의 데이터그램은 자식으로 전달한다. 따라서 기존 세션 유지와 새 세션 전달을 나눠 관찰해야 한다. 한쪽 통신만 확인하면 핫 리스타트 변경의 일부만 검증하게 된다.

검증 대상 해당 조건 확인할 동작
CPU 감지 --concurrency 미지정 컨테이너 CPU 감지가 반영된 실제 워커 수
이벤트 기반 드레인 드레인을 사용하는 연결 드레인 시작 후 연결 종료
인바운드 전용 드레인 Mongo·Redis·Thrift·generic proxy 사용 해당 프록시의 인바운드 드레인
UDP 핫 리스타트 UDP 프록시 사용 부모의 기존 세션 유지와 자식의 새 세션 처리

업그레이드 완료 기준은 사용하는 경로별로 남긴다. 커스텀 빌드는 새 모듈과 도구 체인으로 빌드가 성공해야 하고, MCP 백엔드는 필요한 인증 헤더를 받아야 한다. TLS 연결과 Rust 필터가 정상 작동하며, 드레인과 UDP 핫 리스타트가 기대한 연결 처리를 수행하는 것까지 확인하면 1.40.0의 주요 변경을 실제 배포 동작에 연결할 수 있다.

EnvoyBazelHTTP/3TLSMCPRust