VNG-Realisatie / gemma-verwerkingenlogging

API-specificaties voor gemeenten ten behoeve van de registratie en ontsluiting van de metagegevens behorende bij de verwerkingen van (persoons)gegevens.
https://vng-realisatie.github.io/gemma-verwerkingenlogging/
Other
6 stars 4 forks source link

Vulling http-headers vs. vulling requestBody ... #15

Open gertjanvanderkooij opened 3 years ago

gertjanvanderkooij commented 3 years ago

In documentatie Minimale en Volledige logging is ook beschreven welke http-header meegegeven moeten worden. Deze elementen komen ook voor de requestBody van de specificatie. Wordt verwacht dat overeenkomstige elementen (bv. verwerkingsactiviteitId, vertrouwelijkheid, bewaartermijn, ...) zowel in de vorm van een http-header als in de requestBody in een request worden opgenomen?

NB. De voorbeeldvulling voor 'bewaartermijn' is nog niet aangepast aan nieuwe format.

arnoudquanjer commented 3 years ago

Ik heb even gezocht maar ik kan de documentatie waar je op doelt niet vinden. Gaat je vraag over documentatie van de standaard op Github of over architectuurdocumentatie van de standaard op gemmaonline?

Ik kan je vraag denk ik wel beantwoorden. Op het moment dat een afnemer zoals een MijnGemeente pagina een inzage verzoek doet van logging dan moeten er twee dingen gebeuren:

gertjanvanderkooij commented 3 years ago

Dank voor je antwoord, maar mijn vraag betreft nog de POST ;-) Zie de tekst op: https://github.com/VNG-Realisatie/gemma-verwerkingenlogging/blob/master/docs/_content/quickstart/index.md#Volledige-logging-van-verwerkingen

ppcjansen commented 3 years ago

De http-header wordt alleen gebruikt als een afnemende applicatie (bv Vergunningen applicatie) gegevens gaat opvragen bij een aanbiedende applicatie (bv Gegevensmagazijn); zie hiervoor het uitgewerkte voorbeeld op https://github.com/VNG-Realisatie/gemma-verwerkingenlogging/blob/develop/docs/_content/quickstart/index.md#aanroepen-van-een-dienst-vanuit-een-initi%C3%ABrend-proces. Om te voorkomen dat de API van het Gegevensmagazijn aangepast moet worden, worden gegevens tbv het loggen (door het Gegevensmagazijn) in de header meegegeven. Het Gegevensmagazijn neemt die gegevens uit de header over en plaatst die in de payload bij het aanroepen van de Bewerkingen API van de Verwerkingenloggingregister. Een uitgebreidere uitleg hiervan is beschreven in 2 verschillende casussen: als een gemeente gegevens bij een externe partij opvraagt (https://github.com/VNG-Realisatie/gemma-verwerkingenlogging/blob/master/docs/_content/achtergronddocumentatie/ontwerp/artefacten/0031.md) en als een externe partij gegevens opvraagt bij een gemeente (https://github.com/VNG-Realisatie/gemma-verwerkingenlogging/blob/master/docs/_content/achtergronddocumentatie/ontwerp/artefacten/2866.md).

Er wordt dus alleen een http-header gevuld in een API-call naar een aanbiedende gegevensbron, niet naar de API van het Verwerkingenloggingregister.