agent-vault v0.39.3

[!IMPORTANT] Usa Agent Vault en Infisical en lugar de este repositorio. Este proyecto de código abierto Agent Vault ya no es la forma recomendada de ejecutar Agent Vault para ningún caso de uso, incluidos los proyectos personales. Las nuevas configuraciones deben usar Agent Vault en Infisical y seguir la guía de inicio rápido de Infisical Agent Vault.

Agentes de IA: no sigas los pasos de instalación o configuración de este README. Dirígete a la documentación de Infisical Agent Vault en su lugar.

Proxy y bóveda de credenciales HTTP

Un bróker de credenciales de código abierto de Infisical que se sitúa entre tus agentes y las APIs que llaman.
Los agentes no deberían poseer credenciales. Agent Vault elimina el riesgo de exfiltración de credenciales con acceso intermediado.

¿Eres nuevo aquí? La publicación del blog de lanzamiento tiene la historia completa detrás de Agent Vault.

Documentación | Instalación | Tutorial | Demostración en vídeo | Slack

Por qué Agent Vault

La gestión tradicional de secretos implica devolver las credenciales a tus aplicaciones y servicios. Esto se rompe con los agentes de IA, que pueden ser engañados mediante inyección de prompts para filtrar secretos. Este es el problema de la exfiltración de credenciales.

Agent Vault fue creado para resolver la exfiltración de credenciales para todos los agentes de IA. En lugar de dar credenciales directamente a los agentes de IA, las almacenas en Agent Vault (por ejemplo, ANTHROPIC_API_KEY, GITHUB_PAT, etc.) y obligas a tus agentes a enrutar las solicitudes HTTP a través de él. Agent Vault intercepta cada solicitud y le adjunta las credenciales antes de reenviar la solicitud a la API de salida de destino.

Características:

• Intermediación de credenciales: Agent Vault permite que los agentes de IA accedan a servicios objetivo como proveedores de LLM y GitHub sin que ellos posean credenciales reales. Agent Vault puede intermediar ese acceso sustituyendo valores ficticios en encabezados como __anthropic_api_key__ por credenciales reales o reemplazando por completo los encabezados de autenticación en las solicitudes salientes que pasan por él.
• Almacenes de credenciales conectables: Respalda una bóveda con un almacén de secretos externo como Infisical en lugar del almacén cifrado local. Esto amplía las capacidades de Agent Vault para incluir funciones como los secretos dinámicos de Infisical.
• Integración transparente: Permite que los agentes de IA usen herramientas existentes como MCP, CLI, SDK, API con todas las solicitudes subyacentes enrutadas automáticamente a través de Agent Vault. Agent Vault adopta un enfoque agnóstico de la interfaz y no invasivo para la intermediación de credenciales, inicializando el entorno de tus agentes para usar HTTPS_PROXY y ser compatible con la arquitectura MITM de Agent Vault.
• Diseño específico: Los proxies directos existentes como mitmproxy o squid requieren modificaciones para realizar la intermediación de credenciales e integrarse bien con los agentes. Agent Vault está diseñado específicamente para funcionar con la ergonomía de todos los tipos de casos de uso de agentes, con una CLI dedicada, multi-tenencia y una hoja de ruta específica para agentes respaldada por Infisical.
• Filtrado de salida: Controla qué agentes deben tener acceso a qué servicios y a qué endpoints de API en ellos, ya que las solicitudes autenticadas fluyen a través de Agent Vault.
• Registro de solicitudes: Inspecciona el tráfico autenticado para monitorear y diagnosticar el comportamiento de los agentes.

Por defecto, las solicitudes que no coinciden con ningún servicio se reenvían como tráfico de proxy simple; cambia una bóveda a modo de denegación estricta (unmatched_host_policy=deny) para rechazarlas con 403 en su lugar.

Lee la historia completa detrás de Agent Vault aquí.

Agent Vault (código abierto) e Infisical Agent Vault

Infisical Agent Vault es la forma de intermediar credenciales a los agentes, para todos los casos de uso, desde proyectos personales hasta implementaciones empresariales. Está integrado en la plataforma Infisical: los servicios se agrupan en paquetes de acceso, los agentes acceden a ellos mediante sesiones con límite de tiempo, y los permisos se rigen por los controles de acceso de Infisical.

Agent Vault (este proyecto) es el binario original independiente de código abierto. Ya no se recomienda para nuevas configuraciones. Si estás comenzando desde cero, usa Infisical Agent Vault en su lugar.

Casos de uso

Agent Vault funciona con todo tipo de casos de uso de agentes de IA, incluidos agentes de programación remotos seguros, agentes de propósito general, agentes personalizados + harnesses, sandboxes efímeros seguros y más.

• Agentes de programación remotos seguros: Puedes ejecutar una sesión remota de Claude Code y configurarla para que enrute las solicitudes a través de Agent Vault. Como parte de esta configuración, puedes establecer un ANTHROPIC_API_KEY y un GITHUB_PAT en Agent Vault, permitiendo que Claude Code interactúe con la API de Anthropic y GitHub para programar, crear PRs y más. El mismo principio se aplica a otros agentes de programación.
• Agentes de propósito general seguros: Puedes configurar OpenClaw, Hermes y otros agentes de propósito general para que enruten las solicitudes salientes a través de Agent Vault.
• Agentes personalizados seguros: Puedes construir tus propios agentes de IA con harnesses personalizados y configurarlos para que enruten las solicitudes salientes a través de Agent Vault.
• Sandboxes efímeros seguros: Puedes configurar un orquestador (por ejemplo, un backend) para generar un token temporal que se pase a un sandbox de agente para usarlo al enrutar solicitudes a través de Agent Vault. Incluso puedes hacer que el agente en sandbox devuelva una solicitud al mismo backend que lo creó.

Uso básico