Voor het uitvoeren van monitoring en het opstellen van rapportages moet MedMij beschikken over goede loggegevens van alle deelnemers. Deze pagina beschrijft welke gebeurtenissen moeten worden vastgelegd, aan welke eisen logregels en verzamelingen van logregels moeten voldoen, hoe deze aangeleverd moeten worden en welke verantwoordelijkheden de verschillende rollen hebben.

Gebeurtenissen

In bovenstaande plaat staat de functie Verzamelen uitgewerkt, inclusief de momenten waarop iets gelogd moet worden. Voor Abonneren en Delen moeten dezelfde gebeurtenissen worden vastgelegd.

...

1.

Verzamelingen van logregels worden in het JSON formaat bij MedMij aangeboden. De verzamelingen worden met een HTTP POST request naar de endpoint van MedMij gestuurd.

Anchor

	core.logint.200
	core.logint.200

core.logint.200

2.

Alle aan te leveren logregels bevatten een event-object met een vaste set aan attributen:

type
een vaste code per gebeurtenis, te kiezen uit de lijst hierboven.
location
De hostname van deelnemer die de logregel vastlegd.
datetime
De datum, het tijdstip en de tijdzone van de gebeurtenis, vastgelegd in het formaat "2023-03-28T22:14:23.618+01:00".
session_id
Het identificerende kenmerk van de sessie bij de deelnemer, bij voorkeur een UUID.
trace_id
Het identificerende kenmerk van het proces waarbinnen de stap wordt uitgevoerd, vastgelegd als UUID.

Code Block

language	js
theme	Emacs
title	Voorbeeld event-object binnen logregel
linenumbers	true
collapse	true

{
	"event": {
  		"type": "send_authorization_request",
  		"location": "mijn.pgo.nl",
  		"datetime": "2023-03-28T22:14:23.618+01:00",
  		"session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
  		"trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  	 }
 }

Anchor

	core.logint.201
	core.logint.201

core.logint.201

3.

De logregels van alle verzonden en ontvangen verzoeken bevatten een request-object met een vaste set aan attributen:

id
Het unieke identificerende kenmerk (UUID) van het verzoek dat door versturende en ontvangende partij gebruikt wordt.
method
De gebruikte http method.
client_id
De hostname van de verzender van het verzoek.
server_id
De hostname van de ontvanger van het verzoek.
uri
De URI waar het verzoek naartoe wordt gestuurd.

Code Block

language	js
theme	Emacs
title	Voorbeeld request-object binnen logregel
linenumbers	true
collapse	true

{
	"event": { 
		"type": "send_authorization_request", 
		"location": "mijn.pgo.nl", 
		"datetime": "2023-03-28T22:14:23.618+01:00", 
		"session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb", 
		"trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
	}, 
	"request": { 
		"id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488", 
		"method": "get", 
		"client_id": "mijn.pgo.nl", 
		"server_id": "as.dva.nl", 
		"uri": "https://api.as.dva.nl/2.0.0/authorize"
	 }
 }

Anchor

	core.logint.202
	core.logint.202

core.logint.202

4.

In aanvulling op core.logint.201 worden bij een authorization request de volgende attributen aan het request-object toegevoegd:

provider_id
Het identificerende kenmerk (MedMij Aanbiedersnaam) van de betrokken aanbieder.
response_type
Deze heeft, zolang binnen het MedMij netwerk alleen gebruikgemaakt wordt van de OAuth2 Authorization Code Grant, altijd de waarde 'code'.
redirect_uri
De URI waar het resultaat naartoe gestuurd moet worden. Deze wordt gebruikt voor de redirect terug naar de DVP.
state
De OAuth2 state parameter.

Code Block

language	js
theme	Emacs
title	Voorbeeld Authorization request-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_authorization_request",
    "location": "mijn.pgo.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "request": {
    "id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "method": "get",
    "client_id": "mijn.pgo.nl",
    "server_id": "api.dva.nl",
    "uri": "https://api.dva.nl/2.0.0/authorize",
    "provider_id": "een.huisarts@medmij",
    "response_type": "code",
    "redirect_uri": "https://mijn.pgo.nl/medmij",
    "state": "ipcxyhlbjtvduydtneoaflwiismwxfmj"
  }
}

Anchor

	core.logint.203
	core.logint.203

core.logint.203

5.

In aanvulling op core.logint.201 wordt bij een Artifact resolution request het volgende attribuut aan het request-object toegevoegd:

request_type
Altijd de waarde 'SAML_assertion'

Code Block

language	js
theme	Emacs
title	Voorbeeld Authentication request-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_artifact_resolution_request",
    "location": "api.dva.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "request": {
    "id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "method": "get",
    "client_id": "api.dva.nl",
    "server_id": "digid.nl",
    "uri": "https://api.as.dva.nl/2.0.0/authorize",
    "request_type": "SAML_assertion"
  }
}

Anchor

	core.logint.204
	core.logint.204

