Skip to main content
Dit artikel is automatisch vertaald.

Overzicht

Deze gids is voor IT-beheerders die Microsoft Entra ID verbinden met de globale authenticatie van Legora voor single sign-on (SSO). Leden melden zich daarna bij Legora aan met hun Entra ID-accounts. U werkt op twee plekken: het Microsoft Entra-beheercentrum en Authentication in Legora. Entra ID gebruikt OpenID Connect met de globale authenticatie van Legora.
Uw organisatie moet de globale authenticatie van Legora gebruiken en uw rol moet Manage authentication security omvatten. Zie Hoe beheer ik authenticatie voor mijn organisatie?.Als uw organisatie nog niet is overgestapt op de globale authenticatie, stelt Legora-ondersteuning single sign-on (SSO) in. Neem contact op met support@legora.com. Om een bestaande organisatie te verplaatsen, zie IT Admin-gids: de globale authenticatie van Legora.

Hoe het werkt

Elke stap vermeldt waar u die uitvoert. Rond de Entra-stappen af voordat u de verbinding in Legora test.

Stap 1: De enterprise-app maken (in Entra)

Maak in Entra de enterprise-app waarmee Legora leden aanmeldt. Entra maakt ook een bijbehorende app-registratie, die u in stap 2 en 3 gebruikt. Legora moet een non-gallery enterprise application zijn. Maak de app met de onderstaande stappen onder Enterprise apps, zodat Entra deze als non-gallery-toepassing instelt. Gallery-toepassingen melden dat ze SCIM niet ondersteunen, zodat provisioning voor Directory Sync niet beschikbaar blijft. Als die van u een gallery-toepassing is, of als u deze onder App registrations hebt gemaakt, maakt u een nieuwe enterprise-app en gebruikt u die voor aanmelden en provisioning.
  1. Meld u aan bij het Microsoft Entra-beheercentrum.
  2. Ga naar Entra ID > Enterprise apps en selecteer New application.
  3. Selecteer Create your own application.
  4. Vul het formulier in en selecteer Create:
    • What’s the name of your app?: Een naam die beschrijft waar de app voor is, bijvoorbeeld “Legora SSO.”
    • What are you looking to do with your application?: Selecteer Integrate any other application you don’t find in the gallery (Non-gallery).
  5. Ga naar Entra ID > App registrations, selecteer All applications en open de app met de naam die u hebt ingevoerd.
  6. Kopieer op de pagina Overview van de app-registratie deze waarden voor stap 4:
    • Application (client) ID
    • Directory (tenant) ID

Stap 2: De omleidings-URI toevoegen (in Entra)

Registreer de callback van Legora zodat Entra leden na aanmelding kan terugsturen.
  1. Ga in uw app-registratie naar Authentication.
  2. Selecteer Add a platform en kies daarna Web.
  3. Plak deze omleidings-URI en selecteer Configure:
https://sso.legora.com/api/oauth/oidc Gebruik deze URI voor elke organisatie op de globale authenticatie van Legora. Nadat u de verbinding in stap 4 hebt gemaakt, toont Redirect URL op de verbinding dezelfde waarde. Als Entra vraagt welke OpenID Connect-scopes u wilt toestaan, schakel dan openid, profile en email in. Legora heeft het e-mailadres na aanmelding nodig. Voornaam en achternaam worden aanbevolen. Als deze app-registratie al omleidings-URI’s heeft van een oudere Legora-aanmeldconfiguratie, laat die staan en voeg de URI hierboven toe. Verwijder de oudere URI’s pas nadat uw organisatie de overstap naar de globale authenticatie van Legora heeft afgerond. De volledige takenlijst staat in IT Admin-gids: de globale authenticatie van Legora.

Stap 3: Een clientgeheim maken (in Entra)

Maak het geheim dat Legora gebruikt om verbinding te maken met uw app-registratie.
  1. Ga in uw app-registratie naar Certificates & secrets > Client secrets en selecteer New client secret.
  2. Voeg een beschrijving toe, bijvoorbeeld “Legora SSO secret,” en kies de vervaldatum.
  3. Selecteer Add, kopieer daarna de Value en bewaar die op een veilige plek. Entra toont de Value maar één keer. Het geheim-ID kan niet in Legora worden geplakt.
Stel een herinnering in een paar dagen voordat het geheim verloopt. Wanneer het clientgeheim verloopt Maak een nieuw clientgeheim in Entra en werk daarna Legora bij:
  1. Selecteer in het menu bij uw naam Settings > People > Authentication.
  2. Selecteer onder SSO de verbinding.
  3. Selecteer onder Connection details Edit.
  4. Voer de nieuwe waarde in bij Client secret. Laat het veld alleen leeg als u het huidige geheim wilt behouden.
  5. Opslaan.
U hebt geen nieuwe verbinding nodig om een geheim te vernieuwen.

Stap 4: De verbindingsgegevens toevoegen (in Legora)

Voer in Legora de waarden van stap 1 tot 3 in. Gebruik voor het domein een domein dat uw organisatie bezit. In het Entra-beheercentrum vindt u het onder Entra ID > Domain names. Gebruik een geverifieerd domein zoals legora.com. Sla een domein over dat eindigt op onmicrosoft.com.
  1. Selecteer in het menu bij uw naam Settings > People > Authentication.
  2. Selecteer onder SSO Add en kies daarna Entra ID.
  3. Vul het formulier in:
    • Display Name: De naam die leden zien op het aanmeldscherm.
    • Domain: Het domein van uw organisatie.
    • Tenant ID: De Directory (tenant) ID uit stap 1.
    • Client ID: De Application (client) ID uit stap 1.
    • Client Secret: De geheimwaarde uit stap 3.
  4. Selecteer Create connection. Legora opent de nieuwe verbinding.
