제공되는 기능

LLM, HTTP 호출, MCP, RAG 설정에서 쓰는 ${vault:keyName} 참조
테넌트별 데이터 키를 사용하는 AES-256-GCM 봉투 암호화
에이전트별 권한 부여: 어떤 에이전트가 어떤 시크릿을 사용할 수 있는지 지정
설정 내보내기에서는 시크릿이 제거되고 로그에서는 마스킹됨

EDDI에서의 동작 방식

볼트 마스터 키(EDDI_VAULT_MASTER_KEY)를 설정합니다. 설치 프로그램이 자동으로 생성합니다. 키가 없으면 볼트는 비활성화됩니다.
PUT /secretstore/secrets/{tenantId}/{keyName} 또는 Manager를 통해 시크릿을 저장합니다.
설정에서 ${vault:keyName}으로 참조합니다.
EDDI는 런타임에 참조를 해석합니다. 평문은 대화 메모리에 저장되지 않습니다.
allowedAgents를 해당 시크릿이 필요한 에이전트로만 좁힙니다. 이 검사는 에이전트를 배포할 때 실행됩니다.

설정

EDDI 문서를 기준으로 합니다. your-agent-id 같은 플레이스홀더는 직접 바꿔서 사용하세요.

Store a secret시크릿을 저장합니다. 응답에는 값이 반환되지 않습니다.

curl -X PUT http://localhost:7070/secretstore/secrets/default/openai-key \
  -H "Content-Type: application/json" \
  -d '{"value":"sk-your-key","description":"OpenAI key"}'

langchain.json (reference it, never paste it)LLM 태스크에서 이름으로 시크릿을 참조합니다.

{
  "tasks": [{
    "actions": ["send_message"],
    "id": "simpleChat",
    "type": "openai",
    "description": "Simple chat",
    "parameters": {
      "apiKey": "${vault:openai-key}",
      "modelName": "your-model-id",
      "systemMessage": "You are a helpful assistant",
      "addToOutput": "true"
    }
  }]
}

Grant one secret to specific agents값을 건드리지 않고 시크릿을 사용할 수 있는 대상을 변경합니다.

curl -X PUT "$EDDI/secretstore/secrets/default/openai-key/grant" \
  -H 'Content-Type: application/json' \
  -d '{"allowedAgents": ["0123456789abcdef01234567", "89abcdef0123456789abcdef"]}'

거버넌스

권한 부여는 기본적으로 배포 시점에 강제됩니다. 권한이 없는 시크릿을 참조하는 에이전트는 배포되지 않습니다.
사용자 입력이나 모델 응답처럼 대화 데이터를 통해 들어온 볼트 참조는 해석되지 않고 거부됩니다.
평문은 요청 기록, 승인 미리 보기, 요청 로그 행에서 마스킹됩니다.
인증이 켜져 있으면 볼트 엔드포인트는 eddi-admin 역할로 보호됩니다.

알아 두면 좋은 점

EDDI에는 HashiCorp Vault, AWS, Azure용 네이티브 클라이언트가 없습니다. Kubernetes에서는 External Secrets Operator가 볼트 마스터 키를 담은 eddi-secrets Kubernetes Secret을 HashiCorp Vault, AWS Secrets Manager, Azure Key Vault에서 동기화할 수 있습니다. 개별 시크릿은 여전히 EDDI 볼트에 저장됩니다.
마스터 키를 잃어버리면 암호화된 시크릿을 복구할 수 없습니다. 반드시 백업하세요.

시작하기 문서 ↗

기능

엔터프라이즈

관리형 클라우드 & 엔터프라이즈 지원

리소스

Secrets Vault

제공되는 기능

EDDI에서의 동작 방식

설정

거버넌스

알아 두면 좋은 점

관련 통합