# JumpCloud SAML-implementering

Den här artikeln innehåller **JumpCloud-specifik** hjälp för att konfigurera inloggning med SSO via SAML 2.0. För hjälp med att konfigurera inloggning med SSO för en annan IdP, se [SAML 2.0 Configuration](https://bitwarden.com/sv-se/help/configure-sso-saml/).

Konfiguration innebär att arbeta samtidigt inom Bitwarden-webbappen och JumpCloud-portalen. När du fortsätter rekommenderar vi att du har både lättillgängliga och att du slutför stegen i den ordning de är dokumenterade.

> [!NOTE]
> **Redan en SSO-expert?** Hoppa över instruktionerna i den här artikeln och ladda ner skärmdumpar av exempelkonfigurationer för att jämföra med dina egna.
> 
> ⬇️ [](https://bitwarden.com/assets/2jY7iejfs0KgdWBnwhGMHF/4bdd393ef26aac504ac2dd5b38cd283f/saml-jumpcloud-sample.zip)

## Öppna SSO i webbappen

Logga in på Bitwarden-webbappen 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)

Öppna din organisations **Inställningar** → **Enkel inloggningsskärm**:

![SAML 2.0 configuration ](https://bitwarden.com/assets/20720mRAluo6crSdTiYJrn/1175889d7f6ab42fe7614f34cdd1dcdd/2024-12-04_09-41-15.png)

Om du inte redan har gjort det, skapa en unik **SSO-identifierare**för din organisation och välj **SAML**från **rullgardinsmenyn**Typ. Håll den här skärmen öppen för enkel referens.

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/).

## Skapa en JumpCloud SAML-applikation

I JumpCloud Portal, välj **Applications** från menyn och välj knappen **Kom igång**:

![Create Bitwarden app JumpCloud](https://bitwarden.com/assets/63S5F953fjQN6V4xYKZR3h/d2f5eff68f3c5f4fb7f7b25c71c6dc7d/Create-Bitwarden-App.png)

Ange `Bitwarden` i sökrutan och välj **konfigureringsknappen**:

![Configure Bitwarden JumpCloud](https://bitwarden.com/assets/2pFRcBTjlIjBhMbqlKMhxb/fc85babc5dfa8b90b6edf028bb347a52/Configure_Bitwarden.png)

> [!NOTE] Custom SAML App 
> Om du är mer bekväm med SAML, eller vill ha mer kontroll över saker som NameID Format och Signing Algorithms, skapa en **anpassad SAML-applikation** istället.

### Allmän info

I avsnittet **Allmän information** konfigurerar du följande information:

| **Fält** | **Beskrivning** |
|------|------|
| Visa etikett | Ge applikationen ett Bitwarden-specifikt namn. |

### Konfiguration för enkel inloggning

I avsnittet Konfiguration**av**enkel inloggning konfigurerar du följande information:

![JumpCloud SSO configuration ](https://bitwarden.com/assets/29XSIA5254JE0flwlFEGBf/4889cdd2562033c7975deee1b90cd90c/JumpCloud_SSO_Configuration.png)

| **Fält** | **Beskrivning** |
|------|------|
| IdP Entity ID | Ställ in det här fältet till ett unikt, Bitwarden-specifikt värde, till exempel `bitwardensso_yourcompany`. |
| SP Entity ID | Ställ in det här fältet till det förgenererade **SP Entity ID**. Detta automatiskt genererade värde kan kopieras från organisationens **Inställningar** → **Enkel inloggningsskärm** och kommer att variera beroende på dina inställningar. |
| ACS URL | Ställ in det här fältet till den förgenererade webbadressen för Assertion Consumer Service (ACS). Detta automatiskt genererade värde kan kopieras från organisationens **Inställningar** → **Enkel inloggningsskärm** och kommer att variera beroende på dina inställningar. |

#### Endast anpassad SAML-app

Om du skapade en anpassad SAML-applikation måste du också konfigurera följande fält för konfiguration**av**enkel inloggning:

| **Fält** | **Beskrivning** |
|------|------|
| SAMLSubject NameID | Ange JumpCloud-attributet som ska skickas i SAML-svar som NameID. |
| SAMLSubject NameID Format | Ange formatet för NameID som skickas i SAML-svar. |
| Signaturalgoritm | Välj den algoritm som ska användas för att signera SAML-påståenden eller svar. |
| Tecken påstående | Som standard kommer JumpCloud att signera SAML-svaret. Markera den här rutan för att underteckna SAML-påståendet. |
| Inloggnings-URL | Ange webbadressen från vilken dina användare ska logga in på Bitwarden via SSO. För molnbaserade kunder är detta `https://vault.bitwarden.com/#/sso` eller `https://vault.bitwarden.eu/#/sso`. För egenvärdiga instanser bestäms detta av din [konfigurerade server-URL](https://bitwarden.com/sv-se/help/install-on-premise/#configure-your-domain/), till exempel `https://din.domän.com/#/sso`. |

### Attribut

I avsnittet Konfiguration**av**enkel inloggning → **Attribut**, konstruera följande SP → IdP-attributmappningar. Om du valde Bitwarden-applikationen i JumpCloud bör dessa redan vara konstruerade:

![Attribute Mapping ](https://bitwarden.com/assets/5vRaXPal1HJsXhJZX8MdTL/b7c71fb6d4156d104f0f2b826f78a247/jc-attr.png)

När du är klar, välj aktiveringsknappen.

### Ladda ner certifikatet

När applikationen är aktiverad, använd **SSO-menyalternativet** igen för att öppna den skapade Bitwarden-applikationen. Välj **rullgardinsmenyn**IDP-certifikat och **Ladda ner certifikat**:

![Download Certificate](https://bitwarden.com/assets/6Y2DUGlm3LxBK6Ws44SjRg/d15ec22031306fa8d49b9c22d6e7fb5b/download_certificate.png)

### Bind användargrupper

I JumpCloud-portalen väljer du **Användargrupper** från menyn:

![User Groups](https://bitwarden.com/assets/3nIOyl4xedMgTRTNobFqwG/dc5ec9a5d8144249c81a0c4188ede96a/User_Groups.png)

Skapa antingen en Bitwarden-specifik användargrupp eller öppna standardanvändargruppen Alla användare. I båda fallen, välj fliken **Applikationer** och aktivera åtkomst till den skapade Bitwarden SSO-applikationen för den användargruppen:

![Bind App Access ](https://bitwarden.com/assets/7BUUQUi79zmEy8xm64qwog/7d5537c45423a87f92485e7b6cad5d5e/jc-group-app.png)

> [!NOTE]
> Alternatively, you can bind access to user groups directly from the **SSO** → **Bitwarden Application** screen.

## Tillbaka till webbappen

Vid det här laget har du konfigurerat allt du behöver inom ramen för JumpCloud-portalen. Gå tillbaka till Bitwardens webbvalv för att slutföra konfigurationen.

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

- **SAML-tjänsteleverantörens konfiguration** avgör formatet för SAML-förfrågningar.
- Konfiguration av SAML-identitetsleverantör avgör vilket format som kan förväntas för SAML-svar.

### Tjänsteleverantörens konfiguration

Konfigurera följande fält enligt de val som valts i JumpCloud-portalen [när appen skapades](https://bitwarden.com/sv-se/help/saml-jumpcloud/#create-a-jumpcloud-saml-app/):

| **Fält** | **Beskrivning** |
|------|------|
| Namn ID-format | Om du skapade en anpassad SAML-applikation, ställ in detta på vad det angivna SAMLSubject NameID-formatet är. Lämna annars **Ospecificerat**. |
| Algoritm för utgående signering | Algoritmen Bitwarden kommer att använda för att signera SAML-förfrågningar. |
| Signeringsbeteende | Om/när SAML-förfrågningar kommer att undertecknas. Som standard kommer JumpCloud inte att kräva att förfrågningar signeras. |
| Minsta algoritm för inkommande signering | Om du skapade en anpassad SAML-applikation, ställ in denna på vilken signaturalgoritm du än valde. Annars lämnar du som `rsa-sha256`. |
| Vill ha påståenden undertecknade | Om du skapade en anpassad SAML-applikation, markera den här rutan om du ställer in **alternativet**Sign Assertion i JumpCloud. Lämna annars omarkerat. |
| 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. |

När du är klar med tjänsteleverantörens konfiguration, **spara** ditt arbete.

### Identitetsleverantörskonfiguration

Konfiguration av identitetsleverantör kräver ofta att du går tillbaka till JumpCloud-portalen för att hämta applikationsvärden:

| **Fält** | **Beskrivning** |
|------|------|
| Enhets-ID | Ange ditt JumpCloud **IdP Entity ID**, som kan hämtas från JumpCloud [Single Sign-On Configuration-skärmen](https://bitwarden.com/sv-se/help/saml-jumpcloud/#single-sign-on-configuration/). Det här fältet är skiftlägeskänsligt. |
| Bindningstyp | Ställ in på **omdirigering**. |
| Webbadress till tjänst för enkel inloggning | Ange din JumpCloud **IdP URL**, som kan hämtas från JumpCloud [Single Sign-On Configuration-skärmen](https://bitwarden.com/sv-se/help/saml-jumpcloud/##single-sign-on-configuration/). |
| Webbadress för enkel utloggning | Inloggning med SSO **stöder för närvarande**inte SLO. Detta alternativ är planerat för framtida utveckling. |
| X509 Offentligt certifikat | Klistra in det [hämtade certifikatet](https://bitwarden.com/sv-se/help/saml-jumpcloud/##download-the-certificate/), ta bort `-----BÖRJA CERTIFIKAT-----` och `-----SLUT CERTIFIKAT-----` Certifikatvärdet är skiftlägeskänsligt, extra mellanslag, vagnreturer och andra ovidkommande tecken **kommer att göra att certifieringsvalideringen misslyckas**. |
| Algoritm för utgående signering | Om du skapade en anpassad SAML-applikation, ställ in denna på vilken signaturalgoritm du än valde. Annars lämnar du som `rsa-sha256`. |
| Inaktivera utgående utloggningsförfrågningar | Inloggning med SSO **stöder för närvarande**inte SLO. Detta alternativ är planerat för framtida utveckling. |
| Vill ha signerade förfrågningar om autentisering | Huruvida JumpCloud förväntar sig att SAML-förfrågningar 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.

När du är klar med identitetsleverantörens konfiguration, **spara** ditt arbete.

> [!TIP] Policies for SSO Guides
> Du kan kräva att användare loggar in med SSO genom att aktivera autentiseringspolicyn för enkel inloggning. Observera att detta även kräver aktivering av policyn för en enda organisation. [Läs mer](https://bitwarden.com/sv-se/help/policies/).

## Testa konfigurationen

När din konfiguration är klar, testa den genom att navigera till [https://vault.bitwarden.com](https://vault.bitwarden.com), ange din e-postadress och välja knappen **Använd enkel inloggning**:

![Log in options screen](https://bitwarden.com/assets/3BdlHeogd42LEoG06qROyQ/c68021df4bf45d72e9d37b1fbf5a6040/login.png)

Ange den [konfigurerade organisationsidentifieraren](https://bitwarden.com/sv-se/help/saml-jumpcloud/#/) och välj **Logga in**. Om din implementering är framgångsrikt konfigurerad kommer du att omdirigeras till JumpCloud-inloggningsskärmen:

![JumpCloud Login ](https://bitwarden.com/assets/678vDfFuKfH8FBZkhJdt5J/3d21f8344708eea792da7eb3160a9246/JumpCloud_Login.png)

När du har autentiserat med dina JumpCloud-uppgifter, ange ditt Bitwarden-huvudlösenord för att dekryptera ditt valv!

> [!NOTE] SSO must be initiated from Bitwarden
> Bitwarden stöder inte oönskade svar, så att initiera inloggning från din IdP kommer att resultera i ett fel. SSO-inloggningsflödet måste initieras från Bitwarden.