core.logint.204

6.

In aanvulling op core.logint.201 worden bij een token request de volgende attributen aan het request-object toegevoegd:

grant_type
De waarde moet 'authorization_code' of 'refresh_token' zijn, waarbij de laatste alleen gebruikt mag worden bij het uitvoeren van een langdurige toestemming.
initiated_by
De waarde moet 'person' of 'machine' zijn, waarbij de laatste alleen gebruikt mag worden bij automatisch verzamelen.

Code Block

language	js
theme	Emacs
title	Voorbeeld Token request-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_token_request",
    "location": "mijn.pgo.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "request": {
    "id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "method": "get",
    "client_id": "mijn.pgo.nl",
    "server_id": "api.dva.nl", 
    "uri": "https://api.dva.nl/2.0.0/authorize", 
     "grant_type": "authorization_code",
    "initiated_by": "person"
  }
}

Anchor

	core.logint.205
	core.logint.205

core.logint.205

7.

In aanvulling op core.logint.201 worden bij een resource request de volgende attributen aan het request-object toegevoegd:

provider_id
Het identificerende kenmerk (MedMij Aanbiedersnaam) van de betrokken aanbieder.
service_id
Het identificerende kenmerk (nummer) van de opgevraagde gegevensdienst.

Code Block

language	js
theme	Emacs
title	Voorbeeld Resource request-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_resource_request",
    "location": "mijn.pgo.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "request": {
    "id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "method": "get",
    "client_id": "mijn.pgo.nl",
    "server_id": "api.dva.nl",
     "uri": "https://api.dva.nl/2.0.0/authorize", 
     "provider_id": "een.huisarts@medmij",
    "service_id": 49
  }
}

Anchor

	core.logint.206
	core.logint.206

core.logint.206

8.

De logregels van alle verzonden en ontvangen antwoorden bevatten een response-object met een vaste set aan attributen:

request_id
De id van het request waar het antwoord bij hoort.
status
De HTTP status code.

Code Block

language	js
theme	Emacs
title	Voorbeeld request-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_authorization_response",
    "location": "as.dva.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "response": {
    "request_id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "status": 200
  }
}

Anchor

	core.logint.207
	core.logint.207

core.logint.207

9.

De logregels van alle fouten in het proces bevatten een error-object met een vaste set aan attributen:

code
De waarde van het OAuth2.0 attribuut 'error' worden overgenomen.
description
Omschrijving van de geregistreerde fout. Bij de problemen in de beschikbaarheids- of ontvankelijkheidstoets moeten de waarden no_information_available (bij geen behandelrelatie), invalid_age of blocked worden gebruikt.

Code Block

language	js
theme	Emacs
title	Voorbeeld error-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "availibility_check_error",
    "location": "as.dva.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "error": {
    "code": "access_denied",
    "description": "no_information_available"
  }
}

Anchor

	core.logint.208
	core.logint.208

core.logint.208

10.

In aanvulling op core.logint.207 worden bij request errors de volgende attributen aan het error-object toegevoegd:

request_id
De id van het request waar het antwoord bij hoort.
status
De HTTP status code.

Code Block

language	js
theme	Emacs
title	Voorbeeld request-error-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "send_availibility_check_error",
    "location": "api.dva.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "error": {
    "code": "access_denied",
    "description": "no_information_available",
    "request_id": "8b5d6cb2-a2c0-4893-bd97-240621c3e488",
    "status": 403
  }
}

Anchor

	core.logint.209
	core.logint.209

core.logint.209

11.

De logregels van het type result_gathering_information bevatten een information-object met met daarin een lijst de namen van succesvol opgehaalde data-objecten, een lijst van opgehaalde data-objecten waarvan de waarde leeg is en een lijst van onsuccesvol opgehaalde data-objecten:

Expand

title	Toelichting

In het zorg domein worden de namen van de FHIR resources gebruikt voor de data-objecten. De FHIR Resources worden per gegevensdienst beschreven in de technische uitwerking uitwerkingen die via de Catalogus te vinden zijn.

Code Block

language	js
theme	Emacs
title	Voorbeeld request-error-object binnen logregel
linenumbers	true
collapse	true

{
  "event": {
    "type": "result_gathering_information",
    "location": "api.dva.nl",
    "datetime": "2023-03-28T22:14:23.618+01:00",
    "session_id": "c6a27d45-4316-464e-81e0-48d5dbccacbb",
    "trace_id": "79dc6181-6239-4fdd-ad98-594312aeac71"
  },
  "information": {
    "succesful": ["naam1", "naam2"],
    "empty":  ["naam3", "naam4"], 
    "unsuccesful": ["naam5", "naam6"]
  }
}

Anchor

	core.logint.210
	core.logint.210

core.logint.210

...

Versions Compared

Old Version 6

New Version Current

Key

Gebeurtenissen

Page Comparison

Versions Compared

Old Version 6

New Version Current

Key

Gebeurtenissen