infisical/agent-vaultUn proxy di credenziali HTTP e vault per agenti AI come Claude Code, OpenClaw, Hermes, agenti personalizzati + harness, e altro.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13673/44535c3b743fabeae983d55743aede6bd9a4f33398d242d40b02e53addfd03ec.png" alt="Agent Vault" />
</p>
<p align="center"><strong>Proxy di credenziali HTTP e vault</strong></p>
<p align="center">
Un broker di credenziali open-source di <a href="https://infisical.com">Infisical</a> che si pone tra i tuoi agenti e le API che chiamano.<br>
Gli agenti non dovrebbero possedere credenziali. Agent Vault elimina il rischio di esfiltrazione di credenziali grazie all'accesso intermediato.
</p>
<p align="center">
<strong>Nuovo qui? Il <a href="https://infisical.com/blog/agent-vault-the-open-source-credential-proxy-and-vault-for-agents">post di lancio del blog</a> racconta tutta la storia dietro Agent Vault.</strong>
</p>
<p align="center">
<a href="https://docs.agent-vault.dev">Documentazione</a> | <a href="https://docs.agent-vault.dev/installation">Installazione</a> | <a href="https://docs.agent-vault.dev/tutorial">Tutorial</a> | <a href="https://youtu.be/AkyMmDSX8b4">Video Demo</a> | <a href="https://infisical.com/slack">Slack</a>
</p>
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13673/84edf1ace4d1884e0aa043c9c798bd32b61ded32f1e3785cf85deca6285de361.gif" alt="Dimostrazione di Agent Vault" />
</p>
## Perché Agent Vault
La gestione tradizionale dei segreti prevede la restituzione delle credenziali alle tue applicazioni e servizi. Questo meccanismo viene meno con gli agenti AI, che possono essere indotti tramite prompt injection a divulgare segreti. Questo è il problema dell'esfiltrazione di credenziali.
Agent Vault è stato creato per risolvere l'esfiltrazione di 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 costringi i tuoi agenti a instradare le richieste HTTP attraverso di esso. Agent Vault intercetta ogni richiesta e vi aggiunge le credenziali prima di inoltrarla all'API di destinazione in uscita.
Funzionalità:
- **Intermediazione di credenziali**: Intermedia l'accesso degli agenti AI a servizi target come provider LLM e GitHub senza che essi detengano credenziali reali. Agent Vault è in grado di intermediare tale accesso sostituendo valori fittizi in intestazioni come `__anthropic_api_key__` con credenziali reali o sostituendo interamente le intestazioni di autenticazione nelle richieste in uscita attraverso di esso.
- **[Archivi di credenziali a innesto](https://github.com/infisical/agent-vault/blob/main/docs/learn/credential-stores.mdx)**: Supporta un vault con un archivio di segreti esterno come [Infisical](https://infisical.com) invece dell'archivio crittografato locale. Questo estende le capacità di Agent Vault per includere funzionalità come i [segreti dinamici](https://infisical.com/docs/documentation/platform/dynamic-secrets/overview) di Infisical.
- **Integrazione trasparente**: Consenti agli agenti AI di utilizzare strumenti esistenti come MCP, CLI, SDK, API con tutte le richieste sottostanti automaticamente instradate attraverso Agent Vault. Agent Vault adotta un approccio agnostico rispetto all'interfaccia e non invasivo per l'intermediazione di credenziali, avviando l'ambiente dei tuoi agenti per utilizzare `HTTPS_PROXY` ed essere compatibile con l'architettura MITM di Agent Vault.
- **Progettazione ad hoc**: I proxy forward esistenti come `mitmproxy` o `squid` richiedono modifiche per eseguire l'intermediazione di credenziali e integrarsi bene con gli agenti. Agent Vault è progettato ad hoc 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 supportata da [Infisical](https://github.com/Infisical/infisical).
- **Filtraggio in uscita**: Controlla quali agenti dovrebbero avere accesso a quali servizi ed endpoint API su di essi, poiché le richieste autenticate fluiscono 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 normale; imposta un vault in modalità di rifiuto rigoroso (`unmatched_host_policy=deny`) per rifiutarle con 403.
Leggi la storia completa dietro Agent Vault [qui](https://infisical.com/blog/agent-vault-the-open-source-credential-proxy-and-vault-for-agents).
## Casi d'uso
Agent Vault funziona con tutti i tipi di casi d'uso di agenti AI, inclusi agenti di codifica remota sicuri, agenti multiuso, agenti personalizzati + harness, sandbox effimeri sicuri e altro.
- **Agenti di codifica remota sicuri**: Puoi eseguire una sessione remota di Claude Code e configurarla per fare da proxy alle richieste attraverso Agent Vault. Come parte di questa configurazione, puoi impostare un `ANTHROPIC_API_KEY` e un `GITHUB_PAT` in Agent Vault, permettendo a Claude Code di interagire con le API di Anthropic e GitHub per scrivere codice, creare PR e altro. Lo stesso principio si applica ad altri agenti di codifica.
- **Agenti multiuso sicuri**: Puoi configurare OpenClaw, Hermes e altri agenti multiuso per fare da proxy alle richieste in uscita attraverso Agent Vault.
- **Agenti personalizzati sicuri**: Puoi costruire i tuoi agenti AI con harness personalizzati e configurarli per fare da proxy alle richieste in uscita attraverso Agent Vault.
- **Sandbox effimeri sicuri**: Puoi configurare un orchestrator (ad es. backend) per creare un token temporaneo da passare in un sandbox dell'agente da utilizzare per fare da proxy alle richieste attraverso Agent Vault. Puoi persino fare in modo che l'agente in sandbox reinvii una richiesta allo stesso backend che lo ha generato.
## Utilizzo base
Agent Vault è sia un servizio vault che proxy ed è distribuito come un singolo binario che funge sia da server che da client CLI. Memorizza le credenziali e le intermedia per i tuoi agenti AI utilizzando un'architettura proxy MITM. Per progettazione, Agent Vault dovrebbe essere distribuito su una macchina separata dai tuoi agenti AI per fornire la garanzia di sicurezza necessaria affinché i tuoi agenti AI non possano accedere direttamente alle credenziali all'interno di Agent Vault.
```
┌─────────────────────────────────────────────────────────────────┐
│ Public internet │
│ │
│ api.anthropic.com api.github.com api.stripe.com ... │
│ ▲ ▲ ▲ │
└──────────┼───────────────────┼──────────────────┼───────────────┘
│ │ │
└───────────────────┼──────────────────┘
│ outbound HTTPS, Agent Vault
│ injects credentials on the way out
┌──────────────────────────────┼──────────────────────────────────┐
│ Private network │ │
│ │ │
│ ┌───────────────────────────┴────┐ ┌────────────────────┐ │
│ │ Agent Vault │ │ AI agent │ │
│ │ :14321 management UI / API │◀────│ HTTPS_PROXY= │ │
│ │ :14322 MITM proxy │ │ agent-vault:14322 │ │
│ └────────────────▲───────────────┘ └────────────────────┘ │
│ │ │
└───────────────────┼─────────────────────────────────────────────┘
│ operator access: keep private, or front
│ with TLS + auth (SSO reverse proxy, IP
│ allowlist, or VPN) if you need remote admin
│
Operator
```
Puoi configurare Agent Vault per intermediare le credenziali per un agente AI in pochi passaggi:
1. [Installa](https://docs.agent-vault.dev/installation) e avvia un server Agent Vault. Puoi eseguire lo script qui sotto per installare Agent Vault, supportando macOS (Intel + Apple Silicon) e Linux (x86_64 + ARM64):
```bash
curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh
```
Avvia il server Agent Vault e imposta una password master per esso (conservala in un luogo sicuro); la password viene utilizzata come parte del suo [meccanismo di crittografia dei dati](https://docs.agent-vault.dev/learn/security) e viene rimossa dal processo dopo la lettura iniziale.
```bash
export AGENT_VAULT_MASTER_PASSWORD=your-password
agent-vault server -d
```
Puoi anche distribuire Agent Vault con Docker:
```bash
docker run -it -p 14321:14321 -p 14322:14322 \
-e AGENT_VAULT_MASTER_PASSWORD=your-password \
-v agent-vault-data:/data infisical/agent-vault
```
Il server avvia l'API HTTP sulla porta `14321` e un proxy HTTP/HTTPS trasparente sulla porta `14322`; lo stesso listener gestisce `CONNECT` per upstream `https://` e richieste proxy forward in forma assoluta per upstream `http://`.
L'interfaccia web diventa disponibile all'indirizzo `http://<host>:14321` e ti verrà chiesto di creare il primo utente noto come **proprietario** dell'istanza.
2. Crea un [vault](https://docs.agent-vault.dev/learn/vaults), inserisci le tue [credenziali](https://docs.agent-vault.dev/learn/credentials) e configura le [regole di servizio](https://docs.agent-vault.dev/learn/services) in Agent Vault tramite l'interfaccia di gestione o tramite CLI sulla macchina Agent Vault. Ad esempio, puoi creare una credenziale per `ANTHROPIC_API_KEY` e creare una regola di servizio in modo che Agent Vault sostituisca un valore fittizio `__anthropic_api_key__` con la chiave reale.
3. Crea un [agent](https://docs.agent-vault.dev/agents/overview) per rappresentare un agente a lunga esecuzione e ottieni un **token** per esso. In alternativa, se stai creando agenti sandbox effimeri, puoi utilizzare [agent](https://docs.agent-vault.dev/agents/overview) per rappresentare un backend orchestrator e usarlo per creare un **token** di breve durata da passare nel sandbox affinché l'agente lo utilizzi e faccia da proxy alle richieste attraverso Agent Vault.
4. Imposta le seguenti variabili d'ambiente nell'ambiente del tuo agente AI:
```bash
AGENT_VAULT_ADDR=http://<your-addr>:14321
AGENT_VAULT_TOKEN=<agent-token-from-agent-vault>
AGENT_VAULT_VAULT=<vault-in-agent-vault>
...
ANTHROPIC_API_KEY=__anthropic_api_key__ // dummy key that will be substituted by Agent Vault
```
5. [Installa](https://docs.agent-vault.dev/installation) la CLI di Agent Vault nell'ambiente del tuo agente ed esegui la CLI di Agent Vault con il tuo agente per iniziare a fare da proxy alle richieste attraverso Agent Vault.
```bash
curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh
```
### Verifica dei binari di rilascio scaricati
Gli archivi di rilascio pubblicati da questo workflow sono forniti con un'attestazione di provenienza della build legata all'esecuzione di GitHub Actions che li ha prodotti. Verifica con la CLI `gh` (nessuno strumento extra, nessuna gestione delle chiavi):
```bash
gh attestation verify agent-vault_*.tar.gz --repo Infisical/agent-vault
```
Anche `checksums.txt` è coperto dalla stessa attestazione, e la sua firma cosign continua a essere verificabile con `cosign verify-blob` per gli utenti che preferiscono quella strada.
```bash
agent-vault run -- claude
agent-vault vault run -- agent
agent-vault vault run -- codex
agent-vault vault run -- opencode
```
In alternativa, se il tuo agente è in esecuzione con Docker, puoi installare la CLI di Agent Vault tramite un Dockerfile copiando il binario nella tua immagine e usandolo per avviare il processo dell'agente:
```dockerfile
# Add this line to your existing Dockerfile alongside your agent or app setup.
COPY --from=infisical/agent-vault:latest /usr/local/bin/agent-vault /usr/local/bin/agent-vault
...
ENTRYPOINT ["agent-vault", "run", "--", "claude"]
```
Ci sono molti modi per distribuire Agent Vault e integrare i tuoi agenti AI con esso. Ti consigliamo di consultare la [documentazione](https://docs.agent-vault.dev/installation) più completa.
## Vederlo in azione
Guarda come Agent Vault intermedia le credenziali per gli agenti AI: memorizza le tue chiavi una volta, instrada ogni richiesta in uscita attraverso il proxy e lascia che gli agenti chiamino API reali senza mai vedere un segreto.
<p align="center">
<a href="https://youtu.be/AkyMmDSX8b4">
<img src="https://assets.kitploit.com/production/public/readmes/13673/a6504c2af8f0f1a5875f6dbea16a21cabebb07029ec05d7d82fbc6c826da788c.png" alt="Guarda: gli agenti non dovrebbero vedere i tuoi segreti" />
</a>
</p>
Vuoi una guida completa alla distribuzione? Vedi [Run Hermes on a VPS](https://docs.agent-vault.dev/guides/hermes-on-vps) per un esempio end-to-end con un agente intermediato su una macchina separata.
## Buone pratiche
1. **Sicurezza**: Dovresti distribuire Agent Vault come servizio separato su una macchina host diversa dai tuoi agenti AI per impedire agli agenti di sfruttare un host condiviso per ottenere accesso ad Agent Vault. Dovresti mantenere la porta del proxy (14322 per impostazione predefinita), dove le credenziali vengono iniettate nelle richieste in uscita, privata alla rete dei tuoi agenti. L'interfaccia di gestione sulla porta 14321 è più sicura da esporre se hai bisogno di amministrazione remota, ma comunque rafforzala come qualsiasi servizio web di produzione (TLS, lista consentita IP). Fai riferimento a [examples/nginx-public-ui-proxy/](https://github.com/infisical/agent-vault/blob/main/examples/nginx-public-ui-proxy) per un esempio funzionante.
2. **Latenza**: Dovresti collocare Agent Vault insieme ai tuoi agenti AI all'interno della stessa rete per ridurre la latenza delle richieste.
3. **Token**: Dovresti creare un [agent](https://docs.agent-vault.dev/agents/overview) in Agent Vault per rappresentare un agente longevo. Per sandbox effimeri, potresti preferire creare token di breve durata con ambito limitato al vault per gli agenti in sandbox da utilizzare per fare da proxy alle richieste attraverso Agent Vault.
## PostgreSQL (Produzione)
Per impostazione predefinita, Agent Vault memorizza tutto lo stato in un database SQLite locale, che non richiede configurazione. Per distribuzioni in produzione, o quando si eseguono più istanze, imposta la variabile d'ambiente `DATABASE_URL` (o il flag `--database-url`) con una stringa di connessione PostgreSQL e Agent Vault passa a Postgres come backend. Tutte le istanze condividono lo stesso database, quindi lo stato è coerente tra le repliche. Migra i dati esistenti con `agent-vault migrate-db --to postgres://...` prima di passare. Consulta la [guida PostgreSQL](https://docs.agent-vault.dev/self-hosting/postgres) per esempi di distribuzione (Kubernetes, Docker Compose), note sull'architettura e dettagli operativi.
## SDK
Agent Vault offre un SDK TypeScript nel caso in cui desideri che un orchestrator crei un token di breve durata e passi la configurazione del proxy in un agente in sandbox in modo che possa fare da proxy alle richieste attraverso Agent Vault.
```bash
npm install @infisical/agent-vault-sdk
```
```typescript
import { AgentVault, buildProxyEnv } from "@infisical/agent-vault-sdk";
const av = new AgentVault({
token: "YOUR_TOKEN", // agent token
address: "http://localhost:14321",
});
const session = await av
.vault("my-vault")
.sessions.create({ vaultRole: "proxy" });
// certPath is where you'll mount the CA certificate inside the sandbox.
const certPath = "/etc/ssl/agent-vault-ca.pem";
// env: { HTTPS_PROXY, HTTP_PROXY, NO_PROXY, NODE_USE_ENV_PROXY,
// SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, REQUESTS_CA_BUNDLE,
// CURL_CA_BUNDLE, GIT_SSL_CAINFO, DENO_CERT }
const env = buildProxyEnv(session.containerConfig!, certPath);
const caCert = session.containerConfig!.caCertificate;
// Pass `env` as environment variables and mount `caCert` at `certPath`
// in your sandbox — Docker, Daytona, E2B, Firecracker, or any other runtime.
// Once configured, the agent inside just calls APIs normally:
// fetch("https://api.github.com/...") — no SDK, no credentials needed.
```
Vedi il [README dell'SDK TypeScript](https://github.com/infisical/agent-vault/blob/main/sdks/sdk-typescript/README.md) per la documentazione completa.
## Sviluppo
```bash
make build # Compila frontend + binario Go
make test # Esegui i test
make web-dev # Server di sviluppo Vite con ricarica automatica (porta 5173)
make dev # Server di sviluppo Go + Vite con ricarica automatica
make docker # Crea immagine Docker
```
## Open-source vs. a pagamento
Questo repository è disponibile sotto la [licenza MIT expat](https://github.com/Infisical/infisical/blob/main/LICENSE), ad eccezione della directory `ee` che conterrà funzionalità enterprise premium che richiedono una licenza Infisical.
Se sei interessato a Infisical o a esplorare un percorso più commerciale per Agent Vault, dai un'occhiata al [nostro sito web](https://infisical.com/) o [prenota un incontro con noi](https://infisical.cal.com/vlad/infisical-demo).
## Contribuire
Che sia grande o piccolo, amiamo i contributi. Agent Vault segue le stesse linee guida per i contributi di Infisical.
Dai un'occhiata alla nostra guida per vedere come [iniziare](https://infisical.com/docs/contributing/getting-started).
Non sai da dove iniziare? Puoi:
- Unirti al nostro <a href="https://infisical.com/slack">Slack</a> e farci qualsiasi domanda lì.
## Stiamo assumendo!
Se stai leggendo questo, è molto probabile che ti piacciano i prodotti che abbiamo creato. Potresti anche essere un'ottima aggiunta al nostro team. Stiamo crescendo velocemente e ci piacerebbe che tu ti [unissi a noi](https://infisical.com/careers).
---
> **Anteprima.** Agent Vault è in fase di sviluppo attivo e l'API è soggetta a modifiche. Si prega di rivedere la [documentazione sulla sicurezza](https://docs.agent-vault.dev/learn/security) prima di distribuire.