Supply-Chain-Scan (Go) / govulncheck (push) Failing after 2m8s
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
54 lines
2.4 KiB
Go
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
|
|
}
|
|
}
|