Aide La plateforme Annuaire et SSO
Connecter Keycloak
Sur cette page
Présentation
Keycloak est lu en lecture seule : utilisateurs, groupes (sous-groupes compris) et membres d’un royaume. Cet article couvre la préparation dans Keycloak et les sections Connexion et Connexion SSO ; les autres réglages sont communs à tous les imports.
1Préparer un client dans Keycloak
La synchronisation s’authentifie comme un client confidentiel avec compte de service (flux client_credentials). Dans le royaume à lire :
créez un client OpenID Connect avec authentification du client et compte de service activés ;
attribuez à son compte de service les deux rôles ci-dessous du client
realm-management;vérifiez que le royaume répond sous
{URL de base}/realms/{royaume}/protocol/openid-connect/token(jeton) et{URL de base}/admin/realms/{royaume}/(lectures).
Sans chiffrement côté client, nos serveurs se connectent à Keycloak depuis Internet : l’adresse doit être en https:// et se résoudre uniquement vers des adresses publiques. Dans une organisation chiffrée, l’agent Bexxo Protected lit Keycloak depuis votre réseau.
2Remplir la section Connexion
Saisissez le royaume, l’identifiant et le secret du client, et l’URL de base : l’adresse du serveur en https://, sans /realms, par exemple https://sso.exemple.ch. Si votre serveur publie ses royaumes sous un chemin (comme /auth), incluez-le.
Ce qui est importé
- Un utilisateur désactivé dans Keycloak est importé comme inactif.
- Chaque sous-groupe, à toute profondeur, devient un groupe. Seuls les membres directs sont rattachés : un membre d’un sous-groupe ne l’est pas au groupe parent.
- Propriétés utilisables dans la correspondance des champs et les filtres, pour une personne :
username,email,firstName,lastName,enabled, et chaque attribut personnalisé sous la formeattributes.suivi de son nom (première valeur seulement), par exempleattributes.department. - Pour un groupe :
nameetpath(chemin complet, par exemple/Siège/Vente).
La correspondance préremplie ne couvre que le nom, le prénom et l’email : ajoutez au besoin une ligne pour la fonction ou le téléphone à partir d’un attribut personnalisé.
Connexion SSO avec Keycloak
Le SSO utilise un client OpenID Connect du royaume, avec ses propres identifiant et secret, indépendants de la section Connexion.
Déclarez toutes les URL de redirection affichées dans Connexion SSO (portail et Academy) comme adresses de redirection valides du client.
Saisissez l’émetteur du royaume, de la forme
https://{serveur}/realms/{royaume}, l’identifiant et le secret client, enregistrez, puis testez la découverte. L’émetteur doit être joignable depuis Internet, même pour une organisation au chiffrement actif.
L’activation du SSO et les effets d’une coupure sont décrits dans l’article général.
Tester et dépanner
| Situation | À vérifier |
|---|---|
| Échec du test de connexion | L’URL de base est-elle en https://, sans /realms ? Le royaume et l’identifiant client sont-ils exacts ? Le compte de service est-il activé sur le client ? |
| Identifiants acceptés, lecture refusée | Le compte de service du client a-t-il les rôles view-users et query-groups du client realm-management ? |
| Organisation au chiffrement actif | Le test et la synchronisation passent par l’agent Bexxo Protected : il doit être démarré et joindre votre serveur Keycloak. |
Vous n’avez pas trouvé la réponse ? Nous contacter