Skip to main content
Cet article a été traduit automatiquement.

Vue d’ensemble

Connectez votre fournisseur d’identité SAML 2.0 pour que les membres se connectent à Legora avec leurs identifiants professionnels. Ces étapes concernent SAML, ADFS et PingFederate, y compris une application d’entreprise Entra configurée pour SAML. L’option Entra ID utilise OpenID Connect, pas SAML. Voir OpenID Connect.

Prérequis

Votre organisation doit utiliser l’authentification globale de Legora. Vous devez disposer de Manage authentication security dans Legora et d’un accès administrateur au fournisseur d’identité. Consultez Gérer l’authentification.

Fonctionnement

Legora réserve les paramètres du fournisseur de services pour chaque nouvelle connexion SAML. Enregistrez-les chez votre fournisseur d’identité, puis importez les métadonnées de cette application dans Legora. Legora reçoit l’assertion à l’URL Assertion Consumer Service (ACS). L’Entity ID (Identifier) du fournisseur de services identifie la connexion Legora. L’Entity ID du fournisseur d’identité identifie l’émetteur. Pour les nouvelles connexions, envoyez un attribut id avec une valeur stable et unique pour chaque personne.

Configurer la connexion

Commencez dans Legora. Conservez les connexions fonctionnelles et leurs correspondances d’identifiants pendant la préparation.

Commencer dans Legora

Réservez d’abord la connexion.
  1. Depuis votre nom dans le menu, sélectionnez Settings. Sous People, sélectionnez Authentication.
  2. Sous SSO, sélectionnez Add, puis SAML, ADFS ou PingFederate.
  3. Saisissez un Connection name, puis sélectionnez Continue.
  4. Copiez Entity ID (Identifier) et ACS URL (Reply URL). Vous pourrez reprendre cette configuration plus tard.

Configurer le fournisseur d’identité

Créez une application SAML. Copiez Entity ID (Identifier) dans Entity ID, Audience URI ou Identifier, et ACS URL (Reply URL) dans ACS URL, Single Sign-On URL ou Reply URL. Copiez les valeurs complètes affichées pour votre connexion. N’ajoutez ni ne supprimez de barre oblique finale. Dans Okta, le champ Identifier s’appelle Audience URI (SP Entity ID). Si le support fournit un lien de métadonnées du fournisseur de services, vérifiez que son Entity ID et son URL ACS correspondent aux valeurs affichées. L’URL de métadonnées du fournisseur d’identité décrit l’application à importer dans Legora.

Associer les identifiants et attributs des utilisateurs

Associez ces attributs SAML à la fiche d’annuaire de la personne connectée :
Pour une connexion SAML existante, contactez le support Legora avant d’ajouter id ou de modifier la source, le format ou la correspondance d’un identifiant. Un identifiant différent peut affecter l’accès aux comptes existants, même si les adresses e-mail restent identiques. Conservez la configuration actuelle jusqu’à ce qu’un plan de migration ait été convenu.
Pour chaque nouvelle connexion SAML, ajoutez un attribut nommé id et associez-le à l’identifiant d’annuaire stable et unique de la personne connectée. Configurez-le explicitement au lieu de vous appuyer sur NameID, un autre attribut d’identifiant ou une valeur de repli dérivée de l’adresse e-mail. Pour une nouvelle application, suivez les instructions de votre fournisseur pour ajouter ces attributs :
Ajoutez des claims SAML propres à l’application. Utilisez les noms d’attributs du tableau avec un Namespace vide et vérifiez que user.mail est renseigné.
Choisissez un identifiant non vide, stable entre les connexions d’une même personne et différent pour chaque personne. Privilégiez un identifiant d’annuaire permanent, jamais réattribué et pris en charge par le fournisseur. Il peut différer de l’adresse e-mail. NameID est l’identifiant de l’utilisateur dans le Subject d’une réponse SAML. Il est distinct des attributs du tableau ci-dessus : un attribut explicite id ou nameidentifier peut être prioritaire sur NameID. Vérifiez NameID et les attributs id ou nameidentifier envoyés. Ils doivent identifier systématiquement la personne connectée. Évitez les textes fixes, identifiants de locataire ou d’application, adresses partagées, noms d’affichage et valeurs générées à chaque connexion. Vérifiez la prise en charge du format NameID par le fournisseur et la connexion. Un identifiant fondé sur l’e-mail exige un plan pour les changements et réattributions d’adresse.
Les correspondances existantes peuvent utiliser ces alias standard avec le préfixe :http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

Terminer la configuration dans Legora

