Lokale Konfiguration - Failproof AI

Failproof AI trennt die Richtlinienauswahl von Maschinen- und Daemon-Einstellungen. Dadurch bleiben die Repository-Richtlinienentscheidungen überprüfbar, während Anmeldedaten und Daemon-Zustand außerhalb des Repositorys gespeichert werden.

Einen Richtlinienbereich wählen

Dashboard
CLI

Führen Sie failproofai ohne Argumente aus, um das lokale Richtlinien-Dashboard zu öffnen. Wählen Sie den Benutzer-, Projekt- oder lokalen Bereich, bevor Sie eine Richtlinie aktivieren, damit die Änderung in die gewünschte Konfigurationsdatei geschrieben wird.

Benutzer gilt projektübergreifend auf dieser Maschine.
Projekt gehört zum Repository und kann eingecheckt werden.
Lokal überschreibt ein Projekt für einen Benutzer und sollte in der .gitignore bleiben.

failproofai policy add block-rm-rf --scope user
failproofai policy add block-force-push --scope project
failproofai policy add warn-large-file-write --scope local
failproofai policies

Nicht jedes Harness unterstützt den lokalen Bereich. Die CLI lehnt einen Bereich ab, den das ausgewählte Harness nicht abbilden kann.

Bereich	Richtlinien-Konfigurationsdatei
Projekt	`<project>/.failproofai/policies-config.json`
Lokal	`<project>/.failproofai/policies-config.local.json`
Benutzer	`~/.failproofai/policies-config.json`

Aktivierte Richtlinien werden als Vereinigung zusammengeführt. Für Richtlinienparameter wird der erste Bereich verwendet, der Parameter für die jeweilige Richtlinie definiert – in der Reihenfolge Projekt → Lokal → Benutzer. Bei expliziten benutzerdefinierten Richtlinienpfaden wird ebenfalls der erste Bereich verwendet, der diese definiert.

Richtlinienparameter konfigurieren

Dashboard
CLI

Öffnen Sie die Richtlinie im lokalen Dashboard, bearbeiten Sie die unterstützten Parameter und speichern Sie im gewählten Bereich. Führen Sie dann eine passende und eine nicht passende Agentenaktion aus und überprüfen Sie die Entscheidung unter Beobachten → Richtlinie.

Bearbeiten Sie die policies-config.json des gewählten Bereichs und führen Sie anschließend failproofai policies aus, um unbekannte Richtliniennamen oder Parameterschlüssel anzuzeigen.

{
  "enabledPolicies": ["block-rm-rf", "block-force-push"],
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Die Maschinendateien verstehen

~/.failproofai enthält separate Dateien für separate Vertrauensbereiche:

Pfad	Zweck
`config.json`	Nicht-geheime Daemon-, Audit- und Telemetrie-Einstellungen
`credentials.json`	Cloud-Anmeldedaten; mit ausschließlichen Eigentümerberechtigungen gespeichert
`policies-config.json`	Benutzerbereich: integrierte Auswahl, Parameter und explizite benutzerdefinierte Pfade
`policies/`	Benutzerkonventions-Richtlinien und Cloud-verwaltete Richtlinien-Artefakte
`hook-activity/`	Lokales Protokoll der Richtlinienentscheidungen
`state/`	Daemon-Spool, Zustand für Gesundheit, Pause und Laufzeit

Verwenden Sie FAILPROOFAI_HOME, um das vollständige Maschinenverzeichnis für einen Container oder isolierten Test an einen anderen Ort zu verschieben. Verschieben Sie einzelne Zustandsverzeichnisse nicht unabhängig voneinander.

Checken Sie credentials.json niemals ein. Checken Sie Projekt-Richtlinienkonfigurationen und Projektkonventions-Richtlinien erst ein, nachdem Sie diese als Durchsetzungscode überprüft haben.

​Einen Richtlinienbereich wählen

​Richtlinienparameter konfigurieren

​Die Maschinendateien verstehen

Einen Richtlinienbereich wählen

Richtlinienparameter konfigurieren

Die Maschinendateien verstehen