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 attributid 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.- Depuis votre nom dans le menu, sélectionnez Settings. Sous People, sélectionnez Authentication.
- Sous SSO, sélectionnez Add, puis SAML, ADFS ou PingFederate.
- Saisissez un Connection name, puis sélectionnez Continue.
- 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 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 :
- Microsoft Entra ID
- Okta
- PingFederate
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é.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.
Alias d’attributs standard
Alias d’attributs standard
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.- Saisissez sa Metadata URL, ou les Entity ID, Sign-In Endpoint URL et Signing Certificate (PEM) du fournisseur d’identité.
- Sélectionnez Complete setup.
- 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 deid 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.
- 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.
- Sélectionnez Test connection et connectez-vous avec la première personne.
- 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
idet les autres champs d’identifiant, notammentNameIDdansSubjectet l’attribut standardnameidentifier. - Démarrez une nouvelle connexion avec cette même personne. L’identifiant doit rester identique.
- 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.
- Pour la nouvelle connexion, activez Status pour les connexions contrôlées ci-dessous. Laissez Auto-provision désactivé.
- 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.
- 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.