Catalogo delle politiche integrate

Il pacchetto installato è la fonte di verità per la disponibilità delle politiche. Esegui failproofai policies dopo ogni aggiornamento perché le voci del catalogo e il comportamento possono cambiare con la versione del pacchetto.

Baseline consigliata

La selezione consigliata della configurazione guidata attualmente abilita i sanitizzatori di segreti, le protezioni dell’ambiente, l’auto-protezione, le protezioni dai comandi catastrofici e la sicurezza dei rami protetti:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-self-pause             block-failproofai-commands
block-sudo                   block-curl-pipe-sh
block-rm-rf                  block-push-master
block-force-push

La configurazione consigliata è deliberatamente più ristretta di Everything. Le politiche infrastrutturali e di workflow possono interrompere il lavoro valido e dovrebbero essere abilitate per i repository e le macchine che ne hanno bisogno.

Segreti e ambiente

Politica	Trigger	Risultato
`sanitize-jwt`	`PostToolUse`	Redige i JWT dall’output dello strumento prima che il modello li veda.
`sanitize-api-keys`	`PostToolUse`	Redige le chiavi comuni di OpenAI, Anthropic, GitHub, AWS, Stripe e Google.
`sanitize-connection-strings`	`PostToolUse`	Redige le stringhe di connessione ai database contenenti credenziali.
`sanitize-private-key-content`	`PostToolUse`	Redige i corpi delle chiavi private PEM.
`sanitize-bearer-tokens`	`PostToolUse`	Redige i token bearer di autorizzazione.
`protect-env-vars`	`PreToolUse` sugli strumenti shell	Blocca i comandi che dumpa le variabili d’ambiente.
`block-env-files`	`PreToolUse`	Blocca le letture e le scritture dei file `.env`.
`block-read-outside-cwd`	`PreToolUse` sugli strumenti read, glob, grep o shell	Mantiene le letture all’interno della directory di lavoro della sessione.
`block-secrets-write`	`PreToolUse` sugli strumenti di scrittura	Blocca le scritture su nomi di file comuni di chiavi segrete e credenziali.

Comandi pericolosi e infrastruttura

Politica	Trigger	Risultato
`block-self-pause`	`PreToolUse`, `PermissionRequest`	Impedisce a un agente di mettere in pausa la propria applicazione.
`block-sudo`	`PreToolUse`, `PermissionRequest`	Blocca `sudo` a meno che un pattern di allow non corrisponda.
`block-curl-pipe-sh`	`PreToolUse`	Blocca gli script scaricati incanalati direttamente a una shell.
`block-rm-rf`	`PreToolUse`	Blocca i pattern di eliminazione ricorsiva catastrofici.
`block-failproofai-commands`	`PreToolUse`	Impedisce agli agenti di modificare o disinstallare Failproof AI.
`block-kubectl`	`PreToolUse`	Controlla i comandi Kubernetes.
`block-terraform`	`PreToolUse`	Controlla i comandi Terraform e OpenTofu.
`block-aws-cli`	`PreToolUse`	Controlla i comandi AWS CLI.
`block-gcloud`	`PreToolUse`	Controlla i comandi Google Cloud CLI.
`block-az-cli`	`PreToolUse`	Controlla i comandi Azure CLI.
`block-helm`	`PreToolUse`	Controlla i comandi Helm.
`block-gh-pipeline`	`PreToolUse`	Controlla le operazioni mutanti di GitHub CLI per workflow, run, merge, release, cache e secret.

Sicurezza di Git e database

Politica	Trigger	Risultato
`block-push-master`	`PreToolUse`	Blocca i push diretti ai rami protetti configurati.
`block-force-push`	`PreToolUse`	Blocca i force-push; `--force-with-lease` rimane consentito nell’implementazione attuale.
`block-work-on-main`	`PreToolUse`	Blocca i commit e i merge su rami protetti.
`warn-git-amend`	`PreToolUse`	Avverte prima di riscrivere un commit con `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Avverte prima di eliminare o cancellare permanentemente gli stash.
`warn-all-files-staged`	`PreToolUse`	Avverte su `git add -A`, `git add .` o `git add --all` ampi.
`warn-destructive-sql`	`PreToolUse`	Avverte su `DROP`, `TRUNCATE` e `DELETE` senza `WHERE` attraverso client di database riconosciuti.
`warn-schema-alteration`	`PreToolUse`	Avverte su operazioni di rinomina e colonne `ALTER TABLE` riconosciute.

Pacchetti, comportamento del sistema e loop degli agenti

Politica	Trigger	Risultato
`warn-package-publish`	`PreToolUse`	Avverte prima di pubblicare nei registri dei pacchetti.
`warn-global-package-install`	`PreToolUse`	Avverte prima dell’installazione globale dei pacchetti.
`prefer-package-manager`	`PreToolUse`	Istruisce l’agente a utilizzare un gestore di pacchetti consentito.
`warn-large-file-write`	`PreToolUse` sugli strumenti di scrittura	Avverte oltre la soglia di dimensione del file configurata.
`warn-background-process`	`PreToolUse`	Avverte su pattern di processi in background distaccati o di lunga durata.
`warn-repeated-tool-calls`	`PreToolUse`	Avverte dopo tre o più chiamate identiche dello strumento.

Workflow di fine compito

Queste politiche richiedono un harness che emetta un evento Stop compatibile.

Politica	Risultato
`require-commit-before-stop`	Rifiuta il completamento mentre il lavoro tracciato rimane uncommitted.
`require-push-before-stop`	Rifiuta il completamento mentre i commit rimangono solo locali.
`require-pr-before-stop`	Richiede una pull request per il ramo attuale.
`require-no-conflicts-before-stop`	Richiede un merge pulito rispetto al ramo di base configurato.
`require-ci-green-before-stop`	Richiede il completamento corretto dei controlli CI di current-HEAD.

Riferimento dei parametri

Configura i parametri nell’oggetto policyParams dello scope selezionato. I tipi sono validati da ogni politica.

Politica	Parametro	Tipo e default
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; le voci contengono `regex` e `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Bloccanti infrastrutturali	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

Un pattern di allow amplia ciò che un agente può fare. Testa la tokenizzazione esatta e le varianti di comando sull’harness di destinazione prima di distribuirla su una flotta.

​Baseline consigliata

​Segreti e ambiente

​Comandi pericolosi e infrastruttura

​Sicurezza di Git e database

​Pacchetti, comportamento del sistema e loop degli agenti

​Workflow di fine compito

​Riferimento dei parametri

Baseline consigliata

Segreti e ambiente

Comandi pericolosi e infrastruttura

Sicurezza di Git e database

Pacchetti, comportamento del sistema e loop degli agenti

Workflow di fine compito

Riferimento dei parametri