developer-overheid-nl/skills-developer-overheid-nl

#!/usr/bin/env python3

url = f"https://api.github.com/repos/{GITHUB_REPO}/contents/{path}?ref={GITHUB_BRANCH}"     req = urllib.request.Request(url, headers={"Accept": "application/vnd.github.v3+json"})

req = urllib.request.Request(url, headers={"Accept": "application/vnd.github.v3+json"})

try:         with urllib.request.urlopen(req) as response:             return json.loads(response.read().decode())

with urllib.request.urlopen(req) as response:

url = f"https://raw.githubusercontent.com/{GITHUB_REPO}/{GITHUB_BRANCH}/{path}"     try:         with urllib.request.urlopen(url) as response:

try:         with urllib.request.urlopen(url) as response:             return response.read().decode()

with urllib.request.urlopen(url) as response:

metadata:   source: developer.overheid.nl   synced-from: https://github.com/{GITHUB_REPO}

source: developer.overheid.nl   synced-from: https://github.com/{GITHUB_REPO}   topic: {topic}

synced-from: https://github.com/{GITHUB_REPO}

Source: https://github.com/{GITHUB_REPO}/tree/{GITHUB_BRANCH}/{DOCS_PATH}/{topic}

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: apis

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/apis

- [Kennisplatform API's](https://www.geonovum.nl/themas/kennisplatform-apis)

Een OpenAPI Specificatie (OAS) is een [YAML](https://yaml.org/spec/) of

Een OpenAPI Specificatie (OAS) is een [YAML](https://yaml.org/spec/) of

[JSON](https://www.forumstandaardisatie.nl/open-standaarden/json) bestand met de

[JSON](https://www.forumstandaardisatie.nl/open-standaarden/json) bestand met de

De ADR Linter controleert of een OpenAPI Specificatie compliant is met de API Design Rules. De linter is gebaseerd op het Open Source project [Spectral](https://github.com/stoplightio/spectral).

De ADR Linter controleert of een OpenAPI Specificatie compliant is met de API Design Rules. De linter is gebaseerd op het Open Source project [Spectral](https://github.com/stoplightio/spectral).

[Spectral](https://github.com/stoplightio/spectral).

[Spectral](https://github.com/stoplightio/spectral).

Een OpenAPI Specificatie kan online getest worden via onze online OAS Checker: [https://developer-overheid-nl.github.io/oas-checker](https://developer-overheid-nl.github.io/oas-checker)

Een OpenAPI Specificatie kan online getest worden via onze online OAS Checker: [https://developer-overheid-nl.github.io/oas-checker](https://developer-overheid-nl.github.io/oas-checker)

[https://developer-overheid-nl.github.io/oas-checker](https://developer-overheid-nl.github.io/oas-checker)

[https://developer-overheid-nl.github.io/oas-checker](https://developer-overheid-nl.github.io/oas-checker)

$ npm install -g @stoplight/spectral-cli $ spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE

$ npm install -g @stoplight/spectral-cli $ spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE

$ spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE

$ spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE

Sommige IDEs ondersteunen Spectral via extensies of plugins. Eén daarvan is VSCode. Hieronder staat beschreven hoe je de ADR Linter kunt gebruiken met [de officiele Spectral extensie voor Visual Studio Code](https://github.com/stoplightio/v

Sommige IDEs ondersteunen Spectral via extensies of plugins. Eén daarvan is VSCode. Hieronder staat beschreven hoe je de ADR Linter kunt gebruiken met [de officiele Spectral extensie voor Visual Studio Code](https://github.com/stoplightio/v

[de officiele Spectral extensie voor Visual Studio Code](https://github.com/stoplightio/vscode-spectral):

[de officiele Spectral extensie voor Visual Studio Code](https://github.com/stoplightio/vscode-spectral):

# Download the ruleset to your project home $ curl -L https://static.developer.overheid.nl/adr/ruleset.yaml > .spectral.yml

# Download the ruleset to your project home $ curl -L https://static.developer.overheid.nl/adr/ruleset.yaml > .spectral.yml

$ curl -L https://static.developer.overheid.nl/adr/ruleset.yaml > .spectral.yml

$ curl -L https://static.developer.overheid.nl/adr/ruleset.yaml > .spectral.yml

$ docker run --rm --entrypoint=sh      -v $(pwd)/api:/locale stoplight/spectral:5.9.1      -c "spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE"

$ docker run --rm --entrypoint=sh      -v $(pwd)/api:/locale stoplight/spectral:5.9.1      -c "spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE"

-c "spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE"

-c "spectral lint -r https://static.developer.overheid.nl/adr/ruleset.yaml $OAS_URL_OR_FILE"

script:     - npm install -g @stoplight/spectral-cli     - curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >

script:     - npm install -g @stoplight/spectral-cli     - curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >

- npm install -g @stoplight/spectral-cli     - curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >       .spectral.yml

- npm install -g @stoplight/spectral-cli     - curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >       .spectral.yml

- curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >

- curl -L https://static.developer.overheid.nl/adr/ruleset.yaml >

De API Design Rules (ADR) Validator is een CLI-tool om te valideren of een API zich gedraagt conform deze delen van de [NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Inleiding/):

De API Design Rules (ADR) Validator is een CLI-tool om te valideren of een API zich gedraagt conform deze delen van de [NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Inleiding/):

[NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Inleiding/):

[NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Inleiding/):

- Alle rules uit de   [API Design Rules Module](https://gitdocumentatie.logius.nl/publicatie/api/adr/)

- Alle rules uit de   [API Design Rules Module](https://gitdocumentatie.logius.nl/publicatie/api/adr/)

[API Design Rules Module](https://gitdocumentatie.logius.nl/publicatie/api/adr/)

[API Design Rules Module](https://gitdocumentatie.logius.nl/publicatie/api/adr/)

die testbaar zijn en we dus kunnen valideren door het aanroepen van de API. - De Transport Layer Security (TLS) rules van de   [Transport Security Module](https://docs.geostandaarden.nl/api/API-Strategie-mod-transport-security/#transport-se

die testbaar zijn en we dus kunnen valideren door het aanroepen van de API. - De Transport Layer Security (TLS) rules van de   [Transport Security Module](https://docs.geostandaarden.nl/api/API-Strategie-mod-transport-security/#transport-se

[Transport Security Module](https://docs.geostandaarden.nl/api/API-Strategie-mod-transport-security/#transport-security).

[Transport Security Module](https://docs.geostandaarden.nl/api/API-Strategie-mod-transport-security/#transport-security).

In de readme van de [ADR Validator repository](https://gitlab.com/commonground/don/adr-validator)

In de readme van de [ADR Validator repository](https://gitlab.com/commonground/don/adr-validator)

[ADR Validator repository](https://gitlab.com/commonground/don/adr-validator)

[ADR Validator repository](https://gitlab.com/commonground/don/adr-validator)

- [DockerFile](https://gitlab.com/commonground/don/developer.overheid.nl/-/blob/main/Dockerfile?ref_type=heads)

- [DockerFile](https://gitlab.com/commonground/don/developer.overheid.nl/-/blob/main/Dockerfile?ref_type=heads)

- [.gitlab-ci.yml](https://gitlab.com/commonground/don/developer.overheid.nl/-/blob/main/.gitlab-ci.yml?ref_type=heads)

- [.gitlab-ci.yml](https://gitlab.com/commonground/don/developer.overheid.nl/-/blob/main/.gitlab-ci.yml?ref_type=heads)

Het actuele en uitgebreide overzicht van de REST API Design Rules vind je hier: [API Design Rules](https://logius-standaarden.github.io/API-Design-Rules/#normative-design-rules).

Het actuele en uitgebreide overzicht van de REST API Design Rules vind je hier: [API Design Rules](https://logius-standaarden.github.io/API-Design-Rules/#normative-design-rules).

[API Design Rules](https://logius-standaarden.github.io/API-Design-Rules/#normative-design-rules).

[API Design Rules](https://logius-standaarden.github.io/API-Design-Rules/#normative-design-rules).

de OpenAPI Specification ook een eigen verplichte standaard op de pas-toe-leg-uit-lijst bij Forum Standaardisatie: [https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification](https://www.forumstandaardisatie.nl/open-standaa

de OpenAPI Specification ook een eigen verplichte standaard op de pas-toe-leg-uit-lijst bij Forum Standaardisatie: [https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification](https://www.forumstandaardisatie.nl/open-standaa

[https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification)

[https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification)

authenticatie en met de juiste CORS policy:   - ✅**Goed**: `Access-Control-Allow-Origin: *`   - ⛔<U+FE0F>**Fout**: `Access-Control-Allow-Origin: https://developer.overheid.nl`

authenticatie en met de juiste CORS policy:   - ✅**Goed**: `Access-Control-Allow-Origin: *`   - ⛔<U+FE0F>**Fout**: `Access-Control-Allow-Origin: https://developer.overheid.nl`

- ⛔<U+FE0F>**Fout**: `Access-Control-Allow-Origin: https://developer.overheid.nl`

- ⛔<U+FE0F>**Fout**: `Access-Control-Allow-Origin: https://developer.overheid.nl`

"contact": {     "name": "Gebouwen API beheerder",     "url": "https://www.github.com/ministerie/gebouwen/issues",

"contact": {     "name": "Gebouwen API beheerder",     "url": "https://www.github.com/ministerie/gebouwen/issues",

"name": "Gebouwen API beheerder",     "url": "https://www.github.com/ministerie/gebouwen/issues",     "email": "teamgebouwen@ministerie.nl"

"name": "Gebouwen API beheerder",     "url": "https://www.github.com/ministerie/gebouwen/issues",     "email": "teamgebouwen@ministerie.nl"

"url": "https://www.github.com/ministerie/gebouwen/issues",

"url": "https://www.github.com/ministerie/gebouwen/issues",

API versie, bijv. `API-Version: 2.1.4` - De major version moet onderdeel zijn van het endpoint, prefixed met een `v`,   bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`

API versie, bijv. `API-Version: 2.1.4` - De major version moet onderdeel zijn van het endpoint, prefixed met een `v`,   bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`

- De major version moet onderdeel zijn van het endpoint, prefixed met een `v`,   bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`   object van de OpenAPI Specificatie zo opgenomen te zijn.

- De major version moet onderdeel zijn van het endpoint, prefixed met een `v`,   bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`   object van de OpenAPI Specificatie zo opgenomen te zijn.

bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`

bijv. `https://api.developer.overheid.nl/v1`. Dit dient ook in het `servers`

"servers": [     {       "url": "https://api.example.com/v1",

"servers": [     {       "url": "https://api.example.com/v1",

{       "url": "https://api.example.com/v1",       "description": "Productie omgeving"

{       "url": "https://api.example.com/v1",       "description": "Productie omgeving"

"url": "https://api.example.com/v1",

"url": "https://api.example.com/v1",

},     {       "url": "https://sandbox-api.example.com:8443/v1",

},     {       "url": "https://sandbox-api.example.com:8443/v1",

{       "url": "https://sandbox-api.example.com:8443/v1",       "description": "Sandbox omgeving"

{       "url": "https://sandbox-api.example.com:8443/v1",       "description": "Sandbox omgeving"

"url": "https://sandbox-api.example.com:8443/v1",

"url": "https://sandbox-api.example.com:8443/v1",

- Collecties in (Nederlands) meervoud. Best practice voor koppelwoorden in de   URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/open-source-projecten`

- Collecties in (Nederlands) meervoud. Best practice voor koppelwoorden in de   URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/open-source-projecten`

URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/open-source-projecten` - Child genest onder resource in (Nederlands) meervoud. Voorkeur voor

URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/open-source-projecten` - Child genest onder resource in (Nederlands) meervoud. Voorkeur voor

- ✅**Goed**: `https://api/v1/open-source-projecten`

- ✅**Goed**: `https://api/v1/open-source-projecten`

- Child genest onder resource in (Nederlands) meervoud. Voorkeur voor   koppelwoorden in de URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten`

- Child genest onder resource in (Nederlands) meervoud. Voorkeur voor   koppelwoorden in de URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten`

koppelwoorden in de URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten` - URI's mogen niet op een slash eindigen.

koppelwoorden in de URI is `kebab-case`:   - ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten` - URI's mogen niet op een slash eindigen.

- ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten`

- ✅**Goed**: `https://api/v1/organisaties/372/open-source-projecten`

- URI's mogen niet op een slash eindigen.   - ✅**Goed**: `https://api/v1/open-source-projecten`   - ⛔<U+FE0F>**Fout**: `https://api/v1/open-source-projecten/`

- URI's mogen niet op een slash eindigen.   - ✅**Goed**: `https://api/v1/open-source-projecten`   - ⛔<U+FE0F>**Fout**: `https://api/v1/open-source-projecten/`

- ✅**Goed**: `https://api/v1/open-source-projecten`

- ✅**Goed**: `https://api/v1/open-source-projecten`

- ⛔<U+FE0F>**Fout**: `https://api/v1/open-source-projecten/`

- ⛔<U+FE0F>**Fout**: `https://api/v1/open-source-projecten/`

- URI's mogen geen gevoelige informatie bevatten omdat dit bijv. in logs terecht   kan komen.   - ⛔<U+FE0F>**Fout**: `https://api/v1/personen?bsn=123234345456`

- URI's mogen geen gevoelige informatie bevatten omdat dit bijv. in logs terecht   kan komen.   - ⛔<U+FE0F>**Fout**: `https://api/v1/personen?bsn=123234345456`

- ⛔<U+FE0F>**Fout**: `https://api/v1/personen?bsn=123234345456`

- ⛔<U+FE0F>**Fout**: `https://api/v1/personen?bsn=123234345456`

- Regel:   https://logius-standaarden.github.io/API-Design-Rules/#/core/doc-openapi-contact

- Regel:   https://logius-standaarden.github.io/API-Design-Rules/#/core/doc-openapi-contact

https://logius-standaarden.github.io/API-Design-Rules/#/core/doc-openapi-contact

https://logius-standaarden.github.io/API-Design-Rules/#/core/doc-openapi-contact

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fdoc%2Dopenapi

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fdoc%2Dopenapi

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/doc-openapi

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/doc-openapi

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fdoc%2Dopenapi

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/http-methods

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/http-methods

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fhttp%2Dmethods

API Design Rules. Kijk voor een volledig overzicht van de regels in de repository van de standaard op https://gitdocumentatie.logius.nl/publicatie/api/adr/.

https://gitdocumentatie.logius.nl/publicatie/api/adr/.

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/no-trailing-slash

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/no-trailing-slash

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fno%2Dtrailing%2Dslash

Deze regel schrijft voor dat elke api een `/openapi.json` file moet publiceren zodat tooling hier gebruik van kan maken. Hiermee kunnen tools zoals [Swagger UI](https://swagger.io/tools/swagger-ui/) automatisch documentatie

zodat tooling hier gebruik van kan maken. Hiermee kunnen tools zoals [Swagger UI](https://swagger.io/tools/swagger-ui/) automatisch documentatie websites bouwen en kunnen er [TypeScript types](https://openapi-ts.dev/) worden

[Swagger UI](https://swagger.io/tools/swagger-ui/) automatisch documentatie

websites bouwen en kunnen er [TypeScript types](https://openapi-ts.dev/) worden

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/publish-openapi

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/publish-openapi

- Regel:   [https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/semver](https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/semver)

[https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/semver](https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/semver)

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/uri-version

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/uri-version

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Furi%2Dversion

- Regel:   https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/version-header

https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/version-header

https://logius-standaarden.github.io/API-Design-Rules/#:~:text=%23%2Fcore%2Fversion%2Dheader

> **Verplichte standaard** Deze standaard is [verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/rest-api-design-rules)

Deze standaard is [verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/rest-api-design-rules) van de overheid.

[verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/rest-api-design-rules)

een adreswijziging of een vergunningaanvraag). In Nederland wordt CloudEvents nu voorzien van een nationaal profiel: het [**NL GOV profile for CloudEvents**](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/).

[**NL GOV profile for CloudEvents**](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/).

![CloudEvents logo](https://github.com/cncf/artwork/blob/main/projects/cloudevents/horizontal/color/cloudevents-horizontal-color.png?raw=true)

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)](https://www.forumstandaardisatie.nl/sites/default/

Bron: [intakeadvies NL GOV profile for CloudEvents (PDF)](https://www.forumstandaardisatie.nl/sites/default/files/BFS/3-lijsten/standaarden/cloudevents/20241204-intakeadvies-NL-GOV-profile-for-CloudEvents.pdf).

sluit nauw aan op internationale CloudEvents-specificaties, maar maakt ze   concreet toepasbaar binnen de Nederlandse overheid.     Bron: [expertadvies NL GOV profile for CloudEvents (PDF)](https://www.forumstandaardisatie.nl/sites/default/

Bron: [expertadvies NL GOV profile for CloudEvents (PDF)](https://www.forumstandaardisatie.nl/sites/default/files/BFS/3-lijsten/standaarden/cloudevents/20250619-Expertadvies-NL-GOV-profile-for-CloudEvents.pdf).

- **25 september 2025 – Forumadvies**     Het Forum Standaardisatie heeft ingestemd met het advies aan het   [OBDO](https://pgdi.nl/) om het _"NL GOV profile for CloudEvents"_ verplicht

Het Forum Standaardisatie heeft ingestemd met het advies aan het   [OBDO](https://pgdi.nl/) om het _"NL GOV profile for CloudEvents"_ verplicht   te stellen (“Pas toe of leg uit”). Daarnaast is Logius het predicaat

[OBDO](https://pgdi.nl/) om het _"NL GOV profile for CloudEvents"_ verplicht

"nlbrpnationaliteit": "0083",   "geheimnummer": null,   "dataref": "https://gemeenteX/api/persoon/999990342",

"geheimnummer": null,   "dataref": "https://gemeenteX/api/persoon/999990342",   "sequence": "1234",

"dataref": "https://gemeenteX/api/persoon/999990342",

De technische specificatie is beschikbaar via Logius: - [CloudEvents NL – technische documentatie](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/).

[CloudEvents NL – technische documentatie](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/).

Het voorbeeld en de toelichting daarop zijn beschikbaar op [gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/#example](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/#example).

[gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/#example](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/#example).

- [JSON gegevensformaat](https://github.com/Logius-standaarden/CloudEvents-NL-Guidelines/blob/develop//NL-GOV-Guideline-for-CloudEvents-JSON.md)

- [HTTP transportprotocol](https://github.com/Logius-standaarden/CloudEvents-NL-Guidelines/blob/develop/NL-GOV-Guideline-for-CloudEvents-HTTP.md)

- [Webhook interactiepatroon](https://github.com/Logius-standaarden/CloudEvents-NL-Guidelines/blob/develop//NL-GOV-Guideline-for-CloudEvents-Webhook.md).

- [NL GOV profile for CloudEvents – Forum Standaardisatie](https://www.forumstandaardisatie.nl/open-standaarden/nl-gov-profile-cloudevents)

- [CloudEvents NL – Logius documentatie](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/CloudEvents-NL/)

- [CloudEvents NL - Guidelines for HTTP, JSON & Webhooks](https://gitdocumentatie.logius.nl/publicatie/notificatieservices/guidelines/)

- [De internationale specificatie en documentatie van Cloudevents](https://cloudevents.io/)

- [Webhooks](./webhooks.md) – voor server-to-server notificaties, zoals een   betaalprovider die een webshop informeert. - [Server-sent events (SSE) wiki](https://en.wikipedia.org/wiki/Server-sent_events)

betaalprovider die een webshop informeert. - [Server-sent events (SSE) wiki](https://en.wikipedia.org/wiki/Server-sent_events)   – voor éénrichtingsverkeer, zoals nieuws feeds of sportuitslagen.

- [Server-sent events (SSE) wiki](https://en.wikipedia.org/wiki/Server-sent_events)

– voor éénrichtingsverkeer, zoals nieuws feeds of sportuitslagen. - [WebSocket wiki](https://en.wikipedia.org/wiki/WebSocket) – voor   bi-directionele communicatie, geschikt voor chats of games.

- [WebSocket wiki](https://en.wikipedia.org/wiki/WebSocket) – voor

Werk je bij een overheid en wil je experimenteren met event-driven API’s? Deel je ervaringen via developer.overheid.nl of neem deel aan het [Kennisplatform API's](https://developer.overheid.nl/communities/kennisplatform-apis/)

je ervaringen via developer.overheid.nl of neem deel aan het [Kennisplatform API's](https://developer.overheid.nl/communities/kennisplatform-apis/) en deel onderling ervaringen rond de NL API Strategie en event oriëntatie. Samen

[Kennisplatform API's](https://developer.overheid.nl/communities/kennisplatform-apis/)

> **Dit is een samenvatting van de Architectuur van de NL API Strategie van het Kennisplatform API's** Het volledige [Architectuurdocument](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/)

Het volledige [Architectuurdocument](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/) is vastgesteld en online gepubliceerd als onderdeel van het

[Architectuurdocument](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/)

[Kennisplatform API's](https://developer.overheid.nl/communities/kennisplatform-apis/).

Dit architectuurdocument is onderdeel van de **NL API Strategie** en biedt een verdieping op [de algemene inleiding](https://docs.geostandaarden.nl/api/API-Strategie/). De

verdieping op [de algemene inleiding](https://docs.geostandaarden.nl/api/API-Strategie/). De versie is opgesteld in december 2023 en is los gepositioneerd ten opzichte van

[de algemene inleiding](https://docs.geostandaarden.nl/api/API-Strategie/). De

> [Verder lezen](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/#typologie-van-api-s)

- Ontdekken: Zorgt voor vindbaarheid via portals, catalogi en API directories     (zoals het     [Developer Overheid API Register](https://apis.developer.overheid.nl/apis)

(zoals het     [Developer Overheid API Register](https://apis.developer.overheid.nl/apis)     ).

[Developer Overheid API Register](https://apis.developer.overheid.nl/apis)

> [Verder lezen](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/#api-capability-model)

- [API Strategie – Geonovum](https://geonovum.nl/geo-standaarden/api-strategie)

- [KP-APIs GitHub](https://github.com/Geonovum/KP-APIs)

- [API Design Rules (ADR)](https://gitdocumentatie.logius.nl/publicatie/api/adr/)

- [NL API Strategie – Architectuur](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/)

- [API Management en Beveiliging – Developer Overheid](https://developer.overheid.nl/apis/beveiliging/)

Meer informatie hierover vind je ook in de richtlijnen van de [NL API Strategie](https://developer.overheid.nl/communities/kennisplatform-apis/).

[NL API Strategie](https://developer.overheid.nl/communities/kennisplatform-apis/).

- [NL API Strategie – Eventgedreven werken](https://developer.overheid.nl/communities/kennisplatform-apis/)

- [CloudEvents standaard bij Geonovum](https://www.gemmaonline.nl/wiki/De_CloudEvents_standaard)

- [Server-sent events wiki](https://en.wikipedia.org/wiki/Server-sent_events)

- [WebSocket wiki](https://en.wikipedia.org/wiki/WebSocket)

resource proberen aan te passen door middel van een `PUT`, `DELETE` of `PATCH` operatie. Dit staat bekend als het [_Lost Update_](https://www.w3.org/1999/04/Editing/) probleem.

[_Lost Update_](https://www.w3.org/1999/04/Editing/) probleem.

voorschrijven. In de API specificatie kan dit worden geimplementeerd door middel van het toevoegen van [`ETag`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag)

van het toevoegen van [`ETag`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag) en

[`ETag`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag)

en [`If-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-Match) headers aan onderstaande operaties.

[`If-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-Match)

Problem JSON is een internetstandaard ([RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807)) die een

([RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807)) die een

{   "type": "https://example.com/probs/out-of-credit",

"type": "https://example.com/probs/out-of-credit",

app.use((err, req, res, next) => {   res.status(err.status || 500).json({     type: "https://example.com/probs/" + (err.type || "unknown-error"),

res.status(err.status || 500).json({     type: "https://example.com/probs/" + (err.type || "unknown-error"),     title: err.title || "Internal Server Error",

type: "https://example.com/probs/" + (err.type || "unknown-error"),

proberen meer wijzigingen worden doorgevoerd dan de bedoeling was. Om dit te voorkomen is het van belang dat alle API-operaties die data wijzigen volledig [_idempotent_](https://en.wikipedia.org/wiki/Idempotence) zijn.

[_idempotent_](https://en.wikipedia.org/wiki/Idempotence) zijn.

| HTTP Verb | Idempotency mechanisme                                                                       | | --------- | -------------------------------------------------------------------------------------------- | | GET       | Safe req

| --------- | -------------------------------------------------------------------------------------------- | | GET       | Safe request [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110#name-safe-methods)     | | PUT       | Idempote

| GET       | Safe request [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110#name-safe-methods)     |

| PUT       | Idempotent [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110#name-idempotent-methods) |

| DELETE    | Idempotent [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110#name-idempotent-methods) |

komt door het afnemen van het API contract van de provider. De termen worden internationaal ook veelvuldig gebruikt, zoals bijvoorbeeld in [consumer-driven contract testing](https://microsoft.github.io/code-with-engineering-playbook/automat

[consumer-driven contract testing](https://microsoft.github.io/code-with-engineering-playbook/automated-testing/cdc-testing/).

> **Verplichte standaard** Deze standaard is [verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification)

Deze standaard is [verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification) van de overheid. Let op: momenteel wordt alleen OAS versie 3.0.x goedgekeurd.

[verplicht voor REST API's](https://www.forumstandaardisatie.nl/open-standaarden/openapi-specification)

OAS wordt beheerd door het [OpenAPI Initiative](https://www.openapis.org/). De

[OpenAPI Spec 3.0](https://spec.openapis.org/oas/v3.0.3).

De [OAS Generator](https://developer-overheid-nl.github.io/oas-generator)

"name": "Team Developer Overheid NL",     "email": "developer.overheid@geonovum.nl",     "url": "https://developer.overheid.nl"

"email": "developer.overheid@geonovum.nl",     "url": "https://developer.overheid.nl"   },

"url": "https://developer.overheid.nl"

[REST API’s](/blog/2025/07/10/openapi-31-in-zicht#van-rest-naar-http) communiceren, is het waarborgen van de veiligheid van deze interfaces cruciaal. **[WuppieFuzz](https://github.com/TNO-S3/WuppieFuzz)**, ontwikkeld door

communiceren, is het waarborgen van de veiligheid van deze interfaces cruciaal. **[WuppieFuzz](https://github.com/TNO-S3/WuppieFuzz)**, ontwikkeld door [TNO](https://tno.nl), is een open-source, coverage-guided fuzzer die specifiek

**[WuppieFuzz](https://github.com/TNO-S3/WuppieFuzz)**, ontwikkeld door

[TNO](https://tno.nl), is een open-source, coverage-guided fuzzer die specifiek

[![How to use WuppieFuzz? - YouTube](./img/demo_video.png)](https://www.youtube.com/watch?v=-oR4d9aXrqo)

WuppieFuzz is gebouwd bovenop het [LibAFL-framework](https://github.com/AFLplusplus/LibAFL) en ondersteunt drie

[LibAFL-framework](https://github.com/AFLplusplus/LibAFL) en ondersteunt drie

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: data

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/data

informatie die belangrijk is voor haar gebruiker (data over openstaande betalingen van burgers) in een model genaamd [`financial claim`](https://vorijk.nl/docs/financiele-verplichtingen/document_types/financial_claims_information_document/)

[`financial claim`](https://vorijk.nl/docs/financiele-verplichtingen/document_types/financial_claims_information_document/).

- [JSON/YAML converter](https://openreplay.com/tools/json-yaml/): handige tool

@prefix dcat: <http://www.w3.org/ns/dcat#> .

@prefix dct: <http://purl.org/dc/terms/> .

@prefix foaf: <http://xmlns.com/foaf/0.1/> .

<http://example.org/dataset/123>

dct:title "Voorbeeld Dataset" ;     dct:description "Een voorbeeld van een dataset beschreven met DCAT." ;     dct:publisher <http://example.org/organization/456> ;

dct:description "Een voorbeeld van een dataset beschreven met DCAT." ;     dct:publisher <http://example.org/organization/456> ;     dcat:distribution [

dct:publisher <http://example.org/organization/456> ;

a dcat:Distribution ;         dct:format "text/csv" ;         dcat:accessURL <http://example.org/dataset/123/data.csv>

dct:format "text/csv" ;         dcat:accessURL <http://example.org/dataset/123/data.csv>     ] .

dcat:accessURL <http://example.org/dataset/123/data.csv>

1. Dataset:    - De URI `<http://example.org/dataset/123>` vertegenwoordigt een dataset.

- De URI `<http://example.org/dataset/123>` vertegenwoordigt een dataset.

@prefix foaf: <http://xmlns.com/foaf/0.1/> .

@prefix dbpedia: <http://dbpedia.org/resource/> .

<http://example.org/person/JanJansen>

a foaf:Person ;     foaf:name "Jan Jansen" ;     foaf:knows <http://example.org/person/PietPietersen> ;

foaf:name "Jan Jansen" ;     foaf:knows <http://example.org/person/PietPietersen> ;     foaf:homepage <http://janjansen.example.org> ;

foaf:knows <http://example.org/person/PietPietersen> ;

foaf:homepage <http://janjansen.example.org> ;

@prefix owl: <http://www.w3.org/2002/07/owl#> .

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .

@prefix ex: <http://example.org/> .

<div vocab="http://schema.org/" typeof="Person">

| Attribuut    | Omschrijving                                                                                                                                                                                                                   

| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

| **vocab**    | Het attribuut vocab specificeert de vocabulaire (`<http://schema.org/>`) die wordt gebruikt.                                                                                                                                   

@prefix sh: <http://www.w3.org/ns/shacl#> .

@prefix ex: <http://example.org/> .

@prefix skos: <http://www.w3.org/2004/02/skos/core#> .

@prefix ex: <http://example.org/> .

Het gebruik van deze standaarden is door [Forum standaardisatie](https://www.forumstandaardisatie.nl) verplicht gesteld

[Forum standaardisatie](https://www.forumstandaardisatie.nl) verplicht gesteld

Er is een referentie implementatie beschikbaar die de samenwerking van verscheidene prototype overheidsapplicaties laat zien. De code is beschikbaar [bij Digilab op GitLab](https://gitlab.com/digilab.overheid.nl/ecosystem/logboek-dataverwer

De code is beschikbaar [bij Digilab op GitLab](https://gitlab.com/digilab.overheid.nl/ecosystem/logboek-dataverwerkingen/ldv-referentie-implementatie).

Om een indruk te geven hoe een implementatie in Go eruit ziet, zie onderstaand voorbeeld van het ophalen van informatie van een burger ([source code](https://gitlab.com/digilab.overheid.nl/ecosystem/logboek-dataverwerkingen/ldv-referentie-i

Deze functie maakt gebruik van een abstractie om de overige attributen correct te zetten ([source code](https://gitlab.com/digilab.overheid.nl/ecosystem/logboek-dataverwerkingen/ldv-referentie-implementatie/-/blob/3a4b2b8bae9272d02731a716a2

`Logboek.java` met een annotation die op een service method kan worden gezet. Hiermee definieer je de [naam](https://logius-standaarden.github.io/logboek-dataverwerkingen/#name) van de dataverwerking en de [`dpl.core.processing_activity_id`

Hiermee definieer je de [naam](https://logius-standaarden.github.io/logboek-dataverwerkingen/#name) van de dataverwerking en de [`dpl.core.processing_activity_id`](https://logius-standaarden.github.io/logboek-dataverwerkingen/#attributes).

Daar komt de standaard [Logboek Dataverwerkingen (LDV)](https://logius-standaarden.github.io/logboek-dataverwerkingen/) om de hoek kijken.

Deze documenten zijn te vinden via [Github](https://github.com/Logius-standaarden/logboek-dataverwerkingen?tab=readme-ov-file#overzicht).

- staan alle statische data in het Register van de Verwerkingsactiviteiten (RvVA), en bevatten Logregels verwijzingen naar dat Register. Specifiek gaat dit om de resources ['verwerkingsactiviteiten'](https://logius-standaarden.github.io/log

Vanuit de wens om zoveel mogelijk context vast te leggen om zo een compleet beeld te schetsen van wat er is gebeurd rond een [Dataverwerking](https://logius-standaarden.github.io/logboek-dataverwerkingen/#dfn-dataverwerkingen) kan  de neigi

Voor de uitoefening van het Inzagerecht is de consequentie dat de Betrokkene informatie uit alle organisaties moet ophalen en deze volgens een paar relatief eenvoudige businessrules aan elkaar moet relateren voor het verkrijgen van een comp

- Een Dataverwerking wordt door een gebruiker bij een [Verwerker](https://logius-standaarden.github.io/logboek-dataverwerkingen/#dfn-verwerkers) uitgevoerd

- De Dataverwerking valt onder verantwoordelijkheid van de [Verantwoordelijke](https://logius-standaarden.github.io/logboek-dataverwerkingen/#dfn-verantwoordelijke), namelijk de organisatie die de Verwerker heeft ingehuurd

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: front-end

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/front-end

Voeg ook een [`.prettierignore`](https://prettier.io/docs/ignore) toe om

Meer documentatie: [Prettier Docs](https://prettier.io/docs/)

Meer documentatie: [ESLint Docs](https://eslint.org/docs/latest/)

{   "$schema": "https://biomejs.dev/schemas/2.0.5/schema.json",

"$schema": "https://biomejs.dev/schemas/2.0.5/schema.json",

Meer documentatie: [Biome Docs](https://biomejs.dev/docs/).

- Prettier:   [VSCode Extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode),

[VSCode Extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode),

[WebStorm Integration](https://www.jetbrains.com/help/webstorm/prettier.html),

[Sublime Text Integration](https://packagecontrol.io/packages/JsPrettier)

- ESLint:   [ESLint VSCode Extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint),   [WebStorm Integration](https://www.jetbrains.com/help/webstorm/eslint.html),

[ESLint VSCode Extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint),

[WebStorm Integration](https://www.jetbrains.com/help/webstorm/eslint.html),

[Sublime Text Integration](https://packagecontrol.io/packages/ESLint)

- Biome:   [Biome VSCode Extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome),   [WebStorm Integration](https://plugins.jetbrains.com/plugin/22761-biome),

[Biome VSCode Extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome),

[WebStorm Integration](https://plugins.jetbrains.com/plugin/22761-biome),

[Sublime Text Integration](https://github.com/sublimelsp/LSP-biome)

Met [Husky](https://typicode.github.io/husky/) en

[lint-staged](https://github.com/lint-staged/lint-staged) of

[Lefthook](https://github.com/evilmartians/lefthook) kun je pre-commit hooks

De [Prettier] GitHub Action werkt met de [`autofix.ci`-app](https://github.com/apps/autofix-ci). Zie de

[`autofix.ci`-app](https://github.com/apps/autofix-ci). Zie de

[Prettier CI-documentatie](https://prettier.io/docs/ci). Voor [Biome] is een

first party [GitHub Action](https://github.com/marketplace/actions/setup-biome)

[Biome CI-documentatie](https://biomejs.dev/recipes/continuous-integration/).

[Prettier]: https://prettier.io/

[ESLint]: https://eslint.org/

[Stylelint]: https://stylelint.io/

[Biome]: https://biomejs.dev/

[Oxc]: https://oxc.rs/

- [DigiToegankelijk](https://www.digitoegankelijk.nl/)

- [Gebruiker Centraal](https://www.gebruikercentraal.nl/)

- [NL-Design-System](https://nldesignsystem.nl/)

- [Rijkshuisstijl Community](https://rijkshuisstijl.community/)

Het bevat ook een [uitgebreide afweging](https://maps.developers.amsterdam/?path=/docs/alternative-solutions--docs)

[uitgebreide afweging](https://maps.developers.amsterdam/?path=/docs/alternative-solutions--docs)

- [NVM](https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating)

Meer componenten vind je in de [Storybook omgeving](https://rijkshuisstijl-community.vercel.app) van de

[Storybook omgeving](https://rijkshuisstijl-community.vercel.app) van de

- **_Bug gevonden of code bekijken?_** Bezoek de   [GitHub repository](https://github.com/nl-design-system/rijkshuisstijl-community).

[GitHub repository](https://github.com/nl-design-system/rijkshuisstijl-community).

- **_Benieuwd naar onze voortgang?_** Bekijk de huidige werkzaamheden op het   [Sprint Board](https://github.com/orgs/nl-design-system/projects/59). - **_Blijf in contact met de community!_** Word lid van de

[Sprint Board](https://github.com/orgs/nl-design-system/projects/59).

- **_Blijf in contact met de community!_** Word lid van de   [Code for NL Slack](https://praatmee.codefor.nl/) en join het   `#nl-design-system` kanaal om samen te werken met de community.

[Code for NL Slack](https://praatmee.codefor.nl/) en join het

**[Direct naar NL Design System](https://nldesignsystem.nl/)**

- **Richtlijnen** voor hoe je de beste digitale diensten maakt, zoals voor het   [maken van formulieren](https://nldesignsystem.nl/richtlijnen/formulieren/).

[maken van formulieren](https://nldesignsystem.nl/richtlijnen/formulieren/).

en in documentatie voor componenten. - Een methode om je **huisstijl** **toe te passen** op onze componenten   ([design tokens](https://nldesignsystem.nl/handboek/design-tokens)).

- Een methode om je **huisstijl** **toe te passen** op onze componenten   ([design tokens](https://nldesignsystem.nl/handboek/design-tokens)). - Technische **infrastructuur** om werk efficiënt te testen, te delen en **uit

([design tokens](https://nldesignsystem.nl/handboek/design-tokens)).

Het [NL Design System](https://nldesignsystem.nl/) is een **framework** waarmee

Je kunt makkelijk beginnen met het bouwen van een eigen thema op basis van de [example template op Github](https://github.com/nl-design-system/example). Deze

[example template op Github](https://github.com/nl-design-system/example). Deze

**[Example Repo van NL Design System »](https://github.com/nl-design-system/example)**

antwoord is; op zich kan dat. Je moet alleen wel toestemming vragen aan de maker van het thema. Een voorbeeld is het [auteursrecht](https://nl-design-system.github.io/utrecht/storybook/?path=/docs/utrecht-toestemming-voor-gebruik--docs)

van het thema. Een voorbeeld is het [auteursrecht](https://nl-design-system.github.io/utrecht/storybook/?path=/docs/utrecht-toestemming-voor-gebruik--docs) van het Design System van gemeente Utrecht.

[auteursrecht](https://nl-design-system.github.io/utrecht/storybook/?path=/docs/utrecht-toestemming-voor-gebruik--docs)

De [Rijkshuisstijl Community](https://rijkshuisstijl.community/) is een

- [Storybook Rijkshuisstijl](https://rijkshuisstijl-community.vercel.app/?path=/docs/rhc-radio--docs)

- [Storybook gemeente Utrecht](https://nl-design-system.github.io/utrecht/storybook/?path=/docs/css_css-alert-dialog--docs)

- [Storybook gemeente Den Haag](https://nl-design-system.github.io/denhaag/?path=/docs/react-cards-case-card--docs)

- [Introductie NL Design System](https://nldesignsystem.nl/handboek/introductie/)

- [Over NL Design System](https://nldesignsystem.nl/project/over-nl-design-system/)

- [Website NL Design System](https://nldesignsystem.nl)

- Praat mee op [Slack van Code for NL](https://praatmee.codefor.nl) in het

- Bezoek de tweewekelijkse NL Design System Heartbeat meetings - Sluit je aan bij de   [Rijkshuisstijl Community op GitHub](https://github.com/Rijkshuisstijl)

- Sluit je aan bij de   [Rijkshuisstijl Community op GitHub](https://github.com/Rijkshuisstijl) - Sluit aan bij de wekelijkse

[Rijkshuisstijl Community op GitHub](https://github.com/Rijkshuisstijl)

- Sluit aan bij de wekelijkse   [developers meeting van de Rijkshuisstijl Community](https://nldesignsystem.nl/events/developer-open-hour/overzicht/) - Schrijf je in voor de nieuwsbrief via

[developers meeting van de Rijkshuisstijl Community](https://nldesignsystem.nl/events/developer-open-hour/overzicht/)

[Gebruiker Centraal](https://www.gebruikercentraal.nl/)

> **Verplichte standaard** Deze standaard is [verplicht voor alle websites](https://www.digitoegankelijk.nl/wetgeving) van de

Deze standaard is [verplicht voor alle websites](https://www.digitoegankelijk.nl/wetgeving) van de overheid.

[verplicht voor alle websites](https://www.digitoegankelijk.nl/wetgeving) van de

Dit artikel heeft als doel om developers ondersteuning te bieden bij het implementeren van de standaard [DigiToegankelijk](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21)

implementeren van de standaard [DigiToegankelijk](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21) zoals vastgesteld door het Forum Standaardisatie.

[DigiToegankelijk](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21)

Sinds 1 juli 2018 zijn overheidsorganisaties verplicht [zich te houden](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21)

[zich te houden](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21)

aan de [WCAG 2.1](https://www.w3.org/TR/WCAG21/) richtlijnen. Dit om te zorgen

Wat je misschien niet direct zou verwachten, is dat HTML zelf ook een standaard is. Forum Standaardisatie [beveelt de Nederlandse overheid aan](https://www.forumstandaardisatie.nl/open-standaarden/html)

is. Forum Standaardisatie [beveelt de Nederlandse overheid aan](https://www.forumstandaardisatie.nl/open-standaarden/html) om de HTML standaard te gebruiken zoals die door de standaardisatie-organisatie

[beveelt de Nederlandse overheid aan](https://www.forumstandaardisatie.nl/open-standaarden/html)

[WHATWG: The elements of HTML](https://html.spec.whatwg.org/multipage/#toc-semantics)

welke acceptatiecriteria erop van toepassing zijn. Een voorbeeld hiervan is het button component: [Button documentatie NL Design System](https://nldesignsystem.nl/button)

[Button documentatie NL Design System](https://nldesignsystem.nl/button)

makkelijker te begrijpen is hoe je precies aan een criterium kunt voldoen. De uitleg per criterium vind je hier: [WCAG criteria op NL Design System](https://nldesignsystem.nl/wcag/)

[WCAG criteria op NL Design System](https://nldesignsystem.nl/wcag/)

tekstjes zijn compleet. Het goede nieuws is dat jij kunt bijdragen aan het compleet maken van alle criteria, door bijvoorbeeld een [issue](https://github.com/nl-design-system/documentatie/issues) aan te dragen._

[issue](https://github.com/nl-design-system/documentatie/issues) aan te dragen._

Er is een [DigiToegankelijk Pleio community](https://digitoegankelijk.pleio.nl/), waar iedereen van de overheid met elkaar kan sparren over vragen rondom het implementeren van digitale toegankelijkheid, denk aan projectmanagement, interpret

- [DigiToegankelijk.nl](https://www.digitoegankelijk.nl/)

- [DigiToegankelijk Pleio community](https://digitoegankelijk.pleio.nl/) (beschikbaar voor mensen met een emailadres van de overheid)

[Microsoft Accessibility Insights](https://accessibilityinsights.io/) helpt bij automatisch en handmatig testen, met hulpmiddelen die je direct op pagina's kunt toepassen (zoals visuele weergave van waar je focus naartoe gaat) en uitgebreid

Het end-to-end testing framework Playwright kan gebruikt worden om een deel van je toegankelijkheidsproblemen op te sporen. Een link naar de documentatie vind je hier: [Playwright](https://playwright.dev/docs/accessibility-testing)

[Playwright](https://playwright.dev/docs/accessibility-testing)

Wave is een online tool die websites kan scannen op sommige toegankelijkheidsproblemen: [Wave](https://wave.webaim.org/)

[Wave](https://wave.webaim.org/)

- [Wetgeving - DigiToegankelijk](https://www.digitoegankelijk.nl/wetgeving)

- [Overzicht componenten NL Design System](https://nldesignsystem.nl/componenten/)

- [Forum Standaardisatie: DigiToegankelijk](https://www.forumstandaardisatie.nl/open-standaarden/digitoegankelijk-en-301-549-met-wcag-21)

[Axe](https://www.deque.com/axe/) is een veelgebruikte accessibility-checker die

Meer informatie en installatie-instructies: [Axe DevTools](https://www.deque.com/axe/devtools).

[Axe DevTools](https://www.deque.com/axe/devtools).

- Node.js 18+, pnpm en Google Chrome zijn geïnstalleerd. - Het Docusaurus‑project draait lokaal op `http://localhost:3000`. Start

- Het Docusaurus‑project draait lokaal op `http://localhost:3000`. Start

======================================== WCAG issues found on: https://developer.overheid.nl/blog/archive

WCAG issues found on: https://developer.overheid.nl/blog/archive

Het gebruik van deze standaarden is door [Forum standaardisatie](https://www.forumstandaardisatie.nl) verplicht gesteld

[Forum standaardisatie](https://www.forumstandaardisatie.nl) verplicht gesteld

[Naar gemeenteniconen.nl](https://www.gemeenteniconen.nl/iconen)

[Naar de tutorial](https://frameless.github.io/iconset-npm/)

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: infra

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/infra

> **TL;DR** De [FSC-standaard](https://fsc-standaard.nl) beschrijft hoe koppelingen voor

De [FSC-standaard](https://fsc-standaard.nl) beschrijft hoe koppelingen voor

gegevensuitwisseling veilig, transparant en beheersbaar kunnen worden opgezet. De standaard is opgenomen als verplicht onderdeel van het [Digikoppeling REST API profiel](https://gitdocumentatie.logius.nl/publicatie/dk/restapi/).

De standaard is opgenomen als verplicht onderdeel van het [Digikoppeling REST API profiel](https://gitdocumentatie.logius.nl/publicatie/dk/restapi/). Wil je direct met FSC aan de slag dan kan je de referentie implementatie

[Digikoppeling REST API profiel](https://gitdocumentatie.logius.nl/publicatie/dk/restapi/).

[OpenFSC](https://docs.open-fsc.nl/) gebruiken.

Volgens het principe [Data bij de Bron](https://www.digitaleoverheid.nl/data-bij-de-bron) moeten

[Data bij de Bron](https://www.digitaleoverheid.nl/data-bij-de-bron) moeten

- [Naar de tutorial voor Docker Compose](https://docs.open-fsc.nl/try-fsc/docker/introduction)

- [Naar de tutorial voor Helm](https://docs.open-fsc.nl/try-fsc/helm/introduction)

- [Website FSC](https://fsc-standaard.nl/)

- [Technische docs OpenFSC](https://docs.open-fsc.nl)

Zorg dat je [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)

1. Download de    [gewenste versie van de Haven CLI](https://gitlab.com/commonground/haven/haven/-/packages)

[gewenste versie van de Haven CLI](https://gitlab.com/commonground/haven/haven/-/packages) 1. Pak de download uit (`unzip haven-v9.0.0-darwin-amd64.zip`) 1. Verplaats de binary in de uitgepakte map naar het gewenste pad

Het is ook mogelijk om de Kubernetes conformance tests uit te voeren. Installeer eerst [Sonobuoy](https://sonobuoy.io/docs/). Voer daarna de checks uit zoals

eerst [Sonobuoy](https://sonobuoy.io/docs/). Voer daarna de checks uit zoals

Ontwikkelaars zullen voorts het cluster in gebruik gaan nemen, voor hen hebben we ter illustratie ook de [Ontwikkelen op Haven](https://haven.commonground.nl/techniek/voorbereiding)

we ter illustratie ook de [Ontwikkelen op Haven](https://haven.commonground.nl/techniek/voorbereiding) documentatie pagina's.

[Ontwikkelen op Haven](https://haven.commonground.nl/techniek/voorbereiding)

- [Readme Haven CLI](https://gitlab.com/commonground/haven/haven/-/tree/main/haven/cli?ref_type=heads)

[Naar de Haven+ Gitlab](https://gitlab.com/commonground/haven/havenplus)

[Naar de Haven+ implementatie met Flux](https://gitlab.com/commonground/haven/havenplus/gitops-flux)

[Naar de Haven+ implementatie met Argo CD](https://gitlab.com/commonground/haven/havenplus/gitops-argocd)

- [Signalen](https://github.com/signalen)

- [Generiek Zaakafhandelcomponent](https://github.com/generiekzaakafhandelcomponent)

- [Keycloak](https://github.com/keycloak/keycloak)

- [Gemeente Utrecht](https://utrecht.nl)

- [Wigo4it](https://www.wigo4it.nl/nieuws/haven-compliancy-bij-wigo4it/)

- [SURF](https://www.surf.nl/files/2024-10/surf-cloud-sourcing-strategie.pdf)

- [Gitlab Haven](https://gitlab.com/commonground/haven/haven)

- [Website Haven](https://haven.commonground.nl/)

Overheidsorganisaties delen regelmatig gegevens met andere (overheids)organisaties. [Federatieve Service Connectivity (FSC)](https://nlx.io/) is een standaard (in

(overheids)organisaties. [Federatieve Service Connectivity (FSC)](https://nlx.io/) is een standaard (in wording d.d. jun 2024) voor veilige digitale gegevensuitwisseling, ontwikkeld

[Federatieve Service Connectivity (FSC)](https://nlx.io/) is een standaard (in

De FSC policy builder is te vinden op [fsc-policy-builder.apps.digilab.network](https://fsc-policy-builder.apps.digilab.network/).

[fsc-policy-builder.apps.digilab.network](https://fsc-policy-builder.apps.digilab.network/).

worden geëxporteerd als Rego-bestand. De werknemer of partij die FSC heeft opgezet kan vervolgens [Open Policy Agent activeren](https://docs.nlx.io/nlx-in-production/setup-authorization/),

opgezet kan vervolgens [Open Policy Agent activeren](https://docs.nlx.io/nlx-in-production/setup-authorization/), waarna de policy kan worden ingesteld.

[Open Policy Agent activeren](https://docs.nlx.io/nlx-in-production/setup-authorization/),

De FSC policy builder is te vinden op [fsc-policy-builder.apps.digilab.network](https://fsc-policy-builder.apps.digilab.network/).

[fsc-policy-builder.apps.digilab.network](https://fsc-policy-builder.apps.digilab.network/).

dienstverlening door de overheid te verbeteren. Vaak ontwikkelen we daarbij maatwerksoftware. Voorbeelden die je misschien kent zijn het [Landelijk Register Kinderopvang](https://www.landelijkregisterkinderopvang.nl)

maatwerksoftware. Voorbeelden die je misschien kent zijn het [Landelijk Register Kinderopvang](https://www.landelijkregisterkinderopvang.nl) of het [Leeroverzicht](https://www.leeroverzicht.nl).

[Landelijk Register Kinderopvang](https://www.landelijkregisterkinderopvang.nl)

of het [Leeroverzicht](https://www.leeroverzicht.nl).

het softwareontwikkelteam, en andere belanghebbenden, inzicht te geven in de kwaliteit van de software en de ontwikkelprocessen, gebruiken we [Quality-time](https://github.com/ICTU/quality-time).

[Quality-time](https://github.com/ICTU/quality-time).

Quality-time verzamelt informatie uit [andere tools](https://quality-time.readthedocs.io/en/latest/reference.html#sources)

[andere tools](https://quality-time.readthedocs.io/en/latest/reference.html#sources)

meetwaardes met instelbare normen. Op die manier kan Quality-time je waarschuwen als meetwaardes afwijken en welke [metrieken](https://quality-time.readthedocs.io/en/latest/reference.html#metrics)

als meetwaardes afwijken en welke [metrieken](https://quality-time.readthedocs.io/en/latest/reference.html#metrics) dus aandacht nodig hebben. Denk aan gefaalde testen, nieuwe CVE's, violations

[metrieken](https://quality-time.readthedocs.io/en/latest/reference.html#metrics)

Quality-time is open source en beschikbaar via [GitHub](https://github.com/ICTU/quality-time/). De documentatie staat op

[GitHub](https://github.com/ICTU/quality-time/). De documentatie staat op

[Read the Docs](https://quality-time.readthedocs.io/en/latest/). Je draait

- [Naar de github van Quality-time](https://github.com/ICTU/quality-time)

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: leidraad

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/leidraad

- [NEN NPR 5326:2019 - Risicobeheersing bij ontwikkeling en onderhoud van maatwerksoftware](https://www.nen.nl/npr-5326-2019-nl-262885)

- [Adviescollege ICT-toetsing](https://www.adviescollegeicttoetsing.nl/publicaties)

- [Scrum.org](https://www.scrum.org)

- [Scrum Guides](https://scrumguides.org)

- [Persona's in beleid, hoe dan? Zo dan!](https://www.gebruikercentraal.nl/personas-in-beleid-hoe-dan-zo-dan/)

ICTU heeft in haar ["Kwaliteitsaanpak Softwareontwikkeling"](https://ictu.github.io/Kwaliteitsaanpak/) verschillende templates, waaronder een Word-template voor het vastleggen van niet-functionele eisen aan de hand van IEC/ISO 25010:2023.

- [ISO/IEC 25010:2023](https://www.iso.org/standard/78176.html) Systems and software engineering — Systems and software Quality Requirements and Evaluation (SQuaRE) — Product quality model.

- [Common Ground](/communities/common-ground) - [Haven](https://haven.commonground.nl/)

- [Haven](https://haven.commonground.nl/)

Met [linkeddata.overheid.nl](https://linkeddata.overheid.nl) krijg je als

- [DCAT (Data Catalog Vocabulary)](https://www.w3.org/TR/vocab-dcat/)

- [Standaarden.overheid.nl](https://standaarden.overheid.nl/)

- [Linkeddata.overheid.nl](https://linkeddata.overheid.nl)

- [Quality-time](https://quality-time.readthedocs.io/en/latest/)

Om een keuze te beproeven kun je gebruik maken van een lichtgewicht proces zoals beschreven in [deze blog over do-describe-check-act](https://developer.overheid.nl/blog/2025/12/04/do-describe-check-act).

[deze blog over do-describe-check-act](https://developer.overheid.nl/blog/2025/12/04/do-describe-check-act).

- Gebruik van   [cloud(diensten)](https://developer.overheid.nl/kennisbank/leidraad/cloud)

[cloud(diensten)](https://developer.overheid.nl/kennisbank/leidraad/cloud)

- Gebruik van   [open source](https://developer.overheid.nl/kennisbank/leidraad/open-source) - [Richtlijn onboarding](https://developer.overheid.nl/don-site/leidraad/hergebruik/richtlijn-onboarding)

[open source](https://developer.overheid.nl/kennisbank/leidraad/open-source)

- [Richtlijn onboarding](https://developer.overheid.nl/don-site/leidraad/hergebruik/richtlijn-onboarding)

vindbaar en raadpleegbaar zijn. - Je hebt de relevante (links naar) informatie opgenomen in de   [onboarding](https://developer.overheid.nl/don-site/leidraad/hergebruik/richtlijn-onboarding).

- Je hebt de relevante (links naar) informatie opgenomen in de   [onboarding](https://developer.overheid.nl/don-site/leidraad/hergebruik/richtlijn-onboarding). - Je hebt belegd hoe keuzes bekrachtigd worden.

[onboarding](https://developer.overheid.nl/don-site/leidraad/hergebruik/richtlijn-onboarding).

- [Deze blogpost](https://developer.overheid.nl/blog/2025/12/04/do-describe-check-act)

waarbij de tests geen unittests zijn maar gewenst gedrag (behaviour) van de applicatie beschrijven. In [Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft

applicatie beschrijven. In [Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft Daniel Terhorst-North hoe BDD ontstond en waarom hij koos voor de term

[Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft

Om inspiratie op te doen in andere projecten kan je onze [Open Source Catalogus](https://oss.developer.overheid.nl/) gebruiken.

[Open Source Catalogus](https://oss.developer.overheid.nl/) gebruiken.

- [Test automation days](https://www.testautomationdays.com)

- (1) Test Driven Development: By Example, Kent Beck, 2002. - (2) [Introducing BDD](https://dannorth.net/blog/introducing-bdd/), Daniel

- (2) [Introducing BDD](https://dannorth.net/blog/introducing-bdd/), Daniel

- [Deze goede redenen heeft de Kiesraad om Rust te gebruiken (Over Cargo test-framework voor Rust)](https://developer.overheid.nl/blog/2025/03/26/interview-kiesraad-rust#cargo-test-framework)

Gebruik de [repository catalogus](https://oss.developer.overheid.nl/repositories) om

[repository catalogus](https://oss.developer.overheid.nl/repositories) om

Gebruik de [API catalogus](https://apis.developer.overheid.nl/) om bestaande

- [publiccode.yml standaard](https://github.com/publiccodeyml/publiccode.yml)

- [NL Design System hoofdstuk](/kennisbank/front-end/nl-design-system/) - [API Catalogus](https://apis.developer.overheid.nl/)

- [API Catalogus](https://apis.developer.overheid.nl/)

- [Repository Catalogus](https://oss.developer.overheid.nl/repositories)

ICTU heeft in haar ["Kwaliteitsaanpak Softwareontwikkeling"](https://ictu.github.io/Kwaliteitsaanpak/)

["Kwaliteitsaanpak Softwareontwikkeling"](https://ictu.github.io/Kwaliteitsaanpak/)

- De [BIO](https://www.bio-overheid.nl) schrijft voor dat alle nieuwe

- [README.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/readme-md)

- [CODE_OF_CONDUCT.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/code-of-conduct-md)

- [CONTRIBUTING.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/contributing-md)

- [NEN NPR 5325:2017 - Praktijkrichtlijn voor het overdragen van software](https://www.nen.nl/npr-5325-2017-nl-238298).

De [Nederlandse Richtlijn Digitale Systemen (NeRDS)](https://nerds.digitaledienst.overheid.nl)

[Nederlandse Richtlijn Digitale Systemen (NeRDS)](https://nerds.digitaledienst.overheid.nl)

De richtlijnen van NeRDS zijn nog in ontwikkeling. Mis je een onderwerp, standaard, techniek of principe? Laat het ons weten via [Slack](https://codefornl.slack.com/archives/CFV4B3XE2) of

standaard, techniek of principe? Laat het ons weten via [Slack](https://codefornl.slack.com/archives/CFV4B3XE2) of [mail](mailto:developer.overheid@geonovum.nl). Wil je bijdragen aan dit project?

[Slack](https://codefornl.slack.com/archives/CFV4B3XE2) of

[mail](mailto:developer.overheid@geonovum.nl). Wil je bijdragen aan dit project? Bekijk dan de [bijdragerichtlijnen van NeRDS](https://nerds.digitaledienst.overheid.nl/Over-NeRDS/CONTRIBUTING/)

Bekijk dan de [bijdragerichtlijnen van NeRDS](https://nerds.digitaledienst.overheid.nl/Over-NeRDS/CONTRIBUTING/) voor meer informatie. Gebruik voor een nieuwe richtlijn het [richtlijnsjabloon](./richtlijnsjabloon-v1.md).

[bijdragerichtlijnen van NeRDS](https://nerds.digitaledienst.overheid.nl/Over-NeRDS/CONTRIBUTING/)

- Mail: [developer.overheid@geonovum.nl](mailto:developer.overheid@geonovum.nl) - Slack:   [#developer-overheid.nl](https://codefornl.slack.com/archives/CFV4B3XE2)

[#developer-overheid.nl](https://codefornl.slack.com/archives/CFV4B3XE2)

- [PIANOo, Expertisecentrum Aanbesteden](https://www.pianoo.nl/nl)

- [Open Source Werken](/communities/open-source-werken) - [Gereedschapskist voor het aanbesteden van open source standaardsoftware](https://minvws.opensourcewerken.nl/open-source-gereedschapskist-voor-het-aanbesteden-van-standaardsoftware/)

- [Gereedschapskist voor het aanbesteden van open source standaardsoftware](https://minvws.opensourcewerken.nl/open-source-gereedschapskist-voor-het-aanbesteden-van-standaardsoftware/)

- [Programma Open Overheid](https://www.rijksoverheid.nl/onderwerpen/digitale-overheid/open-overheid)

- [GitHub: Building communities](https://docs.github.com/en/communities)

- [Standaard voor Publieke Code](https://standaardvoorpubliekecode.nl/)

- [GitHub's opensource.guide](https://opensource.guide/)

Een voorbeeld van een repository policy is https://github.com/ICTU/github-policy.

Voor het maken en lezen van `publiccode.yml` bestanden zijn tools beschikbaar: - [Publicode.yml editor](https://developer.overheid.nl/kennisbank/open-source/tools/publiccode-yml-editor)

- [Publicode.yml editor](https://developer.overheid.nl/kennisbank/open-source/tools/publiccode-yml-editor)

- [Publicode.yml parser](https://developer.overheid.nl/kennisbank/open-source/tools/publiccode-yml-parser)

- Je policy zorgt dat het eigenaarschap van de repository duidelijk is - Je policy zorgt dat het duidelijk is hoe security incidenten gemeld kunnen worden. - Je policy schrijft voor dat repositories een [`publiccode.yml`](https://github.com

- Je policy zorgt dat het duidelijk is hoe security incidenten gemeld kunnen worden. - Je policy schrijft voor dat repositories een [`publiccode.yml`](https://github.com/publiccodeyml/publiccode.yml) bestand bevatten waarmee repositories 'd

- Je policy schrijft voor dat repositories een [`publiccode.yml`](https://github.com/publiccodeyml/publiccode.yml) bestand bevatten waarmee repositories 'discoverable' worden.

- The publiccode.yml Standard, https://github.com/publiccodeyml/publiccode.yml

- Keep a changelog, https://keepachangelog.com/en/1.1.0/

- Semantic versioning, https://semver.org/spec/v2.0.0.html

- [README.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/readme-md)

- [CODE_OF_CONDUCT.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/code-of-conduct-md)

- [CONTRIBUTING.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/contributing-md)

- [PROJECT_GOVERANCE.md](https://developer.overheid.nl/kennisbank/open-source/standaarden/project-governance-md)

- [Publiccode.yml](https://developer.overheid.nl/kennisbank/open-source/standaarden/publiccode-yml)

- [Een licentie kiezen](https://developer.overheid.nl/kennisbank/open-source/tutorials/open-source-software-licenties)

- [Forum Standaardisatie](https://www.forumstandaardisatie.nl/)

- ["Pas toe of leg uit"-lijst](https://www.forumstandaardisatie.nl/open-standaarden/verplicht)

- [Beslisboom open standaarden](https://www.forumstandaardisatie.nl/beslisboom/beslisboom-open-standaarden)

- [Interoperable Europe Portal](https://joinup.ec.europa.eu/interoperable-europe)

cijfers zichtbaar zijn (`*******27`). 1. Gebruik voor testen de test-bsns die    [Rijksdienst voor Identiteitsgegevens gepubliceerd heeft](https://www.rvig.nl/test-bsn-a-nummers-omnummertabel).

1. Gebruik voor testen de test-bsns die    [Rijksdienst voor Identiteitsgegevens gepubliceerd heeft](https://www.rvig.nl/test-bsn-a-nummers-omnummertabel).    Deze worden gegarandeerd nooit uitgegeven aan personen. Er zijn ook

[Rijksdienst voor Identiteitsgegevens gepubliceerd heeft](https://www.rvig.nl/test-bsn-a-nummers-omnummertabel).

Deze worden gegarandeerd nooit uitgegeven aan personen. Er zijn ook    [testsets van fictieve persoonsgegevens inclusief test-bsn](https://www.rvig.nl/testdataset-persoonslijsten-proefomgevingen-bvbsn)    die je kunt gebruiken voor (keten)t

[testsets van fictieve persoonsgegevens inclusief test-bsn](https://www.rvig.nl/testdataset-persoonslijsten-proefomgevingen-bvbsn)

- Samen met andere rollen zoals architect, privacy officer en security officer   overweeg je gebruik van Privacy Enhancing Technology. Gebruik bijvoorbeeld   [deze verdiepingshandleiding van het CIP](https://www.cip-overheid.nl/media/o3vfhs

[deze verdiepingshandleiding van het CIP](https://www.cip-overheid.nl/media/o3vfhs0c/aan-de-slag-met-privacy-by-design-pbd-en-privacy-enhancing-technologies-pets-versie-10.pdf?csf=1&web=1&e=iOEjfq).

- [Wet algemene bepalingen burgerservicenummer](https://wetten.overheid.nl/BWBR0022428/2018-07-28/0)

- Bsn's voldoen aan een variant van de   [elfproef](https://nl.wikipedia.org/wiki/Elfproef). Dit is met name relevant

[elfproef](https://nl.wikipedia.org/wiki/Elfproef). Dit is met name relevant

- [Algemene Verordening Gegevensbescherming (AVG/GDPR)](https://autoriteitpersoonsgegevens.nl)

- [Centrum Informatiebeveiliging en Privacybescherming (CIP)](https://www.cip-overheid.nl)

- [Het Blauwe Boekje](https://www.cs.ru.nl/~jhh/blauwe-boekje.html)

- [Handleiding "Privacy by Design" van het CIP](https://www.cip-overheid.nl/producten-en-diensten/handleiding-privacy-by-design)

waarbij de tests geen unittests zijn maar gewenst gedrag (behaviour) van de applicatie beschrijven. In [Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft

applicatie beschrijven. In [Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft Daniel Terhorst-North hoe BDD ontstond en waarom hij koos voor de term

[Introducing BDD](https://dannorth.net/blog/introducing-bdd/) (2) beschrijft

Om inspiratie op te doen in andere projecten kan je onze [Open Source Catalogus](https://oss.developer.overheid.nl/) gebruiken.

[Open Source Catalogus](https://oss.developer.overheid.nl/) gebruiken.

- [Test automation days](https://www.testautomationdays.com)

- (1) Test Driven Development: By Example, Kent Beck, 2002. - (2) [Introducing BDD](https://dannorth.net/blog/introducing-bdd/), Daniel

- (2) [Introducing BDD](https://dannorth.net/blog/introducing-bdd/), Daniel

- [Deze goede redenen heeft de Kiesraad om Rust te gebruiken (Over Cargo test-framework voor Rust)](https://developer.overheid.nl/blog/2025/03/26/interview-kiesraad-rust#cargo-test-framework)

- [Nationaal Cyber Security Centrum (NCSC)](https://www.ncsc.nl/)

- [Centrum Informatiebeveiliging en Privacybescherming (CIP)](https://www.cip-overheid.nl/)

- [OWASP Cheat Sheet Series](https://cheatsheetseries.owasp.org/)

- [OpenKAT](/kennisbank/security/tools/openkat) - [Security hoofdstuk](/kennisbank/security) - [Rijksinspectie Digitale Infrastructuur (RDI)](https://rdi.nl)

- [Security hoofdstuk](/kennisbank/security) - [Rijksinspectie Digitale Infrastructuur (RDI)](https://rdi.nl) - [Nationaal innovatie centrum privacy-enhancing technologies (nicpet)](https://nicpet.nl)

- [Rijksinspectie Digitale Infrastructuur (RDI)](https://rdi.nl)

- [Nationaal innovatie centrum privacy-enhancing technologies (nicpet)](https://nicpet.nl)

- [OWASP Application Security Verification Standard (ASVS)](https://github.com/OWASP/ASVS),

versie 5.0, paragraaf 15.2, "Security Architecture and Dependencies". - [OWASP Software Assurance Maturity Model (SAMM)](https://owaspsamm.org),   versie 2, the Secure Build practice.

- [OWASP Software Assurance Maturity Model (SAMM)](https://owaspsamm.org),

- [Centrum Informatiebeveiliging en Privacybescherming (CIP)](https://www.cip-overheid.nl/).

- Lees meer over   [security in de kennisbank](https://developer.overheid.nl/kennisbank/security/).

[security in de kennisbank](https://developer.overheid.nl/kennisbank/security/).

PKIoverheid-stelsel beheert. De certificaten zelf worden geleverd door een aantal door PKIoverheid erkende partijen. Meer informatie kun je vinden bij [Logius](https://www.logius.nl/onze-dienstverlening/toegang/pkioverheid).

[Logius](https://www.logius.nl/onze-dienstverlening/toegang/pkioverheid).

Gebruik van PKIoverheid-certificaten is onderdeel van andere standaarden, zoals [Digikoppeling](https://www.logius.nl/onze-dienstverlening/gegevensuitwisseling/digikoppeling).

[Digikoppeling](https://www.logius.nl/onze-dienstverlening/gegevensuitwisseling/digikoppeling).

implementatie ook de certificaten van de intermediate CA's) moet in de trust    store geïmporteerd worden. Deze certificaten kun je downloaden van de    [site van PKIoverheid](https://cert.pkioverheid.nl/).

[site van PKIoverheid](https://cert.pkioverheid.nl/).

1. In veel toepassingen, zoals Digikoppeling, moet het    [Organisatie Identificatie Nummer (OIN)](https://www.logius.nl/onze-dienstverlening/toegang/organisatie-identificatienummer)

[Organisatie Identificatie Nummer (OIN)](https://www.logius.nl/onze-dienstverlening/toegang/organisatie-identificatienummer)

1. Voor testen is het mogelijk om TRIAL PKIoverheid certificaten te gebruiken.    Zie    [https://github.com/pkioverheid/g4-trial](https://github.com/pkioverheid/g4-trial).

[https://github.com/pkioverheid/g4-trial](https://github.com/pkioverheid/g4-trial).

- Gebruik van PKIoverheid is verplicht binnen   [Digikoppeling](https://www.logius.nl/onze-dienstverlening/gegevensuitwisseling/digikoppeling)

[Digikoppeling](https://www.logius.nl/onze-dienstverlening/gegevensuitwisseling/digikoppeling)

- [X.509 ITU](https://www.itu.int/rec/T-REC-X.509)

- Algemene informatie over X.509-certificaten is makkelijk vindbaar op het   internet, bijvoorbeeld op [Wikipedia](https://en.wikipedia.org/wiki/X.509).

internet, bijvoorbeeld op [Wikipedia](https://en.wikipedia.org/wiki/X.509).

- Het NCSC heeft een gearchiveerde   [publicatie uit 2021](https://www.ncsc.nl/documenten/factsheets/2021/september/29/factsheet-pkioverheid-stopt-met-webcertificaten)   die nog steeds veel bruikbare informatie bevat.

[publicatie uit 2021](https://www.ncsc.nl/documenten/factsheets/2021/september/29/factsheet-pkioverheid-stopt-met-webcertificaten)

Dit is niet alleen een wettelijke verplichting (zoals het [Besluit Digitale Toegankelijkheid Overheid](https://wetten.overheid.nl/BWBR0040936/2018-07-01/)),

[Besluit Digitale Toegankelijkheid Overheid](https://wetten.overheid.nl/BWBR0040936/2018-07-01/)),

- [Besluit Digitale Toegankelijkheid Overheid](https://wetten.overheid.nl/BWBR0040936/2018-07-01/)

- [Web Content Accessibility Guidelines (WCAG) 2.1](https://www.w3.org/TR/WCAG21/)

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: open-source

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/open-source

- [Naar codefor.nl](https://codefor.nl)

[Opensourcewerken](https://opensourcewerken.nl) is de community of practice

- Een   [**uitleg**](https://opensourcewerken.nl/page/view/94ccca61-eac1-4441-b727-47db60661a3e/het-opensource-verhaal)

[**uitleg**](https://opensourcewerken.nl/page/view/94ccca61-eac1-4441-b727-47db60661a3e/het-opensource-verhaal)

van wat open source werken precies inhoudt. - Een   **[forum](https://opensourcewerken.nl/groups/view/75fc54b2-f4bf-4e67-a931-1d5b5b4c038a/open-source-community)**

- Een   **[forum](https://opensourcewerken.nl/groups/view/75fc54b2-f4bf-4e67-a931-1d5b5b4c038a/open-source-community)**   waarop je kennis en ervaringen kan delen om samen de transitie naar open by

**[forum](https://opensourcewerken.nl/groups/view/75fc54b2-f4bf-4e67-a931-1d5b5b4c038a/open-source-community)**

default te versnellen. - Informatie over de   **[wet- en regelgeving](https://opensourcewerken.nl/page/view/b28e707b-2731-49bf-bcc6-ac693f1f250a/overzicht-wet-en-regelgeving)**

- Informatie over de   **[wet- en regelgeving](https://opensourcewerken.nl/page/view/b28e707b-2731-49bf-bcc6-ac693f1f250a/overzicht-wet-en-regelgeving)**   die van toepassing is op open source werken.

**[wet- en regelgeving](https://opensourcewerken.nl/page/view/b28e707b-2731-49bf-bcc6-ac693f1f250a/overzicht-wet-en-regelgeving)**

- [Naar de website van TODO Group](https://todogroup.org/)

- [OSPO NL Community](https://ospo-nl.github.io/kennisbank/)

- [Slack Code for NL / #open-werken-best-practices](https://codefornl.slack.com/archives/C01L2643G3W)

- [**Opensourcewerken.nl** / Community: Stel je vraag](https://opensourcewerken.nl/groups/view/75fc54b2-f4bf-4e67-a931-1d5b5b4c038a/open-source-community)

- [GitHub: Building communities](https://docs.github.com/en/communities)

- [Standaard voor Publieke Code](https://standaardvoorpubliekecode.nl/)

- [GitHub's opensource.guide](https://opensource.guide/)

Deze Code of Conduct is overgenomen van de kennisbank van [OSPO-NL](https://ospo-nl.github.io/kennisbank/community/CODE_OF_CONDUCT/).

[OSPO-NL](https://ospo-nl.github.io/kennisbank/community/CODE_OF_CONDUCT/).

We gebruiken [Conventional Commits](https://www.conventionalcommits.org/) voor

- Volg [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) niveau AA

- Meld beveiligingsproblemen **NIET** via publieke issues - Gebruik het proces beschreven in SECURITY.md - Volg [OWASP Top 10](https://owasp.org/www-project-top-ten/) best practices

- Gebruik het proces beschreven in SECURITY.md - Volg [OWASP Top 10](https://owasp.org/www-project-top-ten/) best practices - Voor overheidsprojecten: houd rekening met

- Volg [OWASP Top 10](https://owasp.org/www-project-top-ten/) best practices

- Voor overheidsprojecten: houd rekening met   [BIO](https://www.digitaleoverheid.nl/overzicht-van-alle-onderwerpen/cybersecurity/kaders-voor-cybersecurity/baseline-informatiebeveiliging-overheid/)   normen

[BIO](https://www.digitaleoverheid.nl/overzicht-van-alle-onderwerpen/cybersecurity/kaders-voor-cybersecurity/baseline-informatiebeveiliging-overheid/)

- Code style: verwijzing naar linters, formattering, en naming conventions. - Commit messages: bijvoorbeeld conventies zoals   [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).

- Commit messages: bijvoorbeeld conventies zoals   [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). - Pull requests: hoe je een PR indient.

[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). - Pull requests: hoe je een PR indient. - Reviewproces: hoe de feedbackloop werkt en wie reviews uitvoert.

- Zie de   [contributing guidelines](https://docs.openkat.nl/developer-documentation/contributor/index.html)

[contributing guidelines](https://docs.openkat.nl/developer-documentation/contributor/index.html)

- [Standaard voor Publieke Code / Criterium 4: verwelkom bijdragers](https://codefor.nl/community-translations-standard/nl/criteria/welcome-contributors.html)

Voorbeeld van [OSPO-NL](https://github.com/ospo-nl):

# This repository adheres to the publiccode.yml standard by including this # metadata file that makes public software easily discoverable. # More info at https://github.com/publiccodeyml/publiccode.yml

# More info at https://github.com/publiccodeyml/publiccode.yml

name: Developer Overheid NL Website # De url naar de source code. url: "https://github.com/developer-overheid-nl/don-site"

url: "https://github.com/developer-overheid-nl/don-site"

# De url naar de productieomgeving van de software. landingURL: "https://developer.overheid.nl" # optioneel

landingURL: "https://developer.overheid.nl" # optioneel

# Type software zoals te vinden op: https://yml.publiccode.tools/schema.core.html#key-softwaretype

# Vul hier een aantal tags in die beschrijven wat jouw sofware doet. De tags # zijn te vinden op: https://yml.publiccode.tools/categories-list.html#categories-list

# zijn te vinden op: https://yml.publiccode.tools/categories-list.html#categories-list

# De beschrijving van de verschillende statussen zijn te vinden op: https://yml.publiccode.tools/schema.core.html#key-developmentstatus

legal:   # De licentie volgens de identifier van de SPDX standaard: https://spdx.org/licenses/

# De licentie volgens de identifier van de SPDX standaard: https://spdx.org/licenses/

- NL   # En in welke sector?   # De mogelijke tags vind je hier: https://yml.publiccode.tools/scope-list.html#scope-list

# En in welke sector?   # De mogelijke tags vind je hier: https://yml.publiccode.tools/scope-list.html#scope-list   scope:

# De mogelijke tags vind je hier: https://yml.publiccode.tools/scope-list.html#scope-list

localisation:   # In welke talen is dit project beschikbaar?   # Invullen volgens IETF BCP 47 standaard: https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry

# In welke talen is dit project beschikbaar?   # Invullen volgens IETF BCP 47 standaard: https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry   availableLanguages:

# Invullen volgens IETF BCP 47 standaard: https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry

- [Voorbeelden uit de documentatie van de standaard](https://yml.publiccode.tools/example.html)

- [Publiccode.yml van Open Zaak](https://github.com/open-zaak/open-zaak/blob/main/publiccode.yaml)

achter de standaard waardeert het enorm als wij als developers bijdragen door middel van feedback en suggesties. Je kunt input aanleveren door een [issue aan te maken](https://github.com/publiccodeyml/publiccode.yml/issues) op

middel van feedback en suggesties. Je kunt input aanleveren door een [issue aan te maken](https://github.com/publiccodeyml/publiccode.yml/issues) op de GitHub-pagina van de standaard.

[issue aan te maken](https://github.com/publiccodeyml/publiccode.yml/issues) op

- [Publiccode.yml editor](https://publiccode-editor.developers.italia.it/?lang=nl)

- [De documentatie van de standaard](https://yml.publiccode.tools/index.html)

- [De documentatie van het `publiccode.yml` schema](https://yml.publiccode.tools/schema.core.html)

Een handige bron bij het maken van een readme is [makeareadme.com](https://www.makeareadme.com/).

[makeareadme.com](https://www.makeareadme.com/).

Als je wilt meewerken aan de Standaard voor Publieke Code kan je deelnemen aan [**#standard-for-public-code**](https://codefornl.slack.com/archives/CPJC62GUQ)

[**#standard-for-public-code**](https://codefornl.slack.com/archives/CPJC62GUQ)

[Direct naar de Nederlandse vertaling](https://codefor.nl/community-translations-standard/nl/)<br/>

[Direct naar de originele Engelse versie](https://codefor.nl/community-translations-standard/nl/)

- [Naar de publiccode.yml editor](https://publiccode-editor.developers.italia.it/?lang=nl)

- [Github publiccode.yml Parser](https://github.com/italia/publiccode-parser-go)

- [Contents EUPL 1.2 NL](https://interoperable-europe.ec.europa.eu/sites/default/files/inline-files/EUPL%20v1_2%20NL.txt)

- [Contents EUPL 1.2 EN](https://interoperable-europe.ec.europa.eu/sites/default/files/custom-page/attachment/2020-03/EUPL-1.2%20EN.txt)

- Is specifiek ontworpen voor de publieke sector in de EU. - Heeft copyleft-eigenschappen (afgeleid werk moet onder compatibele licentie). - Is beschikbaar in [alle EU-talen](https://eupl.eu/) met juridische geldigheid.

- Heeft copyleft-eigenschappen (afgeleid werk moet onder compatibele licentie). - Is beschikbaar in [alle EU-talen](https://eupl.eu/) met juridische geldigheid. - Heeft expliciet compatibiliteit met andere belangrijke open source licenties.

- Is beschikbaar in [alle EU-talen](https://eupl.eu/) met juridische geldigheid.

- [Goedgekeurde licenties Open Source Initiative](https://opensource.org/licenses)

- [Licentiewijzer MinBZK](https://licentiewijzer.org/)

- [**Europese Commissie:** What is the EUPL?](https://commission.europa.eu/about/departments-and-executive-agencies/digital-services/open-source-strategy-history/european-union-public-licence_en)

- [**Standaard voor Publieke Code:** Publiceer met een open licentie](https://codefor.nl/community-translations-standard/nl/criteria/publish-with-an-open-license.html)

- [**Opensourcewerken.nl:** Vanaf nu wettelijke verplichting Europees gestandaardiseerde opensource-licentie](https://opensourcewerken.nl/blog/view/e07add3e-075e-47cd-ab08-63608b914514/vanaf-nu-wettelijke-verplichting-europees-gestandaardis

Deze checklist afgeleid van de [Starting an Open Source Project](https://www.linuxfoundation.org/resources/open-source-guides/starting-an-open-source-project)

[Starting an Open Source Project](https://www.linuxfoundation.org/resources/open-source-guides/starting-an-open-source-project)

lijst van de Linux Foundation. De [GitHub Default Community Health Files](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file) is ook een goede bron van inspirati

[GitHub Default Community Health Files](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)

1. Verwijder kritische afhankelijkheden met niet-publieke componenten. 2. Zorg voor een goede README.md met use-case voorbeelden. Zie    [Make a Readme.com](https://www.makeareadme.com/)

2. Zorg voor een goede README.md met use-case voorbeelden. Zie    [Make a Readme.com](https://www.makeareadme.com/) 3. Zorg voor een goede `CONTRIBUTING.md`.

[Make a Readme.com](https://www.makeareadme.com/)

gecommuniceerd worden. 4. Volg best practices zoveel mogelijk & behaal    [OpenSSF ( formerly CII ) Best Practices badge](https://bestpractices.coreinfrastructure.org/en)

[OpenSSF ( formerly CII ) Best Practices badge](https://bestpractices.coreinfrastructure.org/en)

Ga naar de [generator](https://developer-overheid-nl.github.io/repo-docs-generator/#/publiccode.yml)

[generator](https://developer-overheid-nl.github.io/repo-docs-generator/#/publiccode.yml)

Wil je je `publiccode.yml` nog checken op errors? Gebruik dan de [publiccode-checker](https://developer-overheid-nl.github.io/publiccode-checker/#/pc).

[publiccode-checker](https://developer-overheid-nl.github.io/publiccode-checker/#/pc).

- [GitHub van de repo-docs-generator](https://github.com/developer-overheid-nl/repo-docs-generator).

> ****publiccode.yml editor beschikbaar**** Werk jij liever in een web-editor? Dan kan je gebruik maken van de [Publiccode.yml Editor](https://publiccode-editor.developers.italia.it/?lang=nl)

[Publiccode.yml Editor](https://publiccode-editor.developers.italia.it/?lang=nl)

`publiccode.yml`-bestand kan toevoegen aan je project. Als je hier VSCode hiervoor gebruikt maak je automatisch gebruik van de [JSON Schema van publiccode.yml ](https://json.schemastore.org/publiccode.json)

hiervoor gebruikt maak je automatisch gebruik van de [JSON Schema van publiccode.yml ](https://json.schemastore.org/publiccode.json) waardoor je inline tips krijgt over welke properties je nog mist, of eventuele

[JSON Schema van publiccode.yml ](https://json.schemastore.org/publiccode.json)

Pas alle waarden aan met informatie over jouw project. Ben je opzoek naar informatie over de properties van de standard? Ga dan naar de [documentatie van de standaard](https://yml.publiccode.tools/schema.core.html).

[documentatie van de standaard](https://yml.publiccode.tools/schema.core.html).

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: programmeertalen

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/programmeertalen

[kiesraad-interview]:   https://developer.overheid.nl/blog/2025/03/26/interview-kiesraad-rust#een-jonger-ecosysteem-betekent-minder-uitgebreide-libraries-voor-legacy-standaarden-bijvoorbeeld-xml

https://developer.overheid.nl/blog/2025/03/26/interview-kiesraad-rust#een-jonger-ecosysteem-betekent-minder-uitgebreide-libraries-voor-legacy-standaarden-bijvoorbeeld-xml

[Cargo]: https://doc.rust-lang.org/cargo/

[Clippy]: https://doc.rust-lang.org/clippy/

[Cargo test]: https://doc.rust-lang.org/rustc/tests/index.html

[getting-started]: https://rust-lang.org/learn/get-started/

metadata:   source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site

source: developer.overheid.nl   synced-from: https://github.com/developer-overheid-nl/don-site   topic: security

synced-from: https://github.com/developer-overheid-nl/don-site

Source: https://github.com/developer-overheid-nl/don-site/tree/main/docs/security

- [Naar de website van het NCSC](https://www.ncsc.nl/)

- [Naar de website van de Rijksinspectie Digitale Infrastructuur (RDI)](https://rdi.nl)

- [Nationaal innovatie centrum privacy-enhancing technologies (nicpet)](https://nicpet.nl)

> **Verplichte standaard** Op dit moment is [BIO 1.0](https://bio-overheid.nl/media/13kduqsi/bio-versie-104zv_def.pdf) van

Op dit moment is [BIO 1.0](https://bio-overheid.nl/media/13kduqsi/bio-versie-104zv_def.pdf) van kracht. BIO 2.0 is

[BIO 1.0](https://bio-overheid.nl/media/13kduqsi/bio-versie-104zv_def.pdf) van

[in ontwikkeling](https://minbzk.github.io/Baseline-Informatiebeveiliging-Overheid/).

- [Website van BIO: bio-overheid.nl](https://www.bio-overheid.nl/)

- [DigitaleOverheid.nl over BIO](https://www.digitaleoverheid.nl/overzicht-van-alle-onderwerpen/cybersecurity/bio-en-ensia/baseline-informatiebeveiliging-overheid/)

- [Naar ontwikkelomgeving van BIO2](https://minbzk.github.io/Baseline-Informatiebeveiliging-Overheid/)

- [CIP over BIO](https://www.cip-overheid.nl/producten-en-diensten?type=BIO%20en%20Thema-uitwerkingen)

Meer info: [Logius.nl/digid-machtigen](https://www.logius.nl/domeinen/toegang/digid-machtigen)

[Logius.nl/digid-machtigen](https://www.logius.nl/domeinen/toegang/digid-machtigen)

Meer info over BSNk en PP: [Logius.nl/bsnk-pp](https://www.logius.nl/domeinen/toegang/bsnk-pp)

[Logius.nl/bsnk-pp](https://www.logius.nl/domeinen/toegang/bsnk-pp)

- Over DigiD algemeen:   [Logius - DigiD](https://www.logius.nl/domeinen/toegang/digid)

[Logius - DigiD](https://www.logius.nl/domeinen/toegang/digid)

- DigiD Machtigen:   [Logius.nl/digid-machtigen](https://www.logius.nl/domeinen/toegang/digid-machtigen) - BSNk & pseudoniemenvoorziening:

[Logius.nl/digid-machtigen](https://www.logius.nl/domeinen/toegang/digid-machtigen)

[Logius.nl/bsnk-pp](https://www.logius.nl/domeinen/toegang/bsnk-pp)

Organisaties krijgen alleen attributen aangeleverd die binnen het afsprakenstelsel zijn afgesproken en die in de [attributencatalogus](https://afsprakenstelsel.etoegang.nl/Startpagina/as/attribuutverstrekking).

afsprakenstelsel zijn afgesproken en die in de [attributencatalogus](https://afsprakenstelsel.etoegang.nl/Startpagina/as/attribuutverstrekking). Denk aan KvK-nummer en bedrijfsnaam.

[attributencatalogus](https://afsprakenstelsel.etoegang.nl/Startpagina/as/attribuutverstrekking).

- Algemene info en registratie: [eHerkenning.nl](https://www.eherkenning.nl/) of

stuur een bericht naar info@eherkenning.nl - Specificaties:   [Afsprakenstelsel eHerkenning](https://afsprakenstelsel.etoegang.nl/?l=nl)

[Afsprakenstelsel eHerkenning](https://afsprakenstelsel.etoegang.nl/?l=nl)

- [Technische Specificatie](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex%3A32015R0806)

- [eIDAS Building blocs](https://ec.europa.eu/digital-building-blocks/sites/display/DIGITAL/Documentation+eID)

- [Irish eIDAS node provides OAuth 2.0 API that can be used for authentication](https://demo.eidasnode.gov.ie/doc/usage.html)

- EU-info:   [eIDAS Regulation – Europese Commissie](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation) - Nederlandse uitleg (Logius):

[eIDAS Regulation – Europese Commissie](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation)

[Logius.nl - Vertrouwensdiensten](https://www.logius.nl/domeinen/toegang/vertrouwensdiensten)

voldoet aan de eisen van inclusiviteit, toegankelijkheid en veiligheid. De broncode van deze applicatie is als [open source project](https://oss.developer.overheid.nl/repositories/minbzk-nl-wallet-9632)

broncode van deze applicatie is als [open source project](https://oss.developer.overheid.nl/repositories/minbzk-nl-wallet-9632) gepubliceerd. Naast de publieke wallet kunnen in de toekomst ook private

[open source project](https://oss.developer.overheid.nl/repositories/minbzk-nl-wallet-9632)

Meer info: [EUDI Architecture and Reference Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/)

[EUDI Architecture and Reference Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/)

| API / standaard                 | Toepassing                                                                             | Officiële standaard / documentatie                                                                                 

| ------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------

| **Verifiable Credentials (VC)** | Standaard voor digitale bewijsstukken (credentials).                                   | [W3C Verifiable Credentials](https://www.w3.org/TR/vc-overview/)                                                   

| **OpenID4VCI**                  | Standaard voor het uitgeven van VC's. Zo haalt de wallet app een VC op bij een issuer. | [OpenID4VCI](https://openid.net/specs/openid-4-verifiable-credential-issuance-1_0.html)                            

| **OpenID4VP**                   | Standaard voor het presenteren van verifiable credentials aan een relying party.       | [OpenID4VP](https://openid.net/specs/openid-4-verifiable-presentations-1_0.html)                                   

| **SD-JWT VC**                   | Bestandsformaat voor het uitwisselen van VC's.                                         | [IETF SD-JWT VC Draft](https://datatracker.ietf.org/doc/draft-ietf-oauth-sd-jwt-vc/)                               

| **WebAuthn / Passkeys**         | Ondersteuning voor pseudoniemen en sterke authenticatie.                               | [W3C WebAuthn](https://www.w3.org/TR/webauthn-2/)                                                                  

| **Proximity flows (NFC, QR)**   | Voor fysiek nabije presentaties van data.                                              | [ISO/IEC 18013-5 NFC & QR Specificaties](https://www.iso.org/standard/69084.html)                                  

| **Remote presentation flows**   | Voor uitwisseling op afstand tussen wallet en dienstverlener.                          | [EUDI Architecture & Reference Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-re

Zie hoofdstukken 4 en 5 van het [EUDI-Architecture Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/#4-high-level-architecture)

[EUDI-Architecture Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/#4-high-level-architecture)

![het EUDI wallet ecosysteem](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/media/Figure_2_High-Level_Architecture.jpg)

- [edi.pleio.nl](https://edi.pleio.nl) – informatie over de Nederlandse

EDI-wallet. - [blsp.pleio.nl](https://blsp.pleio.nl) – Large Scale Pilots in Europa. - [OSS repository NL-wallet](https://oss.developer.overheid.nl/repositories/minbzk-nl-wallet-9632)

- [blsp.pleio.nl](https://blsp.pleio.nl) – Large Scale Pilots in Europa.

- [OSS repository NL-wallet](https://oss.developer.overheid.nl/repositories/minbzk-nl-wallet-9632)

– open source ontwikkeling van de Nederlandse wallet. - [EUDI Architecture and Reference Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/

- [EUDI Architecture and Reference Framework](https://eu-digital-identity-wallet.github.io/eudi-doc-architecture-and-reference-framework/latest/architecture-and-reference-framework-main/) -

- [Rijksinspectie Digitale Infrastructuur over de Wbni](https://www.rdi.nl/onderwerpen/wet-beveiliging-netwerk--en-informatiesystemen)

> **Nog niet van kracht** Op dit moment is NIS2 [nog niet van kracht](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie).

Op dit moment is NIS2 [nog niet van kracht](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie). De verwachting is dat deze in het

[nog niet van kracht](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie).

De verwachting is dat deze in het [3e kwartaal van 2025](https://www.rijksoverheid.nl/actueel/nieuws/2024/10/23/implementatie-nis2-en-cer-in-nederland-vertraagd-wat-betekent-dat-voor-u#:~:text=In%20Nederland%20is%20het%20niet,van%202025%20i

[3e kwartaal van 2025](https://www.rijksoverheid.nl/actueel/nieuws/2024/10/23/implementatie-nis2-en-cer-in-nederland-vertraagd-wat-betekent-dat-voor-u#:~:text=In%20Nederland%20is%20het%20niet,van%202025%20in%20werking%20treden.)

in werking zal treden. Op de website van het NCSC kan je ondertussen wel al vinden [wat je alvast kunt doen](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie/hoe-kan-uw-organiseren-zich-

vinden [wat je alvast kunt doen](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie/hoe-kan-uw-organiseren-zich-voorbereiden-op-de-nis2-richtlijn) om voor te sorteren op de komst van NIS2.

[wat je alvast kunt doen](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie/hoe-kan-uw-organiseren-zich-voorbereiden-op-de-nis2-richtlijn)

- [Digitaloverheid.nl over de NIS2-richtlijn](https://www.digitaleoverheid.nl/overzicht-van-alle-onderwerpen/nis2-richtlijn/)

- [Ncsc.nl over NIS2-richtlijn](https://www.ncsc.nl/over-ncsc/wettelijke-taak/wat-gaat-de-nis2-richtlijn-betekenen-voor-uw-organisatie)

- [Implementatie NIS2 en CER in Nederland vertraagd, wat betekent dat voor u? op rijksoverheid.nl](https://www.rijksoverheid.nl/actueel/nieuws/2024/10/23/implementatie-nis2-en-cer-in-nederland-vertraagd-wat-betekent-dat-voor-u#:~:text=In%20

> Zie ook de uitgebreide use case beschrijvingen van de > [client credentials flow](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#use-case-client-credentials-flow)

> [client credentials flow](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#use-case-client-credentials-flow)

> [authorization code flow](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#use-case-authorization-code-flow)

- **Resource Owner**: de gebruiker - **Client**: de app die toegang vraagt >   [link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#client)

- **Client**: de app die toegang vraagt >   [link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#client) - **Authorization Server**: geeft tokens uit >

[link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#client)

- **Authorization Server**: geeft tokens uit >   [link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#authorization-server) - **Resource Server**: API die toegang beschermt >

[link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#authorization-server)

[link](https://gitdocumentatie.logius.nl/publicatie/api/oauth/#resource-server)

- Gebaseerd op de OAuth 2.0 standaard (RFC 6749) - Sluit aan bij   [Security Best Current Practices (BCP)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-security-topics)

- Sluit aan bij   [Security Best Current Practices (BCP)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-security-topics) - Strikt gebruik van PKCE en geen client secrets op publieke clients

[Security Best Current Practices (BCP)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-security-topics) - Strikt gebruik van PKCE en geen client secrets op publieke clients - Gebruik van signed requests en mutual TLS waar nodig

- [NL GOV OAuth 2.0 profiel (GitHub)](https://github.com/Logius-standaarden/OAuth-NL-profiel)

- [RFC 6749 - OAuth 2.0 Authorization Framework](https://datatracker.ietf.org/doc/html/rfc6749)

- [RFC 6750 - Bearer Token Usage](https://datatracker.ietf.org/doc/html/rfc6750)

- [OAuth 2.1 (in ontwikkeling)](https://oauth.net/2.1/)

- [OAuth Security Best Practices (BCP)](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-security-topics)

- [OAuth 2.0 overzicht - oauth.net](https://oauth.net/2/)

- [NL GOV OAuth profiel](https://gitdocumentatie.logius.nl/publicatie/api/oauth/)

- [OpenID Connect profiel](https://gitdocumentatie.logius.nl/publicatie/api/oidc/)

- [eIDAS en OAuth in de toekomst](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation)

🔗 [NL GOV OIDC profiel (GitHub)](https://github.com/Logius-standaarden/OIDC-NLGOV/)

[NL GOV OIDC profiel (GitHub)](https://github.com/Logius-standaarden/OIDC-NLGOV/)

- [OpenID Connect Core 1.0](https://openid.net/specs/openid-connect-core-1_0.html)

- [OpenID Connect Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html)

- [OpenID Connect Dynamic Client Registration](https://openid.net/specs/openid-connect-registration-1_0.html)

- [OAuth 2.0 (RFC 6749)](https://datatracker.ietf.org/doc/html/rfc6749)

- [NL GOV OIDC profiel](https://gitdocumentatie.logius.nl/publicatie/api/oidc/)

- [OpenID Connect officiële site](https://openid.net/connect/)

- [OIDC + OAuth uitleg (oauth.net)](https://oauth.net/2/)

- Uitleg van de dienst:   [Logius - PKIoverheid](https://www.logius.nl/onze-dienstverlening/toegang/pkioverheid)

[Logius - PKIoverheid](https://www.logius.nl/onze-dienstverlening/toegang/pkioverheid)

- Wat is PKIoverheid precies:   [Wat is PKIoverheid?](https://www.logius.nl/domeinen/toegang/pkioverheid/wat-pkioverheid) - Certificaten downloaden of controleren:

[Wat is PKIoverheid?](https://www.logius.nl/domeinen/toegang/pkioverheid/wat-pkioverheid)

[cert.pkioverheid.nl](https://cert.pkioverheid.nl/)

SAML is XML-gebaseerd en wordt veel gebruikt in enterprise-omgevingen én bij overheidsdiensten. De huidige standaard is **SAML 2.0**, ontwikkeld door [OASIS](https://docs.oasis-open.org/security/saml/v2.0/).

[OASIS](https://docs.oasis-open.org/security/saml/v2.0/).

Bron: [Logius.nl/digid](https://www.logius.nl/domeinen/toegang/digid)

Bron: [eHerkenning.nl](https://www.eherkenning.nl/)

Bron: [eIDAS Technical Specs - Europa.eu](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation)

[eIDAS Technical Specs - Europa.eu](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation)

- [SAML 2.0 Specificatie bij OASIS](https://docs.oasis-open.org/security/saml/v2.0/)

- [DigiD en SAML - Logius.nl](https://www.logius.nl/domeinen/toegang/digid)

- [eHerkenning en SAML - eherkenning.nl](https://www.eherkenning.nl/)

- [eIDAS en federatieve authenticatie](https://digital-strategy.ec.europa.eu/en/policies/eidas-regulation)

`https://voorbeeld.nl/.well-known/security.txt`

Voor het genereren van een security.txt heeft [securitytxt.org](https://securitytxt.org/) een aan te bevelen tool.

[securitytxt.org](https://securitytxt.org/) een aan te bevelen tool.

doorverwijzen middels een 302 redirect. Een organisatie zoals het CBS (Centraal Bureau voor de Statistiek) doet dit. Je vindt het security.txt bestand van het CBS [hier](https://www.cbs.nl/.well-known/security.txt).

CBS [hier](https://www.cbs.nl/.well-known/security.txt).

Meer informatie over hoe je als organisatie om moet gaan met de security.txt standaard vind je hier: [www.digitaltrustcenter.nl](https://www.digitaltrustcenter.nl/securitytxt)

[www.digitaltrustcenter.nl](https://www.digitaltrustcenter.nl/securitytxt)

**[Naar de website van OpenKat](https://openkat.nl/)**

Bash(curl -s *)

- AskUserQuestion   - Read   - Bash(curl -s *)

- Read   - Bash(curl -s *)   - Bash(npx github:developer-overheid-nl/oas-generator *)

- Bash(curl -s *)

**Agent-instructie:** Deze skill bevat de praktische DON-tools voor API-ontwikkeling op [developer.overheid.nl](https://developer.overheid.nl). Bij het ontwerpen of bouwen van een REST API: volg de [API design-first werkwijze](#api-design-f

Volg de [Bouw een API-tutorial](../don-apis/references/aan-de-slag/bouw-een-api.md) (lokaal beschikbaar via de gesynchroniseerde `don-apis` kennisbank — de bron is [developer.overheid.nl](https://developer.overheid.nl/kennisbank/api-ontwikk

3. **Schema** — zoek eerst in het schema-register (zie [Schema's kiezen uit het register](#schemas-kiezen-uit-het-register)) en **leg de treffers ALTIJD ter keuze voor aan de gebruiker via `AskUserQuestion`**. Kies nooit zelf zonder bevesti

5. **Genereer de OAS** (CLI; de [web-tool](https://developer-overheid-nl.github.io/oas-generator) is het handmatige alternatief):

7. **Server-URL invullen** — de boilerplate bevat een `@TODO`-server-URL, dus stap 6 faalt sowieso op `include-major-version-in-uri`. Vraag de gebruiker om de server-URL **mét major versie** (bijv. `https://api.example.com/v1`) en zet die i

8. **Extra functionaliteit** — vraag per operatie naar extra functionaliteit zoals filtering en zoeken. Query- en padparameters zijn **altijd lowerCamelCase**, óók in de OAS (bijv. `?sorteerOp=naam`, niet `?sorteer_op`). 9. **Voeg de functi

9. **Voeg de functionaliteit toe** aan de OAS (parameters, query's, schema's). Hergebruik standaard headers/foutresponses via externe `$ref`s naar `https://static.developer.overheid.nl/adr/components.yaml` — zie de [`ls-api` Standaardcompon

11. **Oplevering & vervolg** — toon de definitieve OAS en stel een vervolgstap voor: opslaan en bekijken in [editor.swagger.io](https://editor.swagger.io), of doorgaan met servercode-generatie (zie [Code genereren](#code-genereren)).

curl -s 'https://schemas.don.projects.digilab.network/self/v1/api/schemas/search?q=adres'

2. **Leg de treffers ALTIJD ter keuze voor** met `AskUserQuestion` — kies nooit zelf zonder de gebruiker hierin te laten beslissen. Maak per treffer een optie met de `title` als label en de `description` als toelichting, plus altijd een opt

3. **Verwerk de keuze:**    - **Bestaand schema** → gebruik de resolvebare URL `https://schemas.don.projects.digilab.network{path}` als waarde van het `schema`-veld (externe verwijzing, JSON Schema draft 2020-12). Bladeren kan ook in de [re

- **Bestaand schema** → gebruik de resolvebare URL `https://schemas.don.projects.digilab.network{path}` als waarde van het `schema`-veld (externe verwijzing, JSON Schema draft 2020-12). Bladeren kan ook in de [register-UI](https://schemas.d

"title": "Bier API",   "description": "API voor het beheren van bieren en adressen van brouwerijen.",   "contact": { "name": "API Team", "email": "api@example.com", "url": "https://github.com/example/api/issues" },

"description": "API voor het beheren van bieren en adressen van brouwerijen.",   "contact": { "name": "API Team", "email": "api@example.com", "url": "https://github.com/example/api/issues" },   "resources": [

"contact": { "name": "API Team", "email": "api@example.com", "url": "https://github.com/example/api/issues" },

"plural": "adressen",       "readonly": true,       "schema": "https://schemas.don.projects.digilab.network/api-register/dienst-voor-het-kadaster-en-de-openbare-registers/imbag-api-van-de-lvbag-7fnzbuehg/adresuitgebreid"

"readonly": true,       "schema": "https://schemas.don.projects.digilab.network/api-register/dienst-voor-het-kadaster-en-de-openbare-registers/imbag-api-van-de-lvbag-7fnzbuehg/adresuitgebreid"     },

"schema": "https://schemas.don.projects.digilab.network/api-register/dienst-voor-het-kadaster-en-de-openbare-registers/imbag-api-van-de-lvbag-7fnzbuehg/adresuitgebreid"

Valideer elke OpenAPI-spec tegen de ADR met de **DON Checker**. De online [OAS Checker](https://developer-overheid-nl.github.io/oas-checker) gebruikt dezelfde ruleset; onder de motorkap draait de Spectral ADR-ruleset.

npx @developer-overheid-nl/don-checker@latest validate \   --ruleset adr-21 \   --input https://api.developer.overheid.nl/api-register/v1/openapi.json

--input https://api.developer.overheid.nl/api-register/v1/openapi.json

npx @stoplight/spectral-cli lint <jouw-spec.yaml> \   --ruleset https://static.developer.overheid.nl/adr/ruleset.yaml

--ruleset https://static.developer.overheid.nl/adr/ruleset.yaml

Voor het overzicht van regels (DON-versie: 11 regels; GitHub-versie: 22 regels) zie de `ls-api` skill in [skills-standaarden](https://github.com/developer-overheid-nl/skills-standaarden/blob/main/skills/ls-api/SKILL.md#oas-valideren).

npx @redocly/cli bundle ./openapi.json --output openapi.bundled.json --ext json git clone https://github.com/developer-overheid-nl/codegen-templates.git

git clone https://github.com/developer-overheid-nl/codegen-templates.git

De relevante kennisbank-content uit [developer.overheid.nl](https://developer.overheid.nl) staat al lokaal als gesynchroniseerde markdown in de `don-apis` skill. Gebruik deze lokale bronnen i.p.v. online links wanneer je extra context nodig

Voor de **normatieve samenvatting** van de NL GOV API Design Rules (ADR) — naming, problem+json, transport security, signing, encryption, geo — zie de `ls-api` skill in [developer-overheid-nl/skills-standaarden](https://github.com/developer