Skip to main content
Dit artikel is automatisch vertaald.

Overzicht

Deze gids is voor Admins en IT-beheerders die hun organisatie overzetten naar de globale authenticatie van Legora. U voert de migratie zelf uit via de pagina Authenticatiemigratie in Instellingen. Met globale authenticatie krijgt uw organisatie een eigen aanmeldadres en één aanmeldconfiguratie voor heel Legora. De migratie bestaat uit zes stappen. Stap 2 tot en met 5 hangen af van hoe uw organisatie Legora gebruikt. Controleer daarom in de tabel welke voor u van toepassing zijn. Breng elke wijziging aan naast uw bestaande configuratie. Verwijder geen bestaande URL’s of instellingen totdat de migratie is voltooid.
U hebt de machtiging Let members configure SSO and IP restrictions nodig, die standaard in de Admin-rol zit. De pagina Authenticatiemigratie verschijnt alleen als selfservicemigratie voor uw organisatie is ingeschakeld. Als u meer dan één Legora-organisatie hebt, migreer dan elke organisatie afzonderlijk. U hoeft ze niet tegelijk te migreren.
De pagina Authenticatiemigratie in Instellingen begeleidt u stap voor stap door de volledige migratie, in dezelfde volgorde als deze gids. Deze toont welke tests zijn geslaagd en wat nog ontbreekt voordat u de migratie kunt voltooien. Om de pagina te openen, selecteert u via uw naam in het menu Instellingen > Personen > Authenticatiemigratie.

Stap 1: Controleer het speciale domein van uw organisatie

In deze stap stelt u het adres in waarop uw gebruikers zich na de migratie aanmelden. De pagina Authenticatiemigratie toont dit als Custom URL, bijvoorbeeld https://acme.app.legora.com.
Wanneer u deze stap nodig hebt: Altijd.
  1. Controleer op de pagina Authenticatiemigratie de Custom URL. Legora vult deze in voor uw organisatie.
  2. Om deze te wijzigen, selecteert u het bewerkpictogram naast Custom URL, voert u een nieuw Subdomain in en selecteert u Save.
Het subdomein moet uniek zijn binnen heel Legora. Gebruik kleine letters, cijfers en koppeltekens, tot 63 tekens. Het mag niet beginnen of eindigen met een koppelteken. Na het voltooien van de migratie kunt u de custom URL niet meer wijzigen, dus kies deze nu. Controleer het: Custom URL toont uw nieuwe adres, en Migratie voltooien vraagt u niet langer een custom URL in te stellen.

Stap 2: Stel in hoe leden zich aanmelden

In deze stap stelt u het aanmelden voor globale authenticatie in. U registreert de globale aanmeldservice van Legora bij uw identity provider, zoals Okta of Microsoft Entra ID, en kiest of leden e-mail en wachtwoord behouden. Uw bestaande verbindingen blijven werken terwijl u de nieuwe voorbereidt.
Wanneer u deze stap nodig hebt: Uw organisatie gebruikt SSO. Als dat niet zo is, slaat u de wijzigingen in de identity provider over en bevestigt u alleen aanmelden met e-mail en wachtwoord. Zonder die bevestiging kunt u de migratie niet voltooien.
Kopieer de volledige ACS-URL en SP-Identifier die voor deze SAML-verbinding worden weergegeven. Nieuwe verbindingen gebruiken /api/oauth/saml/<connection-id>. Bestaande verbindingen kunnen de gedeelde callback /api/oauth/saml of een opgegeven aangepaste waarde gebruiken. Kopieer de volledige URL die voor de verbinding wordt getoond, inclusief hostnaam en pad.
  • OpenID Connect (OIDC): https://sso.legora.com/api/oauth/oidc. Registreer deze URL als toegestane omleidings-URI voor aanmelden in de applicatie-instellingen van uw identity provider. Zie voor Entra ID de Entra ID-installatiehandleiding.

SAML-verbindingen

  1. Selecteer onder New connections Add om elke nieuwe SAML-verbinding toe te voegen.
  2. Voer een Connection name in en selecteer Continue.
  3. Kopieer Entity ID (Identifier) en ACS URL (Reply URL). U kunt later terugkeren naar deze configuratie.
Voer de Entity ID precies in zoals hierboven, zonder slash aan het einde. In Okta heet dit veld Audience URI (SP Entity ID). Zie voor SAML-gebruikersattributen de attribuuttoewijzingen. Houd de bestaande toepassing en callback beschikbaar totdat de afgestemde overstap is gecontroleerd.

SAML-attribuutinstructies

