mirror of
https://github.com/hanzoai/gateway.git
synced 2026-10-30 15:04:44 +00:00
Every import in this module now resolves to github.com/hanzoai/gateway/v2.
The 34 github.com/krakend/* + github.com/luraproject/lura modules that
supplied the engine and its components are vendored under internal/ and
their 91 packages rewritten onto our own path.
Why fold rather than mirror into 34 hanzoai/* repos:
- It removes the exposure outright. 34 rows leave 34 rows of go.sum to
reason about; zero modules leave nothing. `go list -m all` and go.sum
now contain no krakend/lura entry at all.
- Cross-references cannot go wrong. 28 of the 34 import lura (97 files
inside lura self-reference it). Mirroring means rewriting every one of
those to our lura, and a single miss silently links a SECOND copy of
lura into the binary. With one module that is structurally impossible.
- It creates no duplicates. These are lura-coupled gateway glue with no
consumer outside this binary; publishing 34 repos would be 34 new
things to maintain for zero second caller. internal/ makes that
guarantee mechanical — Go forbids importing it from outside this
module, so none of it can become a competing public package. Verified
no repo outside gateway imports any hanzoai/gateway/v2 subpackage.
Layout mirrors provenance so an upstream re-sync stays a diff:
luraproject/lura/v2 -> internal/lura (the engine, 20 pkgs)
krakend/krakend-<x> -> internal/plugin/<x> (28 components)
krakend/<x> -> internal/pkg/<x> (6 standalone libs)
This commit is PURELY MECHANICAL: 196 of the 197 vendored files are
byte-identical to their upstream original once the import rewrite is
applied. The single exception is bloomfilter's subpackage, which upstream
names `krakend` — the one package name that could not survive as-is; it
becomes internal/pkg/bloomfilter/register. Hand edits land separately in
the next commit so they are readable on their own.
Per `go mod vendor` semantics, dependencies' _test.go files are not
vendored. They test upstream code at a pinned version that we do not
modify, several cannot run at all from a module distribution (they need
TLS certs and compiled .so plugins upstream generates but never ships),
and one is a 100k-request stress test that exhausts the ephemeral port
range and fails every package running beside it. Fold integrity is proven
by the byte-diff above instead, which is the stronger check.
Preserved deliberately — each of these is behaviour, not branding:
- the `github.com/devopsfaith/krakend*` extra_config namespace strings
(35 of them). These are config-surface keys, not import paths;
renaming one silently stops that component finding its config. The
jose validator namespace backs `auth/validator` on 212 endpoints.
- core.KrakendVersion / KrakendUserAgent / the X-KRAKEND consts, whose
VALUES rebrand.go overwrites — that seam is unchanged.
- the KRAKEND_ koanf env prefix (a hardcoded upstream const).
- every vendored module's LICENSE (34 files, Apache-2.0/MIT).
The Makefile/CI -X paths move with the engine. An -X naming a symbol that
does not exist is silently ignored by the linker, so a stale path here
would have shipped an "undefined" version in the backend User-Agent and
X-Api-Version with a perfectly green build. Verified live:
`gateway version` reports 2.13.0, not undefined.
Verification (GOWORK=off CGO_ENABLED=0, both tag modes):
go build ./... OK go build -tags legacy ./... OK
go vet ./... clean go vet -tags legacy ./... clean
go test ./... 6/6 ok go test -tags legacy 5/5 ok
tests/ integration harness 47 fixtures pass
gateway check -c configs/{hanzo,lux}/gateway.json -> Syntax OK!
go list -m all | grep -iE 'krakend|lura' -> empty
go mod verify -> all modules verified
Co-authored-by: Hanzo Dev <[email protected]>
117 lines
3.9 KiB
Go
117 lines
3.9 KiB
Go
// Copyright © 2026 Hanzo AI. MIT License.
|
|
|
|
//go:build legacy
|
|
// +build legacy
|
|
|
|
package gateway
|
|
|
|
import (
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"testing"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"github.com/hanzoai/gateway/v2/internal/lura/core"
|
|
)
|
|
|
|
// TestProductionHeadersMiddleware is the deployed (legacy gin) edge contract:
|
|
// the response carries the white-label brand of the request Host in Server, the
|
|
// brand-neutral X-Api-Version, and the HSTS + nosniff floor; every
|
|
// framework-leaking header (X-KRAKEND, X-Powered-By) is stripped; and a lux/zoo
|
|
// caller never sees "hanzo" or the framework name.
|
|
func TestProductionHeadersMiddleware(t *testing.T) {
|
|
gin.SetMode(gin.TestMode)
|
|
|
|
// Deterministically exercise the X-Api-Version path.
|
|
saved := core.KrakendVersion
|
|
core.KrakendVersion = "2.13.0"
|
|
defer func() { core.KrakendVersion = saved }()
|
|
|
|
r := gin.New()
|
|
r.Use(ProductionHeadersMiddleware())
|
|
r.GET("/x", func(c *gin.Context) {
|
|
// Simulate the upstream SDK leaking framework headers before the write.
|
|
c.Header("X-KRAKEND", "Version 2.13")
|
|
c.Header("X-Powered-By", "hanzoai/gateway Version 2.13.0")
|
|
c.String(http.StatusOK, "ok")
|
|
})
|
|
// Streaming path: Flush BEFORE any buffered write must still stamp the posture
|
|
// and strip framework headers (exercises the prodWriter.Flush override).
|
|
r.GET("/stream", func(c *gin.Context) {
|
|
c.Header("X-KRAKEND", "Version 2.13")
|
|
c.Writer.Flush()
|
|
c.String(http.StatusOK, "chunk")
|
|
})
|
|
|
|
cases := map[string]string{
|
|
"api.hanzo.ai": "hanzo",
|
|
"api.lux.network": "lux",
|
|
"console.lux.cloud": "lux",
|
|
"api.zoo.ngo": "zoo",
|
|
"console.zoo.cloud": "zoo",
|
|
"api.pars.network": "pars",
|
|
"probe.internal": NeutralServerBrand, // unmatched -> neutral
|
|
}
|
|
for host, wantServer := range cases {
|
|
w := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodGet, "http://"+host+"/x", nil)
|
|
req.Host = host
|
|
r.ServeHTTP(w, req)
|
|
|
|
if got := w.Header().Get("Server"); got != wantServer {
|
|
t.Errorf("Host %q: Server=%q want %q", host, got, wantServer)
|
|
}
|
|
if got := w.Header().Get("X-KRAKEND"); got != "" {
|
|
t.Errorf("Host %q: X-KRAKEND leaked: %q", host, got)
|
|
}
|
|
if got := w.Header().Get("X-Powered-By"); got != "" {
|
|
t.Errorf("Host %q: X-Powered-By leaked: %q", host, got)
|
|
}
|
|
if got := w.Header().Get("X-Api-Version"); got != "2.13.0" {
|
|
t.Errorf("Host %q: X-Api-Version=%q want 2.13.0", host, got)
|
|
}
|
|
if got := w.Header().Get("X-Content-Type-Options"); got != "nosniff" {
|
|
t.Errorf("Host %q: X-Content-Type-Options=%q want nosniff", host, got)
|
|
}
|
|
if got := w.Header().Get("Strict-Transport-Security"); got == "" {
|
|
t.Errorf("Host %q: missing Strict-Transport-Security", host)
|
|
}
|
|
for _, bad := range []string{"fasthttp", "fiber", "zip", "KrakenD", "krakend", "hanzoai"} {
|
|
if w.Header().Get("Server") == bad {
|
|
t.Errorf("Host %q: Server leaked framework/brand %q", host, bad)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Streaming (Flush-before-write) response carries the posture and is stripped.
|
|
{
|
|
w := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodGet, "http://api.zoo.ngo/stream", nil)
|
|
req.Host = "api.zoo.ngo"
|
|
r.ServeHTTP(w, req)
|
|
if got := w.Header().Get("Server"); got != "zoo" {
|
|
t.Errorf("stream: Server=%q want zoo", got)
|
|
}
|
|
if got := w.Header().Get("X-KRAKEND"); got != "" {
|
|
t.Errorf("stream: X-KRAKEND leaked on Flush path: %q", got)
|
|
}
|
|
if got := w.Header().Get("X-Content-Type-Options"); got != "nosniff" {
|
|
t.Errorf("stream: missing nosniff on Flush path")
|
|
}
|
|
if got := w.Header().Get("Strict-Transport-Security"); got == "" {
|
|
t.Errorf("stream: missing HSTS on Flush path")
|
|
}
|
|
}
|
|
|
|
// lux/zoo Hosts never resolve to hanzo, even under the deployed edge.
|
|
for _, host := range []string{"api.lux.network", "console.zoo.cloud"} {
|
|
w := httptest.NewRecorder()
|
|
req := httptest.NewRequest(http.MethodGet, "http://"+host+"/x", nil)
|
|
req.Host = host
|
|
r.ServeHTTP(w, req)
|
|
if w.Header().Get("Server") == "hanzo" {
|
|
t.Errorf("Host %q leaked hanzo on the deployed edge", host)
|
|
}
|
|
}
|
|
}
|