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

Aperçu

Ce guide s’adresse aux Admins et aux administrateurs TI qui migrent leur organisation vers l’authentification globale de Legora. Vous effectuez vous-même la migration à partir de la page Migration d’authentification dans les Paramètres. L’authentification globale donne à votre organisation sa propre adresse de connexion et une seule configuration de connexion pour l’ensemble de Legora. La migration comporte six étapes. Les étapes 3 à 5 dépendent de la façon dont votre organisation utilise Legora; consultez le tableau pour savoir lesquelles s’appliquent à vous. Faites chaque changement en plus de votre configuration existante. Ne retirez aucune URL ni aucun paramètre existant avant la fin de la migration.
Vous devez avoir le rôle Admin, et votre rôle doit inclure Manage authentication security. La page Migration d’authentification apparaît seulement lorsque la migration libre-service est activée pour votre organisation. Si vous avez plus d’une organisation Legora, migrez chacune séparément. Vous n’avez pas à les migrer en même temps.
Pour ouvrir la page, à partir de votre nom dans le menu, sélectionnez Paramètres > Personnes > Migration d’authentification. Toutes les étapes, sauf l’étape 5, commencent sur cette page.

Étape 1 : Examiner le domaine dédié de votre organisation

Cette étape définit l’adresse à laquelle vos utilisateurs se connectent après la migration. La page Migration d’authentification l’affiche comme Custom URL, par exemple https://acme.app.legora.com.
Quand vous avez besoin de cette étape : Toujours.
  1. Sur la page Migration d’authentification, examinez Custom URL. Legora la remplit pour votre organisation.
  2. Pour la modifier, sélectionnez Edit custom URL, entrez un nouveau Subdomain, puis sélectionnez Save.
Le sous-domaine doit être unique dans Legora. Utilisez des lettres minuscules, des chiffres et des traits d’union, jusqu’à 63 caractères. Il ne peut pas commencer ni se terminer par un trait d’union. Vous ne pouvez plus modifier l’URL personnalisée après avoir complété la migration; choisissez-la donc maintenant. Vérification : Custom URL affiche votre nouvelle adresse, et Terminer la migration ne vous demande plus de définir une URL personnalisée.

Étape 2 : Configurer la connexion des membres

Cette étape configure la connexion pour l’authentification globale. Vous inscrivez le service de connexion global de Legora auprès de votre fournisseur d’identité, comme Okta ou Microsoft Entra ID, et choisissez si les membres conservent l’adresse courriel et le mot de passe. Vos connexions existantes continuent de fonctionner pendant que vous préparez les nouvelles.
Quand vous avez besoin de cette étape : Toujours. Si votre organisation n’utilise pas le SSO, passez les changements au fournisseur d’identité et confirmez seulement la connexion par courriel et mot de passe.
Legora utilise une URL de rappel pour chaque protocole de connexion. Ajoutez celle qui correspond à votre connexion :
  • SAML : https://sso.legora.com/api/oauth/saml
  • OpenID Connect (OIDC) : https://sso.legora.com/api/oauth/oidc
Ajoutez l’URL de rappel au bon endroit pour votre fournisseur :
  • Okta : Okta prend en charge SAML et OIDC. Ajoutez l’URL du protocole que vous utilisez pour Legora dans Sign-in redirect URIs, dans les paramètres de l’application Legora.
  • Microsoft Entra ID : Utilisez OIDC. Ajoutez l’URL de rappel OIDC aux Redirect URIs de l’inscription d’application Legora. Voir Aperçu de l’intégration — authentification unique Entra ID.
  • Autres fournisseurs d’identité : Ajoutez l’URL de rappel correspondant au protocole de votre fournisseur, en suivant la documentation de votre fournisseur.

Connexions SAML

