ACAccounts in applicaties
Nmbrs Atlassian koppeling: Jira- en Confluence-accounts per bedrijf en afdeling uit Nmbrs
Met een koppeling tussen Nmbrs en Atlassian Cloud krijgt een nieuwe medewerker uit Nmbrs een beheerd Atlassian-account en komt hij in de groepen van zijn bedrijf en afdeling, die toegang geven tot Jira en Confluence. Na de datum uit dienst in Nmbrs wordt het account gedeactiveerd, terwijl zijn issues en pagina's blijven staan.
Wat de koppeling doet
Organisaties met meerdere bv's in Nmbrs die samen één Atlassian-organisatie gebruiken, regelen Jira- en Confluence-toegang vaak via een uitnodiging van een collega. Wie naar een andere bv overstapt, houdt de groepen van de oude, en een vertrekker blijft een betaalde gebruiker tot iemand de lijst doorloopt.
- IT verifieert in Atlassian alle e-maildomeinen die de bv's in Nmbrs gebruiken en zet een directory op voor de koppeling.
- KoppelHet leest de medewerkers van de aangewezen bedrijven in Nmbrs en maakt voor elke nieuwe medewerker met een werkadres een account in die directory.
- De medewerker komt in de groep van zijn bedrijf en afdeling; in Atlassian bepalen jullie welke apps bij die groep horen.
- Bij een andere afdeling of bv in Nmbrs verhuist het groepslidmaatschap mee, vanaf de nieuwe salarisperiode.
- Na de datum uit dienst deactiveert KoppelHet het account.
Waar je op let bij Nmbrs en Atlassian Cloud (Jira en Confluence)
- Nmbrs is geen identity provider die Atlassian zelf kent. Atlassian laat zo'n bron de user provisioning API gebruiken, maar alleen met een Atlassian Guard Standard-abonnement. Zonder Guard kan geen enkele koppeling uit Nmbrs beheerde accounts aanmaken; dat stellen we vast voordat er gebouwd wordt.
- Elke bv in Nmbrs kan een eigen e-maildomein hebben. Atlassian verwerkt wijzigingen alleen voor gebruikers op een geverifieerd domein, en een overstap naar een niet-geverifieerd domein haalt iemand uit zijn groepen. IT verifieert daarom eerst elk domein dat in Nmbrs als werkadres voorkomt; KoppelHet levert de lijst.
- Afdelingen zijn in Nmbrs een lijst per bedrijf, dus twee bv's kunnen allebei een afdeling Projecten hebben. Atlassian weigert een groep met een naam die al bestaat. KoppelHet zet daarom de bedrijfscode in de groepsnaam, zodat de afdelingen gescheiden blijven en geen bestaande groep wordt geraakt.
- Atlassian stuurt geen uitnodigingsmail naar gebruikers die via provisioning ontstaan. Een nieuwe collega uit Nmbrs weet dus niet vanzelf dat hij een account heeft. KoppelHet maakt het account een paar dagen voor de datum in dienst aan, zodat HR de link naar Jira en Confluence in de eigen welkomstmail kan zetten.
- Nmbrs bewaart naast het werkadres ook een privéadres. Een Atlassian-account op een privéadres valt buiten jullie geverifieerde domein en dus buiten het beheer. KoppelHet gebruikt alleen het werkadres; heeft een medewerker er geen, dan komt hij op een lijst voor de salarisadministratie in plaats van in Atlassian.
- Een afdeling die in Nmbrs een andere naam krijgt, kan in Atlassian niet worden hernoemd, want groepen uit provisioning zijn daar alleen-lezen. Omdat KoppelHet de afdelingscode en niet de naam in de groep zet, blijft een naamswijziging in Nmbrs zonder gevolgen voor de toegang.
- Een wissel van functie of afdeling geldt in Nmbrs vanaf een salarisperiode. KoppelHet verplaatst de gebruiker naar de nieuwe groep op de eerste dag van die periode, zodat hij niet weken te vroeg in de Jira-projecten van zijn nieuwe team zit.
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
We gebruiken al Entra ID of Google voor Atlassian. Wat dan?
Dan blijft die de bron voor Atlassian, want twee bronnen voor dezelfde accounts botsen. De koppeling gaat dan van Nmbrs naar Entra ID of Google, en Atlassian volgt.
Krijgt iedereen in Nmbrs een Atlassian-licentie?
Nee. Alleen de bedrijven en afdelingen die jullie aanwijzen. Welke groep toegang tot Jira of Confluence krijgt, stellen jullie in Atlassian zelf in.
Wat gebeurt er met de issues van een vertrekker?
Die blijven staan. Het account wordt gedeactiveerd, niet verwijderd, dus issues en pagina's blijven aan de persoon gekoppeld.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nmbrs wordt gelezen via de Nmbrs REST API met OAuth 2.0, alleen met leesrechten op persoons- en dienstverbandgegevens en de bedrijfsstructuur. In de SOAP EmployeeService (stopt per 1 maart 2027) heten de bronnen PersonalInfoWithoutBSN, Function_GetCurrent en Department_GetCurrent.
- Naar Atlassian via de User provisioning REST API (SCIM 2.0) op https://api.atlassian.com/scim/directory/{directoryId} met de API-key van de directory. POST /Users maakt aan (409 bij een bestaande gebruiker), PATCH wijzigt alleen de meegestuurde velden, DELETE of active = false deactiveert. Groepen via /Groups; een bestaande naam geeft 409. employeeNumber via urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in Atlassian Cloud (Jira en Confluence) | Toelichting |
|---|---|---|
EmailWork | userName en emails | Alleen een werkadres op een geverifieerd domein |
Nickname of FirstName | name.givenName | |
Prefix en LastName | name.familyName | |
Function | title | |
Department | department | |
Bedrijfsnaam | organization | |
Bedrijfscode en EmployeeNumber | employeeNumber (enterprise-extensie) | |
Bedrijf en Department | Groepslidmaatschap | Groepsnaam met voorvoegsel, bedrijfscode en afdelingscode |
Datum uit dienst | active = false |
Gerelateerd
ADP Workforce Now → Nmbrs
ADP Workforce Now Nmbrs koppeling: de Nederlandse payrollgroep uit ADP in het juiste Nmbrs-bedrijf
AlexisHR → Nmbrs
AlexisHR (Simployer One) Nmbrs koppeling: Nederlandse medewerkers in de salarisadministratie
BambooHR → Nmbrs
BambooHR Nmbrs koppeling: Nederlandse salarisadministratie naast een globaal HR-systeem
Bullhorn → Nmbrs
Bullhorn Nmbrs koppeling: plaatsingen met uurloon en einddatum in de verloning