Controleer het domein, de tenant-ID en de client-ID voordat u de verbinding maakt. Om later andere waarden te gebruiken, maakt u een nieuwe verbinding. Edit kan de weergavenaam, de discovery-URL en het clientgeheim wijzigen.

Stap 5: Gebruikers en groepen toewijzen (in Entra)

Kies wie zich via Entra bij Legora kan aanmelden.
  1. Ga naar Entra ID > Enterprise apps en selecteer de app die u in stap 1 hebt gemaakt.
  2. Kies in Properties of elke gebruiker in uw directory zich kan aanmelden of alleen de gebruikers die u toewijst. Assignment required? is standaard No. Zet het op Yes om alleen toegewezen gebruikers en groepen toe te staan.
  3. Als toewijzing verplicht is, ga naar Users and groups en selecteer Add user/group.
  4. Selecteer de gebruikers of groepen die toegang tot Legora moeten hebben en selecteer daarna Assign.

Stap 6: De verbinding testen (in Legora)

Bevestig dat de verbinding werkt voordat leden ervan afhankelijk zijn.
  1. Selecteer in het menu bij uw naam Settings > People > Authentication.
  2. Selecteer onder SSO de verbinding.
  3. Selecteer Test connection. Er opent een aanmeldvenster.
Als Microsoft u vraagt machtigingen goed te keuren, moet een Entra-beheerder mogelijk toestemming geven voordat de test kan eindigen. Als de test mislukt, controleer de omleidings-URI, de client-ID en het clientgeheim en voer de test opnieuw uit. Als het opnieuw mislukt, neem contact op met support@legora.com.

Stap 7: De verbinding inschakelen (in Legora)

Maak de verbinding beschikbaar voor leden. Schakel op de verbinding Status in. Leden kunnen zich dan aanmelden met Entra ID. Tot u dat doet, blijft de verbinding geconfigureerd maar verschijnt die niet als aanmeldmethode.

Wie kan toetreden

Entra bepaalt wie kan authenticeren. Legora bepaalt wie lid wordt. U stelt lidmaatschap in op de verbinding, onder Auto-provision en Email domains.

Auto-provision ingeschakeld

Wanneer Auto-provision is ingeschakeld, voegt Legora iemand toe de eerste keer dat die persoon zich aanmeldt met een e-mailadres op een vermeld domein. Die persoon moet nog steeds toestemming hebben om in Entra te authenticeren. App-toewijzing, voorwaardelijke toegang en multifactorauthenticatie blijven in Entra. Voeg minstens één domein toe onder Email domains voordat u Auto-provision inschakelt. De verbinding moet actief zijn. Als Directory Sync voor de verbinding is ingeschakeld, gebruik Directory Sync om lidmaatschap te beheren. Zie Directory Sync.

Auto-provision uitgeschakeld

Wanneer Auto-provision is uitgeschakeld, kan iemand nog steeds in Entra authenticeren. Legora voegt die persoon pas toe nadat een Admin die persoon uitnodigt en die de uitnodiging accepteert. Zonder actief lidmaatschap stopt de aanmelding. Legora toont: “User has no active membership in any of the connection organisations.” Om toegang te geven, sta de persoon toe in Entra en nodig die uit in Legora. Om toegang te verwijderen, verwijder die persoon uit de Entra-app of uit de organisatie in Legora.

Veelgestelde vragen

Deze antwoorden behandelen de aanmeldproblemen die beheerders het vaakst melden nadat de verbinding is ingeschakeld.

Wat gebeurt er wanneer een gebruiker uit de enterprise-app in Entra wordt verwijderd?

Die persoon kan zich niet meer via die app aanmelden. Het Legora-profiel blijft bestaan. Als u die persoon opnieuw aan de app toewijst, kan die zich aanmelden, zolang die nog lid is of Auto-provision die persoon kan toevoegen. Als de organisatie ook Directory Sync gebruikt, trekt het deactiveren of verwijderen van de gebruiker in Entra de toegang tot de organisatie in. Het verwijdert het Legora-profiel niet.

Waarom meldt een gebruiker zich aan bij een leeg Legora-account?

Wanneer Auto-provision is ingeschakeld, maakt Legora het account aan op basis van het e-mailadres dat Entra stuurt. Als dat adres afwijkt van de uitnodiging, bijvoorbeeld jdoe@example.com in plaats van jane.doe@example.com, maakt Legora een apart account voor het Entra-adres. Laat het e-mailadres in Entra overeenkomen met het adres dat in Legora wordt gebruikt, of neem contact op met support@legora.com.

Waarom kan iemand de aanmelding niet afronden?

Dit betekent meestal dat Auto-provision is uitgeschakeld en dat de persoon niet is uitgenodigd, of dat het lidmaatschap is verwijderd. Legora toont: “User has no active membership in any of the connection organisations.” Nodig die persoon uit in Legora, of schakel Auto-provision in voor het e-maildomein. Die persoon heeft ook toegang nodig tot de Legora-app in Entra.

We hebben meerdere domeinen, maar SSO start niet voor allemaal

Voeg elk domein toe onder Email domains op de verbinding. Neem die domeinen ook op in de toegestane domeinen van de organisatie. Selecteer in het menu bij uw naam Settings > People > Authentication. Selecteer onder Restrictions Approved email domains en bewerk daarna Allowed domains. Met één SSO-verbinding kan Legora de aanmelding routeren met de toegestane domeinen van de organisatie. Met meer dan één verbinding worden alleen domeinen op een verbinding waarvan Auto-provision is ingeschakeld gebruikt om die verbinding te kiezen.

Aanvullende bronnen

Deze pagina’s behandelen de rest van de aanmeldconfiguratie.