Une inscription d’application SAML est liée à l’Entity ID de Legora; vous ne pouvez donc pas rediriger votre application SAML existante vers l’authentification globale. Créez-en plutôt une nouvelle :
  1. Dans votre fournisseur d’identité, créez une nouvelle inscription d’application SAML.
  2. Copiez Legora entity ID et Legora ACS URL à partir de New SAML app settings sur la page Migration d’authentification dans la nouvelle inscription d’application :
    • Entity ID, Audience URI ou Identifier : https://sso.legora.com
    • ACS URL, Single Sign-On URL ou Reply URL : https://sso.legora.com/api/oauth/saml
  3. Laissez votre application SAML existante telle quelle. Elle continue de servir les connexions jusqu’à ce que vous complétiez la migration.
Legora ne prend pas en charge plus d’une inscription d’application SAML dans le même locataire Microsoft Entra. Si vous en avez plusieurs, déplacez ces connexions vers OIDC plutôt que de créer de nouvelles applications SAML.

Portées et revendications OpenID Connect

Si votre fournisseur d’identité demande quelles portées OIDC Legora exige, activez celles-ci :
  • openid : Requise pour la connexion OIDC.
  • profile : Fournit le nom de l’utilisateur.
  • email : Fournit l’adresse courriel professionnelle de l’utilisateur.
Legora a besoin d’une adresse courriel après la connexion. Le prénom et le nom de famille sont recommandés. Vous n’avez pas besoin d’une portée de groupe. L’appartenance à l’organisation Legora contrôle l’accès, et Directory sync se configure séparément. Si votre fournisseur d’identité demande un type de client, choisissez un client OIDC standard avec le flux Authorization Code.

Connecter et tester

  1. Sous Existing connections, sélectionnez Move à côté de chaque connexion OIDC pour la transférer.
  2. Sous New connections, sélectionnez Add pour ajouter chaque nouvelle connexion SAML.
  3. Sélectionnez Exécuter le test pour chaque connexion et connectez-vous avec votre fournisseur d’identité.

Connexion par courriel et mot de passe

Ce paramètre détermine si les membres peuvent se connecter avec une adresse courriel et un mot de passe après la migration. La carte Email and password s’affiche lorsque des membres se connectent aujourd’hui avec un mot de passe. Les changements s’appliquent immédiatement à la nouvelle page de connexion, et les membres continuent d’utiliser votre page de connexion actuelle jusqu’à ce que vous complétiez la migration.
  • Votre organisation utilise le SSO : Sous Keep email-and-password sign-in after migration?, choisissez Yes, keep email and password ou No, use SSO only, puis sélectionnez Save.
  • Votre organisation n’utilise pas le SSO : Sélectionnez Confirm pour conserver l’adresse courriel et le mot de passe.
Les membres qui conservent l’adresse courriel et le mot de passe doivent réinitialiser leur mot de passe la première fois qu’ils utilisent la nouvelle page de connexion. Vérification : Chaque connexion SSO active affiche Réussi, et la carte Email and password affiche votre choix.

Étape 3 : Mettre à jour les URL de rappel des intégrations

Cette étape permet à vos intégrations de renvoyer les utilisateurs vers Legora après leur connexion. Vous ajoutez une nouvelle URL de redirection dans les paramètres d’administration de chaque intégration.
Quand vous avez besoin de cette étape : Votre organisation utilise iManage sur site, SharePoint, Google Drive ou Microsoft 365 avec sa propre application Entra. La section Integration checks de la page Migration d’authentification liste iManage sur site, SharePoint et Google Drive lorsque vous devez les mettre à jour. Microsoft 365 n’y figure pas; vérifiez donc vous-même son paramètre Entra app.
Ajoutez la nouvelle URL comme URI de redirection autorisée. Conservez vos URL existantes. Utilisez ces URL exactes, même si vos utilisateurs se connectent à votre URL personnalisée. Vérification : Sous Integration checks, sélectionnez Exécuter le test pour chaque intégration et complétez la connexion dans la fenêtre contextuelle. Chacune affiche Réussi. Si votre navigateur bloque la fenêtre contextuelle, autorisez les fenêtres contextuelles pour Legora et réessayez.

