Dépanner une connexion SSO échouée

Quand une connexion via votre fournisseur d'identité ne fonctionne pas, Kliv est conçu pour vous indiquer la vraie correction, et pas seulement « échec de la connexion ». Cette page vous montre où chercher et comment interpréter ce que vous trouvez.

Où se trouve la réponse

Il existe volontairement deux vues différentes d'une connexion échouée :

  • La personne qui se connecte voit un simple message « nous n'avons pas pu vous connecter » avec un court identifiant de référence. Elle ne voit pas le détail technique, qui révélerait la configuration de votre identité.
  • Vous, l'administrateur, voyez le diagnostic complet dans le journal d'audit. C'est là que mène l'identifiant de référence.

Quand un collègue signale une connexion échouée, demandez-lui donc l'identifiant de référence, puis recherchez-le.

Lire le diagnostic

  1. Allez dans Gestion des utilisateurs → Authentification unique et ouvrez l'onglet Audit.
  2. Trouvez la connexion échouée (faites correspondre l'identifiant de référence, ou regardez simplement les entrées les plus récentes).
  3. Ouvrez-la pour voir le détail attendu / reçu : pour chaque contrôle effectué par Kliv, ce qu'il attendait et ce que votre fournisseur a réellement envoyé. L'écart est votre correction.

Vous pouvez lancer l'étape Tester la connexion sur la page Authentification unique pour reproduire un échec à la demande pendant que vous travaillez dessus, sans impliquer de vrais utilisateurs.

Causes courantes et corrections

L'émetteur ne correspond pas (OIDC). Le problème OIDC le plus fréquent. L'URL de l'émetteur doit correspondre à celle de votre fournisseur caractère par caractère. Les émetteurs Microsoft Entra sont propres à votre tenant ; Google publie plusieurs formes. Copiez l'émetteur exact depuis l'application de votre fournisseur et collez-le dans Kliv.

Le certificat de signature a expiré (SAML). Des connexions qui fonctionnaient hier échouent soudainement. Le certificat de signature de votre fournisseur a expiré. Téléversez le certificat actuel (ou actualisez à partir des métadonnées de votre fournisseur). La carte d'état vous prévient avant que cela n'arrive : surveillez-la.

Le domaine e-mail de l'utilisateur n'est pas vérifié. Kliv ne crée de comptes que pour les domaines e-mail dont vous avez prouvé le contrôle. Si une connexion est rejetée à cause d'un domaine non vérifié, terminez Vérifier votre domaine pour ce domaine.

Le compte est désactivé. Si la personne a été désactivée dans votre fournisseur d'identité ou dans Kliv, la connexion est refusée par conception : une connexion SSO ne réactive jamais silencieusement un compte désactivé. Réactivez-la chez votre fournisseur si elle doit avoir accès.

L'identité (NameID) n'est pas stable. Si votre fournisseur envoie un identifiant différent à chaque fois, ou envoie une adresse e-mail au lieu d'un identifiant stable, Kliv ne peut pas reconnaître la même personne de façon fiable. Configurez votre fournisseur pour qu'il envoie l'identifiant stable indiqué par le préréglage.

Une adresse e-mail n'est pas marquée « vérifiée ». Kliv n'exige pas cela : il identifie les personnes par un identifiant stable du fournisseur, pas par un indicateur d'e-mail vérifié. L'absence de la mention « vérifié » n'est donc pas la cause. Regardez plutôt les autres contrôles.

Si vous êtes toujours bloqué

Le détail attendu / reçu nomme le contrôle précis qui a échoué et propose des conseils adaptés à votre fournisseur. Traitez ce contrôle, corrigez-le chez votre fournisseur, puis relancez Tester la connexion. Comme l'activation a exigé un test réussi, une configuration qui fonctionnait et s'arrête soudainement vient presque toujours d'un certificat expiré ou d'un réglage modifié du côté de votre fournisseur.