Skip to content
🚀 EDDI 6.5.0

19 proveedores LLM, bases de conocimiento que rastrean su sitio y leen sus archivos, y conversaciones que siguen las versiones compatibles del agenteNovedades

Cloud Gestionada Empezar
Todas las integraciones
Identidad y seguridad${vault:}

Secrets Vault

Una bóveda de secretos integrada con cifrado de sobre. La configuración referencia los secretos como ${vault:keyName} y el valor nunca llega a las configuraciones de agentes, las exportaciones ni los registros.

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

  1. 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.
  2. Guarda un secreto con PUT /secretstore/secrets/{tenantId}/{keyName} o desde el Manager.
  3. Referéncialo en la configuración como ${vault:keyName}.
  4. EDDI resuelve la referencia en tiempo de ejecución. El texto plano no se guarda en la memoria de la conversación.
  5. Restringe allowedAgents a 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.

Store a secretGuardar un secreto. La respuesta nunca devuelve el valor.
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)Referenciar el secreto por nombre desde una tarea de 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 agentsCambiar quién puede usar un secreto sin tocar su valor.
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-admin cuando 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.