Étape 4 : Installer les add-ins Word et Outlook Global

Cette étape prépare les add-ins Word et Outlook Global, qui remplacent les add-ins régionaux. Les add-ins régionaux cessent de fonctionner dès que vous complétez la migration, et les add-ins Global fonctionnent seulement après celle-ci.
Quand vous avez besoin de cette étape : Votre organisation utilise l’add-in Word ou Outlook de Legora. Préparez le déploiement avant d’activer l’authentification globale à l’étape 6, puis déployez-le tout de suite après.
Les add-ins Global sont des installations distinctes. Choisissez la méthode qui convient à votre organisation : Les clavardages Assistant de Word ne sont pas transférés vers le Word Add-in Global. Informez les utilisateurs qu’ils peuvent les exporter à partir du Word Add-in régional. Voir Qu’arrive-t-il aux clavardages Assistant et Agent? Vérification : Après l’étape 6, ouvrez les add-ins Global dans Word et Outlook et connectez-vous.

Étape 5 : Mettre à jour les règles de pare-feu

Cette étape permet à votre réseau de joindre les services de connexion globaux. Appliquez les règles au trafic sortant, ainsi qu’au trafic entrant lorsque la configuration de votre réseau, de votre proxy ou de votre pare-feu l’exige.
Quand vous avez besoin de cette étape : Votre réseau, votre proxy ou votre pare-feu restreint le trafic vers Legora.
Autorisez le trafic HTTPS (TCP 443) vers ces domaines :
  • Votre URL personnalisée de l’étape 1, par exemple https://acme.app.legora.com
  • https://app.legora.com
  • https://login.legora.com
  • https://identity.legora.com
  • https://token.legora.com
  • https://sso.legora.com, si vous utilisez le SSO
  • https://auth.legora.com
  • https://word-addin.legora.com, pour le Word Add-in Global
  • https://outlook-addin.legora.com, pour l’Outlook Add-in Global
Votre URL personnalisée est le seul domaine propre à votre organisation. Les autres sont les mêmes pour toutes les organisations. Gardez vos domaines Legora régionaux, comme auth.eu.legora.com, dans la liste d’autorisation. Pour la liste complète, voir Exigences réseau et de domaine Legora. Vérification : À partir d’un appareil sur le réseau de votre entreprise, ouvrez votre URL personnalisée et connectez-vous. Demandez ensuite à un petit groupe d’utilisateurs de faire de même et de confirmer que leur travail habituel, y compris les intégrations, fonctionne toujours.

Étape 6 : Activer l’authentification globale

Cette étape bascule toute votre organisation vers l’authentification globale. Vous ne pouvez pas l’annuler; planifiez-la donc en dehors des heures de travail et avisez vos utilisateurs à l’avance.
Quand vous avez besoin de cette étape : Toujours, après avoir terminé les étapes qui s’appliquent à vous.
  1. Sélectionnez votre URL personnalisée pour ouvrir la nouvelle page de connexion dans un nouvel onglet. Connectez-vous pour vérifier que votre configuration de l’étape 2 fonctionne. Les membres continuent d’utiliser votre page de connexion actuelle jusqu’à ce que vous terminiez la migration.
  2. Si votre organisation exige l’authentification à deux facteurs, choisissez Transfer MFA settings pour conserver l’exigence, ou Skip transfer.
  3. Sélectionnez Terminer la migration.
  4. Examinez l’URL personnalisée dans la confirmation, puis sélectionnez Terminer la migration.
Terminer la migration reste indisponible tant que toutes ces conditions ne sont pas remplies. Sa description vous indique ce qui manque encore.
  • Votre URL personnalisée est définie.
  • Chaque vérification d’intégration et chaque connexion SSO active affichent Réussi.
  • Au moins une méthode de connexion est active, et votre paramètre de courriel et de mot de passe est enregistré.
  • Vous avez fait un choix pour la MFA, si votre organisation exige l’authentification à deux facteurs.

