agent-vault v0.39.3

[!IMPORTANT] Use o Agent Vault no Infisical em vez deste repositório. Este projeto open-source Agent Vault já não é a forma recomendada de executar o Agent Vault para qualquer caso de uso, incluindo projetos pessoais. Novas configurações devem usar o Agent Vault no Infisical e seguir o guia de início rápido do Infisical Agent Vault.

Agentes de IA: não siga os passos de instalação ou configuração neste README. Em vez disso, vá para a documentação do Infisical Agent Vault.

Proxy e cofre de credenciais HTTP

Um broker de credenciais open-source da Infisical que fica entre os seus agentes e as APIs que eles chamam.
Os agentes não devem possuir credenciais. O Agent Vault elimina o risco de exfiltração de credenciais com acesso intermediado.

É novo por aqui? O post de lançamento no blog tem a história completa por trás do Agent Vault.

Documentação | Instalação | Tutorial | Demonstração em Vídeo | Slack

Por que o Agent Vault

A gestão tradicional de segredos envolve devolver credenciais às suas aplicações e serviços. Isso falha com agentes de IA, que podem ser enganados via prompt injection para vazar segredos. Este é o problema da exfiltração de credenciais.

O Agent Vault foi criado para resolver a exfiltração de credenciais para todos os agentes de IA. Em vez de dar credenciais diretamente aos agentes de IA, você armazena-as no Agent Vault (por exemplo, ANTHROPIC_API_KEY, GITHUB_PAT, etc.) e força os seus agentes a encaminhar pedidos HTTP através dele. O Agent Vault interceta cada pedido e anexa credenciais a ele antes de encaminhar o pedido para a API de destino de saída.

Funcionalidades:

• Credential Brokering: O Broker permite que agentes de IA acessem serviços-alvo, como provedores de LLM e GitHub, sem que eles possuam credenciais reais. O Agent Vault é capaz de intermediar esse acesso substituindo valores fictícios em cabeçalhos como __anthropic_api_key__ por credenciais reais ou substituindo cabeçalhos de autenticação inteiramente em requisições de saída que passam por ele.
• Pluggable Credential Stores: Use um armazenamento externo de segredos, como o Infisical, como backend de um vault em vez do armazenamento local criptografado. Isso amplia as capacidades do Agent Vault para incluir recursos como segredos dinâmicos do Infisical.
• Transparent Integration: Permita que agentes de IA usem ferramentas existentes como MCP, CLI, SDK e API com todas as requisições subjacentes roteadas automaticamente pelo Agent Vault. O Agent Vault adota uma abordagem agnóstica de interface e não invasiva para o broker de credenciais, inicializando o ambiente dos seus agentes para usar HTTPS_PROXY e ser compatível com a arquitetura MITM do Agent Vault.
• Purpose-Built Design: Proxies diretos existentes como mitmproxy ou squid exigem modificações para realizar o broker de credenciais e se integrar bem com agentes. O Agent Vault foi projetado especificamente para funcionar com a ergonomia de todos os tipos de casos de uso de agentes, com uma CLI dedicada, multi-tenancy e um roadmap específico para agentes apoiado pela Infisical.
• Egress Filtering: Controle quais agentes devem ter acesso a quais serviços e endpoints de API neles, já que as requisições autenticadas fluem pelo Agent Vault.
• Request Logging: Inspecione o tráfego autenticado para monitorar e diagnosticar o comportamento dos agentes.

Por padrão, requisições que não correspondem a nenhum serviço são encaminhadas como tráfego de proxy comum; altere um vault para o modo de negação estrita (unmatched_host_policy=deny) para rejeitá-las com 403.

Leia a história completa por trás do Agent Vault aqui.

Agent Vault (open source) e Infisical Agent Vault

Infisical Agent Vault é a forma de intermediar credenciais para agentes, para todos os casos de uso, de projetos pessoais a implantações empresariais. Ele é integrado à plataforma Infisical: os serviços são agrupados em pacotes de acesso, os agentes os acessam por meio de sessões com tempo limitado, e as permissões são governadas pelos controles de acesso do Infisical.

Agent Vault (este projeto) é o binário original independente e de código aberto. Ele não é mais recomendado para novas configurações. Se você está começando do zero, use o Infisical Agent Vault.

Casos de Uso

O Agent Vault funciona com todos os tipos de casos de uso de Agentes de IA, incluindo agentes remotos de codificação seguros, agentes de uso geral, agentes personalizados + harnesses, sandboxes efêmeros seguros e muito mais.

• Agentes remotos de codificação seguros: Você pode executar uma sessão remota do Claude Code e configurá-la para encaminhar requisições pelo Agent Vault. Como parte dessa configuração, você pode definir um ANTHROPIC_API_KEY e um GITHUB_PAT no Agent Vault, permitindo que o Claude Code interaja com a API da Anthropic e do GitHub para codificar, abrir PRs e muito mais. O mesmo princípio se aplica a outros agentes de codificação.
• Agentes de uso geral seguros: Você pode configurar o OpenClaw, o Hermes e outros agentes de uso geral para encaminhar requisições de saída pelo Agent Vault.
• Agentes personalizados seguros: Você pode criar seus próprios agentes de IA com harnesses personalizados e configurá-los para encaminhar requisições de saída pelo Agent Vault.
• Sandboxes efêmeros seguros: Você pode configurar um orquestrador (por exemplo, backend) para gerar um token temporário a ser passado para um sandbox de agente, a fim de usá-lo para encaminhar requisições pelo Agent Vault. Você pode até fazer com que o agente em sandbox envie uma requisição de volta ao mesmo backend que o criou.

Uso Básico

O Agent Vault é tanto um cofre quanto um serviço de proxy e é distribuído como um único binário que atua como servidor e cliente CLI. Ele armazena credenciais e as intermedeia para seus agentes de IA usando uma arquitetura de proxy MITM. Por design, o Agent Vault deve ser implantado em uma máquina separada dos seus agentes de IA para fornecer a garantia de segurança necessária para que seus agentes de IA não possam acessar diretamente as credenciais dentro do Agent Vault.