Files
nexarch/internal/mtls/gate.go
patrickandClaude Sonnet 5 692be05d2a
Supply-Chain-Scan (Go) / govulncheck (push) Failing after 2m8s
OPS-07: betriebs-gate-mtls-aktivierungspflicht-beim-wechsel-auf-verteilten-betrieb
Readiness-Warnung (internal/health.Registry.RegisterWarning) plus
internal/mtls.GateCheck erkennen verteilten Betrieb (>1 Instanz/Host) ohne
aktives mTLS und machen das als "mtls-gate"-Warnung im Readiness-Antwort-
koerper sichtbar, ohne den Dienst als "nicht bereit" zu melden. Neue
Betriebs-Checkliste (docs/BETRIEBS-CHECKLISTE-STUFENWECHSEL.md) haelt die
mTLS-Aktivierung als Pflichtschritt beim Wechsel Stufe 1 -> Stufe 2 fest,
SKALIERUNGSKONZEPT.md verweist darauf.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPsyieCYwvbUBsnN598SbP
2026-09-17 12:06:02 +02:00

54 lines
2.4 KiB
Go

package mtls
import "context"
// Topology beschreibt den aktuell erkannten Betrieb einer Modul-Instanz —
// wie viele Instanzen desselben Moduls und wie viele Hosts insgesamt
// beteiligt sind. Wird von der aufrufenden Betriebsumgebung ermittelt
// (z.B. ueber internal/moduleregistry oder eine Deployment-Konfiguration)
// und hier nur ausgewertet (Kein Umbau angrenzender Bereiche).
type Topology struct {
InstanceCount int // Anzahl laufender Instanzen DESSELBEN Moduls
HostCount int // Anzahl beteiligter Hosts insgesamt
}
// MultiInstance ist wahr, sobald mehr als eine Instanz oder mehr als ein
// Host beteiligt ist — der in OPS-07 beschriebene "verteilte Betrieb"
// (Stufe 2/3), im Unterschied zum Stufe-1-Einzel-LXC-Betrieb.
func (t Topology) MultiInstance() bool {
return t.InstanceCount > 1 || t.HostCount > 1
}
// TopologyProvider ermittelt die aktuelle Topologie zur Laufzeit.
type TopologyProvider func(ctx context.Context) (Topology, error)
// GateWarningMessage ist der im Monitoring angezeigte Warnungstext
// (Akzeptanzkriterium 1) — verweist auf die Betriebs-Checkliste fuer den
// Stufenwechsel (Akzeptanzkriterium 2).
const GateWarningMessage = "mTLS zwischen Modul-Instanzen ist bei verteiltem Betrieb (mehr als eine Instanz/mehr als ein Host) nicht aktiv. Vor dem Wechsel auf Stufe 2 aktivieren (siehe SKALIERUNGSKONZEPT.md und docs/BETRIEBS-CHECKLISTE-STUFENWECHSEL.md)."
// GateCheck ist der in OPS-07 geforderte Readiness-Zusatz-Check: erkennt
// verteilten Betrieb (mehr als eine Instanz/mehr als ein Host) ohne aktives
// mTLS zwischen Modulen und liefert dann eine Warnung
// (Akzeptanzkriterium 1). Bei Einzel-LXC-Betrieb ODER aktivem mTLS bleibt
// die Warnung aus (Akzeptanzkriterium 3). Kann direkt als
// health.WarningCheckerFunc registriert werden — bewusst ohne Abhaengigkeit
// von internal/health, damit dieses Paket eigenstaendig bleibt.
//
// Ist die Topologie nicht ermittelbar (z.B. Provider-Fehler), wird
// bewusst KEINE Warnung erzeugt (fail-open fuer diesen Zusatz-Check) — ein
// fehlschlagender Zusatz-Check darf den Readiness-Endpunkt nicht
// faelschlich als "verteilt ohne mTLS" melden.
func GateCheck(topologyFn TopologyProvider, mode Mode) func(ctx context.Context) (string, bool) {
return func(ctx context.Context) (string, bool) {
topo, err := topologyFn(ctx)
if err != nil {
return "", false
}
if topo.MultiInstance() && mode != ModeRequired {
return GateWarningMessage, true
}
return "", false
}
}