Ce qui arrive lorsque vous complétez la migration

Le changement s’applique à tout le monde dans votre organisation en même temps :
  • Les utilisateurs restent connectés. Personne n’est déconnecté lorsque vous complétez la migration.
  • Les utilisateurs SSO continuent de se connecter avec le SSO et ne remarqueront aucune différence.
  • Les utilisateurs courriel et mot de passe définissent un mot de passe la prochaine fois qu’ils se connectent. Legora leur envoie par courriel un code provenant de Réinitialisez votre mot de passe Legora, et le nouveau mot de passe doit comporter au moins 15 caractères. Pour les étapes utilisateur, voir Pourquoi ne puis-je pas me connecter à Legora?.
  • Authentification à deux facteurs : Si vous avez transféré les paramètres MFA, les membres configurent de nouveau l’authentification à deux facteurs après la migration.
  • URL régionales : Les utilisateurs qui ouvrent une URL Legora régionale alors qu’ils sont connectés sont redirigés vers votre URL personnalisée.
  • Add-ins : Les add-ins Word et Outlook régionaux cessent de fonctionner et demandent aux utilisateurs de changer d’add-in. Déployez maintenant les add-ins Global de l’étape 4.
  • Paramètres : La page Migration d’authentification est retirée. Vous gérez la connexion à partir de Paramètres > Personnes > Authentification. Voir Comment gérer l’authentification pour mon organisation?.
Partagez votre URL personnalisée avec vos utilisateurs pour qu’ils y accèdent directement.

FAQ

Ces réponses couvrent les questions fréquentes des Admins et des utilisateurs pendant et après la migration.

Comment les utilisateurs se connectent-ils à l’application mobile?

Après la migration, les utilisateurs se reconnectent à l’application mobile Legora. À l’écran de connexion, ils sélectionnent Global comme région de données, puis se connectent avec leur méthode habituelle. Voir FAQ de l’application mobile Legora.

Qu’arrive-t-il aux clavardages Assistant et Agent?

Les clavardages Agent et les clavardages Assistant d’Outlook sont stockés dans Legora; ils restent donc accessibles dans les add-ins Global. Les utilisateurs n’ont rien à faire. Les clavardages Assistant de Word, y compris les résultats de Playbook, sont stockés dans le Word Add-in régional et ne sont pas transférés. Les utilisateurs peuvent les exporter à partir du Word Add-in régional et les importer dans le Word Add-in Global. L’add-in régional offre encore Exporter maintenant après la migration. Voir Comment déplacer l’historique Assistant du Word Add-in vers le Global Add-in.

Pouvons-nous encore inviter d’autres clients Legora dans notre Portal?

Oui, une fois que les deux organisations utilisent l’authentification globale. D’ici là, les invitations Portal envoyées à un autre client Legora ne fonctionnent pas. Les invitations envoyées à des clients qui n’utilisent pas Legora ne sont pas touchées.

Puis-je annuler la migration?

Non. Après avoir sélectionné Terminer la migration, votre organisation reste sur l’authentification globale et vous ne pouvez plus modifier l’URL personnalisée.

Dois-je migrer toutes mes organisations Legora en même temps?

Non. Migrez chaque organisation à partir de sa propre page Migration d’authentification, lorsqu’elle est prête.

Pourquoi https://sso.legora.com affiche-t-il « 404 Not Found »?

sso.legora.com est un service de connexion, pas un site web; son adresse racine affiche donc 404 Not Found par conception. Le SSO fonctionne quand même. Utilisez les URL de rappel complètes de l’étape 2 et testez avec Exécuter le test.

Pourquoi Terminer la migration est-il indisponible?

Consultez la description sous Terminer la migration. Elle indique ce qui manque : une URL personnalisée, une vérification qui n’a pas réussi, vos paramètres de connexion ou un choix pour la MFA. Après avoir corrigé la configuration, relancez tout test qui affiche Failed ou Not tested.