🚀 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 seguridadOIDC

Keycloak / OIDC

Coloca la autenticación OpenID Connect delante de EDDI con Keycloak u otro proveedor OIDC, con roles para administradores, editores, usuarios, lectores y aprobadores.

ConfiguraciónDocumentación ↗

Qué obtienes

  • Inicio de sesión en el Manager y en la API a través de tu proveedor de identidad
  • Roles: eddi-admin, eddi-editor, eddi-user, eddi-viewer y eddi-approver para las decisiones de aprobación
  • Un realm eddi listo para usar que el instalador importa en Keycloak
  • Llamadas que actúan como el usuario con sesión iniciada, de modo que el rastro de auditoría nombra a una persona real

Cómo funciona en EDDI

  1. Ejecuta el instalador con --with-auth. Inicia Keycloak e importa el realm eddi en el primer arranque.
  2. Define una contraseña para el usuario eddi en la consola de administración de Keycloak. El realm incluido no trae ninguna.
  3. Inicia sesión en el Manager. Da a cada persona los roles que necesita y añade a los aprobadores a eddi-approver.
  4. Si ya tienes un proveedor de identidad, define las variables QUARKUS_OIDC_* (tenant habilitado, URL del servidor de autenticación, id de cliente, secreto de cliente).
  5. En una llamada HTTP, usa ${caller:token} para llamar a una API con el token propio del usuario con sesión iniciada en lugar de una credencial compartida.

Configuración

Extraída de la documentación de EDDI. Los marcadores como your-agent-id deben sustituirse por tus propios valores.

Install with KeycloakOpción del instalador que añade Keycloak.
bash install.sh --with-auth
Point EDDI at your identity providerVariables de entorno para un proveedor OIDC externo, tomadas de la documentación de EDDI.
docker run -d \
  -p 7070:7070 \
  -e MONGODB_CONNECTIONSTRING='mongodb://mongo:27017/eddi?retryWrites=true&w=majority' \
  -e QUARKUS_OIDC_TENANT_ENABLED=true \
  -e QUARKUS_OIDC_AUTH_SERVER_URL='https://keycloak.example.com/realms/eddi' \
  -e QUARKUS_OIDC_CLIENT_ID=eddi \
  -e QUARKUS_OIDC_CREDENTIALS_SECRET="$OIDC_CLIENT_SECRET" \
  labsai/eddi:6.4.0

Gobernanza

  • En modo de lanzamiento de producción, EDDI se niega a arrancar con OIDC desactivado salvo que lo excluyas de forma explícita, de modo que una API de gestión abierta es una decisión y no un accidente.
  • Los endpoints de aprobación exigen el rol eddi-approver, o ser el propietario o un eddi-admin.
  • Con ${caller:token}, el rastro de auditoría registra al usuario real. Una credencial estática compartida reduciría todas las acciones a un único principal.

Conviene saber

  • La autenticación es opcional y está desactivada por defecto. Keycloak es lo que aprovisiona el instalador. Otros proveedores OIDC usan los mismos ajustes, y algunos detalles (por ejemplo, el endpoint de token anunciado para A2A) asumen rutas de Keycloak salvo que los configures.
  • La importación del realm incluido es de una sola vez. Las ediciones posteriores del JSON no llegan a un Keycloak en ejecución.
EmpezarDocumentación ↗

Integraciones relacionadas

Identidad y seguridadSecrets VaultUna 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.Protocolos de agentesMCP ServerControla EDDI desde Claude Desktop, Cursor, VS Code y otros clientes MCP. EDDI expone 84 herramientas MCP sobre Streamable HTTP para conversaciones y administración.InfraestructuraKubernetes and HelmEjecuta EDDI en cualquier clúster de Kubernetes conforme con un quickstart de un solo archivo, un chart de Helm u overlays de Kustomize, con MongoDB o PostgreSQL.

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.