ACAccounts in applicaties
Entra ID Atlassian koppeling: Jira- en Confluence-toegang vanuit Microsoft Entra ID, ook bij hernoemde groepen
Met een koppeling tussen Microsoft Entra ID en Atlassian Cloud krijgt iedereen in de juiste Entra-groep een beheerd Atlassian-account, komt hij in de groepen die toegang geven tot Jira en Confluence, en wordt het account gedeactiveerd zodra hij uit scope gaat. KoppelHet richt de provisioning in Entra ID in en regelt ook hernoemde groepen, medewerkers zonder mailbox en personeelsnummer en locatie in het profiel.
Wat de koppeling doet
Organisaties die accounts in Entra ID beheren en Jira en Confluence in Atlassian Cloud gebruiken, zetten vaak provisioning vanuit Entra ID aan. Dat werkt tot een groep in Entra ID een nieuwe naam krijgt, een collega zonder mailbox geen e-mailadres meekrijgt, of Atlassian een wijziging op een niet-geverifieerd domein stil overslaat.
- IT verifieert de domeinen in Atlassian, zet een identity provider-directory op en geeft KoppelHet de SCIM-URL en API-key.
- KoppelHet richt de provisioning naar Atlassian in Entra ID in, met personeelsnummer, locatie en een e-mailbron die ook zonder mailbox gevuld is.
- Leden van de toegewezen Entra-groepen worden beheerde accounts in Atlassian, in groepen met dezelfde naam.
- Krijgt een Entra-groep een nieuwe naam, dan maakt KoppelHet de nieuwe groep in Atlassian, verhuist de leden en ruimt de oude op.
- Gaat iemand uit scope of wordt zijn account uitgeschakeld, dan deactiveert Entra ID het Atlassian-account.
Waar je op let bij Microsoft Entra ID en Atlassian Cloud (Jira en Confluence)
- Atlassian kan een groep niet hernoemen, en provisioning vanuit Entra ID geeft een nieuwe groepsnaam daarom niet door. De oude naam blijft in Atlassian staan. KoppelHet ziet het verschil, maakt een groep met de nieuwe naam, zet de leden over en verwijdert de oude groep, nadat de beheerder de app-toegang op de nieuwe groep heeft gezet.
- In Entra ID is het mail-attribuut alleen gevuld als iemand een Exchange-mailbox heeft. Collega's zonder mailbox, zoals medewerkers met alleen Teams of externe projectleden, komen dan zonder e-mailadres aan. KoppelHet zet in de mapping een vervangend attribuut, zodat zij toch een werkend Atlassian-account krijgen.
- Atlassian koppelt een bestaand account aan een Entra-gebruiker op basis van het e-mailadres. Accounts die collega's ooit zelf maakten met hun werkadres, worden zo beheerde accounts met al hun issues en pagina's. KoppelHet vergelijkt vooraf de Atlassian-gebruikers met Entra ID, zodat een verkeerd of oud adres niet bij de verkeerde persoon uitkomt.
- Wijzigingen voor gebruikers op een niet-geverifieerd domein stuurt Entra ID wel, maar Atlassian verwerkt ze niet. Een collega die naar een dochterbedrijf met een eigen domein gaat, verliest zelfs zijn groepen. KoppelHet controleert welke domeinen in Entra ID voorkomen en meldt ontbrekende verificaties voordat ze toegang kosten.
- Zonder aanpassing stuurt Entra ID alleen gebruikersnaam, naam, e-mail en status. Atlassian accepteert vanuit Entra ID ook employeeId als personeelsnummer, physicalDeliveryOfficeName als locatie en een roepnaam. KoppelHet voegt die toe, zodat collega's in Jira en Confluence zien waar iemand werkt.
- Entra ID matcht groepen op weergavenaam. Een Entra-groep die toevallig dezelfde naam heeft als een bestaande of ingebouwde Atlassian-groep, kan niet worden aangemaakt. KoppelHet geeft de groepen voor Atlassian in Entra ID een vast voorvoegsel, zodat er geen botsing ontstaat.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Hebben we Atlassian Guard nodig?
Ja. Automatische provisioning vanuit een identity provider vraagt volgens Atlassian een Guard Standard-abonnement.
Kunnen beheerders groepen nog in Atlassian aanpassen?
Nee. Gesynchroniseerde groepen zijn in Atlassian alleen-lezen. Lidmaatschap wijzig je in Entra ID; welke app bij een groep hoort, stel je in Atlassian in.
Waarom niet rechtstreeks vanuit het HR-systeem?
Als Entra ID al uit HR wordt gevuld, is één bron voor Atlassian eenvoudiger. Zonder identity provider kan het HR-systeem de bron zijn; zie bijvoorbeeld Nmbrs of Workday naar Atlassian.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Entra ID schrijft via provisioning naar de User provisioning REST API (SCIM 2.0) met de SCIM-basis-URL en API-key uit admin.atlassian.com. Gebruikers matchen op e-mail, groepen op displayName; batch-PATCH voor groepen en schema discovery worden ondersteund.
- Voor hernoemde groepen leest KoppelHet groepen via Microsoft Graph (delta-query op groups) en schrijft via dezelfde Atlassian-API op https://api.atlassian.com/scim/directory/{directoryId}: POST /Groups, PATCH met leden en DELETE van de oude groep. Extra attributen via urn:ietf:params:scim:schemas:extension:enterprise:2.0:User (employeeNumber) en urn:ietf:params:scim:schemas:extension:atlassian:2.0:User (basedIn).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Microsoft Entra ID | Veld in Atlassian Cloud (Jira en Confluence) | Toelichting |
|---|---|---|
userPrincipalName | userName | |
mail, of userPrincipalName als er geen mailbox is | emails[type eq "work"].value | |
givenName en surname | name.givenName en name.familyName | |
employeeId | enterprise.employeeNumber | |
physicalDeliveryOfficeName | atlassian.basedIn | |
accountEnabled en toewijzing | active | |
Groep (displayName en leden) | Groups (displayName, externalId, members) |
Gerelateerd
ADP GlobalView → Microsoft Entra ID
ADP GlobalView Entra ID koppeling: accounts per land uit de internationale payroll
ADP iHCM → Microsoft Entra ID
ADP iHCM Entra ID koppeling: accounts uit de ADP-payroll, in elk Europees land met de juiste licentie
ADP Workforce Now → Microsoft Entra ID
ADP Workforce Now Entra ID koppeling: Microsoft-accounts uit ADP, met het werkadres terug in ADP
AFAS Profit → Microsoft Entra ID
AFAS koppelen met Microsoft Entra ID