Aller au contenu
Bexxo Aide

Aide La plateforme Annuaire et SSO

Connecter Keycloak

Pour les administrateurs Mis à jour le 13 novembre 2026

Connecter un royaume Keycloak pour synchroniser les personnes et les groupes de l’organisation, et préparer la connexion avec le compte Keycloak (SSO).
Sur cette page
  1. Présentation
  2. Préparer un client dans Keycloak
  3. Remplir la section Connexion
  4. Ce qui est importé
  5. Connexion SSO avec Keycloak
  6. Tester et dépanner

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.

Les réglages communs à tous les importsSynchroniser l’annuaire et configurer le SSO

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 :

  1. créez un client OpenID Connect avec authentification du client et compte de service activés ;

  2. attribuez à son compte de service les deux rôles ci-dessous du client realm-management ;

  3. 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).

Rôles du client realm-management

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 forme attributes. suivi de son nom (première valeur seulement), par exemple attributes.department.
  • Pour un groupe : name et path (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.

  1. Déclarez toutes les URL de redirection affichées dans Connexion SSO (portail et Academy) comme adresses de redirection valides du client.

  2. 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 connexionL’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éeLe compte de service du client a-t-il les rôles view-users et query-groups du client realm-management ?
Organisation au chiffrement actifLe test et la synchronisation passent par l’agent Bexxo Protected : il doit être démarré et joindre votre serveur Keycloak.
Organisation au chiffrement actifInstaller l’agent Bexxo Protected

Vous n’avez pas trouvé la réponse ? Nous contacter