Zelfstudie: Eenmalige aanmelding van Microsoft Entra integreren met EasySSO voor BitBucket

In deze zelfstudie leert u hoe u EasySSO voor BitBucket integreert met Microsoft Entra ID. Wanneer u EasySSO voor BitBucket integreert met Microsoft Entra ID, kunt u het volgende doen:

  • In Microsoft Entra ID beheren wie toegang heeft tot EasySSO voor BitBucket.
  • Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij EasySSO for BitBucket.
  • Uw accounts op één centrale locatie beheren: de Azure-portal.

Vereisten

Om aan de slag te kunnen, hebt u het volgende nodig:

  • Een Microsoft Entra-abonnement. Als u geen abonnement hebt, kunt u een gratis account krijgen.
  • Een abonnement op EasySSO voor BitBucket dat voor eenmalige aanmelding is ingeschakeld.

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

  • EasySSO voor BitBucket ondersteunt door SP en IDP geïnitieerde eenmalige aanmelding.
  • EasySSO voor BitBucket ondersteunt het Just-In-Time inrichten van gebruikers.

Als u de integratie van EasySSO voor BitBucket in Microsoft Entra ID wilt configureren, moet u EasySSO voor BitBucket vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ in de sectie Toevoegen uit de galerie in het zoekvak: EasySSO voor BitBucket.
  4. Selecteer EasySSO voor BitBucket in de resultaten en voeg de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

U kunt ook de wizard Enterprise App Configuration gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en ook de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Eenmalige aanmelding van Microsoft Entra voor EasySSO voor BitBucket configureren en testen

Configureer en test eenmalige aanmelding van Microsoft Entra met EasySSO for BitBucket met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een gekoppelde relatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in EasySSO voor BitBucket.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met EasySSO for BitBucket te configureren en te testen:

  1. Configureer eenmalige aanmelding van Microsoft Entra om uw gebruikers in staat te stellen deze functie te gebruiken.
    1. Maak een Microsoft Entra-testgebruiker om eenmalige aanmelding van Microsoft Entra te testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen gebruik te maken van eenmalige aanmelding van Microsoft Entra.
  2. Configureer eenmalige aanmelding bij EasySSO voor BitBucket als u de instellingen voor eenmalige aanmelding aan de toepassingszijde wilt configureren.
    1. Maak een testgebruiker voor EasySSO voor BitBucket om een tegenhanger van B.Simon in EasySSO voor BitBucket te hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
  3. Eenmalige aanmelding testen om te controleren of de configuratie werkt.

Eenmalige aanmelding voor Microsoft Entra configureren

Volg deze stappen om eenmalige aanmelding van Microsoft Entra in te schakelen.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar de integratiepagina van Identity>Applications Enterprise-toepassingen>>EasySSO voor BitBucket-toepassingen, ga naar de sectie Beheren. Selecteer Eenmalige aanmelding.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

  4. Selecteer op de pagina Eenmalige aanmelding instellen met SAML het potloodpictogram voor Standaard-SAML-configuratie om de instellingen te bewerken.

    Screenshot of Set up Single Sign-On with SAML page, with pencil icon highlighted

  5. Voer in de sectie Standaard SAML-configuratie de waarden voor de volgende velden in, als u de toepassing in de met IdP geïnitieerde modus wilt configureren:

    a. In het tekstvak Id typt u een URL met het volgende patroon: https://<server-base-url>/plugins/servlet/easysso/saml

    b. In het tekstvak Antwoord-URL typt u een URL met het volgende patroon: https://<server-base-url>/plugins/servlet/easysso/saml

  6. Selecteer Extra URL's instellen en voer de volgende stap uit als u de toepassing in de door SP geïnitieerde modus wilt configureren:

    • In het tekstvak Aanmeldings-URL typt u een URL met het volgende patroon: https://<server-base-url>/login.jsp

    Notitie

    Dit zijn geen echte waarden. Werk deze waarden bij met de werkelijke-id, de antwoord-URL en de aanmeldings-URL. Neem bij twijfel contact op met het ondersteuningsteam van EasySSO om deze waarden te verkrijgen. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

  7. De EasySSO voor BitBucket-toepassing verwacht de SAML-asserties in een specifieke indeling, waarvoor u aangepaste kenmerktoewijzingen moet toevoegen aan de configuratie van de SAML-tokenkenmerken. In de volgende schermafbeelding wordt de lijst met standaardkenmerken weergegeven.

    Screenshot of default attributes

  8. De toepassing EasySSO voor BitBucket verwacht ook dat er nog enkele kenmerken moeten worden teruggestuurd via de SAML-respons. Dit kunt u in de volgende tabel zien. Deze kenmerken worden ook vooraf ingevuld, maar u kunt deze indien nodig herzien.

    Naam Bronkenmerk
    urn:oid:0.9.2342.19200300.100.1.1 user.userprincipalname
    urn:oid:0.9.2342.19200300.100.1.3 user.mail
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 user.surname
    urn:oid:2.5.4.42 user.givenname

    Als uw Microsoft Entra-gebruikers sAMAccountName hebben geconfigureerd, moet u urn:oid:0.9.2342.19200300.100.1.1 toewijzen aan het kenmerk sAMAccountName.

  9. Op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaat selecteert u de downloadkoppelingen voor de optie Certificaat (Base64) of Federation Metadata-XML. Sla een van beide of beide op uw computer op. U hebt deze later nodig om BitBucket EasySSO te configureren.

    Screenshot of the SAML Signing Certificate section, with download links highlighted

    Als u EasySSO voor BitBucket handmatig wilt configureren met een certificaat, moet u ook de aanmeldings-URL en de Microsoft Entra-id kopiëren en deze opslaan op uw computer.

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker, B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruiker Beheer istrator.
  2. Blader naar Identiteitsgebruikers>>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Maken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot EasySSO voor BitBucket.

  1. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>.
  2. Selecteer EasySSO voor BitBucket in de lijst met toepassingen.
  3. Zoek op de overzichtspagina van de app de sectie Beheren en selecteer Gebruikers en groepen.
  4. Selecteer Gebruiker toevoegen. Selecteer Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
  5. Selecteer in de lijst met gebruikers in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers en kies Selecteren onderaan het scherm.
  6. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
  7. Selecteer Toewijzen in het dialoogvenster Toewijzing toevoegen.

