Configurer le SSO SAML

L'authentification unique (SSO) permet à votre équipe de se connecter à Kliv avec les comptes qu'elle utilise déjà au travail, via le fournisseur d'identité de votre entreprise (le service qui gère les connexions de vos employés, comme Okta ou Microsoft Entra). Pas de mot de passe Kliv distinct à gérer, et quand quelqu'un part, le supprimer à un seul endroit supprime aussi son accès ici.

SAML est la méthode la plus largement prise en charge pour connecter un fournisseur d'identité. Cette page vous guide pour le configurer, le tester avec une vraie connexion, puis l'activer, dans cet ordre, afin que rien ne se casse pour votre équipe.

Vous configurez tout cela vous-même. Pas de ticket de support, pas d'appel avec un commercial.

Avant de commencer

  • Il vous faut un compte administrateur autorisé à gérer l'authentification unique de votre organisation.
  • Vous aurez besoin d'un accès à la console d'administration de votre fournisseur d'identité (Okta, Entra, Google Workspace, OneLogin ou un autre fournisseur SAML).
  • Prévoyez un domaine que vous pouvez vérifier : le domaine e-mail avec lequel votre équipe se connecte (par exemple yourcompany.com).

Ouvrir l'assistant de configuration

  1. Allez dans Gestion des utilisateurs → Authentification unique.
  2. Choisissez Configurer l'authentification unique.
  3. Sélectionnez votre fournisseur : Okta, Microsoft Entra, Google, OneLogin ou Autre. Choisir un fournisseur connu préremplit les bons paramètres, ce qui vous laisse moins de valeurs à copier à la main.
  4. Laissez le protocole sur SAML (par défaut). OIDC est une alternative avancée : voir Configurer le SSO OIDC.

Échanger les paramètres avec votre fournisseur d'identité

Le SSO fonctionne parce que votre fournisseur d'identité et Kliv se font mutuellement confiance. Vous donnez à chacun quelques informations sur l'autre :

  1. Kliv vous montre les valeurs dont votre fournisseur a besoin (comme l'URL de connexion sur laquelle Kliv écoute). Copiez-les dans une nouvelle application SAML dans la console d'administration de votre fournisseur.
  2. Votre fournisseur vous renvoie ses propres informations : généralement une URL de métadonnées ou un fichier XML, plus un certificat de signature. Collez les métadonnées (ou téléversez le fichier) dans Kliv.
  3. Assurez-vous que votre fournisseur envoie un identifiant stable pour chaque utilisateur, et pas seulement une adresse e-mail. (L'attribut exact dépend du fournisseur : le préréglage indique lequel utiliser ; vérifiez la formulation dans votre console.) C'est la valeur que Kliv utilise pour reconnaître une personne qui revient, même si son e-mail change.

Kliv enregistre tout cela comme brouillon. Un brouillon est configuré mais pas encore actif : votre équipe continue de se connecter comme aujourd'hui jusqu'à ce que vous ayez terminé.

Vérifier votre domaine

Avant que Kliv crée des comptes depuis votre fournisseur, vous devez prouver que vous contrôlez le domaine e-mail utilisé par votre équipe. Cela empêche quiconque de revendiquer un domaine qui n'est pas le sien.

Suivez Vérifier votre domaine pour ajouter un enregistrement DNS ou un fichier à votre site web. Revenez ici une fois que le domaine affiche Vérifié.

Tester avec une vraie connexion

C'est l'étape qui permet d'activer le SSO en toute sécurité : vous prouvez que tout l'aller-retour fonctionne avant que cela n'affecte qui que ce soit.

  1. Dans l'assistant, choisissez Tester la connexion.
  2. Vous êtes envoyé vers votre fournisseur d'identité pour vous connecter, exactement comme votre équipe le fera.
  3. En cas de succès, Kliv enregistre le test réussi et déverrouille le bouton Activer.
  4. En cas d'échec, Kliv vous montre ce qu'il attendait et ce que votre fournisseur a réellement envoyé : voir Dépanner une connexion SSO échouée. Corrigez le problème chez votre fournisseur et testez de nouveau.

Vous ne pouvez pas activer le SSO tant qu'une connexion de test n'a pas réussi avec la configuration exacte que vous allez activer. Un simple enregistrement ne suffit jamais.

Activer

Une fois le test réussi, choisissez Activer. Désormais, quand quelqu'un saisit une adresse e-mail de votre domaine vérifié, Kliv l'envoie vers votre fournisseur d'identité pour se connecter. Les personnes qui se connectent pour la première fois voient un compte Kliv créé automatiquement, avec un accès membre standard.

Les nouveaux membres arrivent uniquement dans votre groupe « tout le monde ». Ils n'obtiennent ni l'accès administrateur ni aucun rôle élevé de la part de votre fournisseur d'identité, sauf si vous le configurez délibérément : voir Faire correspondre les groupes IdP aux rôles Kliv.

Après la configuration

Votre page Authentification unique affiche désormais une carte d'état à la place de l'assistant : votre fournisseur, votre domaine vérifié, la dernière connexion réussie, et un avertissement si votre certificat de signature approche de son expiration. Surveillez cet avertissement : un certificat expiré bloque les connexions jusqu'à ce que vous en téléversiez un nouveau.

Pour exiger que tous les utilisateurs de votre domaine utilisent le SSO (tout en gardant un moyen sûr de revenir en cas de panne), voir Exiger le SSO et définir des administrateurs de secours.