# SAML 2.0-konfiguration

## Steg 1: Ställ in en SSO-identifierare

Användare som [autentiserar sin identitet med SSO](https://bitwarden.com/sv-se/help/using-sso/#login-using-sso/) kommer att behöva ange en **SSO-identifierare** som anger organisationen (och därför SSO-integrationen) att autentisera mot. Så här ställer du in en unik SSO-identifierare:

1. Logga in på [Bitwarden-webbappen](https://bitwarden.com/sv-se/help/getting-started-webvault/) och öppna administratörskonsolen med hjälp av produktväxlaren:

![Produktväljare](https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png)
2. Navigera till **Inställningar** → **Enkel inloggning** och ange en unik **SSO-identifierare** för din organisation:

![Enter an identifier ](https://bitwarden.com/assets/6pr4tqMnrLCvwDBMlba5x7/7ef7563f7017f58adffff5d15ac68512/2024-12-04_09-39-25.png)
3. Fortsätt till **steg 2: Aktivera inloggning med SSO**.

> [!NOTE] Sharing organization identifier
> You will need to share this value with users once the configuration is ready to be used.

## Steg 2: Aktivera inloggning med SSO

När du har din SSO-identifierare kan du fortsätta med att aktivera och konfigurera din integration. Så här aktiverar du inloggning med SSO:

1. Markera kryssrutan **Tillåt SSO-autentisering** i **Inställningar** → **Enkel inloggning**:

![SAML 2.0 configuration ](https://bitwarden.com/assets/20720mRAluo6crSdTiYJrn/1175889d7f6ab42fe7614f34cdd1dcdd/2024-12-04_09-41-15.png)
2. Från rullgardinsmenyn **Typ** väljer du alternativet **SAML 2.0**. Om du tänker använda OIDC istället, växla över till [OIDC Configuration Guide](https://bitwarden.com/sv-se/help/configure-sso-oidc/).

Du kan stänga av **alternativet**Ange ett unikt SP-enhets-ID i detta skede om du vill. Om du gör det kommer ditt organisations-ID att tas bort från ditt SP-enhets-ID-värde, men i nästan alla fall rekommenderas det att du låter det här alternativet vara aktiverat.

> [!TIP] Self-hosting, use alternative Member Decryption Options.
> There are alternative **Member decryption options**. Learn how to get started using [SSO with trusted devices](https://bitwarden.com/sv-se/help/about-trusted-devices/) or [Key Connector](https://bitwarden.com/sv-se/help/about-key-connector/).

## Steg 3: Konfiguration

Från och med denna tidpunkt kommer implementeringen att variera från leverantör till leverantör. Hoppa till en av våra specifika **implementeringsguider** för hjälp med att slutföra konfigurationsprocessen:

| **Leverantör** | **Guide** |
|------|------|
| AD FS | [AD FS implementeringsguide](https://bitwarden.com/sv-se/help/saml-adfs/) |
| Auth0 | [Auth0 Implementeringsguide](https://bitwarden.com/sv-se/help/saml-auth0/) |
| AWS | [AWS Implementeringsguide](https://bitwarden.com/sv-se/help/saml-aws/) |
| Azurblå | [Azure Implementation Guide](https://bitwarden.com/sv-se/help/saml-azure/) |
| Duo | [Duo Implementeringsguide](https://bitwarden.com/sv-se/help/saml-duo/) |
| Google | [Googles implementeringsguide](https://bitwarden.com/sv-se/help/saml-google/) |
| JumpCloud | [Implementeringsguide för JumpCloud](https://bitwarden.com/sv-se/help/saml-jumpcloud/) |
| Nyckelmantel | [Keycloak Implementeringsguide](https://bitwarden.com/sv-se/help/saml-keycloak/) |
| Okta | [Okta Implementeringsguide](https://bitwarden.com/sv-se/help/saml-okta/) |
| OneLogin | [Implementeringsguide för OneLogin](https://bitwarden.com/sv-se/help/saml-onelogin/) |
| PingFederate | [PingFederate implementeringsguide](https://bitwarden.com/sv-se/help/saml-pingfederate/) |

### Referensmaterial för konfiguration

Följande avsnitt kommer att definiera fält som är tillgängliga under konfigurationen av enkel inloggning, agnostiskt vilken IdP du integrerar med. Fält som måste konfigureras kommer att markeras (**obligatoriskt**).

> [!NOTE] SAML confidence 
> **Unless you are comfortable with SAML 2.0**, we recommend using one of the [above implementation guides](https://bitwarden.com/sv-se/help/configure-sso-saml/#step-3-configuration/) instead of the following generic material.

Skärmen för enkel inloggning delar upp konfigurationen i två sektioner:

- **SAML Service Provider Configuration** kommer att avgöra formatet för SAML-förfrågningar.
- **SAML Identity Provider Configuration** kommer att avgöra vilket format som kan förväntas för SAML-svar.

#### Konfiguration av tjänsteleverantör

| **Fält** | **Beskrivning** |
|------|------|
| SP Entity ID | (**Automatiskt genererad**) Bitwardens slutpunkt för autentiseringsbegäranden. Detta automatiskt genererade värde kan kopieras från organisationens **Inställningar** → **Enkel inloggningsskärm** och kommer att variera beroende på dina inställningar. |
| SAML 2.0 Metadata URL | (**Automatiskt genererad**) Metadata-URL för Bitwarden-slutpunkten. Detta automatiskt genererade värde kan kopieras från organisationens **Inställningar** → **Enkel inloggningsskärm** och kommer att variera beroende på dina inställningar. |
| Assertion Consumer Service (ACS) URL | (**Automatiskt genererad**) Plats dit SAML-påståendet skickas från IdP. Detta automatiskt genererade värde kan kopieras från organisationens **Inställningar** → **Enkel inloggningsskärm** och kommer att variera beroende på dina inställningar. |
| Namn ID-format | Format Bitwarden kommer att begära SAML-påståendet. Måste gjutas som ett snöre. Alternativen inkluderar: -Ospecificerat (standard) -E-postadress -X.509 Ämnesnamn - Windows domänkvalificerat namn - Kerberos huvudnamn - Enhetsidentifierare -Beständig - Övergående |
| Algoritm för utgående signering | Algoritmen Bitwarden kommer att använda för att signera SAML-förfrågningar. Alternativen inkluderar: - `http://www.w3.org/2001/04/xmldsig-more#rsa-sha256` (standard) - `http://www.w3.org/2000/09/xmldsig#rsa-sha384` - `http://www.w3.org/2000/09/xmldsig#rsa-sha512` |
| Signeringsbeteende | Om/när SAML-förfrågningar kommer att undertecknas. Alternativen inkluderar: -Om IdP vill ha autentiseringsförfrågningar signerade (standard) -Alltid -Aldrig |
| Minsta algoritm för inkommande signering | Minsta styrka för algoritmen som Bitwarden accepterar i SAML-svar. |
| Räkna med undertecknade påståenden | Markera den här kryssrutan om Bitwarden ska förvänta sig att svar från IdP ska signeras. |
| Validera certifikat | Markera den här rutan när du använder betrodda och giltiga certifikat från din IdP genom en betrodd CA. Självsignerade certifikat kan misslyckas om inte korrekta förtroendekedjor är konfigurerade i Bitwarden-inloggningen med SSO docker-bild. |

#### Identitetsleverantörskonfiguration

| **Fält** | **Beskrivning** |
|------|------|
| Enhets-ID | (**Obligatoriskt**) Adress eller URL till din identitetsserver eller IdP Entity ID. Det här fältet är skiftlägeskänsligt och måste matcha IdP-värdet exakt. |
| Bindningstyp | Metod som används av IdP för att svara på Bitwarden SAML-förfrågningar. Alternativen inkluderar: -Omdirigering (rekommenderas) -HTTP POST |
| Webbadress till tjänst för enkel inloggning | (**Obligatoriskt om enhets-ID inte är en URL**) SSO-URL utfärdad av din IdP. |
| Webbadress till tjänsten för enkel utloggning | Inloggning med SSO **stöder för närvarande**inte SLO. Det här alternativet är planerat för framtida användning, men vi rekommenderar starkt att du förkonfigurerar det här fältet. |
| X509 Offentligt certifikat | (**Obligatoriskt**) X.509 Base-64-kodat certifikatorgan. Inkludera inte `-----BÖRJA CERTIFIKAT-----` och `-----SLUT CERTIFIKAT-----` rader eller delar av det CER/PEM-formaterade certifikatet. Certifikatvärdet är skiftlägeskänsligt, extra mellanslag, vagnreturer och andra främmande tecken i det här fältet kommer att orsaka misslyckande i certifikatvalideringen. Kopiera **endast**certifikatdata till detta fält. |
| Algoritm för utgående signering | Algoritmen som din IdP kommer att använda för att signera SAML-svar/påståenden. Alternativen inkluderar: - `http://www.w3.org/2001/04/xmldsig-more#rsa-sha256` (standard) - `http://www.w3.org/2000/09/xmldsig#rsa-sha384` - `http://www.w3.org/2000/09/xmldsig#rsa-sha512` |
| Tillåt utgående utloggningsförfrågningar | Inloggning med SSO **stöder för närvarande**inte SLO. Det här alternativet är planerat för framtida användning, men vi rekommenderar starkt att du förkonfigurerar det här fältet. |
| Signera autentiseringsförfrågningar | Markera den här kryssrutan om din IdP ska förvänta sig att SAML-förfrågningar från Bitwarden ska signeras. |

> [!NOTE] X509 cert expiration
> När du fyller i X509-certifikatet, notera utgångsdatumet. Certifikaten kommer att behöva förnyas för att förhindra eventuella avbrott i tjänsten för SSO-slutanvändare. Om ett certifikat har löpt ut kommer administratörs- och ägarkonton alltid att kunna logga in med e-postadress och huvudlösenord.

#### SAML-attribut och anspråk

En **e-postadress krävs för kontoadministration**, som kan skickas som något av attributen eller anspråken i följande tabell.

En unik användaridentifierare rekommenderas också starkt. Om frånvarande kommer e-post att användas i dess ställe för att länka användaren.

Attribut/anspråk listas i prioritetsordning för matchning, inklusive reservalternativ där tillämpligt:

| **Värde** | **Anspråk/attribut** | **Reservanspråk/attribut** |
|------|------|------|
| Unikt ID | NameID (när det inte är övergående) urn:oid:0.9.2342.19200300.100.1.1 Sub UID UPN EPPN | |
| E-post | E-post http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress urn:oid:0.9.2342.19200300.100.1.3 Post E-postadress | Preferred_Username Urn:oid:0.9.2342.19200300.100.1.1 UID |
| Namn | Namn http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name urn:oid:2.16.840.1.113730.3.1.241 urn:oid:2.5.4.3 Visningsnamn CN | Förnamn + " " + Efternamn (se nedan) |
| Förnamn | urn:oid:2.5.4.42 GivenName Förnamn FN FName Smeknamn | |
| Efternamn | urn:oid:2.5.4.4 SN Efternamn Efternamn | |