Skip to main content
Den här artikeln är maskinöversatt.

Översikt

Anslut er SAML 2.0-identitetsleverantör så att medlemmar kan logga in i Legora med sitt arbetskonto. Stegen gäller SAML, ADFS och PingFederate, inklusive Entra-företagsappar med SAML. Alternativet Entra ID använder OpenID Connect.

Förutsättningar

Organisationen måste använda Legoras globala autentisering. Du behöver behörigheten Manage authentication security i Legora och administratörsåtkomst hos identitetsleverantören. Se Hantera autentisering.

Så fungerar det

Legora reserverar tjänsteleverantörens uppgifter för varje ny SAML-anslutning. Registrera dem hos identitetsleverantören och importera sedan appens metadata till Legora. Legora tar emot intyget på Assertion Consumer Service-adressen (ACS). Tjänsteleverantörens Entity ID (Identifier) identifierar Legora-anslutningen. Identitetsleverantörens Entity ID identifierar utfärdaren. För nya anslutningar skickar du ett id-attribut med ett stabilt, unikt värde för varje person.

Konfigurera anslutningen

Börja i Legora. Behåll fungerande anslutningar och deras identifierarmappningar medan du förbereder den nya anslutningen.

Börja i Legora

Reservera anslutningen först.
  1. Från ditt namn i menyn väljer du Settings. Under People väljer du Authentication.
  2. Under SSO väljer du Add och sedan SAML, ADFS eller PingFederate.
  3. Ange ett Connection name och välj Continue.
  4. Kopiera Entity ID (Identifier) och ACS URL (Reply URL). Du kan återkomma till konfigurationen senare.

Konfigurera identitetsleverantören

Skapa en SAML-app. Kopiera Entity ID (Identifier) till Entity ID, Audience URI eller Identifier och ACS URL (Reply URL) till ACS URL, Single Sign-On URL eller Reply URL. Kopiera de fullständiga värden som visas för anslutningen. Lägg inte till eller ta bort ett avslutande snedstreck. I Okta heter Identifier-fältet Audience URI (SP Entity ID). Om Legora support tillhandahåller en länk till tjänsteleverantörens metadata, kontrollera att dess Entity ID och ACS-adress matchar anslutningens värden. Identitetsleverantörens metadatalänk beskriver appen som importeras till Legora.

Mappa användaridentifierare och attribut

Mappa dessa SAML-attribut till personens katalogpost:
För en befintlig SAML-anslutning ska du kontakta Legora support innan du lägger till id eller ändrar en identifierares källa, format eller mappning. En annan identifierare kan påverka åtkomsten till befintliga konton, även om e-postadresserna är oförändrade. Behåll den nuvarande konfigurationen tills ni har kommit överens om en migreringsplan.
Lägg till ett attribut med namnet id för varje ny SAML-anslutning och mappa det till den inloggade personens stabila, unika katalogidentifierare. Konfigurera det uttryckligen i stället för att förlita dig på NameID, ett annat identifierarattribut eller ett reservvärde som härleds från e-postadressen. För en ny app följer du leverantörens instruktioner för att lägga till dessa attribut:
Lägg till appspecifika SAML-claims. Använd attributnamnen i tabellen med tomt Namespace och kontrollera att user.mail har ett värde.
Välj en identifierare som inte är tom, förblir densamma för en person mellan inloggningar och skiljer sig för varje person. Föredra en beständig katalogidentifierare som inte återanvänds och som leverantören stöder. Den kan skilja sig från e-postadressen. NameID är användarens identifierare i Subject i ett SAML-svar. Den är skild från attributen i tabellen ovan: ett uttryckligt id- eller nameidentifier-attribut kan ha företräde framför NameID. Kontrollera NameID och alla skickade id- eller nameidentifier-attribut. De ska konsekvent identifiera personen som loggar in. Undvik fasta texter, klientorganisations- eller app-ID:n, delade adresser, visningsnamn och värden som skapas på nytt vid varje inloggning. Kontrollera att leverantören och anslutningen stöder NameID-formatet. E-postbaserade identifierare kräver en plan för adressändringar och återanvändning.
Befintliga mappningar kan använda dessa standardalias med prefixet:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

Slutför i Legora

