HelixIAM door KubeDNA

DigiD · eHerkenning · eIDAS · Publieke sector · Federatie

DigiD, eHerkenning en eIDAS voor platformbouwers: wat een connector doet en wat je zelf regelt

Een connector maakt van DigiD, eHerkenning en eIDAS standaard inloggen voor je applicaties. Je overeenkomst met Logius of een herkenningsmakelaar vervangt hij niet. Wat de connectors doen, wat bij jou blijft en hoe je ze beoordeelt.

Waar een connector stopt en jouw afspraken beginnen

  1. Jouw overeenkomstMet Logius of een herkenningsmakelaar, door jou geregeld
  2. De connectorDigiD, eHerkenning en eIDAS, inbegrepen, gelabeld Beta
  3. Jouw applicatiesStandaard OIDC- of SAML-login, met een minimaal betrouwbaarheidsniveau
De connector doet het protocolwerk. De overeenkomst blijft van jou.
Op deze pagina
  1. Wat een connector is
  2. Wat HelixIAM meelevert
  3. Wat je zelf nog regelt
  4. Wat Beta hier betekent
  5. Eén platform voor veel organisaties
  6. Wat we niet beweren
  7. Hoe je begint

“Ondersteunt DigiD” is een van de meest beladen zinnen in de Nederlandse publieke IT. Het kan een afgeronde, draaiende koppeling met de voorziening betekenen. Het kan een bibliotheek zijn die je zelf integreert. Het kan ook een slide zijn. Bouw je een platform waarop burgers, bedrijven of ambtenaren inloggen, dan moet je weten welke van de drie je koopt en welke onderdelen bij jou blijven.

Dit artikel scheidt die twee voor DigiD, eHerkenning en eIDAS: wat een connector doet, wat HelixIAM meelevert en wat je zelf nog regelt. De Europese eID-ondersteuning labelen we als Beta, en we leggen uit wat dat betekent voor hoe je haar beoordeelt.

Wat een connector is

DigiD, eHerkenning en eIDAS zijn geen OpenID Connect-providers waar je een client op richt. Elke voorziening heeft een eigen protocolprofiel, eigen betrouwbaarheidsniveaus en eigen regels voor hoe een dienst aansluit. Je applicaties willen daarentegen één ding: standaard inloggen, met een token of assertion die ze kunnen verifiëren.

Een connector zit tussen die twee in. Aan de kant van de voorziening spreekt hij het protocol van die voorziening. Aan jouw kant gedraagt hij zich als elke andere identiteitsbron achter een OpenID Connect- en OAuth 2-provider op basis van open standaarden, en een SAML 2.0-identity provider voor je bestaande applicaties. Je applicatie koppelt één keer met het identiteitsplatform, en het voorzieningspecifieke werk gebeurt daarachter.

Dat is de echte waarde voor een platformbouwer. Zonder connectorlaag leert elk applicatieteam de details van de voorziening apart, en draagt elke applicatie een eigen kopie van de logica. Met zo’n laag koppel je DigiD één keer, en is een nieuwe applicatie gewoon een extra client van hetzelfde platform.

Wat HelixIAM meelevert

HelixIAM bevat drie connectors:

  • DigiD, inclusief Machtigen en mapping van betrouwbaarheidsniveaus. Je sluit aan met je eigen aansluitovereenkomst met Logius.
  • eHerkenning, voor gebruik met je eigen overeenkomst met een herkenningsmakelaar.
  • eIDAS, een connector voor grensoverschrijdend inloggen.

Elke eID-koppeling heeft een minimaal betrouwbaarheidsniveau (LoA) dat zowel wordt gevraagd als wordt afgedwongen. Een niveau vragen is de makkelijke helft: elke integratie kan dat aan de voorziening vragen. Waar het om gaat is dat het minimum ook wordt afgedwongen, eenmalig per koppeling ingesteld op het platform, zodat het niet afhangt van het feit dat elk applicatieteam eraan denkt het te controleren.

De connectors staan naast de rest van het platform. Single sign-on en single logout werken over OIDC- en SAML-applicaties heen. Je kunt inloggen brokeren vanuit andere OIDC-, SAML- en social identity providers, en je bestaande LDAP of Active Directory koppelen, zodat ambtenaren en burgers vanuit één identiteitslaag bediend kunnen worden. De ondertekeningssleutels achter je eID-koppelingen kunnen in jouw HSM of Vault blijven.

Nog één onderdeel, gelabeld als early access: inloggen met de EU Digital Identity Wallet (EUDI-wallet), getest met de EU-referentiewallet. Dat is een aparte functie naast de drie connectors hierboven, en vervangt die vandaag niet.

Wat je zelf nog regelt

Een connector is software. Een DigiD-, eHerkenning- of eIDAS-koppeling vraagt daarnaast een relatie met de partij die de voorziening beheert. Dat is het deel dat geen softwareleverancier voor je kan doen, en het deel dat volgens ons als eerste gezegd moet worden.

  • DigiD. Je sluit aan met je eigen aansluitovereenkomst met Logius. Die overeenkomst is tussen jouw organisatie en Logius.
  • eHerkenning. Je gebruikt je eigen overeenkomst met een herkenningsmakelaar. Met welke makelaar je werkt, bepaal jij.
  • eIDAS. De connector zit erbij. Net als bij de andere twee loopt de koppeling onder je eigen afspraken.
  • Testen tegen de voorziening. De connector moet worden beproefd tegen de omgeving van je makelaar of van de voorziening, met jouw overeenkomst op orde. Die test voer jij uit, en wij sluiten er graag bij aan.

