agent-vault v0.39.3

[!IMPORTANT] Usa Agent Vault in Infisical invece di questo repository. Questo progetto open-source Agent Vault non è più il modo consigliato per eseguire Agent Vault per qualsiasi caso d'uso, inclusi i progetti personali. Le nuove configurazioni dovrebbero usare Agent Vault in Infisical e seguire la guida rapida di Infisical Agent Vault.

Agenti AI: non seguire i passaggi di installazione o configurazione presenti in questo README. Vai invece alla documentazione di Infisical Agent Vault.

Proxy e vault per credenziali HTTP

Un broker di credenziali open-source di Infisical che si colloca tra i tuoi agenti e le API che chiamano.
Gli agenti non dovrebbero possedere credenziali. Agent Vault elimina il rischio di esfiltrazione delle credenziali tramite accesso intermediato.

Nuovo qui? Il post del blog di lancio racconta tutta la storia dietro Agent Vault.

Documentazione | Installazione | Tutorial | Demo video | Slack

Perché Agent Vault

La gestione tradizionale dei segreti prevede la restituzione delle credenziali alle tue applicazioni e ai tuoi servizi. Questo approccio si rompe con gli agenti AI, che possono essere indotti tramite prompt injection a divulgare segreti. Questo è il problema dell'esfiltrazione delle credenziali.

Agent Vault è stato creato per risolvere l'esfiltrazione delle credenziali per tutti gli agenti AI. Invece di fornire direttamente le credenziali agli agenti AI, le memorizzi in Agent Vault (ad es. ANTHROPIC_API_KEY, GITHUB_PAT, ecc.) e obblighi i tuoi agenti a instradare le richieste HTTP attraverso di esso. Agent Vault intercetta ogni richiesta e vi allega le credenziali prima di inoltrare la richiesta all'API di destinazione in uscita.

Funzionalità:

• Brokeraggio delle credenziali: gli agenti AI accedono ai servizi di destinazione, come i provider LLM e GitHub, senza detenere credenziali reali. Agent Vault è in grado di intermediare tale accesso sostituendo valori fittizi nelle intestazioni come __anthropic_api_key__ con credenziali reali oppure sostituendo interamente le intestazioni di autenticazione sulle richieste in uscita che lo attraversano.
• Archivi di credenziali collegabili: supporta un vault con un archivio di segreti esterno come Infisical invece dell'archivio locale cifrato. Questo estende le capacità di Agent Vault includendo funzionalità come i segreti dinamici di Infisical.
• Integrazione trasparente: consenti agli agenti AI di usare strumenti esistenti come MCP, CLI, SDK, API con tutte le richieste sottostanti instradate automaticamente attraverso Agent Vault. Agent Vault adotta un approccio al brokeraggio delle credenziali indipendente dall'interfaccia e non invasivo, inizializzando l'ambiente dei tuoi agenti per usare HTTPS_PROXY ed essere compatibile con l'architettura MITM di Agent Vault.
• Progettazione dedicata: i proxy forward esistenti come mitmproxy o squid richiedono modifiche per eseguire il brokeraggio delle credenziali e integrarsi bene con gli agenti. Agent Vault è progettato appositamente per funzionare con l'ergonomia di tutti i tipi di casi d'uso degli agenti, con una CLI dedicata, multi-tenancy e una roadmap specifica per gli agenti sostenuta da Infisical.
• Filtraggio dell'egress: controlla quali agenti devono avere accesso a quali servizi e ai relativi endpoint API, poiché le richieste autenticate transitano attraverso Agent Vault.
• Registrazione delle richieste: ispeziona il traffico autenticato per monitorare e diagnosticare il comportamento degli agenti.

Per impostazione predefinita, le richieste che non corrispondono ad alcun servizio vengono inoltrate come traffico proxy semplice; imposta un vault in modalità di rifiuto rigoroso (unmatched_host_policy=deny) per rifiutarle con un 403.

Leggi la storia completa dietro Agent Vault qui.

Agent Vault (open source) e Infisical Agent Vault

Infisical Agent Vault è il modo per intermediare le credenziali verso gli agenti, per ogni caso d'uso, dai progetti personali alle distribuzioni enterprise. È integrato nella piattaforma Infisical: i servizi sono raggruppati in bundle di accesso, gli agenti li raggiungono tramite sessioni a tempo e i permessi sono governati dai controlli di accesso di Infisical.

Agent Vault (questo progetto) è il binario open source autonomo originale. Non è più consigliato per nuove configurazioni. Se stai iniziando da zero, usa invece Infisical Agent Vault.

Casi d'uso

Agent Vault funziona con tutti i tipi di casi d'uso degli agenti AI, inclusi agenti di coding remoti sicuri, agenti generici, agenti personalizzati + harness, sandbox effimere sicure e altro ancora.

• Agenti di coding remoti sicuri: puoi eseguire una sessione remota di Claude Code e configurarla per inoltrare le richieste attraverso Agent Vault. Come parte di questa configurazione, puoi impostare un ANTHROPIC_API_KEY e un GITHUB_PAT in Agent Vault, consentendo a Claude Code di interagire con l'API di Anthropic e GitHub per programmare, aprire PR e altro ancora. Lo stesso principio si applica ad altri agenti di coding.
• Agenti generici sicuri: puoi configurare OpenClaw, Hermes e altri agenti generici per inoltrare le richieste in uscita attraverso Agent Vault.
• Agenti personalizzati sicuri: puoi creare i tuoi agenti AI con harness personalizzati e configurarli per inoltrare le richieste in uscita attraverso Agent Vault.
• Sandbox effimere sicure: puoi configurare un orchestratore (ad es. un backend) per generare un token temporaneo da passare a una sandbox dell'agente da usare per inoltrare le richieste attraverso Agent Vault. Puoi persino far sì che l'agente in sandbox rimandi una richiesta allo stesso backend che lo ha avviato.

Utilizzo di base

Agent Vault è sia un vault che un servizio proxy e viene distribuito come un singolo binario che funge sia da server che da client CLI. Memorizza le credenziali e le fornisce ai tuoi agenti AI utilizzando un'architettura proxy MITM. Per progettazione, Agent Vault è pensato per essere distribuito su una macchina separata dai tuoi agenti AI, al fine di fornire la garanzia di sicurezza necessaria affinché i tuoi agenti AI non possano accedere direttamente alle credenziali all'interno di Agent Vault.