ADFS OIDC-implementatie

Dit artikel bevat Active Directory Federation Services (AD FS)-specifieke hulp voor het configureren van aanmelden met SSO via OpenID Connect (OIDC). Voor hulp bij het configureren van aanmelding met SSO voor een andere OIDC IdP, of voor het configureren van AD FS via SAML 2.0, zie OIDC-configuratie of ADFS SAML-implementatie.

Bij de configuratie wordt tegelijkertijd gewerkt binnen de Bitwarden webapp en de AD FS Server Manager. We raden u aan om beide documenten bij de hand te hebben en de stappen uit te voeren in de volgorde waarin ze zijn beschreven.

Log in op de Bitwarden web app en open de Admin Console met behulp van de product switcher ():

Selecteer Instellingen → Eenmalige aanmelding in de navigatie:

Als je dit nog niet hebt gedaan, maak dan een unieke SSO identifier aan voor je organisatie. Verder hoef je nog niets aan te passen op dit scherm, maar houd het open voor gemakkelijke referentie.

Navigeer in Server Manager naar AD FS Management en maak een nieuwe applicatiegroep:

1. Selecteer in de consolestructuur Toepassingsgroepen en kies Toepassingsgroep toevoegen in de lijst Acties.

2. Kies in het welkomstscherm van de wizard de sjabloon Serverapplicatie die toegang heeft tot een web-API .

   

3. In het scherm Servertoepassing:

   

   • Geef de servertoepassing een naam.

   • Let op de Client Identifier. U hebt deze waarde nodig in een volgende stap.

   • Geef een Redirect URI op. Voor cloud-hosted klanten is dit https://sso.bitwarden.com/oidc-signin of https://sso.bitwarden.eu/oidc-signin. Voor zelf gehoste instanties wordt dit bepaald door je geconfigureerde Server URL, bijvoorbeeld https://your.domain.com/sso/oidc-signin.

4. Let op het Client Secret in het scherm Configure Application Credentials. U hebt deze waarde nodig in een volgende stap.

5. Op het scherm Web API configureren:

   

   • Geef de Web API een naam.

   • Voeg de Client Identifier en Redirect URI (zie stap 2B. & C.) toe aan de lijst Identifier.

6. Stel in het scherm Toegangsbeheerbeleid toepassen een geschikt toegangsbeheerbeleid in voor de Toepassingsgroep.

7. Sta in het scherm Toepassingsmachtigingen configureren de scopes allatclaims en openid toe.

   

8. Voltooi de wizard Toepassingsgroep toevoegen.

Navigeer in Server Manager naar AD FS Management en bewerk de gemaakte applicatiegroep:

1. Selecteer in de consolestructuur Toepassingsgroepen.

2. Klik in de lijst Toepassingsgroepen met de rechtermuisknop op de aangemaakte toepassingsgroep en selecteer Eigenschappen.

3. Kies in de sectie Toepassingen de Web-API en selecteer Bewerken... .

4. Navigeer naar het tabblad Regels voor de uitgifteomzetting en selecteer de knop Regel toevoegen. ...

5. Selecteer in het scherm Choose Rule Type de optie Send LDAP Attributes as Claims.

6. In het scherm Claim Rule configureren:

   

   • Geef de regel een Claim-regelnaam.

   • Selecteer E-mailadressen in de vervolgkeuzelijst LDAP-attribuut .

   • Selecteer E-mailadres in de vervolgkeuzelijst Type uitgaande claim.

7. Selecteer afwerking.

Op dit punt heb je alles geconfigureerd wat je nodig hebt binnen de wedstrijd van de AD FS Server Manager. Ga terug naar de Bitwarden web app om de volgende velden te configureren:

Sla je werk op als je klaar bent met het configureren van deze velden.

Zodra je configuratie voltooid is, kun je deze testen door te navigeren naar https://vault.bitwarden.com, je e-mailadres in te voeren, Doorgaan te selecteren en de knop Enterprise Single-On te selecteren:

Voer de geconfigureerde Organisatie-ID in en selecteer Aanmelden. Als uw implementatie succesvol is geconfigureerd, wordt u doorgestuurd naar het AD FS SSO inlogscherm. Nadat u zich hebt geverifieerd met uw AD FS-gegevens, voert u uw Bitwarden-hoofdwachtwoord in om uw kluis te ontsleutelen!