Skip to content
🚀 EDDI 6.5.0

19 LLM-Anbieter, Wissensdatenbanken, die Ihre Website crawlen und Ihre Dateien lesen, und Konversationen, die kompatiblen Agentenversionen folgenNeuigkeiten

Managed Cloud Jetzt Starten
Alle Integrationen
Identität und SicherheitOIDC

Keycloak / OIDC

OpenID-Connect-Authentifizierung vor EDDI schalten, mit Keycloak oder einem anderen OIDC-Anbieter, mit Rollen für Admins, Editoren, Nutzer, Betrachter und Freigeber.

Was Sie bekommen

  • Anmeldung am Manager und an der API über Ihren Identity Provider
  • Rollen: eddi-admin, eddi-editor, eddi-user, eddi-viewer und eddi-approver für Freigabeentscheidungen
  • Ein fertiger eddi-Realm, den der Installer in Keycloak importiert
  • Aufrufe im Namen des angemeldeten Nutzers, sodass der Audit-Trail eine echte Person nennt

So funktioniert es in EDDI

  1. Den Installer mit --with-auth ausführen. Er startet Keycloak und importiert beim ersten Start den eddi-Realm.
  2. In der Keycloak-Admin-Konsole ein Passwort für den Nutzer eddi setzen. Der mitgelieferte Realm hat keines.
  3. Am Manager anmelden. Den Personen die nötigen Rollen geben und Freigeber zu eddi-approver hinzufügen.
  4. Bei einem bestehenden Identity Provider die QUARKUS_OIDC_*-Variablen setzen (Tenant aktiviert, Auth-Server-URL, Client-ID, Client Secret).
  5. In einem HTTP-Aufruf ${caller:token} verwenden, um eine API mit dem eigenen Token des angemeldeten Nutzers statt mit einem gemeinsamen Credential aufzurufen.

Konfiguration

Aus der EDDI-Dokumentation übernommen. Platzhalter wie your-agent-id ersetzen Sie durch Ihre eigenen Werte.

Install with KeycloakInstaller-Option, die Keycloak hinzufügt.
bash install.sh --with-auth
Point EDDI at your identity providerUmgebungsvariablen für einen externen OIDC-Anbieter, aus der EDDI-Doku.
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

Governance

  • Im Produktionsmodus verweigert EDDI den Start mit deaktiviertem OIDC, sofern Sie nicht ausdrücklich verzichten. Eine offene Management-API ist also eine Entscheidung, kein Versehen.
  • Freigabe-Endpunkte erfordern die Rolle eddi-approver oder den Eigentümer bzw. einen eddi-admin.
  • Mit ${caller:token} erfasst der Audit-Trail den echten Nutzer. Ein gemeinsames statisches Credential würde jede Aktion in einem einzigen Principal zusammenfallen lassen.

Gut zu wissen

  • Die Authentifizierung ist optional und standardmäßig aus. Keycloak ist das, was der Installer bereitstellt. Andere OIDC-Anbieter nutzen dieselben Einstellungen, und manche Details (etwa der angegebene Token-Endpunkt für A2A) setzen Keycloak-Pfade voraus, sofern Sie sie nicht festlegen.
  • Der mitgelieferte Realm-Import läuft nur einmal. Spätere Änderungen am JSON erreichen ein laufendes Keycloak nicht.

Verwandte Integrationen

Konfiguration und Verhalten auf dieser Seite folgen der EDDI-Dokumentation, geprüft am 2026-10-14. Feldnamen und Standardwerte können sich zwischen Releases ändern. Bestätigen Sie sie daher in der Dokumentation Ihrer Version.