Sicherheitsmodell
Die Idee in drei Sätzen: Menschen weisen sich mit einem Schlüssel in Hardware aus, und wie viel dieser Nachweis zählt,
ist sein Level. Ein Agent liefert nur Daten: Er schlägt vor, die Policy entscheidet wie bei einem Menschen, und
riskante Aktionen brauchen immer einen zweiten Menschen mit Level presence. Wer freigibt, sieht eine Anzeige, die
sein eigener Client aus signierten Daten rendert, und genau diese Anzeige wird signiert.
Was Agenten können und was nicht
Abschnitt betitelt „Was Agenten können und was nicht“| Ein Agent-Lauf kann | Ein Agent-Lauf kann nicht |
|---|---|
die Aktionen aus der mayPropose-Liste seines Triggers vorschlagen, aus dem signierten Katalog | etwas außerhalb dieser Liste oder des Katalogs vorschlagen |
mit explain fragen, was der Kern entscheiden würde | seinen eigenen Vorschlag freigeben, oder überhaupt eine riskante Aktion |
| Metriken, Logs, Traces und Kubernetes-Objekte innerhalb eines Budgets lesen, geschwärzt | Secrets lesen; in Produktion lesen, außer du hast dort agent-read aktiviert |
höchstens mit den Rechten des Nutzers handeln, für den er handelt, gedeckelt auf device | presence erreichen oder sein Token-, Vorschlags- und Zeitbudget überschreiten |
| Text schreiben, den die oder der Freigebende als ungeprüfte Behauptung sieht | die Fakten, den Plan oder die Anzeige ändern, die die oder der Freigebende signiert |
Ein Reviewer-Agent kann safe- und routine-Aktionen unter den Profilen starter und standard entscheiden, nie
risky-Aktionen, und unter strict berät er nur.
Reichweite eines Fehlers
Abschnitt betitelt „Reichweite eines Fehlers“- Pro Aktion: Das Parameterschema und die CEL-Bedingungen des Katalogs begrenzen jeden Parameter (zum Beispiel kann ein Volume nur wachsen, innerhalb der Obergrenze der Umgebung).
- Pro Umgebung: Rollen lassen sich auf Umgebungen beschränken, und die Policy entscheidet pro Umgebung, was von selbst läuft.
- Pro Lauf: Budgets für Tokens, Läufe pro Tag, Vorschläge pro Lauf und Zeit.
- Pro Playbook:
maxSharedeckelt den Anteil eines Clusters, der auf einmal angefasst wird. - Pro Change-Fenster: Freezes und aufgebrauchte Error Budgets stoppen Changes.
- Destruktive Aktionen brauchen ein ausgewähltes oder eingetipptes Ziel, werden nie wiederholt und gehen nie als Notfall-Change.
Wo Freigaben geprüft werden
Abschnitt betitelt „Wo Freigaben geprüft werden“Bei Aktionen, die ein Node ausführt (Podman, Host, k3s, Kubernetes, Cluster API), prüft der Node die Op selbst: die Signatur gegen den Roster, den er gepinnt hat (einen älteren Roster lehnt er ab), den gepinnten Katalog und die Risikoklasse, den Plan, die Rahmen im Roster und jeden Playbook-Schritt gegen die freigegebene Expansion. Ein kompromittierter Kern kann dort Arbeit zurückhalten oder verzögern, aber er kann einen Node nicht dazu bringen, eine riskante Op auszuführen, die kein Mensch freigegeben hat.
Bei Aktionen gegen APIs Dritter (Hetzner Cloud, Forgejo, Alertmanager, Observability, MCP-Server) führt ein Treiber die Op im Kern aus, und der Kern ist der Prüfpunkt. Freigaben von Agenten kann der Node noch nicht prüfen. Beides steht im Bedrohungsmodell.
Assurance-Profile
Abschnitt betitelt „Assurance-Profile“Eine Einstellung wählt einen stimmigen Satz von Voreinstellungen. Das Krypto-Profil ist in allen dreien gleich; Profile ändern, wie viel Nachweis verlangt wird, nie, welche Algorithmen verwendet werden.
starter (Standard von init) | standard | strict | |
|---|---|---|---|
| Geräte-Level beim Paaren | die Behauptung des Clients zählt | nicht attestierte Schlüssel gedeckelt auf device; presence braucht Attestierung | jedes Gerät attestiert |
| Quorum für riskante Aktionen | Owner oder Operator mit presence, ein Freigebender ≠ Vorschlagender | ebenso | zwei Freigebende ≠ Vorschlagender, verschiedene Personen |
| Agenten als Freigebende | dürfen safe/routine entscheiden | dürfen safe/routine entscheiden | nur beratend |
| Gültigkeit einer Freigabe | 24 h | 1 h | 15 min |
| Standard-Changes, Solo-Modus | erlaubt, als gelockert angezeigt | auditierte Abschwächungen | abgelehnt |
Unter strict darf eine explizite Einstellung nur verschärfen; sonst verweigert der Kern den Start. Das Profil
anzuheben bewertet jedes gepaarte Gerät neu, und vaicoa-core check listet, wer was nicht mehr freigeben kann, bevor
die Änderung greift. Das Profil ist in den Roster signiert, also setzen es auch die Nodes durch.
Krypto-Profil
Abschnitt betitelt „Krypto-Profil“Vaicoa folgt der BSI TR-02102: nur TLS 1.3 mit AES-GCM-Suites und den Gruppen P-384 und P-256, Schlüssel mit ECDSA P-256/P-384, SHA-256/384, AES-256-GCM, HKDF-SHA-256; IPsec (IKEv2) statt WireGuard. Nicht verwendet: Ed25519, X25519, ChaCha20-Poly1305, WireGuard, age. Jede Verbindung zwischen zwei Vaicoa-Komponenten verwendet dieses Profil ohne Ausnahme und lehnt jeden RSA-Schlüssel in der Kette der Gegenseite ab.
Zwei dokumentierte Abweichungen:
- RSA ≥ 2048 Bit nur für TLS-Gegenstellen Dritter (Container-Registries, Object Stores, MCP-Server, Push-Dienste, der Webhost des Release-Feeds, Identity Provider, Webhooks). TR-02102-2 verlangt 3000 Bit. Ein Test schlägt fehl, wenn diese Konfiguration irgendwo anders auftaucht. Inhalte, die über eine solche Verbindung geholt werden, werden per Signatur oder Digest geprüft.
- TLS 1.2 für den S3-Client des Backups des Kerns.
Schlüssel können in PKCS#11 (HSMs, YubiKeys), der Secure Enclave und dem Android Keystore liegen. Der IKE-Schlüssel des Kerns ist vorerst eine Datei.
Release-Integrität
Abschnitt betitelt „Release-Integrität“Jedes Release soll SHA256SUMS, deren ECDSA-P-256-Signatur und CycloneDX-SBOMs pro Artefakt tragen. Der eingebaute
Katalog ist mit dem Release-Schlüssel signiert und vom Kern und den Nodes gepinnt. Updates kommen über einen
signierten Release-Feed mit Anti-Rollback-Prüfung; jeder Node prüft ein Update gegen seinen eigenen gepinnten
Release-Schlüssel, und das Binary, das ein Update installiert, ist nie dasjenige, das aktualisiert wird. Der
Release-Schlüssel ist noch nicht erzeugt.
Eine Schwachstelle melden
Abschnitt betitelt „Eine Schwachstelle melden“Vertraulich per E-Mail an security@mitjamartini.com (security.txt), nicht in einem
öffentlichen Issue. Eingangsbestätigung binnen 3 Werktagen, eine erste Einschätzung binnen 10, koordinierte
Offenlegung mit Nennung; Details und die Safe-Harbour-Bedingungen stehen in der SECURITY.md des Repositorys.