8.3 KiB
kind, slug, title, topic, topicName, project, status, sourceRevision, source
| kind | slug | title | topic | topicName | project | status | sourceRevision | source | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| REFERENCE | overwrite-a-forwarded-header-at-the-trust-boundary-do-not-extend-it | 신뢰 경계에서는 forwarded 헤더를 덧붙이지 않고 덮어쓴다 | lab-entry-path-and-measurement-integrity | 실험대의 진입 경로 | virtualization | 게시 전 | import-head 9465582b5d1630eb4ae7c4e078021486919bf6b6 · uncommitted-working-tree snapshot |
|
신뢰 경계에서는 forwarded 헤더를 덧붙이지 않고 덮어쓴다
맨 바깥 프록시는 클라이언트가 보낸 X-Forwarded-For를 버리고 자기가 실제로 본 주소로 덮어쓴다. nginx에서는 $proxy_add_x_forwarded_for가 아니라 $remote_addr를 쓰는 이유다. 다만 $remote_addr가 원본 client IP라는 보장은 네트워크 계층이 제공해야 한다. 현재 실험대에서는 2026-09-21 packet capture로 Tailscale MASQUERADE가 edge 앞에서 source를 192.168.122.1로 바꾸는 것을 확인했다.
forwarded 헤더가 신뢰 경계가 되는 이유
X-Forwarded-For 는 누구나 보낼 수 있는 평범한 HTTP 헤더다. 값을 믿을 만하게 만드는 것은 헤더 이름이 아니라 그 값을 쓴 주체이고, 쓰는 주체를 하나로 좁히는 것이 이 기준이다. 맨 바깥 프록시가 클라이언트의 값을 이어 붙이면 위조된 값이 사슬 앞에 남고, 그러면 뒤쪽의 어느 것도 그 헤더를 근거로 쓸 수 없다.
실제 nginx 설정에는 이 헤더를 덮어쓰는 이유가 주석으로 남아 있다.
$remote_addr, not $proxy_add_x_forwarded_for. This is the trust boundary: a client-supplied X-Forwarded-For must be discarded, not extended, or nothing downstream can rely on the value.
「이 부의 출처와 범위」에서는 설정 원본의 주석 59줄을 대조하면서 이 저장소 어디에도 없는 것 둘을 셌고, 이 설명이 그중 하나다. 「단계 03 — 엣지 nginx 라우팅과 호스트 DNAT」와 「단계 04 — Let's Encrypt 와 인증서 갱신」에서는 그 줄을 옮겨 적기만 하고 왜 그 형태여야 하는지는 적지 않았다.
경계에서는 덧붙이지 않고 덮어쓴다
1. 맨 바깥 프록시는 클라이언트가 보낸 X-Forwarded-For 를 버리고 자기가 본 주소로 덮어쓴다
nginx 에서는 proxy_set_header X-Forwarded-For $remote_addr; 이고 $proxy_add_x_forwarded_for 가 아니다. 둘의 차이는 클라이언트가 보낸 값을 사슬 앞에 남기느냐 버리느냐에 있다. proxy_set_header 가 값을 이어 붙이지 않고 덮어쓰는 지시어인 이유도 여기에 있다.
2. X-Forwarded-Proto 와 X-Forwarded-Host 도 같은 규칙으로 다룬다
셋 다 프록시가 뒤쪽 서버에게 원래 클라이언트가 어땠는지 알려 주는 관례적 헤더이고, 클라이언트가 임의로 보낼 수 있다. 하나만 덮어쓰고 나머지를 이어 붙이면, 뒤쪽 서버는 클라이언트가 보낸 값을 그대로 근거로 삼는다. 공격자가 X-Forwarded-Host 를 조작해 인증 흐름을 자기 도메인으로 돌릴 수 있는 것도 이 경로다.
3. $remote_addr를 원본 client IP로 쓰려면 경계 앞 source rewrite가 없어야 한다
우리 lab_edge DNAT 파일은 SNAT를 넣지 않는다. 하지만 2026-09-21 재검증에서 host 전체 경로는 source-preserving이 아니었다. tailscale0에서는 100.92.240.34:<port> → 100.83.212.4:443이던 요청이 edge 쪽 vnet13/enp1s0에서는 192.168.122.1:<same-port> → 192.168.122.10:443으로 보였다. host의 Tailscale ts-postrouting chain이 fwmark 0x40000 패킷에 MASQUERADE를 적용하고 있었다.
따라서 lab_edge 테이블에 SNAT가 없다는 사실과 end-to-end source IP 보존은 다른 사실이다. nginx의 proxy_set_header X-Forwarded-For $remote_addr는 여전히 client-supplied 헤더를 버린다는 trust-boundary 원칙에는 맞지만, 현재 $remote_addr 자체가 원본 Tailscale client 주소가 아니다.
4. 경계가 어디인지는 「그 앞에 우리가 통제하지 않는 것이 있는가」로 가른다
이름에 엣지가 붙었다고 해서 그 프록시가 경계가 되는 것은 아니다. 우리가 통제하지 않는 쪽에서 요청을 직접 받는 첫 프록시가 경계이고, 그 한 대만 이 기준을 따른다. 이 실험대에서는 엣지 게스트의 nginx 가 그렇고, 클라우드라면 ALB 가 같은 곳에 선다.
5. 프록시를 한 겹 더 넣거나 옮길 때 이 기준을 다시 적용한다
설정을 처음 쓸 때보다 구성을 바꿀 때 이 기준이 실제로 쓰인다. 이 실험대가 엣지를 호스트에서 게스트로 옮겼을 때 경계도 함께 옮겨 갔다. 공개 터널을 앞에 붙였다면 경계가 Cloudflare 엣지로 한 번 더 옮겨 갔을 것이다. 옮겨 간 뒤에도 옛 경계가 클라이언트의 값을 이어 붙이고 있으면 사슬은 다시 믿을 수 없게 된다.
이 규칙이 걸리는 프록시 경계
- 신뢰 경계에 선 맨 바깥 프록시 한 대. 이 실험대에서는 엣지 게스트의 nginx 이고, 클라우드라면 ALB 가 같은 곳에 선다
- 대상 헤더 :
X-Forwarded-For·X-Forwarded-Proto·X-Forwarded-Host셋. 셋 다 관례적 헤더이고 클라이언트가 임의로 보낼 수 있다 - 적용 시점 : 설정을 처음 쓸 때가 아니라 프록시를 한 겹 더 넣거나 옮길 때
- 경계 판정 : 그 프록시 앞에 우리가 통제하지 않는 것이 있을 때
내부 trusted proxy를 따로 보는 경우
경계 안쪽의 두 번째 홉은 반대다. 이 실험대의 Traefik 처럼 신뢰하는 프록시 뒤에 서는 것은 앞이 쓴 값을 이어받아야 하고, 거기서 덮어쓰면 원래 클라이언트 주소가 없어진다. $proxy_add_x_forwarded_for 자체가 틀린 값은 아니고, 쓰는 곳이 따로 정해져 있다. 경계에서 쓰면 클라이언트가 위조한 값을 그대로 통과시킨다.
두 번째 홉도 일부 재봤다. 2026-09-17에는 Traefik 기본 신뢰 설정에서 edge가 쓴 forwarded 정보가 앱까지 그대로 보존되지 않았고, 별도 trust 설정을 적용한 뒤에도 x-forwarded-for가 앱에 나타나지 않았다. 2026-09-21에는 trust 설정을 새 클러스터에 다시 적용했지만 echo 앱이 없어 최종 앱 수신 헤더까지는 재측정하지 못했다. 따라서 현재 원본 client IP 전달은 확인된 기능이 아니라 미해결 조건이다.
L4 통과 구성은 HTTP forwarded header와 다른 방식으로 client identity를 전달한다. source IP를 실제로 보존하는 구성도 있고, NAT/LB 특성상 그렇지 않으면 PROXY protocol로 원본 주소를 전달할 수 있다. 따라서 L4라는 이유만으로 원본 IP 보존을 가정하지 않고 실제 경로를 확인한다.
경계 앞에 CDN 이나 터널이 있으면 그 공급자의 헤더가 정본이 된다. Cloudflare 라면 CF-Connecting-IP 이고, 그때는 그 헤더를 놓고 이 기준을 다시 세운다.
이 기준만으로 신뢰가 완성되지 않는다. 경계 프록시를 거치지 않는 경로로 뒤쪽에 직접 닿을 수 있으면 헤더를 어떻게 쓰든 소용이 없다. 그 경로를 막는 것은 방화벽과 네트워크 배치의 일이고, 이 실험대에서는 게스트가 libvirt NAT 뒤에 있는 것이 그 몫을 한다.
이 실험대의 nginx와 Traefik
- 경계의 nginx :
proxy_set_header X-Forwarded-For $remote_addr; - 경계 안쪽 두 번째 홉 :
$proxy_add_x_forwarded_for로 앞이 쓴 값을 이어받는다 - 우리
lab_edge테이블 : DNAT만 걸고 SNAT는 두지 않는다 - host 전체 경로 : Tailscale
ts-postroutingMASQUERADE가 실제로 존재한다 - 2026-09-21 edge에서 관측한 ingress source :
192.168.122.1 - 경계 앞에 Cloudflare 가 있을 때의 정본 헤더 :
CF-Connecting-IP - 클라이언트가 보낸 값을 이어 붙인 사슬 : 위조된 값이 앞에 남아 뒤쪽에서 근거로 못 쓴다
- L4 통과 구성 : 헤더가 필요 없고 PROXY protocol 을 쓴다