Initiale Version: MCP-Auth-Sidecar (RFC 9728 + JWT-prüfender Proxy) #1

Merged

jochen merged 4 commits from feature/initial-sidecar into main

2026-09-26 19:20:17 +00:00

claude commented

2026-09-25 17:26:26 +00:00

Owner

Zweck

Kleiner Sidecar vor einem bestehenden MCP-Gateway. Er liefert die OAuth-Ressourcen, die MCP-Clients (z. B. Claude-Connectoren) brauchen, die FortiWeb und Keycloak allein aber nicht bereitstellen.

Inhalt

Protected Resource Metadata (RFC 9728), als Root- und Pfad-Variante
Spiegel der Keycloak-Discovery (RFC 8414), auch am Root-Pfad für ältere Clients und für „path insertion“
Proxy-Modus:
- JWT-Prüfung (RS/PS/ES/EdDSA) gegen JWKS mit Schlüsselrotation und Rate-Limit
- Prüfung von iss, aud, exp/nbf/iat und Keycloak-typ
- spec-konforme 401/403 mit WWW-Authenticate
- ungepuffertes SSE
- X-Auth-*-Identitätsheader, gefälschte Header werden entfernt
Metadata-Modus für eine token-prüfende WAF davor
Nur Go-Standardbibliothek, ohne go.sum und ohne Fremd-Code in der Supply Chain
Distroless-Containerfile mit eingebautem -healthcheck
Quadlet-Units und Env-Vorlage
kcadm-Skript für den Keycloak-Realm (Audience-Mapper, DCR-Trusted-Hosts, PKCE)
Forgejo-CI (gofmt, vet, test -race, build)

Getestet

Lokal mit Go 1.22: go vet, go test -race grün (Token, JWKS, Config, Server-Integration mit Fake-Keycloak und Fake-Gateway). Die Blob-Hashes der gepushten Dateien sind gegen den lokal getesteten Stand abgeglichen.

Nicht getestet / offen

deploy/keycloak/setup-realm.sh wurde nicht gegen ein echtes Keycloak ausgeführt. Bitte zuerst in einem Test-Realm laufen lassen.
Runner-Label docker in der CI ist eine Annahme.
Basis-Images sind noch nicht per Digest gepinnt.
Das Skript hat über die API kein Executable-Bit bekommen. Aufruf daher mit sh deploy/keycloak/setup-realm.sh oder vorher chmod +x.

Keine Datenbank, daher keine Migrationen nötig.

## Zweck Kleiner Sidecar vor einem bestehenden MCP-Gateway. Er liefert die OAuth-Ressourcen, die MCP-Clients (z. B. Claude-Connectoren) brauchen, die FortiWeb und Keycloak allein aber nicht bereitstellen. ## Inhalt - **Protected Resource Metadata** (RFC 9728), als Root- und Pfad-Variante - **Spiegel der Keycloak-Discovery** (RFC 8414), auch am Root-Pfad für ältere Clients und für „path insertion“ - **Proxy-Modus**: - JWT-Prüfung (RS/PS/ES/EdDSA) gegen JWKS mit Schlüsselrotation und Rate-Limit - Prüfung von `iss`, `aud`, `exp`/`nbf`/`iat` und Keycloak-`typ` - spec-konforme `401`/`403` mit `WWW-Authenticate` - ungepuffertes SSE - `X-Auth-*`-Identitätsheader, gefälschte Header werden entfernt - **Metadata-Modus** für eine token-prüfende WAF davor - Nur Go-Standardbibliothek, ohne `go.sum` und ohne Fremd-Code in der Supply Chain - Distroless-Containerfile mit eingebautem `-healthcheck` - Quadlet-Units und Env-Vorlage - `kcadm`-Skript für den Keycloak-Realm (Audience-Mapper, DCR-Trusted-Hosts, PKCE) - Forgejo-CI (gofmt, vet, `test -race`, build) ## Getestet Lokal mit Go 1.22: `go vet`, `go test -race` grün (Token, JWKS, Config, Server-Integration mit Fake-Keycloak und Fake-Gateway). Die Blob-Hashes der gepushten Dateien sind gegen den lokal getesteten Stand abgeglichen. ## Nicht getestet / offen - `deploy/keycloak/setup-realm.sh` wurde **nicht gegen ein echtes Keycloak** ausgeführt. Bitte zuerst in einem Test-Realm laufen lassen. - Runner-Label `docker` in der CI ist eine Annahme. - Basis-Images sind noch nicht per Digest gepinnt. - Das Skript hat über die API kein Executable-Bit bekommen. Aufruf daher mit `sh deploy/keycloak/setup-realm.sh` oder vorher `chmod +x`. Keine Datenbank, daher keine Migrationen nötig.

claude added 4 commits

2026-09-25 17:26:26 +00:00

Sidecar für MCP-OAuth: RFC-9728-Metadaten, AS-Metadaten-Spiegel, JWT-prüfender Reverse Proxy 49ab4aac36

- Protected Resource Metadata (Root- und Pfad-Variante)
- Spiegel der Keycloak-Discovery (RFC 8414, inkl. Root-Pfad für ältere Clients)
- Proxy-Modus: JWT-Prüfung (RS/PS/ES/EdDSA) gegen JWKS mit Rotation,
  spec-konforme 401/403-Challenges, ungepuffertes SSE, Identitäts-Header
- Metadata-Modus für den Betrieb hinter einer token-prüfenden WAF
- Nur Go-Standardbibliothek, distroless Containerfile, Quadlet-Units,
  Keycloak-Setup-Skript, Forgejo-CI

Server, Proxy und Tests (Token, JWKS-Rotation, 401/403, Spoofing, SSE) 1541f8630b

Integrationstests, Containerfile, Quadlet, Keycloak-Setup, CI, README 95b1432712

Keycloak-Setup-Skript und README

ci / test (pull_request) Has been cancelled

Details

4f8dfb3a3a