Zum Inhalt springen
Ein persönliches Experiment · Alpha · Code noch nicht öffentlich · kein Angebot, kein Support Projektstatus →

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.

Ein Agent-Lauf kannEin Agent-Lauf kann nicht
die Aktionen aus der mayPropose-Liste seines Triggers vorschlagen, aus dem signierten Katalogetwas außerhalb dieser Liste oder des Katalogs vorschlagen
mit explain fragen, was der Kern entscheiden würdeseinen eigenen Vorschlag freigeben, oder überhaupt eine riskante Aktion
Metriken, Logs, Traces und Kubernetes-Objekte innerhalb eines Budgets lesen, geschwärztSecrets 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 devicepresence erreichen oder sein Token-, Vorschlags- und Zeitbudget überschreiten
Text schreiben, den die oder der Freigebende als ungeprüfte Behauptung siehtdie 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.

  • 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: maxShare deckelt 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.

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.

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)standardstrict
Geräte-Level beim Paarendie Behauptung des Clients zähltnicht attestierte Schlüssel gedeckelt auf device; presence braucht Attestierungjedes Gerät attestiert
Quorum für riskante AktionenOwner oder Operator mit presence, ein Freigebender ≠ Vorschlagenderebensozwei Freigebende ≠ Vorschlagender, verschiedene Personen
Agenten als Freigebendedürfen safe/routine entscheidendürfen safe/routine entscheidennur beratend
Gültigkeit einer Freigabe24 h1 h15 min
Standard-Changes, Solo-Moduserlaubt, als gelockert angezeigtauditierte Abschwächungenabgelehnt

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.

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.

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.

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.