🚀 EDDI 6.5.0

19 provedores LLM, bases de conhecimento que rastreiam o seu site e leem os seus arquivos, e conversas que acompanham as versões compatíveis do agenteNovidades

Cloud Gerenciada Começar
Todas as integrações
Identidade e segurançaOIDC

Keycloak / OIDC

Coloque a autenticação OpenID Connect na frente do EDDI com Keycloak ou outro provedor OIDC, com papéis para administradores, editores, usuários, leitores e aprovadores.

ConfiguraçãoDocumentação ↗

O que você recebe

  • Login no Manager e na API pelo seu provedor de identidade
  • Papéis: eddi-admin, eddi-editor, eddi-user, eddi-viewer e eddi-approver para as decisões de aprovação
  • Um realm eddi pronto que o instalador importa para o Keycloak
  • Chamadas que agem como o usuário conectado, de modo que a trilha de auditoria cita uma pessoa real

Como funciona no EDDI

  1. Execute o instalador com --with-auth. Ele inicia o Keycloak e importa o realm eddi na primeira inicialização.
  2. Defina uma senha para o usuário eddi no console de administração do Keycloak. O realm incluído não traz nenhuma.
  3. Entre no Manager. Conceda às pessoas os papéis de que precisam e adicione os aprovadores a eddi-approver.
  4. Para um provedor de identidade existente, defina as variáveis QUARKUS_OIDC_* (tenant habilitado, URL do servidor de autenticação, id do cliente, segredo do cliente).
  5. Em uma chamada HTTP, use ${caller:token} para chamar uma API com o token do próprio usuário conectado, em vez de uma credencial compartilhada.

Configuração

Extraída da documentação do EDDI. Marcadores como your-agent-id devem ser substituídos pelos seus próprios valores.

Install with KeycloakOpção do instalador que adiciona o Keycloak.
bash install.sh --with-auth
Point EDDI at your identity providerVariáveis de ambiente para um provedor OIDC externo, da documentação do 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

Governança

  • No modo de execução de produção, o EDDI se recusa a iniciar com o OIDC desativado, a menos que você opte por isso explicitamente, de modo que uma API de gerenciamento aberta é uma decisão e não um acidente.
  • Os endpoints de aprovação exigem o papel eddi-approver, ou ser o proprietário ou um eddi-admin.
  • Com ${caller:token}, a trilha de auditoria registra o usuário real. Uma credencial estática compartilhada reduziria todas as ações a um único principal.

Bom saber

  • A autenticação é opcional e vem desativada por padrão. O Keycloak é o que o instalador provisiona. Outros provedores OIDC usam as mesmas configurações, e alguns detalhes (por exemplo, o endpoint de token anunciado para A2A) assumem caminhos do Keycloak, a menos que você os defina.
  • A importação do realm incluído acontece uma única vez. Edições posteriores no JSON não chegam a um Keycloak em execução.
ComeçarDocumentação ↗

Integrações relacionadas

Identidade e segurançaSecrets VaultUm cofre de segredos integrado com criptografia de envelope. A configuração referencia os segredos como ${vault:keyName}, e o valor nunca chega às configurações de agentes, às exportações nem aos logs.Protocolos de agentesMCP ServerControle o EDDI a partir do Claude Desktop, Cursor, VS Code e outros clientes MCP. O EDDI expõe 84 ferramentas MCP via Streamable HTTP para conversas e administração.InfraestruturaKubernetes and HelmExecute o EDDI em qualquer cluster Kubernetes em conformidade, com um quickstart de arquivo único, um chart Helm ou overlays Kustomize, com MongoDB ou PostgreSQL.

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.