Eenmalige aanmelding bij EasySSO voor BitBucket configureren

  1. Meld u in een ander browservenster als beheerder aan bij uw Zoom-bedrijfssite

  2. Ga naar de sectie Beheer.

    Screenshot of BitBucket instance, with gear icon highlighted

  3. Zoek en selecteer EasySSO.

    Screenshot of Easy SSO option

  4. Selecteer SAML. U wordt naar de sectie SAML-configuratie geleid.

    Screenshot of EasySSO Admin page, with SAML highlighted

  5. Selecteer het tabblad Certificaten. Het volgende scherm wordt geopend:

    Screenshot of the Certificates tab, with various options highlighted

  6. Zoek de optie Certificaat (Base64) of Metagegevensbestand dat u in de vorige sectie van deze zelfstudie hebt opgeslagen. U kunt op een van de volgende manieren doorgaan:

    • Gebruik het Metagegevensbestand van de app-federatie dat u naar een lokaal bestand op de computer hebt gedownload. Selecteer het keuzerondje Uploaden en volg het specifieke pad voor het besturingssysteem.

    • Open het Metagegevensbestand voor app-federatie om de inhoud van het bestand in een eenvoudige teksteditor te bekijken. Kopieer het naar het klembord. Selecteer Invoer en plak de inhoud van het klembord in het tekstveld.

    • Voer een volledig handmatige configuratie uit. Open het certificaat (Base64) voor app-federatie om de inhoud van het bestand in een eenvoudige teksteditor te bekijken. Kopieer het naar het klembord en plak het in het tekstveld IdP-certificaat voor token-ondertekening. Ga vervolgens naar het tabblad Algemeen en vul de velden POST Binding URL en Entity ID in met de respectievelijke waarden voor aanmeldings-URL en Microsoft Entra-id die u eerder hebt opgeslagen.

  7. Selecteer Opslaan onder aan de pagina. U ziet dat de inhoud van de metagegevens- of certificaatbestanden in de configuratievelden wordt geparseerd. De configuratie van EasySSO voor BitBucket is voltooid.

  8. Als u de configuratie wilt testen, gaat u naar het tabblad Uiterlijk en selecteert u SAML-aanmeldingsknop. Hiermee kunt u een afzonderlijke knop in het aanmeldingsscherm van BitBucket inschakelen, met name om uw Microsoft Entra SAML-integratie end-to-end te testen. U kunt deze knop ingeschakeld laten en ook de positie, kleur en vertaling voor productiemodus configureren.

    Screenshot of SAML page Look & Feel tab, with SAML Login Button highlighted

    Notitie

    Als u problemen ondervindt, neemt u contact op met het ondersteuningsteam van EasySSO.

Testgebruiker voor EasySSO voor BitBucket maken

In deze sectie maakt u in BitBucket een gebruiker met de naam Britta Simon. EasySSO voor BitBucket ondersteunt het Just-In-Time inrichten van gebruikers, wat standaard is uitgeschakeld. Als u het wilt inschakelen, moet u Gebruiker maken na geslaagde aanmelding expliciet inschakelen in de sectie Algemeen van de configuratie voor de EasySSO-invoegtoepassing. Als er nog geen gebruiker in BitBucket bestaat, wordt er na authenticatie een nieuwe gemaakt.

Als u het automatisch inrichten van gebruikers echter niet wilt inschakelen wanneer de gebruiker zich voor het eerst aanmeldt, moeten gebruikers aanwezig zijn in de gebruikersmappen waarvan het exemplaar van BitBucket gebruikmaakt. Deze directory kan bijvoorbeeld LDAP of Atlassian Crowd zijn.

Screenshot of the General section of EasySSO plug-in configuration, with Create user on successful login highlighted

Eenmalige aanmelding testen

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

Met SP geïnitieerd:

  • Klik op Deze toepassing testen. U wordt omgeleid naar de aanmeldings-URL van EasySSO voor BitBucket, waar u de aanmeldingsstroom kunt initiëren.

  • Ga rechtstreeks naar de aanmeldings-URL van EasySSO for BitBucket en initieer hier de aanmeldingsstroom.

Met IDP geïnitieerd:

  • Klik op Deze toepassing testen en u wordt automatisch aangemeld bij het exemplaar van EasySSO voor BitBucket waarvoor u eenmalige aanmelding hebt ingesteld

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u in Mijn apps op de tegel EasySSO for BitBucket klikt, en deze is geconfigureerd in de SP-modus, wordt u omgeleid naar de aanmeldingspagina van de toepassing voor het initiëren van de aanmeldingsstroom. Als deze is geconfigureerd in de IDP-modus, wordt u automatisch aangemeld bij het EasySSO for BitBucket-exemplaar waarvoor u eenmalige aanmelding hebt ingesteld. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Volgende stappen

Zodra u EasySSO for BitBucket hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens in uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.