Share via

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

  • Artikel

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

  • In Microsoft Entra ID bepalen wie toegang heeft tot Jira.
  • Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij Jira.
  • Beheer uw accounts op één centrale locatie.

Vereisten

U hebt het volgende nodig om aan de slag te gaan:

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

Beschrijving van scenario

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

  • EasySSO voor Jira ondersteunt door SP en IDP geïnitieerde eenmalige aanmelding.
  • EasySSO biedt ondersteuning voor Just-In-Time-inrichting van gebruikers.

Als u de integratie van EasySSO voor Jira in Microsoft Entra ID wilt configureren, moet u EasySSO voor Jira 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 Jira.
  4. Selecteer EasySSO voor Jira in het resultatenvenster, en voeg de app vervolgens 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 Jira configureren en testen

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

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

  1. Configureer eenmalige aanmelding van Microsoft Entra - zodat uw gebruikers deze functie kunnen gebruiken.
    1. Een Microsoft Entra-testgebruiker maken : eenmalige aanmelding van Microsoft Entra testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen eenmalige aanmelding van Microsoft Entra te gebruiken.
  2. Eenmalige aanmelding bij EasySSO voor Jira configureren: als u de instellingen voor eenmalige aanmelding aan de clientzijde wilt configureren.
    1. Testgebruiker voor EasySSO voor Jira maken: als u een tegenhanger van B.Simon in EasySSO voor Jira wilt 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 Identity>Applications Enterprise-toepassingen>>EasySSO voor Jira>Eenmalige aanmelding.

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

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

    Edit Basic SAML Configuration

  5. In het gedeelte Standaard SAML-configuratie voert u de volgende stappen uit als u de toepassing in de door 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 de volgende notatie: https://<server-base-url>/plugins/servlet/easysso/saml

  6. Klik op 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 contact op met het klantenondersteuningsteam van EasySSO om deze waarden te verkrijgen als u twijfelt. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

  7. Uw EasySSO voor Jira-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.

    image

  8. Bovendien verwacht de toepassing EasySSO voor Jira nog enkele kenmerken die als SAML-antwoord moeten worden doorgestuurd. Deze worden hieronder weergegeven. Deze kenmerken worden ook vooraf ingevuld, maar u kunt ze controleren volgens uw vereisten.

    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 klikt u op de koppeling Downloaden voor de optie Certificaat (Base64) of Federation Metadata XML en slaat u een optie of allebei op uw computer op. U hebt deze later nodig om Jira EasySSO te configureren.

    The Certificate download link

    Als u van plan bent om de configuratie van EasySSO voor Jira handmatig uit te voeren met een certificaat, moet u ook de aanmeldings-URL en de Microsoft Entra-id kopiëren uit de onderstaande sectie en deze opslaan op uw computer.

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam 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 Jira.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Identity>Applications Enterprise-toepassingen>>EasySSO voor Jira.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. 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.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

Eenmalige aanmelding bij EasySSO voor Jira configureren

  1. Meld u bij uw Atlassian Jira-exemplaar aan met beheerdersmachtigingen en navigeer naar de sectie Apps beheren.

    Manage Apps

  2. Klik links in het scherm op EasySSO.

    Easy SSO

  3. Selecteer de optie SAML. U wordt dan naar de sectie SAML-configuratie geleid.

    SAML

  4. Selecteer het tabblad Certificaten tabblad bovenaan om het volgende scherm te openen:

    Metadata URL

  5. Zoek nu het certificaat (Base64) of het metagegevensbestand dat u hebt opgeslagen in de eerdere stappen van de configuratie van Microsoft Entra SSO. U hebt de volgende opties om verder te gaan:

    a. Gebruik het Metagegevensbestand voor app-federatie dat u hebt gedownload naar het lokale bestand op uw computer. Selecteer het keuzerondje Uploaden en volg het specifieke dialoogvenster Bestand uploaden voor uw besturingssysteem.

    OF

    b. Open het Metagegevensbestand voor app-federatie om de inhoud van het bestand (in een eenvoudige teksteditor) te bekijken en kopieer deze naar het klembord. Selecteer de optie Invoer en plak de klembordinhoud in het tekstveld.

    OF

    c. Volledig handmatige configuratie. Open het Certificaat (Base64) voor app-federatie om de inhoud van het bestand (in een eenvoudige teksteditor) te bekijken en kopieer deze naar het klembord. Plak de klembordinhoud in het tekstveld Certificaten voor IdP-tokenondertekening. Navigeer vervolgens naar het tabblad Algemeen en vul de velden POST Binding URL en Entiteits-id in met respectievelijke waarden voor aanmeldings-URL en Microsoft Entra-id die u eerder hebt opgeslagen.

  6. Klik op de knop Opslaan onderaan de pagina. U ziet dat de inhoud van het bestand Metagegevens of Certificaat wordt geparseerd in de configuratievelden. De configuratie van EasySSO voor Jira is voltooid.

  7. Voor de beste testervaring navigeert u naar het tabblad Weergave en schakelt u de optie SAML-aanmelding in. Hiermee schakelt u een afzonderlijke knop in op het Jira-aanmeldingsscherm 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.

    Look & Feel

    Notitie

    Neem contact op met het ondersteuningsteam van EasySSO als u problemen ondervindt.

Testgebruiker voor EasySSO voor Jira maken

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

Als u het automatisch inrichten van gebruikers na hun eerste aanmelding echter niet wilt inschakelen, moeten gebruikers bestaan in back-end gebruikerslijsten waarvan het Jira-exemplaar gebruikmaakt, zoals LDAP of Atlassian Crowd.

User provisioning

Eenmalige aanmelding testen

Door IdP geïnitieerde werkstroom

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

  • Klik op Deze toepassing testen en u wordt automatisch aangemeld bij het exemplaar van EasySSO voor Jira 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 op de tegel EasySSO voor Jira in Mijn apps klikt en als 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 de instantie van EasySSO voor Jira waarvoor u eenmalige aanmelding hebt ingesteld. Zie Introduction to My Apps (Inleiding tot Mijn apps) voor meer informatie over Mijn apps.

Door SP geïnitieerde werkstroom

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met behulp van de knop Jira SAML Login .

User SAML login

In dit scenario wordt ervan uitgegaan dat u op de knop SAML-aanmelding hebt geklikt op het tabblad Uiterlijk op de configuratiepagina van uw Jira EasySSO (zie hierboven). Open uw aanmeldings-URL voor Jira in de incognitomodus van de browser om interferentie met uw bestaande sessies te voorkomen. Klik op de knop SAML-aanmelding en u wordt omgeleid naar de gebruikersverificatiestroom van Microsoft Entra. Zodra dit is voltooid, wordt u via SAML teruggeleid naar uw Jira-instantie als geverifieerde gebruiker.

Er is een mogelijkheid dat u het volgende scherm tegenkomt nadat u bent omgeleid vanuit Microsoft Entra-id.

EasySSO failure screen

In dit geval volgt u de instructies op deze pagina om toegang te krijgen tot het bestand atlassian-jira.log. Details van de fout zijn beschikbaar via de verwijzings-id op de foutpagina van EasySSO.

Neem contact op met het ondersteuningsteam van EasySSO als u geen samenvatting van de logboekberichten kunt weergeven.

Volgende stappen

Zodra u EasySSO voor Jira hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van 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.