infisical/agent-vaultHTTP-прокси и хранилище учетных данных для AI-агентов, таких как Claude Code, OpenClaw, Hermes, пользовательских агентов + обвязок и многого другого.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13673/44535c3b743fabeae983d55743aede6bd9a4f33398d242d40b02e53addfd03ec.png" alt="Agent Vault" />
</p>
<p align="center"><strong>HTTP-прокси и хранилище учётных данных</strong></p>
<p align="center">
Прокси-брокер учётных данных с открытым исходным кодом от <a href="https://infisical.com">Infisical</a>, располагающийся между вашими агентами и API, которые они вызывают.<br>
Агенты не должны владеть учётными данными. Agent Vault устраняет риск кражи учётных данных с помощью брокерского доступа.
</p>
<p align="center">
<strong>Новичок? В <a href="https://infisical.com/blog/agent-vault-the-open-source-credential-proxy-and-vault-for-agents">анонсирующем блог-посте</a> изложена полная история Agent Vault.</strong>
</p>
<p align="center">
<a href="https://docs.agent-vault.dev">Документация</a> | <a href="https://docs.agent-vault.dev/installation">Установка</a> | <a href="https://docs.agent-vault.dev/tutorial">Руководство</a> | <a href="https://youtu.be/AkyMmDSX8b4">Видеодемонстрация</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="Демонстрация Agent Vault" />
</p>
## Зачем нужен Agent Vault
Традиционное управление секретами предполагает возврат учётных данных обратно в ваши приложения и сервисы. Это перестаёт работать с AI-агентами, которых с помощью [инъекции промптов](https://en.wikipedia.org/wiki/Prompt_injection) можно обманом заставить раскрыть секреты. Это проблема **кражи учётных данных** (credential exfiltration).
Agent Vault был создан для решения проблемы кражи учётных данных для всех AI-агентов. Вместо того чтобы передавать AI-агентам учётные данные напрямую, вы храните их в Agent Vault (например, `ANTHROPIC_API_KEY`, `GITHUB_PAT` и т.д.) и заставляете свои агенты маршрутизировать HTTP-запросы через него. Agent Vault перехватывает каждый запрос и добавляет к нему учётные данные перед отправкой запроса целевому внешнему API.
Возможности:
- **Брокер учётных данных**: Предоставьте AI-агентам доступ к целевым сервисам (поставщикам LLM, GitHub и т.д.) без хранения реальных учётных данных у агентов. Agent Vault осуществляет такой доступ, заменяя фиктивные значения в заголовках (например, `__anthropic_api_key__`) на реальные учётные данные или полностью заменяя заголовки аутентификации в исходящих запросах.
- **[Подключаемые хранилища учётных данных](https://github.com/infisical/agent-vault/blob/main/docs/learn/credential-stores.mdx)**: Подключите внешнее хранилище секретов, например [Infisical](https://infisical.com), вместо локального зашифрованного хранилища. Это расширяет возможности Agent Vault, включая такие функции, как [динамические секреты](https://infisical.com/docs/documentation/platform/dynamic-secrets/overview) от Infisical.
- **Прозрачная интеграция**: Позвольте AI-агентам использовать существующие инструменты (MCP, CLI, SDK, API) — все базовые запросы будут автоматически маршрутизироваться через Agent Vault. Agent Vault использует интерфейсно-независимый, неинвазивный подход к брокерству учётных данных, устанавливая переменную окружения `HTTPS_PROXY` в среде агентов и обеспечивая совместимость с архитектурой MITM Agent Vault.
- **Целенаправленная архитектура**: Существующие прямые прокси (например, `mitmproxy` или `squid`) требуют доработки для выполнения брокерства учётных данных и хорошей интеграции с агентами. Agent Vault специально спроектирован для взаимодействия с эргономикой всех типов сценариев использования агентов: выделенный CLI, мультиарендность и дорожная карта, ориентированная на агентов, при поддержке [Infisical](https://github.com/Infisical/infisical).
- **Фильтрация исходящего трафика**: Контролируйте, какие агенты имеют доступ к каким сервисам и конечным точкам API, поскольку аутентифицированные запросы проходят через Agent Vault.
- **Логирование запросов**: Анализируйте аутентифицированный трафик для мониторинга и диагностики поведения агентов.
По умолчанию запросы, не соответствующие ни одному сервису, передаются как обычный прокси-трафик; переключите хранилище в режим строгого запрета (`unmatched_host_policy=deny`), чтобы отклонять их с кодом 403.
Полную предысторию Agent Vault читайте [здесь](https://infisical.com/blog/agent-vault-the-open-source-credential-proxy-and-vault-for-agents).
## Варианты использования
Agent Vault работает со всеми видами сценариев использования AI-агентов, включая безопасные удалённые агенты кодирования, универсальные агенты, пользовательские агенты + обвязки, безопасные эфемерные песочницы и многое другое.
- Безопасные удалённые агенты кодирования: Вы можете запустить удалённую сессию Claude Code и настроить её на проксирование запросов через Agent Vault. В рамках такой настройки можно установить `ANTHROPIC_API_KEY` и `GITHUB_PAT` в Agent Vault, что позволит Claude Code взаимодействовать с API Anthropic и GitHub для написания кода, создания PR и т.д. Тот же принцип применим и к другим агентам кодирования.
- Безопасные универсальные агенты: Вы можете настроить OpenClaw, Hermes и других универсальных агентов на проксирование исходящих запросов через Agent Vault.
- Безопасные пользовательские агенты: Вы можете создавать собственных AI-агентов с пользовательскими обвязками и настраивать их на проксирование исходящих запросов через Agent Vault.
- Безопасные эфемерные песочницы: Вы можете настроить оркестратор (например, бэкенд) на выпуск временного токена, который передаётся в песочницу агента для проксирования запросов через Agent Vault. Можно даже организовать, чтобы агент в песочнице отправлял запрос обратно тому же бэкенду, который его запустил.
## Базовое использование
Agent Vault — это одновременно хранилище и прокси-сервис, поставляемый в виде одного бинарного файла, который выполняет функции сервера и CLI-клиента. Он хранит учётные данные и предоставляет их вашим AI-агентам через архитектуру MITM-прокси. По замыслу, Agent Vault должен развёртываться на отдельной машине, отличной от машин с AI-агентами, чтобы обеспечить гарантию безопасности: AI-агенты не смогут напрямую получить доступ к учётным данным, хранящимся в Agent Vault.
```
┌─────────────────────────────────────────────────────────────────┐
│ Публичный интернет │
│ │
│ api.anthropic.com api.github.com api.stripe.com ... │
│ ▲ ▲ ▲ │
└──────────┼───────────────────┼──────────────────┼───────────────┘
│ │ │
└───────────────────┼──────────────────┘
│ исходящий HTTPS, Agent Vault
│ добавляет учётные данные на выходе
┌──────────────────────────────┼──────────────────────────────────┐
│ Частная сеть │ │
│ │ │
│ ┌───────────────────────────┴────┐ ┌────────────────────┐ │
│ │ Agent Vault │ │ AI-агент │ │
│ │ :14321 интерфейс управления │◀────│ HTTPS_PROXY= │ │
│ │ :14322 MITM-прокси │ │ agent-vault:14322 │ │
│ └────────────────▲───────────────┘ └────────────────────┘ │
│ │ │
└───────────────────┼─────────────────────────────────────────────┘
│ доступ оператора: держите приватным или
│ обеспечьте TLS + аутентификацию (обратный
│ прокси SSO, белый список IP или VPN),
│ если нужен удалённый администринг
│
Оператор
```
Вы можете настроить Agent Vault на брокерство учётных данных для AI-агентов всего за несколько шагов:
1. [Установите](https://docs.agent-vault.dev/installation) и запустите сервер Agent Vault. Вы можете выполнить скрипт ниже для установки Agent Vault на macOS (Intel + Apple Silicon) и Linux (x86_64 + ARM64):
```bash
curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh
```
Запустите сервер Agent Vault и задайте для него мастер-пароль (сохраните его в надёжном месте); пароль используется как часть [механизма шифрования данных](https://docs.agent-vault.dev/learn/security) и удаляется из процесса после первого чтения.
```bash
export AGENT_VAULT_MASTER_PASSWORD=your-password
agent-vault server -d
```
Вы также можете развернуть Agent Vault с помощью 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
```
Сервер запускает HTTP API на порту `14321` и прозрачный HTTP/HTTPS-прокси на порту `14322`; один и тот же обработчик принимает запросы `CONNECT` для вышестоящих серверов `https://` и прямые прокси-запросы в абсолютной форме для вышестоящих серверов `http://`.
Веб-интерфейс становится доступен по адресу `http://<host>:14321`, и вам будет предложено создать первого пользователя — **владельца** экземпляра.
2. Создайте [хранилище](https://docs.agent-vault.dev/learn/vaults), введите [учётные данные](https://docs.agent-vault.dev/learn/credentials) и настройте [правила сервисов](https://docs.agent-vault.dev/learn/services) в Agent Vault через веб-интерфейс управления или через CLI на машине с Agent Vault. Например, вы можете создать учётные данные для `ANTHROPIC_API_KEY` и создать правило сервиса, чтобы Agent Vault заменял фиктивное значение `__anthropic_api_key__` на реальный ключ.
3. Создайте [агента](https://docs.agent-vault.dev/agents/overview) для представления долгоживущего агента и получите для него **токен**. Либо, если вы запускаете эфемерных агентов в песочницах, используйте [агента](https://docs.agent-vault.dev/agents/overview) для представления оркестратора бэкенда и с его помощью выпустите краткосрочный **токен**, который будет передан в песочницу для использования агентом и проксирования запросов через Agent Vault.
4. Установите следующие переменные окружения в среде вашего 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__ // фиктивный ключ, который будет заменён Agent Vault
```
5. [Установите](https://docs.agent-vault.dev/installation) CLI Agent Vault в среду вашего агента и запустите CLI Agent Vault вместе с вашим агентом, чтобы начать проксирование запросов через Agent Vault.
```bash
curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh
```
### Проверка загруженных бинарных файлов релиза
Архивы релизов, опубликованные из этого рабочего процесса, содержат аттестацию сборки, привязанную к запуску GitHub Actions, который их создал. Проверьте с помощью CLI `gh` (без дополнительных инструментов и управления ключами):
```bash
gh attestation verify agent-vault_*.tar.gz --repo Infisical/agent-vault
```
`checksums.txt` также покрывается той же аттестацией, а его подпись cosign продолжает проверяться с помощью `cosign verify-blob` для пользователей, предпочитающих этот путь.
```bash
agent-vault run -- claude
agent-vault vault run -- agent
agent-vault vault run -- codex
agent-vault vault run -- opencode
```
Кроме того, если ваш агент работает с Docker, вы можете установить CLI Agent Vault через Dockerfile, скопировав бинарный файл в ваш образ и используя его для запуска процесса агента:
```dockerfile
# Добавьте эту строку в ваш существующий Dockerfile рядом с настройкой агента или приложения.
COPY --from=infisical/agent-vault:latest /usr/local/bin/agent-vault /usr/local/bin/agent-vault
...
ENTRYPOINT ["agent-vault", "run", "--", "claude"]
```
Существует множество способов развернуть Agent Vault и интегрировать с ним ваших AI-агентов. Рекомендуем ознакомиться с полной [документацией](https://docs.agent-vault.dev/installation).
## Посмотрите в действии
Посмотрите, как Agent Vault осуществляет брокерство учётных данных для AI-агентов: сохраните ключи один раз, маршрутизируйте каждый исходящий запрос через прокси и позвольте агентам вызывать реальные API, не видя ни одного секрета.
<p align="center">
<a href="https://youtu.be/AkyMmDSX8b4">
<img src="https://assets.kitploit.com/production/public/readmes/13673/a6504c2af8f0f1a5875f6dbea16a21cabebb07029ec05d7d82fbc6c826da788c.png" alt="Смотреть: агенты не должны видеть ваши секреты" />
</a>
</p>
Хотите полное руководство по развёртыванию? Обратитесь к разделу [Запуск Hermes на VPS](https://docs.agent-vault.dev/guides/hermes-on-vps) для полного примера с брокерским агентом на отдельной машине.
## Лучшие практики
1. Безопасность:
- Развёртывайте Agent Vault как отдельный сервис на отдельной хост-машине, отличной от машин с AI-агентами, чтобы предотвратить возможность использования общего хоста для получения доступа к Agent Vault.
- Держите порт прокси (по умолчанию 14322), в который внедряются учётные данные в исходящие запросы, приватным для сети ваших агентов. Интерфейс управления на порту 14321 безопаснее открывать, если вам нужен удалённый администринг, но всё равно укрепляйте его как любой производственный веб-сервис (TLS, белый список IP). Обратитесь к [examples/nginx-public-ui-proxy/](https://github.com/infisical/agent-vault/blob/main/examples/nginx-public-ui-proxy) за рабочим примером.
2. Задержка: Размещайте Agent Vault в одной сети с вашими AI-агентами, чтобы снизить задержку запросов.
3. Токены: Создайте [агента](https://docs.agent-vault.dev/agents/overview) в Agent Vault для представления долгоживущего агента. Для эфемерных песочниц вы можете предпочесть выпускать краткосрочные токены, ограниченные хранилищем, для использования агентами в песочницах при проксировании запросов через Agent Vault.
## PostgreSQL (Продакшн)
По умолчанию Agent Vault хранит всё состояние в локальной базе данных SQLite, которая не требует настройки. Для продакшн-развёртываний или при запуске нескольких экземпляров установите переменную окружения `DATABASE_URL` (или флаг `--database-url`) в строку подключения PostgreSQL, и Agent Vault переключится на Postgres как на своё хранилище. Все экземпляры используют одну и ту же базу данных, поэтому состояние согласовано между репликами.
Перенесите существующие данные с помощью `agent-vault migrate-db --to postgres://...` перед переключением. См. [руководство по PostgreSQL](https://docs.agent-vault.dev/self-hosting/postgres) для примеров развёртывания (Kubernetes, Docker Compose), заметок по архитектуре и операционных деталей.
## SDK
Agent Vault предоставляет TypeScript SDK на случай, если вы захотите, чтобы оркестратор выпускал краткосрочный токен и передавал конфигурацию прокси в агента в песочнице для проксирования запросов через 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", // токен агента
address: "http://localhost:14321",
});
const session = await av
.vault("my-vault")
.sessions.create({ vaultRole: "proxy" });
// certPath — путь, по которому вы смонтируете сертификат CA внутри песочницы.
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;
// Передайте `env` как переменные окружения и смонтируйте `caCert` по пути `certPath`
// в вашей песочнице — Docker, Daytona, E2B, Firecracker или любой другой среде выполнения.
// После настройки агент внутри просто вызывает API обычным образом:
// fetch("https://api.github.com/...") — без SDK, без необходимости в учётных данных.
```
См. полную документацию в [README TypeScript SDK](https://github.com/infisical/agent-vault/blob/main/sdks/sdk-typescript/README.md).
## Разработка
```bash
make build # Сборка фронтенда + Go-бинарника
make test # Запуск тестов
make web-dev # Vite dev-сервер с горячей перезагрузкой (порт 5173)
make dev # Go + Vite dev-серверы с горячей перезагрузкой
make docker # Сборка Docker-образа
```
## Open-source и платная версия
Этот репозиторий доступен под [лицензией MIT expat](https://github.com/Infisical/infisical/blob/main/LICENSE), за исключением каталога `ee`, который будет содержать премиальные корпоративные функции, требующие лицензии Infisical.
Если вы заинтересованы в Infisical или хотите изучить более коммерческий путь для Agent Vault, посетите [наш сайт](https://infisical.com/) или [запишитесь на встречу с нами](https://infisical.cal.com/vlad/infisical-demo).
## Вклад
Будь то большие или маленькие изменения, мы любим вклад. Agent Vault следует тем же правилам участия, что и Infisical.
Ознакомьтесь с нашим руководством, чтобы узнать, как [начать](https://infisical.com/docs/contributing/getting-started).
Не знаете, с чего начать? Вы можете:
- Присоединиться к нашему <a href="https://infisical.com/slack">Slack</a> и задать нам любые вопросы там.
## Мы нанимаем!
Если вы читаете это, велика вероятность, что вам нравятся продукты, которые мы создали.
Возможно, вы станете отличным дополнением к нашей команде. Мы быстро растём и будем рады, если вы [присоединитесь к нам](https://infisical.com/careers).
---
> **Предварительная версия.** Agent Vault находится в активной разработке, и API может меняться. Пожалуйста, ознакомьтесь с [документацией по безопасности](https://docs.agent-vault.dev/learn/security) перед развёртыванием.