Kies een niet-lege identifier die voor dezelfde persoon bij elke aanmelding gelijk blijft en voor elke andere persoon verschilt. Gebruik bij voorkeur een permanente directory-identifier die nooit opnieuw wordt toegewezen en door de provider wordt ondersteund. Deze mag afwijken van het e-mailadres. Zie voor SAML-gebruikersattributen de attribuuttoewijzingen.

OpenID Connect-scopes en claims

Als uw identity provider vraagt welke OIDC-scopes Legora nodig heeft, schakel dan deze in:
  • openid: Vereist voor OIDC-aanmelding.
  • profile: Levert de naam van de gebruiker.
  • email: Levert het werk-e-mailadres van de gebruiker.
Legora heeft na aanmelding een e-mailadres nodig. Voornaam en achternaam worden aanbevolen. U hebt geen group-scope nodig. Lidmaatschap van de Legora-organisatie regelt de toegang, en directory sync wordt apart ingesteld. Als uw identity provider vraagt om een clienttype, kies dan een standaard OIDC-client met de Authorization Code-flow.

Verbinden en testen

  1. Selecteer onder Existing connections Move naast elke OIDC-verbinding om deze over te zetten.
  2. Selecteer Test uitvoeren bij elke verbinding en meld u aan bij uw identity provider.
Zie voor SAML-gebruikersattributen de attribuuttoewijzingen.

Aanmelden met e-mail en wachtwoord

Deze instelling bepaalt of leden zich na de migratie kunnen aanmelden met e-mail en wachtwoord. De kaart Email and password verschijnt als leden zich nu met een wachtwoord aanmelden. Wijzigingen gelden direct voor de nieuwe aanmeldpagina. Leden blijven uw huidige aanmeldpagina gebruiken totdat u de migratie voltooit.
  • Uw organisatie gebruikt SSO: Kies onder Keep email-and-password sign-in after migration? Yes, keep email and password of No, use SSO only en selecteer vervolgens Save.
  • Uw organisatie gebruikt geen SSO: Selecteer Confirm om e-mail en wachtwoord te behouden.
Leden die e-mail en wachtwoord behouden, moeten hun wachtwoord opnieuw instellen wanneer ze de nieuwe aanmeldpagina voor het eerst gebruiken. Controleer het: Elke actieve SSO-verbinding toont Geslaagd en de kaart Email and password toont uw keuze.

Stap 3: Werk integratie-callback-URL’s bij

Met deze stap kunnen uw integraties gebruikers na het verbinden terugsturen naar Legora. U voegt een nieuwe redirect-URL toe in de admin-instellingen van elke integratie.
Wanneer u deze stap nodig hebt: Uw organisatie gebruikt iManage on-premises, SharePoint, Google Drive of Microsoft 365 met uw eigen Entra-app. Stap 3 op de pagina Authenticatiemigratie toont iManage on-premises, SharePoint en Google Drive wanneer u die moet bijwerken. Microsoft 365 staat daar niet bij, dus controleer de instelling Entra app zelf.
Voeg de nieuwe URL toe als toegestane redirect URI. Laat uw bestaande URL’s staan. Gebruik precies deze URL’s, ook al melden uw gebruikers zich aan via uw custom URL. Controleer het: Selecteer in stap 3 op de pagina Authenticatiemigratie Test uitvoeren voor elke integratie en voltooi de aanmelding in de pop-up. Elke integratie toont Geslaagd. Als uw browser de pop-up blokkeert, sta pop-ups voor Legora toe en probeer het opnieuw.

Stap 4: Installeer de Global Word- en Outlook-add-ins

In deze stap bereidt u de Global Word- en Outlook-add-ins voor, die de regionale add-ins vervangen. De regionale add-ins werken niet meer zodra u de migratie voltooit, en de Global add-ins werken pas daarna.
Wanneer u deze stap nodig hebt: Uw organisatie gebruikt de Legora Word- of Outlook-add-in. Rol de Global add-ins uit voordat u in stap 6 globale authenticatie inschakelt.
De Global add-ins zijn aparte installaties. U kunt ze naast de regionale add-ins installeren. Installeren verwijdert of wijzigt de regionale add-ins niet, dus u kunt ze al vóór stap 6 uitrollen. Gebruikers melden zich pas na het voltooien van de migratie aan bij de Global add-ins. Houd de regionale Word Add-in geïnstalleerd totdat gebruikers hun Assistant-chats hebben geëxporteerd. Kies de methode die bij uw organisatie past: Word Assistant-chats worden niet overgezet naar de Global Word Add-in. Laat gebruikers weten dat ze die kunnen exporteren vanuit de regionale Word Add-in. Zie Wat gebeurt er met Assistant- en Agent-chats? Controleer het: Open na stap 6 de Global add-ins in Word en Outlook en meld u aan.

Stap 5: Werk firewallregels bij

