Qué obtienes
- Referencias
${vault:keyName}en la configuración de LLM, llamadas HTTP, MCP y RAG - Cifrado de sobre AES-256-GCM con una clave de datos por tenant
- Permisos por agente: qué agentes pueden usar qué secreto
- Secretos eliminados de las exportaciones de configuración y redactados en los registros
Cómo funciona en EDDI
- Define la clave maestra de la bóveda (
EDDI_VAULT_MASTER_KEY). El instalador genera una por ti. Sin clave, la bóveda queda desactivada. - Guarda un secreto con
PUT /secretstore/secrets/{tenantId}/{keyName}o desde el Manager. - Referéncialo en la configuración como
${vault:keyName}. - EDDI resuelve la referencia en tiempo de ejecución. El texto plano no se guarda en la memoria de la conversación.
- Restringe
allowedAgentsa los agentes que necesitan el secreto. La comprobación se ejecuta cuando se despliega un agente.
Configuración
Extraída de la documentación de EDDI. Los marcadores como your-agent-id deben sustituirse por tus propios 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"]}'Gobernanza
- Los permisos se aplican en el momento del despliegue por defecto: un agente que referencia un secreto para el que no tiene permiso no se despliega.
- Una referencia a la bóveda que llega a través de datos de la conversación, como la entrada del usuario o una respuesta del modelo, se rechaza en lugar de resolverse.
- El texto plano se redacta en el registro de la petición, en la vista previa de la aprobación y en la línea del registro de peticiones.
- Los endpoints de la bóveda quedan tras el rol
eddi-admincuando la autenticación está activada.
Conviene saber
- EDDI no tiene un cliente nativo de HashiCorp Vault, AWS ni Azure. En Kubernetes, el External Secrets Operator puede sincronizar el Secret de Kubernetes
eddi-secrets(que contiene la clave maestra de la bóveda) desde HashiCorp Vault, AWS Secrets Manager o Azure Key Vault. Los secretos individuales siguen residiendo en la bóveda de EDDI. - Si se pierde la clave maestra, los secretos cifrados son irrecuperables. Haz una copia de seguridad.
Integraciones relacionadas
La configuración y el comportamiento de esta página siguen la documentación de EDDI, comprobada el 2026-10-14. Los nombres de campo y los valores por defecto pueden cambiar entre versiones, así que confírmalos en la documentación de tu versión.