developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

NL GOV Profile for CloudEvents

Van intake tot verplichte standaard​

CloudEvents is een internationale standaard voor het uniform beschrijven van events in eventgedreven architecturen. Dankzij deze standaard kunnen applicaties eenvoudiger informatie uitwisselen over gebeurtenissen (bijvoorbeeld een adreswijziging of een vergunningaanvraag). In Nederland wordt CloudEvents nu voorzien van een nationaal profiel: het NL GOV profile for CloudEvents.

CloudEvents logo

Besluitvorming Forum Standaardisatie​

  • 4 december 2024 – Intakefase
    Het Forum Standaardisatie stemde in met het intakeadvies om het "NL GOV profile for CloudEvents" in procedure te nemen voor plaatsing op de lijst met verplichte standaarden (“Pas toe of leg uit”).
    Bron: intakeadvies NL GOV profile for CloudEvents (PDF).

  • 19 juni 2025 – Expertadvies
    De expertgroep adviseerde positief over opname van de standaard. Het profiel sluit nauw aan op internationale CloudEvents-specificaties, maar maakt ze concreet toepasbaar binnen de Nederlandse overheid.
    Bron: expertadvies NL GOV profile for CloudEvents (PDF).

  • 25 september 2025 – Forumadvies
    Het Forum Standaardisatie heeft ingestemd met het advies aan het OBDO om het "NL GOV profile for CloudEvents" verplicht te stellen (“Pas toe of leg uit”). Daarnaast is Logius het predicaat ‘Uitstekend beheer’ toegekend voor deze standaard.

Wat is het NL GOV profile for CloudEvents?​

Het Nederlandse profiel geeft richtlijnen voor hoe overheidsorganisaties CloudEvents moeten gebruiken, zodat er interoperabiliteit ontstaat tussen systemen en sectoren. Het NL GOV profiel specificeert onder meer:

  • Uniforme naamgeving en metadata.
  • Afspraken over payload en headers.
  • Toepassing in notificatieservices van de overheid.

Een voorbeeld van een CloudEvent dat is opgenomen in de standaard:

{
  "specversion": "1.0",
  "type": "nl.overheid.zaken.zaakstatus-gewijzigd",
  "source": "urn:nld:oin:00000001823288444000:systeem:BRP-component",
  "subject": "999990342",
  "id": "f3dce042-cd6e-4977-844d-05be8dce7cea",
  "time": "2021-12-10T17:31:00Z",
  "nlbrpnationaliteit": "0083",
  "geheimnummer": null,
  "dataref": "https://gemeenteX/api/persoon/999990342",
  "sequence": "1234",
  "sequencetype": "integer",
  "datacontenttype": "application/json",
  "data": {
    "bsn": "999990342",
    "naam": "Jan Jansen",
    "gecontroleerd": "ja"
  }
}

De technische specificatie is beschikbaar via Logius: - CloudEvents NL – technische documentatie.
Het voorbeeld en de toelichting daarop zijn beschikbaar op gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/#example.

Naast het Nederlandse profiel zijn ook een drietal handreikingen gemaakt die toelichten hoe het NL GOV profiel is toe te passen bij gebruik van het:

Deze handreikingen verwijzen naar door de Serverless Working Group ontwikkelde specificaties. Doel daarvan is om verdergaande standaardisatie te bewerkstelligen en interoperabiliteit te vergroten.

Waarom belangrijk?​

Het gebruik van CloudEvents en het NL GOV profiel helpt de overheid om:

  • Real-time en event-driven te werken in ketens en ecosystemen.
  • Losse koppelingen te realiseren tussen systemen, waardoor onderhoud en innovatie eenvoudiger worden.
  • Interoperabiliteit te garanderen, zodat alle overheidsorganisaties dezelfde taal spreken in event-uitwisseling.

Meer informatie​