Importera konfigurationen för appen du just skapade.
  1. Ange appens Metadata URL, eller identitetsleverantörens Entity ID, Sign-In Endpoint URL och Signing Certificate (PEM).
  2. Välj Complete setup.
  3. Låt Status och Auto-provision vara avstängda för den nya anslutningen fram till de kontrollerade, fullständiga inloggningarna nedan.

Verifiera med två testanvändare

Logga in två gånger som samma person för att kontrollera att identifieraren är stabil. Logga sedan in som en annan person för att kontrollera att identifierarna skiljer sig åt. En lyckad inloggning kan fortfarande använda en felaktigt delad identifierare. Test connection visar inte SAML-attribut och jämför inte användare. Be identitetsleverantörens administratör kontrollera SAML-svaret som skickas vid varje testinloggning, med leverantörens svarsvisare eller ett SAML-spårningsverktyg som organisationen har godkänt. Om du inte kan se dessa värden kontaktar du Legora support innan du aktiverar anslutningen. För en ny anslutning kontrollerar du det uttryckliga id-värdet i varje test nedan. Om det saknas eller är tomt korrigerar du mappningen innan du aktiverar anslutningen, även om Test connection lyckas. För en befintlig anslutning kontrollerar du den etablerade identifierarmappningen utan att ändra den.
  1. Tilldela appen hos identitetsleverantören två olika testpersoner. Båda måste redan vara medlemmar i din Legora-organisation, med egna katalogposter och arbetsadresser. Begränsa åtkomsten till en ny app till dessa testpersoner tills kontrollen är klar.
  2. Välj Test connection och logga in som den första personen.
  3. Öppna svaret för den inloggningen i identitetsleverantörens svarsvisare eller i ett SAML-spårningsverktyg som organisationen har godkänt. Kontrollera id och andra identifierarfält, inklusive NameID inuti Subject och standardattributet nameidentifier.
  4. Starta en ny inloggning som samma person. Identifieraren ska vara oförändrad.
  5. Använd en separat webbläsarprofil eller privat session för den andra personen. Identifieraren ska skilja sig från den förstas. Kontrollera bådas e-post- och namnattribut.
  6. Aktivera Status för den nya anslutningen inför de kontrollerade inloggningarna nedan. Låt Auto-provision vara avstängd.
  7. Ordna kontrollerade, fullständiga Legora-inloggningar för båda före bred utrullning eller automatisk provisionering. Kontrollera att var och en når sitt eget konto och rätt organisation. Upprepa den första personens inloggning. Testfönstret gör inte denna kontokontroll.
  8. Utöka åtkomsten till appen hos identitetsleverantören enligt plan när båda personerna har klarat dessa kontroller. Aktivera Auto-provision först efter att avsedda tilldelningar och e-postdomäner har bekräftats.
Stoppa utrullningen om en identifierare ändras, båda personerna delar identifierare eller ett oväntat konto visas. Kontakta support@legora.com. Skicka inte token, privata nycklar eller råa intyg via e-post eller supportärenden.

Migrera en befintlig anslutning

Jämför nuvarande och föreslagna identifierare med Legora support och avgör om kontona behöver migreras. Kom överens om en kontrollerad utrullning, kontroller av att återkommande användare når sina befintliga konton och en plan för återställning innan konfigurationen ändras. Migrering till global autentisering Förbered en separat app med den nya anslutningens värden. Behåll den fungerande appen och dess gemensamma eller anslutningsspecifika callback tills en samordnad övergång har verifierats. Se guiden för global autentisering.

Felsökning

Jämför anslutningens visade värden med identitetsleverantörens konfiguration och attributmappningar.

Reply URL eller audience avvisas

Kopiera exakt Identifier och ACS URL för anslutningen. Hämtade metadata bekräftar inte att båda matchar.

Profilen saknas eller är felaktig

Kontrollera SAML-attributnamnen och värdena per användare ovan. Se till att personen har en e-postadress på arbetet och att den skickas i det konfigurerade e-postattributet. Metadataimport verifierar inte en persons attribut.

Oväntat konto eller ändrad identifierare

Stoppa utrullningen och granska identifierarkällorna med Legora support innan befintliga mappningar ändras. Kontakta support@legora.com om problemet kvarstår.