Nmbrs logoBi

Accounts in applicaties

Nmbrs Bitwarden koppeling: Bitwarden-leden per bedrijf en afdeling uit Nmbrs

Met een koppeling tussen Nmbrs en Bitwarden wordt een nieuwe medewerker uit Nmbrs op zijn datum in dienst uitgenodigd in de Bitwarden-organisatie, in de groep van zijn bedrijf en afdeling. Wisselt hij van afdeling of bv, dan wisselen de groepen mee, en na de datum uit dienst trekt de koppeling het lid in, zodat de licentieplaats vrijkomt.

Wat de koppeling doet

Organisaties die de salarisadministratie van een of meer bv's in Nmbrs doen en gedeelde inlogs in Bitwarden bewaren, voegen leden meestal toe als iemand erom vraagt. Wie binnen de groep naar een andere bv gaat, houdt de collecties van zijn oude bedrijf, en vertrekkers blijven lid tot IT een lijst opschoont.

  1. We leggen samen vast welke bedrijven en afdelingen een Bitwarden-groep krijgen, en of functies een extra groep krijgen.
  2. Iemand met toegang tot de werkgevers in Nmbrs geeft de koppeling eenmalig toestemming, alleen om te lezen.
  3. Op de datum in dienst nodigt KoppelHet de medewerker uit op zijn werkadres, in de groep van zijn bedrijf en afdeling. Een beheerder bevestigt het lid na het accepteren.
  4. Een andere afdeling, functie of bv wisselt de groepen op de ingangsdatum; het lid en zijn eigen kluis blijven.
  5. Na de datum uit dienst trekt KoppelHet het lid in, en na de termijn die jullie kiezen verwijdert het het lid uit de organisatie.
Nmbrs → KoppelHet → BitwardenBRONNmbrsDOELBitwardenBitwardenKoppelHetmapping · logging · monitoringNmbrs → KoppelHet → BitwardenBRONNmbrsDOELBitwardenBitwardenKoppelHetmapping · logging · monitoring
Heen: Lid van de Bitwarden-organisatie · Groep per bedrijf en afdeling · Groep per functie, waar afgesproken · Intrekken, herstellen en na een termijn verwijderen

Waar je op let bij Nmbrs en Bitwarden

  • Afdelingen zijn in Nmbrs een lijst per bedrijf, en een afdeling Financiën komt vaak bij meerdere bv's voor. KoppelHet maakt per bedrijf en afdeling een eigen Bitwarden-groep, zodat de bankinlogs van de ene bv niet zichtbaar worden voor de financiële afdeling van een andere.
  • Een personeelsnummer is in Nmbrs alleen binnen een bedrijf uniek. Bitwarden zoekt leden en groepen op met een extern ID; KoppelHet zet de bedrijfscode voor het nummer, zodat twee medewerkers met hetzelfde nummer bij verschillende bv's nooit hetzelfde lid worden.
  • Een overstap naar een andere bv staat in Nmbrs als uitdiensttreding bij het ene bedrijf en indiensttreding bij het andere. KoppelHet herkent dezelfde persoon en verhuist het bestaande lid naar de groepen van het nieuwe bedrijf, in plaats van het in te trekken en een tweede uitnodiging te sturen.
  • Een functie of afdeling geldt in Nmbrs per salarisperiode. KoppelHet wisselt de Bitwarden-groepen op de eerste dag van die periode, niet op het moment dat de salarisadministratie de wijziging invoert, die soms weken eerder of later ligt.
  • Komt een oud-medewerker terug onder hetzelfde personeelsnummer en staat het lid nog als ingetrokken in Bitwarden, dan herstelt KoppelHet het op de nieuwe datum in dienst. Bitwarden vraagt dan geen nieuwe uitnodiging of bevestiging, en ingetrokken leden hebben in de tussentijd geen licentieplaats gekost.
  • KoppelHet vraagt bij Nmbrs alleen leesrechten voor personalia, dienstverband, organisatiestructuur en bedrijfsgegevens, en geen rechten voor loon of bankrekeningen. Loopt de salarisadministratie via een administratiekantoor, dan geeft het kantoor de koppeling alleen toegang tot jullie bedrijven.

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, architectuur en compliance

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.

Prijsindicatie · Basis

Laat je zakelijke e-mailadres achter, dan zie je de prijsindicatie direct.

We gebruiken je adres alleen om je vraag over deze koppeling op te volgen.

Veelgestelde vragen

Kan Bitwarden niet via Entra ID en SCIM?

Ja, als Entra ID al uit Nmbrs wordt gevuld en de groepen per bedrijf en afdeling kloppen. Deze koppeling past als Nmbrs de enige plek is die de juiste bv en afdeling kent.

Wat als het werkadres nog niet in Nmbrs staat?

Dan wacht KoppelHet met uitnodigen en meldt het na de datum in dienst aan HR. Een uitnodiging naar een privéadres sturen we niet.

Ziet KoppelHet de inhoud van de kluis?

Nee. De Public API van Bitwarden beheert leden, groepen en collecties, geen kluisitems.

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 (identityservice.nmbrs.com, autorisatiecode-flow met toestemming van een Nmbrs-gebruiker en refresh token) met alleen leesscopes: employee.info.read, employee.employment.read, employee.orgstructure.read en company.info.read; per bedrijf gelezen. De SOAP API stopt per 1 maart 2027.
  • Naar Bitwarden schrijven we via de Bitwarden Public API (api.bitwarden.com of api.bitwarden.eu) met de organisatie-API-sleutel (client_id organization.ClientId, grant_type client_credentials, scope api.organization; token 3600 seconden). Leden en groepen met externalId, intrekken en herstellen via de member-endpoints, lijsten met continuationToken. Beschikbaar voor Teams- en Enterprise-organisaties.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in NmbrsVeld in BitwardenToelichting
Bedrijfscode en personeelsnummerexternalId van het lidNummer is alleen per bedrijf uniek
Werk-e-mailadresemailNiet het privéadres
Bedrijf en afdelingGroep: externalId en name
FunctieExtra groep via een tabel die HR beheert
Datum in dienstMoment van uitnodigen of herstellen
Datum uit dienstLid intrekken, na een termijn verwijderen

Gerelateerd

Welke systemen wil je koppelen?

Vertel welke systemen je gebruikt en wat er automatisch moet gebeuren. Samen bepalen we de kleinste werkende oplossing, met een helder ontwerp en een offerte vooraf.