Configuration locale - Failproof AI

Failproof AI sépare la sélection des politiques des paramètres de la machine et du daemon. Cela permet de garder les choix de politiques du dépôt consultables, tandis que les identifiants et l’état du daemon restent en dehors du dépôt.

Choisir une portée de politique

Tableau de bord
CLI

Exécutez failproofai sans arguments pour ouvrir le tableau de bord des politiques locales. Choisissez la portée utilisateur, projet ou locale avant d’activer une politique, afin que la modification soit enregistrée dans le fichier de configuration approprié.

Utilisateur s’applique à tous les projets de cette machine.
Projet appartient au dépôt et peut être versionné.
Local remplace un projet pour un utilisateur spécifique et doit rester ignoré par git.

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

Tous les harnais ne prennent pas en charge la portée locale. Le CLI rejette une portée que le harnais sélectionné ne peut pas représenter.

Portée	Fichier de configuration des politiques
Projet	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
Utilisateur	`~/.failproofai/policies-config.json`

Les politiques activées sont fusionnées en une union. Les paramètres de politique utilisent la première portée qui définit des paramètres pour cette politique, dans l’ordre projet → local → utilisateur. Les chemins de politiques personnalisées explicites utilisent la première portée qui les définit.

Configurer les paramètres des politiques

Tableau de bord
CLI

Ouvrez la politique dans le tableau de bord local, modifiez ses paramètres pris en charge, puis enregistrez dans la portée sélectionnée. Exécutez une action d’agent correspondante et une autre non correspondante, puis inspectez la décision dans Observer → politique.

Modifiez le fichier policies-config.json de la portée sélectionnée, puis exécutez failproofai policies pour faire apparaître les noms de politiques ou clés de paramètres inconnus.

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

failproofai policies

Comprendre les fichiers machine

~/.failproofai contient des fichiers distincts pour des périmètres de confiance séparés :

Chemin	Rôle
`config.json`	Paramètres du daemon, d’audit et de télémétrie (non sensibles)
`credentials.json`	Identifiants cloud ; stockés avec des permissions réservées au propriétaire
`policies-config.json`	Sélection des politiques intégrées de portée utilisateur, paramètres et chemins personnalisés explicites
`policies/`	Politiques de convention utilisateur et artefacts de politique gérés par le cloud
`hook-activity/`	Journal local des décisions de politique
`state/`	File d’attente du daemon, état de santé, de pause et d’exécution

Utilisez FAILPROOFAI_HOME pour déplacer l’ensemble de la structure machine vers un conteneur ou un environnement de test isolé. Ne déplacez pas les répertoires d’état individuels de façon indépendante.

Ne versionnez jamais credentials.json. Ne versionnez la configuration des politiques de projet et les politiques de convention de projet qu’après les avoir examinées en tant que code d’application des règles.

​Choisir une portée de politique

​Configurer les paramètres des politiques

​Comprendre les fichiers machine

Choisir une portée de politique

Configurer les paramètres des politiques

Comprendre les fichiers machine