Catalogo delle policy integrate

Il pacchetto installato è la fonte autorevole per la disponibilità delle policy. 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, i guard per 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-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands è sempre attiva. È elencata sopra per completezza, ma si registra ad ogni valutazione indipendentemente dal fatto che compaia nel tuo set abilitato, e non può essere disabilitata o messa in pausa — una protezione contro l’agente che disattiva l’applicazione della normativa non è una protezione se l’agente può disattivarla. La baseline consigliata è volutamente più ristretta di Everything. Le policy di infrastruttura e workflow possono interrompere il lavoro valido e dovrebbero essere abilitate nei repository e nelle macchine che le richiedono.

Segreti e ambiente

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

Comandi pericolosi e infrastruttura

Policy	Trigger	Risultato
`block-sudo`	`PreToolUse`, `PermissionRequest`	Blocca `sudo` a meno che non corrisponda un pattern di autorizzazione.
`block-curl-pipe-sh`	`PreToolUse`	Blocca gli script scaricati reindirizzati direttamente a una shell.
`block-rm-rf`	`PreToolUse`	Blocca i pattern di eliminazione ricorsiva catastrofica.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	Sempre attiva, non può essere disabilitata. Blocca ogni invocazione della CLI di Failproof AI, l’auto-pausa e la disinstallazione del gestore di pacchetti.
`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 di workflow, run, merge, release, cache e secret di GitHub CLI che modificano lo stato.

Sicurezza Git e database

Policy	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 dall’implementazione attuale.
`block-work-on-main`	`PreToolUse`	Blocca i commit e i merge sui rami protetti.
`warn-git-amend`	`PreToolUse`	Avvisa prima di riscrivere un commit con `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Avvisa prima di eliminare o cancellare definitivamente gli stash.
`warn-all-files-staged`	`PreToolUse`	Avvisa su ampi `git add -A`, `git add .` o `git add --all`.
`warn-destructive-sql`	`PreToolUse`	Avvisa su `DROP`, `TRUNCATE` e `DELETE` senza `WHERE` attraverso i client di database riconosciuti.
`warn-schema-alteration`	`PreToolUse`	Avvisa su riconosciute operazioni di colonna e rinomina di `ALTER TABLE`.

Pacchetti, comportamento del sistema e loop dell’agente

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

Flusso di lavoro di fine attività

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

Policy	Risultato
`require-commit-before-stop`	Rifiuta il completamento mentre rimane lavoro tracciato non committato.
`require-push-before-stop`	Rifiuta il completamento mentre i commit rimangono solo locali.
`require-pr-before-stop`	Richiede una pull request per il ramo corrente.
`require-no-conflicts-before-stop`	Richiede un merge pulito contro il ramo base configurato.
`require-ci-green-before-stop`	Richiede il completamento con successo dei controlli CI dell’HEAD corrente.

Riferimento dei parametri

Configura i parametri sotto l’oggetto policyParams dello scope selezionato. I tipi sono validati da ogni policy.

Policy	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[]`, `[]`
Bloccatori infrastruttura	`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 autorizzazione amplia quello che un agente può fare. Verifica la tokenizzazione esatta e le varianti di comando sull’harness target prima di distribuirlo su una flotta.

​Baseline consigliata

​Segreti e ambiente

​Comandi pericolosi e infrastruttura

​Sicurezza Git e database

​Pacchetti, comportamento del sistema e loop dell’agente

​Flusso di lavoro di fine attività

​Riferimento dei parametri

Baseline consigliata

Segreti e ambiente

Comandi pericolosi e infrastruttura

Sicurezza Git e database

Pacchetti, comportamento del sistema e loop dell’agente

Flusso di lavoro di fine attività

Riferimento dei parametri