agent-vault v0.39.3

[!IMPORTANT] Используйте Agent Vault в Infisical вместо этого репозитория. Этот open-source проект Agent Vault больше не является рекомендуемым способом запуска Agent Vault для любого сценария использования, включая личные проекты. Новые установки должны использовать Agent Vault в Infisical и следовать краткому руководству по Infisical Agent Vault.

AI-агенты: не выполняйте шаги по установке или настройке из этого README. Вместо этого перейдите к документации Infisical Agent Vault.

HTTP-прокси и хранилище учётных данных

Открытый брокер учётных данных от Infisical, который находится между вашими агентами и API, которые они вызывают.
Агенты не должны обладать учётными данными. Agent Vault устраняет риск эксфильтрации учётных данных за счёт брокерского доступа.

Впервые здесь? В блог-посте о запуске изложена полная история Agent Vault.

Документация | Установка | Руководство | Видеодемонстрация | Slack

Зачем нужен Agent Vault

Традиционное управление секретами предполагает возврат учётных данных вашим приложениям и сервисам. Это ломается с AI-агентами, которых можно обмануть с помощью prompt injection и заставить раскрыть секреты. Это проблема эксфильтрации учётных данных.

Agent Vault был создан для решения проблемы эксфильтрации учётных данных для всех AI-агентов. Вместо того чтобы выдавать AI-агентам учётные данные напрямую, вы храните их в Agent Vault (например, ANTHROPIC_API_KEY, GITHUB_PAT и т. д.) и заставляете своих агентов направлять HTTP-запросы через него. Agent Vault перехватывает каждый запрос и прикрепляет к нему учётные данные перед перенаправлением запроса к целевому внешнему API.

Возможности:

• Брокеринг учётных данных: Broker AI-агенты получают доступ к целевым сервисам, таким как провайдеры LLM и GitHub, без наличия у них реальных учётных данных. Agent Vault способен брокерить этот доступ, подставляя фиктивные значения в заголовках, например __anthropic_api_key__, реальными учётными данными или полностью заменяя заголовки аутентификации в исходящих запросах, проходящих через него.
• Подключаемые хранилища учётных данных: Используйте внешнее хранилище секретов, например Infisical, вместо локального зашифрованного хранилища. Это расширяет возможности Agent Vault, добавляя такие функции, как динамические секреты из Infisical.
• Прозрачная интеграция: Позвольте AI-агентам использовать существующие инструменты, такие как MCP, CLI, SDK, API, при этом все нижележащие запросы автоматически маршрутизируются через Agent Vault. Agent Vault применяет независимый от интерфейса, ненавязчивый подход к брокерингу учётных данных, настраивая окружение ваших агентов для использования HTTPS_PROXY и совместимости с MITM-архитектурой Agent Vault.
• Целенаправленный дизайн: Существующие прямые прокси, такие как mitmproxy или squid, требуют модификации для выполнения брокеринга учётных данных и хорошей интеграции с агентами. Agent Vault специально создан для работы с эргономикой всех типов сценариев использования агентов, с выделенным CLI, мультитенантностью и дорожной картой, ориентированной на агентов, при поддержке Infisical.
• Фильтрация исходящего трафика: Контролируйте, какие агенты должны иметь доступ к каким сервисам и конечным точкам API на них, поскольку аутентифицированные запросы проходят через Agent Vault.
• Логирование запросов: Изучайте аутентифицированный трафик для мониторинга и диагностики поведения агентов.

По умолчанию запросы, не соответствующие ни одному сервису, пересылаются как обычный прокси-трафик; переключите хранилище в строгий режим запрета (unmatched_host_policy=deny), чтобы отклонять их с кодом 403.

Полную предысторию Agent Vault читайте здесь.

Agent Vault (open source) и Infisical Agent Vault

Infisical Agent Vault — это способ брокеринга учётных данных для агентов, для любого сценария использования — от личных проектов до корпоративных развёртываний. Он встроен в платформу Infisical: сервисы группируются в пакеты доступа, агенты получают к ним доступ через сессии с ограничением по времени, а разрешения регулируются средствами контроля доступа Infisical.

Agent Vault (этот проект) — это оригинальный автономный бинарный файл с открытым исходным кодом. Он больше не рекомендуется для новых установок. Если вы начинаете с нуля, используйте вместо него Infisical Agent Vault.

Сценарии использования

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-клиент. Он хранит учётные данные и передаёт их вашим ИИ-агентам с использованием архитектуры MITM-прокси. По замыслу Agent Vault предназначен для развёртывания на отдельной машине от ваших ИИ-агентов, чтобы обеспечить необходимую гарантию безопасности: ваши ИИ-агенты не смогут напрямую получить доступ к учётным данным внутри Agent Vault.