Ce que vous obtenez
- Une connexion au Manager et à l'API via votre fournisseur d'identité
- Des rôles :
eddi-admin,eddi-editor,eddi-user,eddi-viewereteddi-approverpour les décisions de validation - Un realm
eddiprêt à l'emploi que l'installateur importe dans Keycloak - Des appels effectués au nom de l'utilisateur connecté, de sorte que la piste d'audit désigne une personne réelle
Fonctionnement dans EDDI
- Lancer l'installateur avec
--with-auth. Il démarre Keycloak et importe le realmeddiau premier démarrage. - Définir un mot de passe pour l'utilisateur
eddidans la console d'administration de Keycloak. Le realm fourni n'en a pas. - Se connecter au Manager. Donner aux personnes les rôles dont elles ont besoin et ajouter les approbateurs à
eddi-approver. - Pour un fournisseur d'identité existant, définir les variables
QUARKUS_OIDC_*(tenant activé, URL du serveur d'authentification, identifiant client, secret client). - Dans un appel HTTP, utiliser
${caller:token}pour appeler une API avec le jeton propre à l'utilisateur connecté plutôt qu'avec un identifiant partagé.
Configuration
Tirée de la documentation d'EDDI. Les espaces réservés comme your-agent-id sont à remplacer par vos propres valeurs.
bash install.sh --with-authdocker 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.0Gouvernance
- En mode de lancement production, EDDI refuse de démarrer avec OIDC désactivé sauf renoncement explicite : une API de gestion ouverte est donc une décision, pas un accident.
- Les points d'accès de validation exigent le rôle
eddi-approver, ou bien le propriétaire ou uneddi-admin. - Avec
${caller:token}, la piste d'audit enregistre l'utilisateur réel. Un identifiant statique partagé ferait converger toutes les actions vers un seul principal.
Bon à savoir
- L'authentification est facultative et désactivée par défaut. Keycloak est ce que l'installateur provisionne. Les autres fournisseurs OIDC utilisent les mêmes réglages, et certains détails (par exemple le point d'accès de jeton annoncé pour A2A) supposent des chemins Keycloak tant que vous ne les définissez pas.
- L'import du realm fourni est ponctuel. Les modifications ultérieures du JSON n'atteignent pas un Keycloak en cours d'exécution.
Intégrations associées
La configuration et le comportement décrits sur cette page suivent la documentation d'EDDI, vérifiée le 2026-10-14. Les noms de champs et les valeurs par défaut peuvent changer d'une version à l'autre : confirmez-les dans la documentation de votre version.