O que você recebe
- Referências
${vault:keyName}na configuração de LLM, chamadas HTTP, MCP e RAG - Criptografia de envelope AES-256-GCM com uma chave de dados por tenant
- Permissões por agente: quais agentes podem usar qual segredo
- Segredos removidos das exportações de configuração e redigidos nos logs
Como funciona no EDDI
- Defina a chave mestra do cofre (
EDDI_VAULT_MASTER_KEY). O instalador gera uma para você. Sem uma chave, o cofre fica desativado. - Guarde um segredo com
PUT /secretstore/secrets/{tenantId}/{keyName}ou pelo Manager. - Referencie-o na configuração como
${vault:keyName}. - O EDDI resolve a referência em tempo de execução. O texto puro não é armazenado na memória da conversa.
- Restrinja
allowedAgentsaos agentes que precisam do segredo. A verificação roda quando um agente é implantado.
Configuração
Extraída da documentação do EDDI. Marcadores como your-agent-id devem ser substituídos pelos seus próprios valores.
curl -X PUT http://localhost:7070/secretstore/secrets/default/openai-key \
-H "Content-Type: application/json" \
-d '{"value":"sk-your-key","description":"OpenAI key"}'{
"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"
}
}]
}curl -X PUT "$EDDI/secretstore/secrets/default/openai-key/grant" \
-H 'Content-Type: application/json' \
-d '{"allowedAgents": ["0123456789abcdef01234567", "89abcdef0123456789abcdef"]}'Governança
- As permissões são aplicadas no momento da implantação por padrão: um agente que referencia um segredo para o qual não tem permissão não é implantado.
- Uma referência ao cofre que chega por dados da conversa, como a entrada do usuário ou a resposta de um modelo, é recusada em vez de resolvida.
- O texto puro é redigido no registro da requisição, na pré-visualização da aprovação e na linha do log de requisições.
- Os endpoints do cofre ficam atrás do papel
eddi-adminquando a autenticação está ativada.
Bom saber
- O EDDI não tem cliente nativo de HashiCorp Vault, AWS ou Azure. No Kubernetes, o External Secrets Operator pode sincronizar o Secret do Kubernetes
eddi-secrets(que guarda a chave mestra do cofre) a partir do HashiCorp Vault, do AWS Secrets Manager ou do Azure Key Vault. Os segredos individuais continuam no cofre do EDDI. - Se a chave mestra for perdida, os segredos criptografados serão irrecuperáveis. Faça backup dela.
Integrações relacionadas
A configuração e o comportamento desta página seguem a documentação do EDDI, verificada em 2026-10-14. Nomes de campos e valores padrão podem mudar entre versões, portanto confirme-os na documentação da sua versão.