We beschrijven de connectors niet als turnkey, en we beweren niet dat HelixIAM zelf door een van de voorzieningen is goedgekeurd. Wees op je hoede voor elke pitch die doet alsof de overeenkomst al geregeld is.

Gebruik je liever een hub, dan kan dat ook. Signicat biedt bijvoorbeeld DigiD, eHerkenning en iDIN aan via een eigen platform. Omdat HelixIAM inloggen kan brokeren vanuit andere OIDC- en SAML-identity providers, kan zo’n hub erachter zitten, als alternatief voor rechtstreeks aansluiten. Dat is een ontwerpkeuze voor jouw architectuur, en geen keuze die wij de een of andere kant op duwen.

Wat Beta hier betekent

De Europese eID-ondersteuning in HelixIAM (DigiD, eHerkenning en eIDAS) is Beta. In onze eigen woorden: geïmplementeerd, maar nog niet gevalideerd en afhankelijk van jouw configuratie. We hebben geen live DigiD-roundtrip gedraaid tegen een echte aansluitovereenkomst.

Behandel dat als ontwerpinput en niet als voetnoot:

  1. Beoordeel op je eigen overeenkomsten. Draai de connector in de testomgeving van je makelaar, met je eigen instellingen, voordat een besluit definitief is.
  2. Test de betrouwbaarheidsniveaus die je nodig hebt. Controleer hoe het minimumniveau zich gedraagt op elke koppeling die je configureert.
  3. Bepaal wie het bewijs bezit. De resultaten van je tests horen in je eigen beoordeling, naast je eigen beheersmaatregelen.

Ter vergelijking: in de openbare documentatie van Keycloak vonden we geen ingebouwde DigiD- of eHerkenning-connector. Een generieke SAML-broker is misschien te configureren voor deze voorzieningen, maar dat hebben we niet getoetst aan het DigiD-profiel, dus we doen geen uitspraak, de ene noch de andere kant op. Draai je nu Keycloak en wil je een andere route, dan is de vraag aan elk platform dezelfde: wat doet de connector precies, en wie heeft hem waartegen getest?

Eén platform voor veel organisaties

De Nederlandse publieke sector bestaat zelden uit één organisatie. Een regionaal platform bedient meerdere gemeenten. Een leverancier host diensten voor veel klanten. Elk van hen heeft eigen gebruikers, een eigen huisstijl en eigen overeenkomsten.

HelixIAM is van nature multi-tenant: elke tenant krijgt een eigen realm, eigen gebruikers, sleutels en huisstijl. Een realm per organisatie betekent dat de koppelingsinstellingen, gebruikers en sleutels van de ene gemeente gescheiden zijn van die van een andere, op een platform dat je één keer draait. Sleutels kun je nog een stap verder nemen: een eigen HSM-partitie of Vault-credential per tenant, en sleutels voor credential-uitgifte en eID-koppelingen in jouw HSM of Vault.

Het platform zelf is self-hosted op je eigen infrastructuur: jij bepaalt waar data staat, en er is geen telemetrie. Dat is geen toezegging over waar je data blijft. Waar data uiteindelijk terechtkomt, hangt ook af van de rest van je stack, zoals back-ups en mailrelays. Het betekent wel dat de beslissing bij jou ligt.

Wat we niet beweren

Om het eerlijk te houden, de korte lijst:

  • De connectors zijn Beta, niet stabiel.
  • We beweren geen onafhankelijke toetsing: een onafhankelijke penetratietest is in voorbereiding.
  • We bieden geen conformiteits- of goedkeuringsverklaring van een van de voorzieningen.
  • De EU-wallet is early access.
  • De overeenkomsten met Logius of een herkenningsmakelaar blijven bij jou.

Hoe je begint

Je hoeft niet alles in één keer te beslissen. We stellen drie stappen voor.

  1. Een technische demo. Onze engineers laten de connectors, de controle op het betrouwbaarheidsniveau en een realm per organisatie zien op een draaiend systeem.
  2. Jouw use case. We vertalen je organisaties, je diensten en de overeenkomsten die je hebt of aan het regelen bent naar een realm-indeling en een set connectors.
  3. Een betaalde pilot. Past het, dan volgt een pilot op je eigen infrastructuur, met vooraf afgesproken succescriteria, en waar je de overeenkomsten op orde hebt, een test tegen de testomgeving van je makelaar.

HelixIAM is commerciële software van KubeDNA B.V., beschikbaar onder een commerciële licentie, en zit in early access. We nemen nu lanceringspartners aan boord. Staan DigiD en eHerkenning op jouw roadmap, dan is een demo een goed begin.

Lees ook

IAM voor de publieke sector: DigiD, eHerkenning en EU-wallet

Voor gemeenten en samenwerkingsverbanden: één multi-tenant IAM met een realm per organisatie, DigiD-, eHerkenning- en eIDAS-connectoren voor je eigen overeenkomsten, AVG-tooling en early access tot de EU Digitale Identiteitswallet.

Soevereine identiteit en zelfgehoste enterprise-IAM

Enterprise-IAM op infrastructuur en sleutels die jij beheert: OIDC, SAML, SSO en MFA, ondertekeningssleutels in je HSM of Vault, DigiD-, eHerkenning- en eIDAS-connectoren, en de EU Digitale Identiteitswallet in early access.

Alle artikelen

Bekijk het op een draaiend systeem.

In een technische demo laten onze engineers de flows uit dit artikel zien op een echte HelixIAM en vertalen ze naar jouw landschap.