> ## Documentation Index
> Fetch the complete documentation index at: https://support.legora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vejledning til SAML SSO-integration

> Konfigurer SAML single sign-on med forbindelsesspecifikke URL'er og stabile, unikke brugeridentifikatorer.

Denne artikel er maskinoversat.

## Oversigt

Forbind din SAML 2.0-identitetsudbyder, så medlemmer kan logge ind på Legora med deres arbejdsoplysninger. Trinnene gælder for **SAML**, **ADFS** og **PingFederate**, herunder en Entra-virksomhedsapplikation, der er konfigureret til SAML. Udbyderindstillingen **Entra ID** bruger [OpenID Connect](https://support.legora.com/da/integration-overview-entra-id-single-sign-on.md).

## Forudsætninger

> [!NOTE]
>
> Din organisation skal bruge Legoras globale autentificering, og din rolle skal omfatte **Manage authentication security**. Du skal også have administratoradgang til din identitetsudbyder. Se [Administrer autentificering](https://support.legora.com/da/how-do-i-manage-authentication-for-my-organization.md).

## Sådan fungerer det

Legora reserverer tjenesteudbyderoplysninger for hver ny SAML-forbindelse. Du registrerer disse værdier hos din identitetsudbyder og importerer derefter den pågældende applikations metadata til Legora. Legora modtager assertionen på Assertion Consumer Service (ACS)-URL'en.

Tjenesteudbyderens **Entity ID (Identifier)** identificerer Legora-forbindelsen. Din identitetsudbyders **Entity ID** identificerer udstederen. For nye forbindelser skal du sende en `id`-attribut med en stabil, unik værdi for hver person.

## Konfigurer forbindelsen

Start i Legora for at hente værdierne til din forbindelse. Behold eksisterende fungerende forbindelser og deres identifikatortilknytninger uændret, mens du forbereder en ny forbindelse.

### Start konfigurationen i Legora

Reserver forbindelsen, før du konfigurerer din identitetsudbyder.

1. Fra dit navn i menuen skal du vælge **Indstillinger**. Under **People** skal du vælge **Authentication**.
2. Under **SSO** skal du vælge **Add** og derefter **SAML**, **ADFS** eller **PingFederate**.
3. Angiv et **Connection name**, og vælg **Continue**.
4. Kopiér **Entity ID (Identifier)** og **ACS URL (Reply URL)** fra konfigurationssiden. Du kan vende tilbage til konfigurationen senere.

### Konfigurer din identitetsudbyder

Opret en SAML-applikation, og angiv de nøjagtige værdier, der vises af Legora.

| Indstilling hos identitetsudbyderen | Værdi, der skal kopieres fra Legora |
| - | - |
| Entity ID, Audience URI eller Identifier | **Entity ID (Identifier)** |
| ACS URL, Single Sign-On URL eller Reply URL | **ACS URL (Reply URL)** |

Kopiér de fulde værdier, der vises for din forbindelse. Tilføj eller fjern ikke en afsluttende skråstreg. I Okta hedder Identifier-feltet **Audience URI (SP Entity ID)**.

Hvis Legora Support giver dig et link til tjenesteudbyderens metadata, skal du kontrollere, at dets Entity ID og ACS URL svarer til de viste værdier. En URL til identitetsudbyderens metadata beskriver den applikation, du importerer til Legora.

### Knyt brugeridentifikatorer og attributter

Brug disse SAML-attributnavne med værdier fra den indloggede brugers katalogpost:

> [!WARNING]
>
> For en eksisterende SAML-forbindelse skal du kontakte [Legora Support](mailto:support@legora.com), før du tilføjer `id` eller ændrer en identifikators kilde, format eller tilknytning. En anden identifikator kan påvirke adgangen til eksisterende konti, selvom e-mailadresserne forbliver de samme. Behold den aktuelle konfiguration, indtil I har aftalt en [migreringsplan](#migrating-to-legoras-new-authentication-protocol).

| SAML-attribut | Værdi |
| - | - |
| `id` | En stabil, unik katalogidentifikator for hver bruger. |
| `email` | Personens arbejdsmailadresse, som er nødvendig for at logge ind på Legora. |
| `firstName` | Personens fornavn, anbefalet. |
| `lastName` | Personens efternavn, anbefalet. |

For hver ny SAML-forbindelse skal du tilføje en attribut med navnet `id` og knytte den til den indloggede brugers stabile, unikke katalogidentifikator. Angiv den eksplicit i stedet for at basere dig på `NameID`, en anden identifikatorattribut eller en reserveværdi, der er afledt af e-mailadressen.

Følg din udbyders vejledning for at tilføje disse attributter til en ny applikation:

> [tab] Microsoft Entra ID
>
> [Tilføj applikationsspecifikke SAML-claims](https://learn.microsoft.com/en-us/entra/identity-platform/saml-claims-customization#add-application-specific-claims). Brug attributnavnene i tabellen med et tomt **Namespace**, og sørg for, at `user.mail` er udfyldt.
>
> | SAML-attribut | Værdi |
> | - | - |
> | `id` | `user.objectid` |
> | `email` | `user.mail` |
> | `firstName` | `user.givenname` |
> | `lastName` | `user.surname` |

> [tab] Okta
>
> Brug [Oktas aktuelle claims-grænseflade](https://help.okta.com/oie/en-us/content/topics/apps/federated-claims-overview.htm) til at tilføje disse attributter:
>
> | SAML-attribut | Værdi |
> | - | - |
> | `id` | `user.id` |
> | `email` | `user.profile.email` |
> | `firstName` | `user.profile.firstName` |
> | `lastName` | `user.profile.lastName` |
>
> Applikationer, der bruger **Show legacy configuration**, anvender andre udtryk. Se [Oktas vejledning til ældre attributudsagn](https://help.okta.com/oie/en-us/content/topics/apps/define-attribute-statements.htm).

> [tab] PingFederate
>
> [Opret en attributkontrakt](https://docs.pingidentity.com/pingfederate/13.0/administrators_reference_guide/help_assertioncreationtasklet_createattributecontractstate.html), og [knyt dens værdier](https://docs.pingidentity.com/pingfederate/13.0/administrators_reference_guide/pf_configuring_contract_fulfillment_idp_browser_sso.html). Tilføj attributterne ovenfor, og knyt `id` til din katalogtjenestes vedvarende brugeridentifikator.
>
> Kildenavnene på felterne afhænger af den tilsluttede katalogtjeneste eller adapter. Vælg det felt, der leverer hver værdi:
>
> | SAML-attribut | Værdi |
> | - | - |
> | `id` | Vedvarende, unik brugeridentifikator |
> | `email` | Arbejdsmailadresse |
> | `firstName` | Fornavn |
> | `lastName` | Efternavn |

Vælg en identifikator, der ikke er tom, forbliver den samme for en person mellem logins og er forskellig for alle andre personer. Foretræk en vedvarende katalogidentifikator, der ikke tildeles igen, og som understøttes af din udbyder. Identifikatoren kan være forskellig fra personens e-mailadresse.

`NameID` er brugeridentifikatoren i `Subject` i et SAML-svar. Den er adskilt fra attributterne i tabellen ovenfor: En eksplicit `id`- eller `nameidentifier`-attribut kan have forrang frem for `NameID`.

Kontrollér kilden til `NameID` og eventuelle `id`- eller `nameidentifier`-attributter, som din udbyder sender. De skal identificere den indloggede person konsekvent. Undgå fast tekst, tenant-id'er, applikations-id'er, delte adresser og midlertidige værdier, der genereres for hvert login. Et visningsnavn er uegnet, fordi flere personer kan have samme navn, eller fordi navnet kan ændres.

Bekræft, at det anvendte `NameID`-format understøttes af din udbyder og forbindelse. En e-mailbaseret identifikator kræver en plan for ændringer og genbrug af adresser.

> [accordion] Standardaliaser for attributter
>
> Eksisterende tilknytninger kan bruge disse standardaliaser med præfikset:
>
> `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/`
>
> | Suffiks for standardattribut | Legora-attribut |
> | - | - |
> | `nameidentifier` | `id` |
> | `emailaddress` | `email` |
> | `givenname` | `firstName` |
> | `surname` | `lastName` |

### Færdiggør konfigurationen i Legora

Importér konfigurationen for den applikation, du lige har oprettet.

1. Angiv dens **Metadata URL**, eller angiv identitetsudbyderens **Entity ID**, **Sign-In Endpoint URL** og **Signing Certificate (PEM)**.
2. Vælg **Complete setup**.
3. For den nye forbindelse skal du lade **Status** og **Auto-provision** være slået fra, indtil de kontrollerede, fulde logins nedenfor er gennemført.

### Kontrollér med to testbrugere

Log ind to gange som samme person for at kontrollere, at identifikatoren er stabil, og log derefter ind som en anden person for at kontrollere, at identifikatorerne er forskellige. Et vellykket login kan stadig bruge en identifikator, der fejlagtigt er delt.

**Test connection** viser ikke SAML-attributter og sammenligner ikke brugere. Bed din identitetsudbyders administrator om at kontrollere SAML-svaret for hvert testlogin ved hjælp af udbyderens svarvisning eller et SAML-sporingsværktøj, der er godkendt af organisationen. Hvis du ikke kan se disse værdier, skal du kontakte Legora Support for at få hjælp, før du aktiverer forbindelsen.

For en ny forbindelse skal du kontrollere den eksplicitte `id`-værdi i hver af testene nedenfor. Hvis den mangler eller er tom, skal du rette tilknytningen, før du aktiverer forbindelsen, også selvom **Test connection** lykkes. For en eksisterende forbindelse skal du kontrollere den etablerede identifikatortilknytning uden at ændre den.

1. Tildel to forskellige testbrugere til applikationen hos identitetsudbyderen. Begge skal allerede være medlemmer af din Legora-organisation og have hver sin katalogpost og arbejdsmailadresse. Begræns adgangen til disse testbrugere for en ny applikation, indtil kontrollen er gennemført.
2. Vælg **Test connection**, og log ind som den første bruger.
3. Åbn svaret for dette login i identitetsudbyderens svarvisning eller i et SAML-sporingsværktøj, der er godkendt af organisationen. Kontrollér `id` og eventuelle andre identifikatorfelter, herunder `NameID` i `Subject` og standardattributten `nameidentifier`.
4. Start et nyt login som den samme bruger. Kontrollér, at identifikatoren er uændret.
5. Brug en separat browserprofil eller privat session til den anden bruger. Kontrollér, at brugerens identifikator er forskellig fra den første brugers. Kontrollér, at hver brugers e-mail- og navneattributter svarer til katalogposten.
6. Aktivér **Status** for den nye forbindelse til de kontrollerede logins nedenfor. Lad **Auto-provision** være slået fra.
7. Før en bred udrulning eller automatisk klargøring skal du arrangere et kontrolleret, fuldt Legora-login for begge brugere. Bekræft, at hver bruger kommer ind på sin egen konto og i den forventede organisation. Medtag et nyt login for den første bruger. Konfigurationsvinduet alene udfører ikke denne kontokontrol.
8. Når begge brugere har bestået disse kontroller, skal du udvide adgangen til applikationen hos identitetsudbyderen som planlagt. Aktivér først **Auto-provision**, når de tilsigtede tildelinger og e-maildomæner er bekræftet.

Hvis en af identifikatorerne ændres mellem logins, hvis begge brugere deler en identifikator, eller hvis en uventet konto vises, skal du stoppe udrulningen og kontakte [support@legora.com](mailto:support@legora.com). Undlad at sende tokens, private nøgler og rå assertions via e-mail eller i supportsager.

## Migrer en eksisterende forbindelse

Samarbejd med Legora Support om at sammenligne de aktuelle og foreslåede identifikatorer og afgøre, om kontomigrering er nødvendig. Aftal en kontrolleret udrulning, kontroller af, at tilbagevendende brugere kommer ind på deres eksisterende konti, og en plan for tilbagerulning, før du ændrer konfigurationen.

**Migrering til global autentificering**

Forbered en separat applikation med værdierne fra den nye forbindelses konfiguration. Behold den fungerende applikation og dens delte eller forbindelsesspecifikke callback, indtil et koordineret skift er blevet kontrolleret. Brug [vejledningen til migrering af global autentificering](https://support.legora.com/da/it-admin-guide-legora-s-new-authentication-protocol.md) til den bredere migrering.

## Fejlfinding

Sammenlign forbindelsens viste værdier med identitetsudbyderens konfiguration og attributtilknytninger.

### Reply URL eller audience afvises

Kopiér den nøjagtige Identifier og ACS URL for denne forbindelse. En vellykket hentning af metadata bekræfter ikke i sig selv, at begge værdier stemmer overens.

### Manglende eller forkert profil

Kontrollér SAML-attributnavnene og værdierne for hver bruger ovenfor. Sørg for, at personen har en arbejdsmailadresse, og at den sendes i den konfigurerede e-mailattribut. Når konfigurationen af metadata er færdig, er den enkelte brugers attributter ikke valideret.

### Uventet konto eller skiftende identifikator

Stop udrulningen. Gennemgå alle identifikatorkilder med Legora Support, før du ændrer en eksisterende tilknytning.

Kontakt [support@legora.com](mailto:support@legora.com), hvis disse kontroller ikke løser problemet.
