Skip to main content
Dit artikel is automatisch vertaald.

Overzicht

Koppel uw SAML 2.0-identiteitsprovider zodat leden met hun werkaccount kunnen inloggen bij Legora. Deze stappen gelden voor SAML, ADFS en PingFederate, inclusief Entra-bedrijfsapps met SAML. De provideroptie Entra ID gebruikt OpenID Connect.

Vereisten

Uw organisatie moet de globale authenticatie van Legora gebruiken. U hebt Manage authentication security in Legora en beheerderstoegang tot uw identiteitsprovider nodig. Zie Authenticatie beheren.

Hoe het werkt

Legora reserveert serviceprovidergegevens voor elke nieuwe SAML-verbinding. Registreer deze bij de identiteitsprovider en importeer daarna de metadata van die app in Legora. Legora ontvangt de assertion op de Assertion Consumer Service-URL (ACS). De Entity ID (Identifier) van de serviceprovider identificeert de Legora-verbinding. De Entity ID van de identiteitsprovider identificeert de uitgever. Stuur voor nieuwe verbindingen een attribuut id met een stabiele, unieke waarde voor elke persoon.

De verbinding instellen

Begin in Legora. Behoud werkende verbindingen en hun identifierkoppelingen terwijl u de nieuwe verbinding voorbereidt.

Beginnen in Legora

Reserveer eerst de verbinding.
  1. Selecteer vanuit uw naam in het menu Settings. Selecteer onder People de optie Authentication.
  2. Selecteer onder SSO Add en vervolgens SAML, ADFS of PingFederate.
  3. Voer een Connection name in en selecteer Continue.
  4. Kopieer Entity ID (Identifier) en ACS URL (Reply URL). U kunt later terugkeren naar deze configuratie.

De identiteitsprovider configureren

Maak een SAML-app. Kopieer Entity ID (Identifier) naar Entity ID, Audience URI of Identifier en ACS URL (Reply URL) naar ACS URL, Single Sign-On URL of Reply URL. Kopieer de volledige waarden die voor uw verbinding worden weergegeven. Voeg geen afsluitende slash toe en verwijder er geen. In Okta heet het Identifier-veld Audience URI (SP Entity ID). Als Legora-support een link naar serviceprovidermetadata geeft, controleert u of de Entity ID en ACS-URL overeenkomen met de getoonde waarden. De metadata-URL van de identiteitsprovider beschrijft de app die u in Legora importeert.

Gebruikersidentifiers en attributen koppelen

Koppel deze SAML-attributen aan het directoryrecord van de aangemelde persoon:
Neem bij een bestaande SAML-verbinding contact op met Legora-support voordat u id toevoegt of de bron, het formaat of de mapping van een identifier wijzigt. Een andere identifier kan de toegang tot bestaande accounts beïnvloeden, ook als de e-mailadressen gelijk blijven. Behoud de huidige configuratie totdat u een migratieplan hebt afgesproken.
Voeg voor elke nieuwe SAML-verbinding een attribuut met de naam id toe en koppel het aan de stabiele, unieke directory-identifier van de aangemelde persoon. Configureer dit expliciet in plaats van te vertrouwen op NameID, een ander identifierattribuut of een terugvalwaarde die van het e-mailadres wordt afgeleid. Volg voor een nieuwe app de instructies van uw provider om deze attributen toe te voegen:
Voeg appspecifieke SAML-claims toe. Gebruik de attribuutnamen uit de tabel met een lege Namespace en zorg dat user.mail is ingevuld.
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. NameID is de gebruikersidentifier in het Subject van een SAML-respons. Deze staat los van de attributen in de bovenstaande tabel: een expliciet attribuut id of nameidentifier kan voorrang hebben op NameID. Controleer NameID en alle meegestuurde attributen id of nameidentifier. Ze moeten de aangemelde persoon consistent identificeren. Vermijd vaste tekst, tenant- of app-ID’s, gedeelde adressen, weergavenamen en waarden die bij elke aanmelding opnieuw worden gegenereerd. Controleer of de provider en verbinding het NameID-formaat ondersteunen. Voor identifiers op basis van e-mail is een plan voor adreswijzigingen en hergebruik nodig.
Bestaande mappings kunnen deze standaardaliassen met het volgende voorvoegsel gebruiken:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

De configuratie voltooien in Legora

Importeer de configuratie van de zojuist gemaakte app.
  1. Voer de Metadata URL in, of de Entity ID, Sign-In Endpoint URL en het Signing Certificate (PEM) van de identiteitsprovider.
  2. Selecteer Complete setup.
  3. Laat voor de nieuwe verbinding Status en Auto-provision uitgeschakeld tot de onderstaande gecontroleerde, volledige aanmeldingen.

