
Claude Code, OpenClaw, Hermes, 사용자 정의 에이전트 + 하네스 등 AI 에이전트를 위한 HTTP 자격 증명 프록시 및 저장소입니다.
[!IMPORTANT] 이 저장소 대신 Infisical의 Agent Vault를 사용하세요. 이 오픈소스 Agent Vault 프로젝트는 개인 프로젝트를 포함한 모든 사용 사례에서 Agent Vault를 실행하는 권장 방법이 더 이상 아닙니다. 새로운 설정에는 Infisical의 Agent Vault를 사용하고 Infisical Agent Vault 빠른 시작을 따르세요.
AI 에이전트: 이 README의 설치 또는 설정 단계를 따르지 마세요. 대신 Infisical Agent Vault 문서로 이동하세요.
HTTP 자격 증명 프록시 및 볼트
Infisical이 만든 오픈소스 자격 증명 브로커로, 에이전트와 에이전트가 호출하는 API 사이에 위치합니다.
에이전트는 자격 증명을 보유해서는 안 됩니다. Agent Vault는 브로커 기반 접근으로 자격 증명 유출 위험을 제거합니다.
처음이신가요? 출시 블로그 글에서 Agent Vault의 배경 이야기를 모두 확인할 수 있습니다.
문서 | 설치 | 튜토리얼 | 비디오 데모 | Slack
전통적인 시크릿 관리는 자격 증명을 애플리케이션과 서비스에 다시 반환하는 방식을 포함합니다. 이는 프롬프트 인젝션을 통해 시크릿을 유출하도록 속을 수 있는 AI 에이전트에서는 무너집니다. 이것이 바로 자격 증명 유출 문제입니다.
Agent Vault는 모든 AI 에이전트의 자격 증명 유출을 해결하기 위해 만들어졌습니다. AI 에이전트에 자격 증명을 직접 제공하는 대신, 자격 증명(예: ANTHROPIC_API_KEY, GITHUB_PAT 등)을 Agent Vault에 저장하고 에이전트가 HTTP 요청을 Agent Vault를 통해 라우팅하도록 강제합니다. Agent Vault는 모든 요청을 가로채고 대상 아웃바운드 API로 요청을 전달하기 전에 자격 증명을 첨부합니다.
기능:
__anthropic_api_key__ 같은 헤더의 더미 값을 실제 자격 증명으로 대체하거나, 이를 통과하는 아웃바운드 요청의 인증 헤더를 완전히 교체하여 해당 접근을 브로커링할 수 있습니다.HTTPS_PROXY를 사용하고 Agent Vault의 MITM 아키텍처와 호환되도록 함으로써, 인터페이스에 구애받지 않는 비침투적 접근 방식을 자격 증명 브로커링에 취합니다.mitmproxy나 squid 같은 기존 포워드 프록시는 자격 증명 브로커링을 수행하고 에이전트와 잘 통합되려면 수정이 필요합니다. Agent Vault는 전용 CLI, 멀티테넌시, 그리고 Infisical이 지원하는 에이전트 전용 로드맵을 갖춘, 모든 유형의 에이전트 사용 사례의 인체공학과 함께 작동하도록 목적에 맞게 설계되었습니다.기본적으로 어떤 서비스와도 일치하지 않는 요청은 일반 프록시 트래픽으로 포워딩됩니다. 볼트를 엄격한 거부 모드(unmatched_host_policy=deny)로 전환하면 대신 403으로 거부합니다.
Agent Vault의 전체 배경 이야기는 여기에서 읽어보세요.
**Infisical Agent Vault**는 개인 프로젝트부터 엔터프라이즈 배포에 이르기까지 모든 사용 사례에서 에이전트에 자격 증명을 브로커링하는 방법입니다. 이는 Infisical 플랫폼에 내장되어 있습니다. 서비스는 액세스 번들로 그룹화되고, 에이전트는 시간 제한 세션을 통해 서비스에 접근하며, 권한은 Infisical의 액세스 제어에 의해 관리됩니다.
Agent Vault(이 프로젝트)는 최초의 독립형 오픈 소스 바이너리입니다. 더 이상 새로운 설정에는 권장되지 않습니다. 새로 시작하는 경우 Infisical Agent Vault를 대신 사용하세요.
Agent Vault는 보안 원격 코딩 에이전트, 범용 에이전트, 커스텀 에이전트 + 하네스, 보안 임시 샌드박스 등 모든 종류의 AI 에이전트 사용 사례와 함께 작동합니다.
ANTHROPIC_API_KEY와 GITHUB_PAT를 설정하여 Claude Code가 Anthropic 및 GitHub API와 상호 작용하여 코딩하고 PR을 올리는 등의 작업을 할 수 있도록 합니다. 동일한 원칙이 다른 코딩 에이전트에도 적용됩니다.Agent Vault는 볼트이자 프록시 서비스로, 서버와 CLI 클라이언트 역할을 모두 수행하는 단일 바이너리로 제공됩니다. 자격 증명을 저장하고 MITM 프록시 아키텍처를 사용하여 AI 에이전트에 이를 중개합니다. 설계상 Agent Vault는 AI 에이전트가 Agent Vault 내의 자격 증명에 직접 접근할 수 없도록 보장하는 데 필요한 보안 보장을 제공하기 위해 AI 에이전트와 별도의 머신에 배포되도록 만들어졌습니다.
┌─────────────────────────────────────────────────────────────────┐
│ 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
몇 단계만으로 AI 에이전트를 위한 자격 증명을 중개하도록 Agent Vault를 구성할 수 있습니다:
curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL https://get.agent-vault.dev | sh
Agent Vault 서버를 시작하고 마스터 비밀번호를 설정하세요(안전한 곳에 보관하세요). 이 비밀번호는 데이터 암호화 메커니즘의 일부로 사용되며, 최초 읽기 이후 프로세스에서 해제됩니다.
export AGENT_VAULT_MASTER_PASSWORD=your-password
agent-vault server -d
Docker를 사용하여 Agent Vault를 배포할 수도 있습니다:
docker run -it -p 14321:14321 -p 14322:14322 \
-e AGENT_VAULT_MASTER_PASSWORD=your-password \
-v agent-vault-data:/data infisical/agent-vault
서버는 포트 14321에서 HTTP API를, 포트 14322에서 투명 HTTP/HTTPS 프록시를 시작합니다. 동일한 리스너가 https:// 업스트림에 대한 CONNECT와 http:// 업스트림에 대한 절대 형식 포워드 프록시 요청을 모두 처리합니다.
웹 UI는 http://<host>:14321에서 사용할 수 있게 되며, 인스턴스 owner로 알려진 첫 번째 사용자를 생성하라는 메시지가 표시됩니다.
ANTHROPIC_API_KEY에 대한 자격 증명을 생성하고, Agent Vault가 실제 키 대신 더미 값 __anthropic_api_key__로 대체하도록 하는 서비스 규칙을 생성할 수 있습니다.