Met deze stap kan uw netwerk de globale aanmeldservices bereiken. Pas de regels toe op uitgaand verkeer, en op inkomend verkeer wanneer uw netwerk-, proxy- of firewallopzet dat vereist.
Wanneer u deze stap nodig hebt: Uw netwerk, proxy of firewall beperkt verkeer naar Legora.
Sta HTTPS (TCP 443) toe naar deze domeinen:
  • Uw custom URL uit stap 1, bijvoorbeeld 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, als u SSO gebruikt
  • https://auth.legora.com
  • https://word-addin.legora.com, voor de Global Word Add-in
  • https://outlook-addin.legora.com, voor de Global Outlook Add-in
Uw custom URL is het enige domein dat specifiek is voor uw organisatie. De andere zijn voor elke organisatie hetzelfde. Houd uw regionale Legora-domeinen, zoals auth.eu.legora.com, toegestaan. Voor de volledige lijst, zie Netwerk- en domeinvereisten van Legora. Controleer het: Open vanaf een apparaat in uw bedrijfsnetwerk uw custom URL en meld u aan. Vraag daarna een kleine groep gebruikers hetzelfde te doen en te bevestigen dat hun gebruikelijke werk, inclusief integraties, nog steeds werkt. U kunt ook connectivity.legora.com openen vanaf uw bedrijfsnetwerk. De pagina controleert de globale aanmelddomeinen en maakt een rapport dat u naar support@legora.com kunt sturen.

Stap 6: Schakel globale authenticatie in

Met deze stap schakelt u uw hele organisatie over naar globale authenticatie. Dit kunt u niet ongedaan maken, dus plan het buiten werktijden en informeer uw gebruikers vooraf.
Wanneer u deze stap nodig hebt: Altijd, nadat u de stappen hebt afgerond die voor u van toepassing zijn.
  1. Selecteer uw custom URL om de nieuwe aanmeldpagina in een nieuw tabblad te openen. Meld u aan om te controleren of uw configuratie uit stap 2 werkt. Leden blijven uw huidige aanmeldpagina gebruiken totdat u de migratie voltooit.
  2. Als uw organisatie tweefactorauthenticatie vereist, kies dan Transfer MFA settings om de vereiste te behouden, of Skip transfer.
  3. Selecteer Migratie voltooien.
Migratie voltooien blijft onbeschikbaar totdat aan al deze voorwaarden is voldaan. De beschrijving ervan laat zien wat er nog ontbreekt.
  • Uw custom URL is ingesteld.
  • Elke actieve SSO-verbinding toont Geslaagd.
  • Ten minste één aanmeldmethode is actief en uw instelling voor e-mail en wachtwoord is opgeslagen.
  • U hebt een MFA-keuze gemaakt, als uw organisatie tweefactorauthenticatie vereist.
Integratiecontroles uit stap 3 blokkeren Migratie voltooien niet. Voer ze toch uit voordat u de migratie voltooit, om te bevestigen dat uw integraties blijven werken.

Wat er gebeurt wanneer u de migratie voltooit

De wijziging geldt voor iedereen in uw organisatie tegelijk:
  • Gebruikers blijven aangemeld. Niemand wordt afgemeld wanneer u de migratie voltooit.
  • SSO-gebruikers blijven zich via SSO aanmelden en merken geen verschil.
  • Gebruikers met e-mail en wachtwoord stellen een wachtwoord in wanneer ze zich de volgende keer aanmelden. Legora stuurt ze een code per e-mail van Reset your Legora password, en het nieuwe wachtwoord moet minstens 15 tekens bevatten. Voor de gebruikersstappen, zie Waarom kan ik niet aanmelden bij Legora?.
  • Tweefactorauthenticatie: Als u de MFA-instellingen hebt overgezet, stellen leden na de migratie opnieuw tweefactorauthenticatie in.
  • Regionale URL’s: Gebruikers die een regionale Legora-URL openen terwijl ze zijn aangemeld, worden doorgestuurd naar uw custom URL.
  • Add-ins: De regionale Word- en Outlook-add-ins werken niet meer en vragen gebruikers over te stappen. Als u de Global add-ins uit stap 4 nog niet hebt uitgerold, doe dit dan nu.
  • Instellingen: De pagina Authenticatiemigratie wordt verwijderd. U beheert de aanmelding via Instellingen > Personen > Authentication. Zie Hoe beheer ik authenticatie voor mijn organisatie?.
  • Profiel: Op de pagina Instellingen > Personal > Profile van elk lid toont Aanmelding onder Werkruimtetoegang de waarde Global. Gebruik dit om te bevestigen dat de migratie is toegepast.
Deel uw custom URL met uw gebruikers zodat ze daar rechtstreeks naartoe gaan.