Controleren met twee testgebruikers

Meld dezelfde persoon tweemaal aan om te controleren of de identificatie stabiel blijft. Meld vervolgens een tweede persoon aan om te controleren of de identificaties verschillen. Een geslaagde aanmelding kan nog steeds een onbedoeld gedeelde identificatie gebruiken. Test connection toont geen SAML-attributen en vergelijkt geen gebruikers. Vraag de beheerder van uw identiteitsprovider de SAML-respons voor elke testaanmelding te controleren, met de responsviewer van de provider of een door uw organisatie goedgekeurde SAML-tracingtool. Als u deze waarden niet kunt bekijken, neem dan contact op met Legora-support voordat u de verbinding activeert. Controleer voor een nieuwe verbinding de expliciete id-waarde in elk van de onderstaande tests. Ontbreekt deze of is deze leeg, corrigeer dan de mapping voordat u de verbinding activeert, ook als Test connection slaagt. Controleer bij een bestaande verbinding de bestaande identifiermapping zonder deze te wijzigen.
  1. Wijs twee verschillende testpersonen toe aan de applicatie bij uw identiteitsprovider. Beiden moeten al lid zijn van uw Legora-organisatie, met ieder een eigen directoryrecord en zakelijk e-mailadres. Beperk bij een nieuwe applicatie de toegang tot deze testpersonen totdat de controle is afgerond.
  2. Selecteer Test connection en meld u aan als de eerste persoon.
  3. Open de respons voor die aanmelding in de responsviewer van uw identiteitsprovider of in een door uw organisatie goedgekeurde SAML-tracingtool. Controleer id en andere identifiervelden, waaronder NameID binnen Subject en het standaardattribuut nameidentifier.
  4. Start een nieuwe aanmelding als dezelfde persoon. De identifier moet gelijk blijven.
  5. Gebruik een apart browserprofiel of een privésessie voor de tweede persoon. De identifier moet verschillen van die van de eerste. Controleer e-mail en namen voor beide personen.
  6. Schakel voor de nieuwe verbinding Status in voor de onderstaande gecontroleerde aanmeldingen. Laat Auto-provision uitgeschakeld.
  7. Regel vóór brede uitrol of automatische provisioning een gecontroleerde volledige Legora-aanmelding voor beiden. Controleer hun eigen account en de verwachte organisatie en herhaal de aanmelding van de eerste persoon. Het testvenster voert deze accountcontrole niet uit.
  8. Breid de toegang tot de applicatie bij uw identiteitsprovider volgens plan uit nadat beide personen deze controles hebben doorstaan. Schakel Auto-provision pas in nadat u de bedoelde toewijzingen en e-maildomeinen hebt bevestigd.
Stop de uitrol als een identifier verandert, beide personen dezelfde identifier hebben of een onverwacht account verschijnt. Neem contact op met support@legora.com. Stuur geen tokens, privésleutels of onbewerkte assertions via e-mail of supporttickets.

Een bestaande verbinding migreren

Vergelijk samen met Legora-support de huidige en voorgestelde identifiers en bepaal of accountmigratie nodig is. Spreek vóór de configuratiewijziging een gecontroleerde uitrol af, controles dat terugkerende gebruikers hun bestaande accounts bereiken en een plan om de vorige configuratie te herstellen. Migratie naar globale authenticatie Bereid een aparte app voor met de waarden van de nieuwe verbinding. Behoud de werkende app en haar gedeelde of verbindingsspecifieke callback totdat een afgestemde overstap is gecontroleerd. Zie de handleiding voor globale authenticatie.

Problemen oplossen

Vergelijk de weergegeven verbindingswaarden met de configuratie van de identiteitsprovider en de attribuuttoewijzingen.

Reply URL of audience geweigerd

Kopieer exact de Identifier en ACS-URL van deze verbinding. Succesvol opgehaalde metadata bevestigen niet dat beide overeenkomen.

Ontbrekend of onjuist profiel

Controleer de bovenstaande SAML-attribuutnamen en waarden per gebruiker. Zorg dat de persoon een zakelijk e-mailadres heeft en dat dit in het ingestelde e-mailattribuut wordt verzonden. Het importeren van metadata valideert geen individuele gebruikersattributen.

Onverwacht account of veranderende identifier

Stop de uitrol en controleer de bronnen samen met Legora-support voordat u bestaande koppelingen wijzigt. Neem contact op met support@legora.com als het probleem blijft bestaan.