Catálogo de políticas integradas

El paquete instalado es la fuente de verdad para la disponibilidad de políticas. Ejecuta failproofai policies tras cada actualización, ya que las entradas del catálogo y el comportamiento pueden cambiar con la versión del paquete.

Línea base recomendada

La selección recomendada por la configuración guiada activa actualmente los sanitizadores de secretos, las protecciones de entorno, la autoprotección, las defensas contra comandos catastróficos y la seguridad de ramas protegidas:

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 está siempre activo. Se incluye arriba por completitud, pero se registra en cada evaluación independientemente de si aparece en tu conjunto habilitado, y no puede desactivarse ni pausarse — una protección contra que el agente desactive la aplicación que el propio agente puede desactivar no es una protección. La selección recomendada es deliberadamente más acotada que Todo. Las políticas de infraestructura y flujo de trabajo pueden interrumpir trabajo válido, y deben habilitarse únicamente en los repositorios y máquinas que las necesiten.

Secretos y entorno

Política	Disparador	Resultado
`sanitize-jwt`	`PostToolUse`	Redacta JWTs de la salida de las herramientas antes de que el modelo los vea.
`sanitize-api-keys`	`PostToolUse`	Redacta claves comunes de OpenAI, Anthropic, GitHub, AWS, Stripe y Google.
`sanitize-connection-strings`	`PostToolUse`	Redacta cadenas de conexión a bases de datos que contengan credenciales.
`sanitize-private-key-content`	`PostToolUse`	Redacta cuerpos de claves privadas PEM.
`sanitize-bearer-tokens`	`PostToolUse`	Redacta tokens de autorización de tipo bearer.
`protect-env-vars`	`PreToolUse` en herramientas de shell	Bloquea comandos que vuelcan variables de entorno.
`block-env-files`	`PreToolUse`	Bloquea lecturas y escrituras de archivos `.env`.
`block-read-outside-cwd`	`PreToolUse` en herramientas de lectura, glob, grep o shell	Restringe las lecturas al directorio de trabajo de la sesión.
`block-secrets-write`	`PreToolUse` en herramientas de escritura	Bloquea escrituras en nombres de archivo comunes de claves secretas y credenciales.

Comandos peligrosos e infraestructura

Política	Disparador	Resultado
`block-sudo`	`PreToolUse`, `PermissionRequest`	Bloquea `sudo` salvo que coincida un patrón de permiso.
`block-curl-pipe-sh`	`PreToolUse`	Bloquea scripts descargados y canalizados directamente a un shell.
`block-rm-rf`	`PreToolUse`	Bloquea patrones de eliminación recursiva catastróficos.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	Siempre activo, no puede desactivarse. Bloquea toda invocación del CLI de Failproof AI, autopausas y desinstalaciones mediante gestores de paquetes.
`block-kubectl`	`PreToolUse`	Controla comandos de Kubernetes.
`block-terraform`	`PreToolUse`	Controla comandos de Terraform y OpenTofu.
`block-aws-cli`	`PreToolUse`	Controla comandos del CLI de AWS.
`block-gcloud`	`PreToolUse`	Controla comandos del CLI de Google Cloud.
`block-az-cli`	`PreToolUse`	Controla comandos del CLI de Azure.
`block-helm`	`PreToolUse`	Controla comandos de Helm.
`block-gh-pipeline`	`PreToolUse`	Controla operaciones mutantes del CLI de GitHub: workflow, run, merge, release, cache y secret.

Seguridad en Git y bases de datos

Política	Disparador	Resultado
`block-push-master`	`PreToolUse`	Bloquea pushes directos a las ramas protegidas configuradas.
`block-force-push`	`PreToolUse`	Bloquea los force-pushes; `--force-with-lease` sigue siendo permitido por la implementación actual.
`block-work-on-main`	`PreToolUse`	Bloquea commits y merges en ramas protegidas.
`warn-git-amend`	`PreToolUse`	Advierte antes de reescribir un commit con `--amend`.
`warn-git-stash-drop`	`PreToolUse`	Advierte antes de eliminar o limpiar stashes de forma permanente.
`warn-all-files-staged`	`PreToolUse`	Advierte ante el uso amplio de `git add -A`, `git add .` o `git add --all`.
`warn-destructive-sql`	`PreToolUse`	Advierte ante `DROP`, `TRUNCATE` y `DELETE` sin `WHERE` en clientes de base de datos reconocidos.
`warn-schema-alteration`	`PreToolUse`	Advierte ante operaciones reconocidas de `ALTER TABLE` para columnas y renombrados.

Paquetes, comportamiento del sistema y bucles de agente

Política	Disparador	Resultado
`warn-package-publish`	`PreToolUse`	Advierte antes de publicar en registros de paquetes.
`warn-global-package-install`	`PreToolUse`	Advierte antes de instalar paquetes de forma global.
`prefer-package-manager`	`PreToolUse`	Instruye al agente para que use un gestor de paquetes permitido.
`warn-large-file-write`	`PreToolUse` en herramientas de escritura	Advierte cuando se supera el umbral de tamaño de archivo configurado.
`warn-background-process`	`PreToolUse`	Advierte ante patrones de procesos en segundo plano desacoplados o de larga duración.
`warn-repeated-tool-calls`	`PreToolUse`	Advierte tras tres o más llamadas idénticas a una herramienta.

Flujo de trabajo al final de la tarea

Estas políticas requieren un harness que emita un evento Stop compatible.

Política	Resultado
`require-commit-before-stop`	Rechaza la finalización mientras haya trabajo rastreado sin confirmar.
`require-push-before-stop`	Rechaza la finalización mientras haya commits solo en local.
`require-pr-before-stop`	Requiere un pull request para la rama actual.
`require-no-conflicts-before-stop`	Requiere un merge limpio contra la rama base configurada.
`require-ci-green-before-stop`	Requiere que las comprobaciones de CI del HEAD actual finalicen con éxito.

Referencia de parámetros

Configura los parámetros en el objeto policyParams del scope seleccionado. Los tipos son validados por cada política.

Política	Parámetro	Tipo y valor por defecto
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; las entradas contienen `regex` y `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Bloqueadores de infraestructura	`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 patrón de permiso amplía lo que un agente puede hacer. Prueba la tokenización exacta y las variantes de comandos en el harness de destino antes de desplegarlo en una flota.

​Línea base recomendada

​Secretos y entorno

​Comandos peligrosos e infraestructura

​Seguridad en Git y bases de datos

​Paquetes, comportamiento del sistema y bucles de agente

​Flujo de trabajo al final de la tarea

​Referencia de parámetros

Línea base recomendada

Secretos y entorno

Comandos peligrosos e infraestructura

Seguridad en Git y bases de datos

Paquetes, comportamiento del sistema y bucles de agente

Flujo de trabajo al final de la tarea

Referencia de parámetros