FAQ

Deze antwoorden behandelen veelgestelde vragen van Admins en gebruikers tijdens en na de migratie.

Is de migratie verplicht?

Ja. Elke Legora-organisatie stapt over op globale authenticatie. Met één aanmeldsysteem houdt Legora het aanmelden op één plek veilig. Nieuwe functies waarvoor aanmelden nodig is, worden gebouwd op globale authenticatie.

Verandert er nog iets anders voor onze gebruikers?

Gebruikers behouden hun projecten, documenten en Agent-chats. De migratie verandert hoe gebruikers zich aanmelden en welke Word- en Outlook-add-ins ze gebruiken. Zie voor Assistant-chats in Word Wat gebeurt er met Assistant- en Agent-chats? Zie voor wat gebruikers zien bij de overstap Wat er gebeurt wanneer u de migratie voltooit.

Betekent “globaal” dat onze gegevens naar een andere regio verhuizen?

Nee. De gegevens van uw organisatie blijven in de regio waar Legora ze vandaag bewaart. Globale authenticatie verandert hoe leden zich aanmelden en op welk adres ze dat doen. Legora stuurt verzoeken van uw eigen URL naar de bestaande regio van uw organisatie. De aanmeldservice bewaart ook de accountgegevens waarmee leden worden herkend. Voor elk lid zijn dat de naam, het e-mailadres, het organisatielidmaatschap en de rol. Ook bewaart de service hoe iemand zich aanmeldt: met een wachtwoord of via single sign-on, met meervoudige authenticatie en met aanmeldsessies. Voor de organisatie bewaart de service de aanmeldinstellingen, inclusief de SSO-verbinding en de geaccepteerde e-maildomeinen. Documenten, projecten en chats bewaart de service niet.

Kan ik de migratie voltooien voordat de Global add-ins zijn uitgerold?

Ja. Migratie voltooien controleert de add-ins niet. Als u eerst de migratie voltooit, werken de regionale Word- en Outlook-add-ins niet meer en vraagt Legora gebruikers de Global add-ins te installeren. Legora in de browser blijft werken. Zie voor de installatiestappen Hoe installeer ik de Word Add-in? en De Outlook Add-in voor gebruikers installeren.

Hoe melden gebruikers zich aan in de mobiele app?

Na de migratie melden gebruikers zich opnieuw aan in de mobiele app van Legora. Op het aanmeldscherm selecteren ze Global als dataregio en melden ze zich vervolgens aan met hun gebruikelijke methode. Zie Veelgestelde vragen over de mobiele app van Legora.

Wat gebeurt er met Assistant- en Agent-chats?

Agent-chats en Outlook Assistant-chats worden in Legora opgeslagen en blijven dus beschikbaar in de Global add-ins. Gebruikers hoeven niets te doen. Word Assistant-chats, inclusief Playbook-resultaten, worden in de regionale Word Add-in opgeslagen en worden niet overgezet. Gebruikers kunnen ze exporteren vanuit de regionale Word Add-in en importeren in de Global Word Add-in. De regionale add-in biedt na de migratie nog steeds Nu exporteren. Zie Uw Word Add-in Assistant-geschiedenis verplaatsen naar de Global Add-in.

Kunnen we nog steeds andere Legora-klanten uitnodigen voor ons Portal?

Ja, zodra beide organisaties op globale authenticatie zitten. Tot die tijd werken Portal-uitnodigingen aan een andere Legora-klant niet. Uitnodigingen aan cliënten die Legora niet gebruiken, worden niet beïnvloed.

Kan ik de migratie ongedaan maken?

Nee. Nadat u Migratie voltooien hebt geselecteerd, blijft uw organisatie op globale authenticatie en kunt u de custom URL niet meer wijzigen.

Moet ik al mijn Legora-organisaties tegelijk migreren?

Nee. Migreer elke organisatie via haar eigen pagina Authenticatiemigratie, zodra die klaar is.

Waarom toont https://sso.legora.com “404 Not Found”?

sso.legora.com is een aanmeldservice, geen website, dus het rootadres toont bewust 404 Not Found. SSO werkt gewoon. Gebruik de volledige callback-URL’s uit stap 2 en test met Test uitvoeren.

Waarom mislukt de test van een SAML-verbinding?

Zie voor SAML-gebruikersattributen de attribuuttoewijzingen.

Waarom is Migratie voltooien onbeschikbaar?

Controleer de beschrijving onder Migratie voltooien. Die toont wat er ontbreekt: een custom URL, een SSO-verbindingstest die niet is geslaagd, uw aanmeldinstellingen of een MFA-keuze. Voer na het herstellen van de configuratie elke test die Failed of Not tested toont opnieuw uit.