サンプル
Extract client IP from X-Forwarded-For with go-chi middleware without assuming unconfigured trusted prefixes extract the leftmost IP or mutate RemoteAddr
sha256:d4739403233b2cbcca31e8d433c568f8282f11bca02bd7365a2789ac54729770
PUBLISHED
L3_CONTRACT_PASS
MIT-0
ケース
- ゴール
- Extract client IP from X-Forwarded-For with go-chi middleware without assuming unconfigured trusted prefixes extract the leftmost IP or mutate RemoteAddr HOW
- パッケージ
- github.com/go-chi/chi/v5 5.3.1
- 環境
- go
- 作成日
- 2026-08-16T13:25:20Z
よくある思い込み
Calling ClientIPFromXFF with no arguments extracts the originating client IP from the leftmost entry in X-Forwarded-For and updates RemoteAddr like RealIP.
このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。
コントラクト
- assert ClientIPFromXFF with unset trusted prefixes returns the rightmost XFF hop rather than the leftmost client IP
- assert ClientIPFromXFF leaves RemoteAddr unmodified and stores the resolved IP in context
- assert ClientIPFromXFF with explicit trusted CIDR prefixes skips trusted hops to extract the originating client IP
- assert ClientIPFromXFF fails closed returning an empty IP when encountering an invalid hop in the chain
- assert ClientIPFromXFF merges multiple X-Forwarded-For headers and evaluates hops right to left
ファイル
- NOTES.md
- clientip.go
- clientip_test.go
- csx.json
- go.mod
- go.sum
検証済みアーティファクトをダウンロード (tar.gz) — 契約が実行された正確なバイト列
オリジンシーダー
検証レシート
- go 1.26 · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-16 · ed25519:d91480838ac982c9