Importez la configuration de l’application que vous venez de créer.
  1. Saisissez sa Metadata URL, ou les Entity ID, Sign-In Endpoint URL et Signing Certificate (PEM) du fournisseur d’identité.
  2. Sélectionnez Complete setup.
  3. Pour la nouvelle connexion, laissez Status et Auto-provision désactivés jusqu’aux connexions complètes contrôlées ci-dessous.

Vérifier avec deux utilisateurs de test

Connectez deux fois la même personne pour vérifier la stabilité de l’identifiant, puis une seconde personne pour vérifier que leurs identifiants diffèrent. Une connexion réussie peut tout de même utiliser un identifiant partagé par erreur. Test connection n’affiche pas les attributs SAML et ne compare pas les utilisateurs. Demandez à l’administrateur de votre fournisseur d’identité d’examiner la réponse SAML envoyée à chaque connexion de test, avec l’outil de visualisation du fournisseur ou un outil de traçage SAML approuvé par votre organisation. Si ces valeurs ne sont pas accessibles, contactez le support Legora avant d’activer la connexion. Pour une nouvelle connexion, vérifiez la valeur explicite de id dans chacun des tests ci-dessous. Si elle est absente ou vide, corrigez la correspondance avant d’activer la connexion, même si Test connection réussit. Pour une connexion existante, vérifiez la correspondance d’identifiants en place sans la modifier.
  1. Affectez deux personnes distinctes à l’application du fournisseur d’identité. Elles doivent déjà être membres de votre organisation Legora, chacune avec sa fiche d’annuaire et son e-mail professionnel. Pour une nouvelle application, limitez l’accès à ces personnes jusqu’à la fin de la vérification.
  2. Sélectionnez Test connection et connectez-vous avec la première personne.
  3. Ouvrez la réponse de cette connexion dans l’outil de visualisation des réponses de votre fournisseur d’identité ou dans un outil de traçage SAML approuvé par votre organisation. Vérifiez id et les autres champs d’identifiant, notamment NameID dans Subject et l’attribut standard nameidentifier.
  4. Démarrez une nouvelle connexion avec cette même personne. L’identifiant doit rester identique.
  5. Utilisez un autre profil de navigateur ou une session privée pour la seconde personne. Son identifiant doit être différent. Vérifiez les e-mails et les noms des deux personnes.
  6. Pour la nouvelle connexion, activez Status pour les connexions contrôlées ci-dessous. Laissez Auto-provision désactivé.
  7. Avant un déploiement étendu ou l’activation du provisionnement automatique, organisez une connexion complète contrôlée à Legora pour chacune. Vérifiez leur propre compte et l’organisation attendue, puis reconnectez la première personne. La fenêtre de test ne réalise pas ce contrôle des comptes.
  8. Une fois ces vérifications réussies pour les deux personnes, étendez l’accès à l’application du fournisseur d’identité comme prévu. Activez Auto-provision seulement après avoir confirmé les affectations et les domaines d’e-mail prévus.
Si un identifiant change, si les deux personnes partagent un identifiant ou si un compte inattendu apparaît, interrompez le déploiement et contactez support@legora.com. Ne transmettez pas de jetons, clés privées ou assertions brutes par e-mail ou ticket.

Migrer une connexion existante

Comparez les identifiants actuels et proposés avec le support Legora pour déterminer si une migration des comptes est nécessaire. Avant de modifier la configuration, convenez d’un déploiement contrôlé, de vérifications de l’accès aux comptes existants lors des reconnexions et d’un plan de retour à la configuration précédente. Migration vers l’authentification globale Ne supprimez aucune URL de rappel existante avant la vérification de la bascule coordonnée. Préparez une application distincte avec les valeurs de la nouvelle connexion. Conservez l’application fonctionnelle et son rappel partagé ou spécifique jusqu’à la vérification d’une transition coordonnée. Consultez le guide de migration vers l’authentification globale.

Résoudre les problèmes

Comparez les valeurs affichées pour la connexion avec la configuration du fournisseur d’identité et les correspondances d’attributs.

URL de réponse ou audience refusée

Copiez exactement l’Identifier et l’URL ACS de cette connexion. Un téléchargement réussi des métadonnées ne confirme pas leur correspondance.

Profil incomplet ou incorrect

Vérifiez les noms des attributs SAML et les valeurs propres à chaque utilisateur indiqués ci-dessus. Assurez-vous que la personne possède une adresse e-mail professionnelle et que celle-ci est transmise dans l’attribut e-mail configuré. L’import des métadonnées ne valide pas les attributs d’une personne.

Compte inattendu ou identifiant changeant

Interrompez le déploiement et examinez les sources d’identifiants avec le support avant toute modification. Si le problème persiste, contactez support@legora.com.