Auth0 SAML-implementering

Den här artikeln innehåller Auth0-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.

Konfiguration innebär att arbeta samtidigt inom Bitwarden-webbappen och Auth0-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.

Logga in på Bitwarden-webbappen och öppna administratörskonsolen med hjälp av produktväxlaren:

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

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.

I Auth0-portalen använder du menyn Program för att skapa en vanlig webbapplikation:

Klicka på fliken Inställningar och konfigurera följande information, varav en del måste hämtas från Bitwarden Single Sign-On-skärmen:

Bidragstyper

I avsnittet Avancerade inställningar → Bidragstyper, se till att följande bidragstyper är valda (de kan vara förvalda):

Certifikat

I avsnittet Avancerade inställningar → Certifikat, kopiera eller ladda ner ditt signeringscertifikat. Du behöver inte göra något med det ännu, men du måste referera till det senare.

Slutpunkter

Du behöver inte redigera någonting i avsnittet Avancerade inställningar → Slutpunkter, men du behöver SAML-slutpunkterna att referera till senare.

Skapa åtgärder för att anpassa logiken som Auth0 kommer att använda under flödet efter inloggning och diktera parametrarna för utbytet med Bitwarden. För att skapa den nödvändiga åtgärden:

1. Navigera till Åtgärder → Bibliotek och välj Skapa åtgärd → Bygg från början.

2. Ge din handling ett namn som Bitwarden SSO, välj utlösaren Logga in / Posta inloggning, välj alternativet Nod 18 (rekommenderas) Runtime och välj Skapa.

3. Lägg till följande regel i den integrerade kodredigeraren:

   JavaScriptCopy
   exports.onExecutePostLogin = async (event, api) => {
       // Modify SAML configuration settings
       if (event.request.protocol === 'samlp') {
           api.saml.updateConfiguration({
               signatureAlgorithm: "rsa-sha256",
               digestAlgorithm: "sha256",
               signResponse: true,
               nameIdentifierFormat: "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress",
               binding: "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"
           });
       }
   };

4. Välj Distribuera.

5. Navigera till Åtgärder → Utlösare och välj utlösaren efter inloggning.

6. Dra och släpp din nya åtgärd i flödet för inloggning efter inloggning och välj Använd.

När du konfigurerar ovanstående åtgärd kan du anpassa något av följande attribut för att passa dina behov:

Den 18 november 2024 kommer Auth0 att fasa ut regler. Om du för närvarande använder en regel som beskrivs i en tidigare version av det här dokumentet kan du använda knappen Migrera till åtgärd på skärmen Auth0 Rules för att göra processen enklare. Om du gör så här:

• Stäng inte av den redan existerande regeln.

• Lägg till den nya åtgärden i din trigger efter inloggning enligt beskrivningen ovan i steg 5 och 6.

Vid det här laget har du konfigurerat allt du behöver inom ramen för Auth0-portalen. Gå tillbaka till Bitwarden-webbappen 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.

Om du inte har konfigurerat anpassade regler kommer konfigurationen av din tjänsteleverantör redan att vara klar. Om du har konfigurerat anpassade regler eller vill göra ytterligare ändringar i din implementering, redigera de relevanta fälten:

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

Identitetsleverantörskonfiguration kräver ofta att du går tillbaka till Auth0-portalen för att hämta applikationsvärden:

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

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

Ange den konfigurerade organisationsidentifieraren och välj Logga in. Om din implementering är framgångsrikt konfigurerad kommer du att omdirigeras till Auth0-inloggningsskärmen:

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