---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# MedMij Afsprakenstelsel
## MedMij Afsprakenstelsel
Versie 2.3.0 datum publicatie 2025-10-14
Dit is de gearchiveerde versie van het afsprakenstelsel.
*
### [Architectuur en technische specificaties](https://afsprakenstelsel.medmij.nl/v23/archief/architectuur-en-technische-specificaties.md)
Een onmisbaar deel van het MedMij Afsprakenstelsel betreft de verantwoordelijkheden die de deelnemers in het afsprakenstelsel hebben, elk in zijn eigen rol, tijdens het feitelijk verzorgen van het informatieverkeer tussen het Persoonsdomein en het Zorgaanbiedersdomein.
#### [Introductie](https://afsprakenstelsel.medmij.nl/v23/archief/introductie.md)
#### [Afsprakenset](https://afsprakenstelsel.medmij.nl/v23/archief/afsprakenset.md)
*
#### [Catalogus](https://afsprakenstelsel.medmij.nl/v23/archief/catalogus.md)
#### [Toetreding](https://afsprakenstelsel.medmij.nl/v23/archief/toetreding.md)
#### [Governance](https://afsprakenstelsel.medmij.nl/v23/archief/governance.md)
*
#### [Issues](https://afsprakenstelsel.medmij.nl/v23/archief/issues.md)
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.10.1.1 Beleid inzake het gebruik van cryptografische beheersmaatregelen
## Norm
| Rationale | Persoonlijke gezondheidsgegevens moeten versleuteld worden opgeslagen. Dit heeft als doel dat de vertrouwelijkheid en integriteit van de gezondheidsgegevens gewaarborgd is, ook indien: · Een onbevoegd persoon toegang krijgt tot de datadrager (het hardware medium) · Een onbevoegd persoon toegang verkrijgt tot de logische dataopslag (de database of het gegevensbestand) |
| Implementatie | Opgeslagen persoonlijke gezondheidsgegevens MOETEN beschermd worden door middel van encryptie. Hiervoor wordt verwezen naar de ++aanbevelingen++ die gelden voor 'near term protection' en 'long-term protection' in de aanbevelingen, zie . |
| Toelichting | 1. Deze maatregel mag uitgesloten worden indien DVA onder zijn verantwoording geen persoonlijke gezondheidsgegevens opslaat. 2. Een overzicht van publicaties is te vinden op 3. Er kan gebruik gemaakt worden van de ECRYPT-CSA aanbevelingen, NIST of BSI aanbevelingen 4. Deze norm betreft alle opgeslagen persoonlijke gezondsheidsgegevens, inclusief logfiles, backups en/of archieven. |
| NEN 7510:2017 | A.10.1.1 Beleid inzake het gebruik van cryptografische beheersmaatregelen |
| NEN 7510:2011 | A.12.3.1 Beleid voor het gebruik van cryptografische beheersmaatregelen |
|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel op basis van de architectuurdiagrammen vast of er wordt voldaan aan de aanbevelingen die gelden voor 'near term protection' en 'long-term protection' volgens de door deelnemer gekozen invulling van encryptie standaarden en sleutels bijvoorbeeld ECRYPT-CSA,NIST of BSI (zie ). De deelnemer zal moeten aangeven welke encryptiestandaarden en sleutellengtes etc er gekozen zijn voor de opslag van gezondheidsgegevens. * Stel op basis van een steekproef vast of aanbevelingen ook daadwerkelijk geïmplementeerd zijn. |
| Verificatie | * Welke versie van de aanbevelingen is gehanteerd. * Welke versie van de architectuurdiagrammen zijn ingezien. * Evidence m.b.t. de daadwerkelijke implementatie. |
|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.1.2 (1) Wijzigingsbeheer
## Norm
| Rationale | Deze maatregel borgt dat wijzigingen binnen de keten beheerst verlopen. |
| Implementatie | De IT-beheerprocessen MOETEN aansluiten op het MedMij Change- en releasebeleid. |
| NEN 7510-1:2017 | A.12.1.2 Wijzigingsbeheer |
| NEN 7510:2011 | A.10.1.2 Wijzigingsbeheer |
|-----------------|---------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat IT-beheerprocessen van de organisatie aansluiten op het Change- en releasebeleid van MedMij. * Stel op basis van een steekproef vast dat de IT-beheerprocessen voor MedMij juist worden uitgevoerd. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Evidence m.b.t. de daadwerkelijke implementatie. |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.1.2 (2) Wijzigingsbeheer
## Norm
| Rationale | Deze maatregel borgt dat er altijd twee medewerkers betrokken zijn bij werkzaamheden aan systemen (configuratiewijzigingen, onderhoud, installatie van updates) die direct impact (kunnen) hebben op de beschikbaarheid, integriteit of vertrouwelijkheid van de keten. De maatregel vermindert het risico op onbeschikbaarheid van of kwetsbaarheden binnen de keten. |
| Implementatie | Niet-standaard wijzigingen op de IT componenten die gebruikt worden binnen de scope van MedMij MOETEN op basis van het vier-ogen-principe worden uitgevoerd. |
| Toelichting | Het gaat hier niet om achterliggende systemen (zoals EPD) maar om de aansluitende systemen en netwerkcomponenten (zoals firewalls). |
| NEN 7510-1:2017 | A.12.1.2 Wijzigingsbeheer |
| NEN 7510:2011 | A.10.1.2 Wijzigingsbeheer |
|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat een overzicht van standaard en niet-standaard wijzigingen is gedocumenteerd. Ga na of standaardwijzigingen geen midden/hoog risico hebben op op de beschikbaarheid, integriteit of vertrouwelijkheid van de keten. * Stel vast dat vier-ogen-principe is ingericht voor niet-standaard wijzigingen. * Stel door middel van interview met de betrokken medewerkers vast of de procedures worden nageleefd. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de implementatie. |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.1.2 (3) Wijzigingsbeheer
## Norm
| Rationale | Deze maatregel borgt dat wijzigingen binnen de keten beheerst verlopen. |
| Implementatie | Indien er wijzigingen plaatsvinden die mogelijk significante impact hebben op de informatiebeveiliging, MOET de penetratietest zoals benoemd in [A.18.2.3 Beoordeling van technische naleving](https://afsprakenstelsel.medmij.nl/v23/archief/a-18-2-3-beoordeling-van-technische-naleving.md) voor deze componenten opnieuw uitgevoerd worden. |
| NEN 7510-1:2017 | A.12.1.2 Wijzigingsbeheer |
| NEN 7510:2011 | A.10.1.2 Wijzigingsbeheer |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Zie [A.18.2.3 Beoordeling van technische naleving](https://afsprakenstelsel.medmij.nl/v23/archief/a-18-2-3-beoordeling-van-technische-naleving.md) |
| Verificatie | Zie [A.18.2.3 Beoordeling van technische naleving](https://afsprakenstelsel.medmij.nl/v23/archief/a-18-2-3-beoordeling-van-technische-naleving.md) |
|--------------|------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.1.3 (1) Capaciteitsbeheer
## Norm
| Rationale | Deze maatregel borgt dat alle systemen in de keten voldoen aan de afgesproken eisen omtrent beschikbaarheid. |
| Implementatie | Maatregelen MOETEN zijn gedocumenteerd en geïmplementeerd om te (kunnen) voldoen aan de beschikbaarheidseisen zoals vastgelegd in [Token interface](https://afsprakenstelsel.medmij.nl/v23/archief/token-interface.md) en [Resource interface](https://afsprakenstelsel.medmij.nl/v23/archief/resource-interface.md). |
| NEN 7510-1:2017 | A.12.1.3 Capaciteitsbeheer |
| NEN 7510:2011 | A.10.3.1 Capaciteitsbeheer |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel op basis van IT-monitoring en/of service level rapportages vast dat over een periode van drie maanden voorafgaand aan de auditdatum voldaan is aan de beschikbaarheidseisen. |
| Verificatie | Evidence m.b.t. de rapportages. |
|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP | |
| DVA |  |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.1.3 (2) Capaciteitsbeheer
## Norm
| Rationale | Deze maatregel borgt dat alle systemen in de keten voldoen aan de afgesproken eisen omtrent beschikbaarheid. |
| Implementatie | Maatregelen MOETEN zijn gedocumenteerd en geïmplementeerd om te (kunnen) voldoen aan de beschikbaarheidseisen zoals vastgelegd in [Interfaces lijsten](https://afsprakenstelsel.medmij.nl/v23/archief/interfaces-lijsten.md). |
| NEN 7510-1:2017 | A.12.1.3 Capaciteitsbeheer |
| NEN 7510:2011 | A.10.3.1 Capaciteitsbeheer |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel op basis van IT-monitoring en/of service level rapportages vast dat over een periode van drie maanden voorafgaand aan de auditdatum voldaan is aan de beschikbaarheidseisen. |
| Verificatie | Evidence m.b.t. de rapportages. |
|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP | |
| DVA | |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.3.1 Back-up van informatie
## Norm
| Rationale | Deze maatregel borgt dat deelnemers beschikken over een bruikbare back-up. |
| Implementatie | Er MOETEN maatregelen zijn geïmplementeerd waardoor het gegevensverlies van persoonlijke gezondheidsinformatie maximaal 24 uur bedraagt. Daarnaast moet een herstelprocedure zijn ingericht waardoor de gegevens van een persoon binnen 24 uur terug kunnen worden geplaatst in geval van een incident. Deze herstelprocedure wordt minimaal jaarlijks getest. |
| Toelichting | Deze maatregel MAG worden uitgesloten door een DVP indien de persoonlijke gezondheidsinformatie niet centraal wordt opgeslagen. |
| NEN 7510-1:2017 | A.12.3.1 Back-up van informatie |
| NEN 7510:2011 | A.10.5.1 Reservekopieën (back-ups) |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie maatregelen heeft ingericht waardoor gegevensverlies is beperkt tot maximaal 24 uur. Dit zijn bijvoorbeeld back-ups en/of heet repliceren van gegevens. * Stel vast dat de herstelprocedure binnen 24u uitgevoegd kan worden en minimaal jaarlijks wordt getest. * Stel daarnaast via monitoring en rapportages vast dat de leverancier voldoet |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Evidence m.b.t. de (minimaal) jaarlijkse test. |
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA | |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.4.1 Gebeurtenissen registreren
## Norm
| Rationale | Deze maatregel borgt dat relevante security gebeurtenissen in systemen van de deelnemers en de beheerorganisatie gelogd worden. Voorbeelden zijn het verlenen van toestemming aan aanbieder door de persoon of het inzien of wijzigen van een PGO. |
| Implementatie | * **Toegangslog** * Deelnemers richten logbestanden in zoals beschreven in de [AVG](https://autoriteitpersoonsgegevens.nl/uploads/imported/verordening_2016_-_679_definitief.pdf) en [NEN 7513:2018](https://www.nen.nl/nen-7513-2018-nl-245399) en zorgen voor een [wettelijke bewaartermijn](https://zoek.officielebekendmakingen.nl/stcrt-2019-38007.html) van vijf jaar. De volgende acties moeten ten minste onweerlegbaar en controleerbaar worden gelogd. * De acties waarbij de persoon gegevens wil verzamelen of delen. * De acties waarbij de persoon toestemming geeft voor uitwisseling conform de specificaties in het afsprakenstelsel. * **Technische logs** * De bewaartermijn voor technische logbestanden, zoals applicatie of service logs, hoeven niet aan de vijf jaar termijn te voldoen. Deelnemers kunnen bewaartermijnen vaststellen voor de technische logs op basis van best practices, zoals bijvoorbeeld beschreven in NIST SP 800-92 of CIS Control 6. Daarnaast kan een risicoanalyse de organisatie in staat stellen de bewaartermijn te bepalen die het beste past bij de specifieke behoeften en risico's van hun omgeving. Als richtlijn wordt aanbevolen om technische logs ten minste één jaar te bewaren, aangezien dit cruciaal kan zijn voor het uitvoeren van effectieve incident response en forensisch onderzoek. * **Ketenlog** * Vanuit het afsprakenstelsel moeten Deelnemers gebeurtenissen vastleggen ten behoeve van ketenmonitoring en -logging (Zie de [Verantwoordelijkheden, Core](https://vzvz.atlassian.net/wiki/spaces/MMAS2MIG/pages/1364492542/Verantwoordelijkheden+Core) onder logging en de [Logging interface](https://vzvz.atlassian.net/wiki/spaces/MMAS2MIG/pages/1364493576/Logging+interface)). De bewaartermijn van de logbestanden is ten minste 24 maanden en niet meer dan 36 maanden. De maximum bewaartermijn voor de loggegevens voor ketenlog is lager omdat deze niet gegevens over inzage en/of bewerkingen van het medisch dossier betreffen*.* De minimale en maximale bewaartermijnen van deze logbestanden passen binnen de uitersten die daartoe zijn bepaald door [NEN7513:2018](https://www.nen.nl/nen-7513-2018-nl-245399) (paragraaf 8.5). * De maximum bewaartermijn van 36 maanden is niet van toepassing op aggregaten en algemene tellingen. Deze aggregaten en algemene tellingen mogen niet zijn voorzien van herleidbare gegevens zoals trace-id en session-id. * **Disclaimer** * De, vanuit Deelnemers, ontvangen logbestanden worden met zorg en vertrouwelijkheid behandeld. Beheer MedMij draagt er zorg voor dat de logbestanden veilig worden opgeslagen en verwerkt, in overeenstemming met geldende privacy- en veiligheidsvoorschriften. Toegang tot de aangeleverde gelogde gebeurtenissen is strikt beperkt tot geautoriseerde medewerkers binnen Beheer MedMij. Deze data wordt uitsluitend gebruikt voor de volgende doeleinden: monitoring van het MedMij-ketenverkeer, het bieden van ondersteuning aan Deelnemers bij prio-1 incidenten en het uitvoeren van analyses ter verbetering van het MedMij-ketenverkeer. Logging data betreffende deelnemers wordt onder geen beding gedeeld met andere deelnemers. * ***Uitzondering*** * In het geval van een klacht of een juridische procedure mag een Deelnemer een uitzondering maken op de bewaartermijnen. Dan mogen de relevant geachte logregels en de relevante geachte rapportages tot maximaal 10 jaar na het ontstaan van de loggegevens worden bewaard. Praktische aanpak is om een export te maken van de relevante logregels en deze informatie vast te leggen in een register dat specifiek is gewijd voor uitzonderingen. Door deze afzonderlijke procedure voor het verlengd bewaren van logregels kunnen organisaties voldoen bij klachten, terwijl de reguliere bewaartermijnen van loggegevens worden gehandhaafd. |
| NEN 7510-1:2017 | A.12.4.1 Gebeurtenissen registreren |
| NEN 7510:2011 | A.10.10.1 Aanmaken audit-logbestanden A.10.10.2 Controle van systeemgebruik |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel vast of de logbestanden voor toegangslog en ketenlog voldoen aan de voorwaarden zoals gesteld in de implementatie. |
| Verificatie | * Evidence m.b.t. de logbestanden. * Evidence m.b.t. aansluiting. |
|--------------|-------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.4.3 Logbestanden van beheerders en operators
## Norm
| Rationale | Deze maatregel borgt dat partijen regelmatig controleren of alleen gerechtigde gebruikers toegang hebben tot relevante IT-componenten (waaronder servers, databases en netwerkinfrastructuur). |
| Implementatie | 1. Het gebruik van toegangsrechten op IT-componenten waar persoonlijke gezondheidsgegevens worden verwerkt MOET worden gelogd; 2. Deze logging MOET ten minste maandelijks worden gecontroleerd. Dit geldt ook voor eventuele onderaannemers; 3. Hierbij MOET functiescheiding gewaarborgd zijn; 4. Tijdens deze controle moet aandacht zijn voor onterecht/onnodig gebruik door medewerkers (met aantoonbare opvolging). |
| NEN 7510-1:2017 | A.9.2.5 Beoordeling van toegangsrechten van gebruikers |
| NEN 7510:2011 | A.11.2.4 Beoordeling van toegangsrechten van gebruikers |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel op basis van de procedures vast dat de logging van servers, databases en netwerkinfrastructuur waar persoonlijke gezondheidsgegevens worden opgeslagen of worden verwerkt maandelijks gecontroleerd worden. * Stel vast dat de functionaris(sen) die deze controle uitvoert/uitvoeren geen toegangsrechten verstrekken en/of zelf (beheer)toegang hebben tot de IT-componenten. * De controle van logging mag ook geautomatiseerd plaatsvinden. Stel dan vast dat configureren van de geautomatiseerde controle(s) juist en volledig plaatsvindt. |
| Verificatie | Welke documenten/registraties (incl. versienummers) zijn ingezien. |
|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.4.4 Kloksynchronisatie
## Norm
| Rationale | Deze maatregel borgt dat tijdsvermeldingen in logbestanden gelijklopen, wanneer deze worden gebruikt om misbruik in de keten op te sporen. Zie ook [A.16.1.7 Verzamelen van bewijsmateriaal](https://afsprakenstelsel.medmij.nl/v23/archief/a-16-1-7-verzamelen-van-bewijsmateriaal.md). |
| Implementatie | De klokken van IT componenten die communiceren via MedMij en logging in het kader van MedMij bijhouden, MOETEN worden gesynchroniseerd met . Het is toegestaan te synchroniseren met een alternatieve NTP-server, wanneer maatregelen zijn getroffen om de afwijking met niet groter dan plus of min 500 ms te laten zijn. |
| NEN 7510-1:2017 | A.12.4.4 Kloksynchronisatie |
| NEN 7510:2011 | A.10.10.6 Synchronisatie van systeemklokken |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel voor de relevante systemen voor het MedMij afsprakenstelsel vast via de logging\*- en/of configuratie-instellingen dat de synchronisatie met ten minste 1x per 24 uur plaats vindt. Dan wel middels een verklaring van een lokale NTP server over de synchronisatieprocedure met genoemde NTP-server. |
| Verificatie | Evidence m.b.t. de logbestanden en/ of configuratie instellingen. |
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.12.6.1 Beheer van technische kwetsbaarheden
## Norm
| Rationale | Deze maatregel borgt dat deelnemers in staat zijn tijdig te reageren op meldingen van (vermeende) kwetsbaarheden in het MedMij stelsel. Zie ook [A.16.1.3 Rapportage van zwakke plekken in de informatiebeveiliging](https://afsprakenstelsel.medmij.nl/v23/archief/a-16-1-3-rapportage-van-zwakke-plekken-in-de-infor.md). |
| Implementatie | De processen MOETEN aansluiten op de [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md) in het MedMij Afsprakenstelsel ten aanzien van het beheer van technische kwetsbaarheden. Dit dient te omvatten: * Identificeren van kwetsbaarheden in de eigen technologie, onderzoeken van relevantie van door de beheerorganisatie geïdentificeerde kwetsbaarheden + terugkoppeling naar de beheerorganisatie hieromtrent; * Het patchen van systemen of anderzijds mitigeren van de kwetsbaarheid; * Het tijdig kunnen doorlopen van de gehele procedure bij hoog risico-kwetsbaarheden. |
| NEN 7510-1:2017 | A.12.6.1 Beheer van technische kwetsbaarheden |
| NEN 7510:2011 | A.12.6.1 Beheersing van technische kwetsbaarheden |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie in haar procedures aansluit op het proces van beheren van technische kwetsbaarheden uit het afsprakenstelsel van MedMij. * Stel door middel van interview met de betrokken medewerkers vast of de procedures worden nageleefd. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de implementatie. |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.14.2.1 Beleid voor beveiligd ontwikkelen
## Norm
| Rationale | Deze maatregel borgt dat deelnemers en beheerorganisatie beveiligingsstandaarden toepassen bij het ontwikkelen van software en systemen die aan het internet gekoppeld worden. Dit voorkomt dat bekende programmeerfouten worden gemaakt. |
| Implementatie | Bij het vaststellen voor het beleid voor beveiligd ontwikkelen MOETEN de ICT-beveiligingsrichtlijnen voor webapplicaties van het NCSC uit het "Uitvoeringsdomein" overwogen worden (). Voor mobiele applicaties MOETEN de Beveiligingsrichtlijnen voor mobiele applicaties van het NCSC overwogen worden (). |
| NEN 7510:2011 | Deze maatregel bestond nog niet in NEN 7510:2011 |
|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie in haar beleid met betrekking tot de ontwikkeling, de door NCSC gedefinieerde minimale beveiligingsstandaarden ('Uitvoeringsdomein') in overweging heeft genomen. * Stel vast dat deze zijn toegepast. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de toepassing van de procedures. |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.15.1.2 Opnemen van beveiligingsaspecten in leveranciersovereenkomsten
## Norm
| Rationale | Deze maatregel borgt dat MedMij beheersmaatregelen die door een leverancier worden uitgevoerd contractueel vastgelegd worden. |
| Implementatie | Organisaties MOETEN relevante MedMij beheersmaatregelen contractueel beleggen bij hun leveranciers. |
| Toelichting | Deze maatregel mag worden uitgesloten indien er voor de MedMij-dienstverlening geen gebruik wordt gemaakt van externe leveranciers. |
| NEN 7510-1:2017 | A.15.1.2 Opnemen van beveiligingsaspecten in leveranciersovereenkomsten |
| NEN 7510:2011 | 6.2.3 Beveiliging in overeenkomsten met een derde partij |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel vast dat de organisatie de uitbestede maatregelen contractueel heeft geborgd met de leverancier(s). |
| Verificatie | Welke documenten (incl. versienummers) zijn ingezien. |
|--------------|----------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.15.2.1 Monitoring en beoordeling van dienstverlening van leveranciers
## Norm
| Rationale | Deze maatregel borgt dat er controle plaatsvindt op de naleving van MedMij beheersmaatregelen die door een leverancier worden uitgevoerd. |
| Implementatie | Organisaties MOETEN toezien op correcte naleving van de relevante MedMij beheersmaatregelen die bij een leverancier belegd zijn. |
| Toelichting | Deze maatregel mag worden uitgesloten indien er voor de MedMij-dienstverlening geen gebruik wordt gemaakt van externe leveranciers. |
| NEN 7510-1:2017 | A.15.2.1 Monitoring en beoordeling van dienstverlening van leveranciers |
| NEN 7510:2011 | 10.2.2 Controle en beoordeling van dienstverlening door een derde partij. |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel vast (bijvoorbeeld door het inzien van auditrapportages of leveranciersbeoordelingen) dat de organisatie heeft vastgesteld dat de leverancier de relevante maatregelen naar behoren heeft geïmplementeerd/uitgevoerd. |
| Verificatie | Welke documenten (incl. versienummers) zijn ingezien. |
|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.16.1.1 Verantwoordelijkheden en procedures
## Norm
| Rationale | Deze maatregel borgt dat deelnemers en beheerorganisatie volgens hetzelfde proces handelen in geval van incidenten en calamiteiten. Zie ook [A. 6.1.1 Rollen en verantwoordelijkheden bij informatiebeveiliging](https://afsprakenstelsel.medmij.nl/v23/archief/a-6-1-1-rollen-en-verantwoordelijkheden-bij-inform.md) . |
| Implementatie | De processen voor het behandelen van incidenten en calamiteiten moeten aansluiten op de [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md) in het afsprakenstelsel. |
| NEN 7510-1:2017 | A.16.1.1 Verantwoordelijkheden en procedures |
| NEN 7510:2011 | A.13.2.1 Verantwoordelijkheden en procedures |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie in haar procedures aansluit op het proces van incidenten en calamiteiten uit het afsprakenstelsel van MedMij. * Stel vast de procedures worden nageleefd. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de implementatie. * Evidence m.b.t. de daadwerkelijke implementatie. |
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.16.1.3 Rapportage van zwakke plekken in de informatiebeveiliging
## Norm
| Rationale | Deze maatregel borgt dat alle partijen elkaar tijdig op de hoogte brengen wanneer zij kennis hebben over kwetsbaarheden, die relevant kan zijn voor het MedMij stelsel. Het kan hier bijvoorbeeld gaan om informatie verkregen via het NCSC, penetratietesten of een Responsible Disclosure-melding). Zie ook [A.12.6.1 Beheer van technische kwetsbaarheden](https://afsprakenstelsel.medmij.nl/v23/archief/a-12-6-1-beheer-van-technische-kwetsbaarheden.md) . |
| Implementatie | Kwetsbaarheden en incidenten die betrekking hebben op persoonlijke gezondheidsgegevens of het functioneren van het MedMij stelsel MOETEN binnen 48 uur gemeld te worden bij het centrale incident management team. Zie [](https://medmij.atlassian.net/wiki/display/MMAS2MIG/Deelnemersovereenkomsten+(oud)). DVZA maken hierover zonodig afspraken met de aangesloten ZA's. |
| NEN 7510-1:2017 | A.16.1.3 Rapportage van zwakke plekken in de informatiebeveiliging |
| NEN 7510:2011 | A.13.1.2 Rapportage van zwakke plekken in de beveiliging |
|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie in haar procedures aansluit op het proces van incidenten en calamiteiten en proces beheren technische kwetsbaarheden uit het afsprakenstelsel van MedMij. * Stel door middel van interview met de betrokken medewerkers en waar mogelijk onderbouwd met evidence vast of de procedures worden nageleefd. * Stel door middel van interview en evidence vast of de deelnemer alle ontdekte kwetsbaarheden tijdig heeft gemeld aan MedMij. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de implementatie. * Evidence m.b.t. ontdekte kwetsbaarheden en tijdige melding aan MedMij. |
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.16.1.7 Verzamelen van bewijsmateriaal
## Norm
| Rationale | Deze maatregel borgt dat alle partijen moeten meewerken aan forensische onderzoeken, bijvoorbeeld in de nasleep van een stelselincident of fraude. Het zal meestal gaan om het opleveren van logfiles (zie [A.12.4.1 Gebeurtenissen registreren](https://afsprakenstelsel.medmij.nl/v23/archief/a-12-4-1-gebeurtenissen-registreren.md) ). |
| Implementatie | Medewerking MOET worden verleend aan (forensische) onderzoeken, door het aanleveren van gevraagde bewijsmaterialen, zulks op verzoek van de beheerorganisatie of bevoegde instanties. DVA maken hierover zonodig afspraken met de aangesloten Aanbieders. |
| NEN 7510-1:2017 | A.16.1.7 Verzamelen van bewijsmateriaal |
| NEN 7510:2011 | A.13.2.3 Verzamelen van bewijsmateriaal |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de organisatie in haar procedures het verlenen van medewerking aan (forensische) onderzoeken heeft opgenomen. * Stel vast datg de procedures worden nageleefd. |
| Verificatie | * Welke procedures (incl. versienummers) zijn ingezien. * Met wie gesproken is ter bevestiging van de implementatie. * Evidence m.b.t. de implementatie. |
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A.18.2.3 Beoordeling van technische naleving
\|
## Norm
| Rationale | Deze maatregel borgt dat deelnemers en de beheerorganisatie met regelmaat (en gebruikmakend van verschillende partijen) hun software, systemen en infrastructuur laten toetsen op bekende kwetsbaarheden. |
| Implementatie | Tenminste jaarlijks MOET een greybox applicatiepenetratietest worden uitgevoerd op de externe koppelvlakken door een externe, onafhankelijke organisatie. De volgende specifieke MedMij eisen moeten ook aantoonbaar getoetst zijn in de pentest rapportage; * Voor alle deelnemers: * DNSSEC zie [core.dns.300](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.dns.300) en [core.dns.301](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.dns.301) * TLS zie verantwoordelijkheid [core.tls.301](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.tls.301) in combinatie met [core.tls.302](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.tls.302) en [core.tls.304](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.tls.304) * NCSC webapplicatie richtlijnen U/PW.02, U/PW.03, U/WA.03, U/WA.04 NB deze zijn voor DigiD assessments al verplicht. Zie NOREA Handreiking DigiD assessments * In geval van een Authorization server: * De uniciteit van de uitgegeven Authorization codes, Access tokens en Refresh tokens door middel van een code review, zie [core.autorisatie.208](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.autorisatie.208) De externe koppelvlakken zijn: * *DVP: Burgerfrontend, OAuth Client Redirect* * *DVA: Resourceserver koppelvlak, Autorization server interface(s) eindgebruiker en voor de DVP.* * *BO: Stelselnode en administratieve front-end* **Voor toetreding** heeft een greybox applicatiepenetratietest minimaal al één keer plaatsgevonden en MOETEN de hoog en middel risico bevindingen op externe MedMij koppelvlakken zijn opgelost. Voor penetratietesten die worden uitgevoerd na toetreding, dient een adequaat actieplan opgesteld te worden voor minimaal de hoge en midden risico's (CVSS-score (Common Vulnerability Scoring System) van 4,0 of hoger) ten aanzien van de MedMij dienstverlening. Dit actieplan wordt gedeeld met de beheerorganisatie. De corrigerende maatregelen worden tijdig doorgevoerd. **Bij grootschalige wijziging of herbouw** vereisen eenmalig een greyboxapplicatiepenetratietest. Voor penetratietesten die worden uitgevoerd **na toetreding**, dient een adequaat actieplan opgesteld te worden voor minimaal de hoge en midden risico's ten aanzien van de MedMij dienstverlening. Dit actieplan wordt gedeeld met de beheerorganisatie. De corrigerende maatregelen worden tijdig doorgevoerd. |
| Toelichting | Een greybox penetratietest houdt in dat de penetratietester zoveel mogelijk inzicht heeft in de applicatie. Dit kan onder meer inhouden: * Toegang tot architectuur/ontwerpdocumentatie; * Toegang tot broncode; * Inloggegevens voor verschillende rollen. Het is niet nodig om een penetratietest uit te voeren op de gehele architectuur en/of alle programmacode. Het gaat met name om de beveiliging van de gegevens die over internet worden uitgewisseld, de focus moet dus liggen op de beveiliging van de externe koppelvlakken. Een app of een web portaal is ook een extern koppelvlak! |
| NEN 7510-1:2017 | A.18.2.3 Beoordeling van technische naleving |
| NEN 7510:2011 | A.15.2.2 Controle op technische naleving |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | Stel op basis van de meest recente rapportages vast of er wordt voldaan aan de jaarlijkse greybox applicatiepenetratietesten op de externe koppelvlakken conform de architectuur en specificaties van MedMij (en louter binnen de scope van het MedMij afsprakenstelsel). |
| Verificatie | * Evidence m.b.t. de uitgevoerde jaarlijkse testen. * Met wie gesproken is ter bevestiging van de implementatie. * Evidence m.b.t. het melden van kwetsbaarheden |
|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 5.1.1 Beleidsregels voor informatiebeveiliging
## Norm
| Rationale | Deze maatregel borgt dat het Afsprakenstelsel wordt toegepast in beleid en maatregelen bij de deelnemers. |
| Implementatie | De beleidsdocumenten MOETEN de beleidsmaatregelen die van toepassing zijn op MedMij (onder andere gespecificeerd in [Privacy- en informatiebeveiligingsbeleid](https://afsprakenstelsel.medmij.nl/v23/archief/privacy-en-informatiebeveiligingsbeleid.md)) specifiek benoemen. |
| NEN 7510-1:2017 | A.5.1.1 Beleidsregels voor informatiebeveiliging |
| NEN 7510:2011 | A.5.1.1 Beleidsdocument voor informatiebeveiliging |
|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat in de beleidsdocumenten het privacy en informatiebeveiligingsbeleid van MedMij specifiek is opgenomen. * Stel vast dat dit beleid is uitgewerkt in maatregelen. * Stel minimaal door middel van interviews met de betrokken medewerkers vast of de maatregelen worden toegepast. Dit geldt ook voor eventuele onderaannemers. |
| Verificatie | * Welke beleidsdocumenten (incl. versienummer) zijn onderzocht. * Welke documenten zijn onderzocht die de maatregelen beschrijven. * Met wie gesproken is ter bevestiging van toepassing van de maatregelen. |
|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 6.1.1 Rollen en verantwoordelijkheden bij informatiebeveiliging
## Norm
| Rationale | Deze maatregel borgt dat bij (dreiging van) calamiteiten door alle partijen daadkrachtig kan worden gereageerd. Zie ook [A.12.4.1 Gebeurtenissen registreren](https://afsprakenstelsel.medmij.nl/v23/archief/a-12-4-1-gebeurtenissen-registreren.md) en [A.16.1.1 Verantwoordelijkheden en procedures](https://afsprakenstelsel.medmij.nl/v23/archief/a-16-1-1-verantwoordelijkheden-en-procedures.md) . |
| Implementatie | De (eind)verantwoordelijkheid voor informatiebeveiliging MOET belegd zijn. Deze functionaris(sen) dient/dienen mandaat te hebben om bij (een dreiging van) een crisis spoedbesluiten te nemen ten aanzien van MedMij en deze besluiten met spoed te kunnen (laten) realiseren. De verantwoordelijke en operationele functionaris(sen) (inclusief eventuele onderaannemers) dient/ dienen hiervoor tijdens kantooruren binnen een uur beschikbaar te zijn en buiten kantooruren binnen drie uur. |
| Toelichting | Conform de betreffende [](https://medmij.atlassian.net/wiki/display/MMAS2MIG/Deelnemersovereenkomsten+(oud)) . |
| NEN 7510-1:2017 | A.6.1.1 Rollen en verantwoordelijkheden bij informatiebeveiliging |
| NEN 7510:2011 | A.6.1.3 Toewijzing van verantwoordelijkheden voor informatiebeveiliging A.8.1.1 Rollen en verantwoordelijkheden |
|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel op basis van evidence vast dat de genoemde functionaris(sen) is/zijn aangewezen. * Stel vast dat een procedure is ingericht zodat de genoemde beschikbaarheid, tijdens kantooruren binnen een uur en buiten kantooruren binnen drie uur, te allen tijde gegarandeerd is op dit onderwerp. Indien van toepassing dient deze procedure onderaannemers te omvatten. * De beschikbaarheid dient tevens gegarandeerd te zijn bij geplande en ongeplande afwezigheid. * Stel door middel van interviews vast dat de functionaris(sen) op de hoogte is/zijn van hun taken en verantwoordelijkheden t.a.v. de beschikbaarheid en het juiste mandaat hebben. |
| Verificatie | * In welke documentatie de verantwoordelijkheden en bevoegdheden zijn belegd. * Welke procedure (incl. versienummer) is ingezien m.b.t. de beschikbaarheid. * Met wie gesproken is ter bevestiging van de implementatie. |
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 7.2.2 Bewustzijn, opleiding en training ten aanzien van informatiebeveiliging
## Norm
| Rationale | Deze maatregel borgt dat medewerkers zich bewust zijn van de werking van MedMij en de ketenverantwoordelijkheden. |
| Implementatie | Medewerkers die werkzaamheden verrichten ten aanzien van de operationele processen zoals omschreven in de verplichte versie van het MedMij Afsprakenstelsel MOETEN een training hebben gevolgd over de algemene werking van het stelsel en op de voor hem/haar van toepassing zijnde beveiligingsmaatregelen. |
| Toelichting | De beheerorganisatie levert het trainingsmateriaal aan. De deelnemer verwerkt het materiaal in haar interne informatiebeveiliging training programma. De presentatie kan 1:1 worden overgenomen of geïncorporeerd worden met andere trainingen |
| NEN 7510-1:2017 | A.7.2.2 Bewustzijn, opleiding en training ten aanzien van informatiebeveiliging |
| NEN 7510:2011 | A.8.2.2 Bewustzijn, opleiding en training ten aanzien van informatiebeveiliging |
|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Verkrijg een overzicht van medewerkers die betrokken zijn bij MedMij operationele gerelateerde werkzaamheden. Stel op basis van het bewijs van deelname vast dat deze personen ofwel de MedMij training gevolgd hebben die aangeleverd is door de beheerorganisatie, . * Als deelnemer een training heeft geïncorporeerd stel vast dat de volgende aspecten voldoende behandeld worden: de werking van MedMij, de ketenverantwoordelijkheden en de voor de medewerker van toepassing zijnde beveiligingsmaatregelen. |
| Verificatie | * Het overzicht van contactpersonen. * Evidence m.b.t. de gevolgde training. |
|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 8.2.1 Classificatie van informatie
## Norm
| Rationale | Deze maatregel borgt dat informatie die binnen het stelsel wordt gebruikt, door deelnemers met dezelfde voorzichtigheid wordt behandeld. |
| Implementatie | De gegevens die binnen het stelsel worden verwerkt MOETEN worden behandeld conform het Informatieclassificatiebeleid (van MedMij). |
| Toetsing | Door middel van interviews en/of het tonen van evidence (zoals het informatieclassificatieschema of -beleid van de partij). |
| NEN 7510-1:2017 | A.8.2.1 Classificatie van informatie |
| NEN 7510:2011 | A.7.2.1 Richtlijnen voor classificatie |
|-----------------|------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat de classificatie van gegevens binnen de organisatie, voor de gegevens die binnen het stelsel worden uitgewisseld, overeenstemt met de classificatie zoals door MedMij benoemd in het Informatieclassificatiebeleid van MedMij * Stel vast dat de verwerking van de gegevens door de deelnemer daadwerkelijk plaatsvindt conform het Informatieclassificatiebeleid van MedMij. Hierbij ligt de focus op: gezondheidsgegevens, metagegevens, operationele gegevens, risicoanalyses, pentestrapporten en de whitelist. Dit geldt ook voor eventuele onderaannemers. |
| Verificatie | Welk document (incl. versienummer) is ingezien. |
|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 9.1.1 Beleid voor toegangsbeveiliging
## Norm
| Rationale | Deze maatregel borgt dat persoonlijke gezondheidsgegevens alleen toegankelijk zijn voor de zorgaanbieder en de zorggebruiker (zie ook [A.10.1.1 Beleid inzake het gebruik van cryptografische beheersmaatregelen](https://afsprakenstelsel.medmij.nl/v23/archief/a-10-1-1-beleid-inzake-het-gebruik-van-cryptografi.md) ). |
| Implementatie | Er MOETEN technische en organisatorische maatregelen worden genomen om inzage van persoonlijke gezondheidsgegevens door medewerkers te voorkomen. De organisatie dient minimaal elk halfjaar en na grote wijzigingen een self-assessment uit te voeren om vast te stellen dat deze maatregelen nog effectief zijn. In (zeer) uitzonderlijke gevallen is inzage in persoonlijke gezondheidsgegevens niet te voorkomen. Hiervoor dient de organisatie een (nood)procedure te documenteren. Deze procedure dient in te gaan op: * Functiescheiding tussen vragen van toestemming voor inzage en het geven van toestemming door een verantwoordelijke functionaris; * Randvoorwaarden en maatregelen met als doel dat inzage plaatsvindt op een gecontroleerde en zo beperkt mogelijke (in tijd en hoeveelheid gegevens) wijze; * Borging dat de deelnemer voldoet wordt aan wet- en regelgeving (AVG, Meldplicht Datalekken) en de geldende versie van het MedMij Afsprakenstelsel; * Vastlegging en verantwoording van de getroffen acties. |
| NEN 7510:2017 | A.9.1.1 Beleid voor toegangsbeveiliging |
| NEN 7510:2011 | A.11.1.1 Toegangsbeleid |
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat het technisch onmogelijk is gemaakt dat (medewerkers van) partijen zich inzage kunnen verschaffen in persoonlijke gezondheidsgegevens. Dit geldt ook voor eventuele onderaannemers * Stel vast dat self assessment minimaal elk halfjaar en na grote wijzigingen is uitgevoerd. * Stel vast dat de (nood)procedure is opgesteld en effectief is (m.a.w. geen toegang is verkregen zonder toepassing van de procedure). * Indien inzage heeft plaatsgevonden: Controleer de vastlegging en verantwoording |
| Verificatie | Welke documenten (incl. versienummers) zijn ingezien. |
|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 9.2.5 Beoordeling van toegangsrechten van gebruikers
## Norm
| Rationale | Deze maatregel borgt dat partijen regelmatig controleren of alleen gerechtigde gebruikers toegang hebben tot relevante IT-componenten (waaronder servers, databases en netwerkinfrastructuur). |
| Implementatie | 1. Toegangsrechten die zijn verstrekt op IT-componenten waar persoonlijke gezondheidsgegevens worden worden verwerkt MOETEN ten minste maandelijks worden gecontroleerd. 2. Hierbij MOET functiescheiding gewaarborgd zijn. 3. Dit geldt ook voor eventuele onderaannemers. 4. Tijdens deze controle moet aandacht zijn voor medewerkers die geen gebruik (meer) maken van de toegangsrechten (met aantoonbare opvolging). |
| NEN 7510:2017 | A.9.2.5 Beoordeling van toegangsrechten van gebruikers |
| NEN 7510:2011 | A.11.2.4 Beoordeling van toegangsrechten van gebruikers |
|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel op basis van de procedures vast dat toegangsrechten op servers, databases en netwerkinfrastructuur waar persoonlijke gezondheidsgegevens worden opgeslagen of worden verwerkt maandelijks gecontroleerd worden. Dit geldt ook voor eventuele onderaannemers. * Stel vast dat de functionaris(sen) die deze controle uitvoert/uitvoeren geen toegangsrechten verstrekken en/of zelf (beheer)toegang hebben tot de IT-componenten. * De controle van toegangsrechten mag ook geautomatiseerd plaatsvinden. Stel dan vast dat configureren van de geautomatiseerde controle(s) juist en volledig plaatsvindt |
| Verificatie | Welke procedures (incl. versienummers) zijn ingezien. |
|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Rollen
| DVP |  |
| DVA |  |
| BO |  |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# A. 9.4.1 Beperking toegang tot informatie
## Norm
| Rationale | Deze maatregel borgt dat authenticatie van personen en autorisatie tot hun persoonlijke gegevens betrouwbaar plaatsvindt. |
| Implementatie | Authenticatie van personen (eindgebruikers) MOET plaatsvinden op basis van minimaal twee factoren. Na succesvolle authenticatie krijgen personen alleen toegang tot hun eigen persoonlijke gezondheidsgegevens of de gegevens van de vertegenwoordigde. Scope: Dit geldt voor het gehele MedMij PGO en voor alle gebruikers die hier toegang toe krijgen. Dit is onafhankelijk of deze gebruikers MedMij uitwisselingen gebruiken of niet. Naast zwakkere tweede factoren als e-mail en SMS MOET een deelnemer ook één of meerdere sterkere tweede factoren aanbieden. De Persoon bepaalt zelf welke tweede factor wordt gebruikt. In deze versie van het Afsprakenstelsel worden e-mail en SMS als tweede factor nog geaccepteerd. Het voornemen is deze methode te schrappen. Dit kan, op het moment dat grotere beveiligingsrisico's optreden, via een snel door te voeren patch van het Afsprakenstelsel. |
| NEN 7510:2017 | A.9.4.1 Beperking toegang tot informatie |
| NEN 7510:2011 | A.11.5.2 Gebruikersindentificatie en -authenticatie |
|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
## Beoordeling
| Auditmethode | * Stel vast dat (minimaal) twee-factorauthenticatie van personen technisch afgedwongen wordt * Stel vast dat voldoende maatregelen zijn ingericht die waarborgen dat na succesvolle authenticatie de personen alleen toegang krijgen tot hun eigen persoonlijke gezondheidsgegevens. Ondersteunende evidence omvat bijvoorbeeld gedocumenteerde usecases of het uitvoeren van een 'walk through' vanuit het perspectief van de eindgebruiker Ten aanzien van de in het eerste punt bedoelde twee factoren gelden de volgende twee richtlijnen. Ten eerste moeten de factoren uit verschillende van de volgende categorieën gebruikt worden. * drie categorieën van zogenoemde "authenticatiefactoren": factoren waarvan is bevestigd dat deze gebonden zijn aan een persoon. * op **bezit** gebaseerde authenticatiefactoren: authenticatiefactoren waarvan de betrokkene moet aantonen dat deze in zijn bezit is; * op **kennis** gebaseerde authenticatiefactoren: authenticatiefactoren waarvan de betrokkene moet aantonen dat hij ervan kennis draagt; * **inherente** authenticatiefactoren: authenticatiefactoren die op een fysiek kenmerk van een natuurlijke persoon is gebaseerd en waarbij de betrokkene moet aantonen dat hij dat fysieke kenmerk bezit; * dynamische authenticatie: een elektronisch proces, dat met gebruikmaking van cryptografie of een andere techniek de middelen biedt om op verzoek een elektronisch bewijs op te maken dat de betrokkene de controle heeft over of in het bezit is van de identificatiegegevens, en dat verandert telkens als authenticatie plaatsvindt tussen de betrokkene en het systeem dat diens identiteit verifieert; Twee factoren Bijvoorbeeld, wanneer er tijdens het inloggen zowel een TouchID als een FaceID gebruikt wordt, dan is er geen sprake van two-factor, omdat het beide inherente authenticatiefactoren zijn. Ten tweede moet het gebruik van beide factoren tijdens het inloggen achter elkaar plaatsvinden en in het inlog-proces onlosmakelijk aan elkaar verbonden zijn. Twee factoren Bijvoorbeeld, wanneer FaceID gebruikt wordt om met de iCloud password manager een wachtwoord in te voeren is er geen sprake van twee-factorauthenticatie, omdat het wachtwoord ook handmatig ingevoerd kan worden. Deze tabel toont voorbeelden van veelgebruikte authenticatiefactoren. | categorie | factor | beschrijving | |-----------|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | bezit | kaart of pas | Bij de authenticatie is een fysieke, losse kaart betrokken bijvoorbeeld een bankkaart. | | bezit | E-mail | Als onderdeel van de authenticatie wordt een e-mail ontvangen op het opgegeven e-mailadres. Deze e-mail bevat een voldoende lange en steeds andere code die bij authenticatie ingevoerd moet worden. Naast e-mail MOET een deelnemer ook één of meerdere sterkere tweede factoren aanbieden. | | bezit | SMS | Als onderdeel van de authenticatie wordt een dynamische SMS-code gecontroleerd. De SMS-code is voldoende lang en steeds een andere. Naast SMS MOET een deelnemer ook één of meerdere sterkere tweede factoren aanbieden. | | bezit | push notifications | Als onderdeel van de authenticatie wordt er een melding ontvangen op de telefoon. De gebruiker bevestigt de melding. | | bezit | keychain | Deze controle is niet zichtbaar voor de gebruiker. Op de mobiele telefoon wordt een secure enclave of keychain gebruikt om bezit van de telefoon aan te tonen. | | kennis | pincode | Als onderdeel van de authenticatie wordt een pincode ingevoerd. Een pincode is altijd verbonden aan een kaart of een app(licatie). Na een beperkt aantal foutpogingen wordt de kaart of app geblokkeerd. | | kennis | wachtwoord | Als onderdeel van de authenticatie wordt een wachtwoord ingevoerd. Voor de eisen aan het wachtwoord, de levensduur en het toegestane aantal foutpogingen is wachtwoordbeleid aanwezig. | | inherent | vingerafdruk | Als onderdeel van de authenticatie wordt een vingerafdruk gecontroleerd, zoals TouchID. | | inherent | gezichtsherkenning | Als onderdeel van de authenticatie wordt het gezicht gecontroleerd, zoals FaceID. | | inherent | irisscan | Als onderdeel van de authenticatie wordt het oog gecontroleerd. | |
| Verificatie | Welke documenten (incl. versienummers) zijn ingezien. |
|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Eindgebruikers moeten worden beschermd. De eindgebruiker van een PGO moet er vanuit kunnen gaan dat gegevens op een goede manier toegankelijk worden gemaakt. Eindgebruikers moeten kunnen vertrouwen dat hun medische informatie veilig wordt opgeslagen.
## Rollen
| DVP |  |
| DVA | |
| BO | |
|-----|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
*DVP = Dienstverlener persoon, DVA = Dienstverlener aanbieder, BO = Beheerorganisatie*
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Aanbiedersnamenbeleid
*Aanbieders* kunnen hun deelname en de manier waarop ze via MedMij te bereiken zijn aan *Personen* kenbaar maken via een *Aanbiedersnaam* (`aanbiedersnaam@medmij`). Het aanbiedersnamenbeleid beschrijft hoe een *Aanbieder* een voor de *Persoon* herkenbare naam kan kiezen, zonder in de toekomst de mogelijkheden van andere *Aanbieders* om een herkenbare naam te kiezen te veel te beperken.
Het is de *Aanbieder* die zijn *Aanbiedersnaam* kiest, maar de *Dienstverlener aanbieder* die de *aanbiedersnaam* aanreikt aan de MedMij Beheerorganisatie voor gebruik in de *Aanbiederslijst* . Daarbij moet de *Dienstverlener aanbieder* een verklaring van de *Aanbieder* kunnen overleggen. Deze verklaring is opgenomen onder het Registratieproces *Aanbiederslijst* op de pagina [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md).
## Rollen inzake de *Aanbiedersnaam*
De *Aanbiedersnaam*:
* wordt gekozen door de *Aanbieder* , als verwerkingsverantwoordelijke, voor het specifieke doel om *Gegevensdiensten* aan te bieden binnen het MedMij-netwerk;
* wordt vastgesteld door de Stichting MedMij, die hiervoor onderstaande kwaliteitseisen verifieert;
* wordt door MedMij niet gebonden aan enige *Gegevensdienst* , maar *Aanbieder* mag dit wel doen;
* is niet gebonden aan de *Dienstverlener aanbieder* . De *Dienstverlener aanbieder* informeert *Aanbieders* wel over de context, het doel en het beleid inzake *Aanbiedersnamen* in MedMij;
* wordt door een *Dienstverlener aanbieder* verwerkt en, in het bijzonder, gehanteerd wanneer hij in opdracht van een *Aanbieder* een *Gegevensdienst* wil laten opnemen op, of afvoeren van, de *Aanbiederslijst*;
* wordt binnen het MedMij-netwerk niet verbonden aan enig ander kenmerk, adres of identificatie van de *Aanbieder* . De verantwoordelijkheid voor zijn portfolio aan adressen (voor verschillende communicatiekanalen) en identificaties (voor verschillende doelen) ligt bij de *Aanbieder* zelf.
## Eisen aan de *Aanbiedersnaam*
1. De naam moet gekoppeld zijn aan de naam die de Aanbieder in andere communicatie gebruikt (niet: `stichtingtersamenwerkinghuisartsenoegstgeest@medmij`, wel: `huisartsensamenwerkingoegstgeest@medmij`);
2. De naam moet uniek zijn en mag niet sterk lijken op een naam die al geregistreerd is;
3. De naam mag niet ambigu zijn en op veel verschillende aanbieders kunnen slaan (niet: `huisartshaarlem@medmij`, wel: `huisartswestergrachthaarlem@medmij`);
4. De naam mag niet de naam van een deelnemer bevatten of anderszins aan een specifieke deelnemer gekoppeld zijn;
5. De naam eindigt altijd op `@medmij`;
6. De naam is minimaal drie en maximaal 280 karakters lang (exclusief `@medmij`);
7. De naam wordt geregistreerd (ook in de *Aanbiederslijst*) in het volgende formaat:
1. een reeks van één of meer ++segmenten++, gescheiden door
1. hetzij één koppelteken,
2. hetzij één ampersand,
3. hetzij één punt;
2. gevolgd door `@medmij`, waarin
3. elk ++segment++ een reeks van één of meer ++fragmenten++ is, zodanig dat
4. elk ++fragment++ bestaat uit een reeks, met een minimale lengte van één karakter, van
1. kleine letters uit het Nederlandse alfabet (bestaande uit de zesentwintig letters `a..z`) en/of
2. Arabische cijfers (`0..9`).
8. Van de naam mogen, buiten de registratie, varianten voorkomen waarin een kleine letter is vervangen door de corresponderende hoofdletter en/of diakritische varianten van letters voorkomen. Deze lettervarianten worden echter als identiek gezien aan de kleine basisletter. De naam is dus niet hoofdletter-gevoelig en evenmin diacriet-gevoelig.
9. De naam mag niet te herleiden zijn tot een persoon;
10. De naam mag in het verleden niet door een andere aanbieder gebruikt zijn;
11. De naam mag het merk MedMij niet negatief beïnvloeden.
Het formaat van de Aanbiedernaam
Het formaat van de *Aanbiedersnaam* benadert dat van de handelsnaam uit het Handelsregister. Dat is nastrevenswaardig omdat doel en aard van de *Aanbiedersnaam*lijken op die van de handelsnaam.
Met betrekking tot de diakritische tekens is niet zozeer het voorkomen ervan een probleem, maar wel het onderscheidend vermogen tussen verschillende accenten op, aan of onder dezelfde basisletter. Geautomatiseerde systemen kunnen weliswaar `woltgens` van `wöltgens` onderscheiden, `mondhygiënist` van `mondhygienist` en `hélene` van `helène`, maar dat geldt niet voor (vooral PGO-)gebruikers die *Aanbiedersnamen* handmatig zullen willen intypen. Dat laatste moet mogelijk zijn, omdat een arts bijvoorbeeld op een kaartje of een kladje zijn *Aanbiedersnaam* aan een patiënt zou kunnen meegeven. In die zin lijkt een *Aanbiedersnaam* op een e-mailadres. Een snel gemaakte fout met een diakritisch teken moet niet even snel tot de adressering van een onbedoelde *Aanbieder*leiden.
Met betrekking tot cijfers is het om vergelijkbare redenen zaak te voorkomen dat te lange reeksen (volg)nummers ontstaan. Daarom mogen er maximaal vier achtereenvolgende cijfers voorkomen.
Het koppelteken, de ampersand en de punt kunnen een belangrijke functie vervullen in de herkenbaarheid van de *Aanbiedersnaam*, maar een reeks van dergelijke tekens achter elkaar heeft dat nauwelijks.
*Aanbiedersnamen* worden dus in kleine letters en zonder diakritische tekens geregistreerd en in de *Aanbiederslijst*opgenomen, maar mogen in wíLlëKęūrîgE diakritische en hoofdlettervarianten worden aangegeven.
Zie voor meer informatie over de *Aanbiedersnaam* de pagina over de [XML-schema's](https://afsprakenstelsel.medmij.nl/v23/archief/xml-schema-s.md).
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Aanvullende auditverklaring en onderbouwende rapportage
Download
Zie [Aanvullende_auditverklaring_en_onderbouwende_rapportage.xlsx](https://afsprakenstelsel.medmij.nl/__attachments/a_b9493364232136f04904e4864fee9ddb10ada26b3b180b7d6f7cfcec0aaf971c/Aanvullende_auditverklaring_en_onderbouwende_rapportage_20240318.xlsx.md?cb=8d02cfc7a37765642b0c132ce13e0c15) voor de Excel-versie van de Aanvullende auditverklaring en onderbouwende rapportage.
## Organisatiegegevens
De gegevens van de (aspirant) MedMij deelnemer.
| Naam | |
| Adres | |
| Vertegenwoordigd door | |
| Rol | DVP/DVA |
|-----------------------|---------|
## Certificatiegegevens
De gegevens van het onderliggende NEN 7510-certificaat.
| Norm | NEN 7510-1:2017 |
| Scope | |
| Certificaatnummer | |
| Vervaldatum | |
|-------------------|-----------------|
## Auditgegevens
Gegevens over de audit.
| CBI | |
| Bezochte locatie(s) | |
| Lead auditor | |
| Overige teamleden | |
|---------------------|---|
## Rapport
Gegevens over dit rapport.
| Datum rapport | |
| Status rapport | Concept/Definitief |
| Bijlagen bij dit rapport | |
|--------------------------|--------------------|
## Onderbouwende rapportage
| Beheersmaatregel |
|-------------------|
| No content found. |
## Ondertekening
Hierbij verklaren ondergetekenden (auditor en vertegenwoordiger CBI) dat bovengenoemde Organisatie **wel/niet** voldoet aan het aanvullend normenkader informatiebeveiliging van de hieronder genoemde versie van het MedMij Afsprakenstelsel, zoals door Stichting MedMij is uitgegeven.
*** ** * ** ***
(Versie van het afsprakenstelsel)
*** ** * ** ***
(Naam auditor, datum, handtekening)
*** ** * ** ***
(Naam vertegenwoordiger CBI, datum, handtekening)
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Abonneren
## Inleiding
Op deze pagina staan de diagrammen behorende bij de functie*Abonneren.*De functie *Abonneren* hoort geheel bij de hoofdfunctie *Regie*. Zij omvat het aangaan, het veranderen van de duur en het beëindigen van *Abonnementen*. De diagrammen tonen allereerst de situatie waarin alle acties slagen tot en met het uiteindelijke afsluiten van een *Abonnement* (de zogenaamde happy flow). De oranje banen horen bij het Persoonsdomein, de blauwe bij het Aanbiedersdomein.
## Businesslaag
* In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de genoemde rollen.
De totale procesgang van de functie *Abonneren* kent de volgende stappen:
* De *Dienstverlener persoon*presenteert aan de *Persoon*de mogelijkheid om *Abonnementen* aan te gaan, aan te passen of te beëindigen.
* De *Persoon*selecteert voor het aangaan van een *Abonnement* expliciet de *Aanbieder* en de specifieke *Gegevensdienst*, en voor het aanpassen of beëindigen het betreffende *Abonnement*. Daarvoor kunnen desgewenst de *Gegevensdienstnamen* worden gebruikt uit de *Gegevensdienstnamenlijst*. Het verzoek gaat naar de passende *Dienstverlener aanbieder*.
* De *Dienstverlener aanbieder start het autorisatieproces*.
* De *Dienstverlener aanbieder* laat de *Persoon* zich authenticeren en geeft autorisatie af aan de *Dienstverlener persoon*.
* Na de autorisatie kan de *Dienstverlener persoon*de *Dienstverlener aanbieder* vragen om diens vaststelling van het aangaan, aanpassen of beëindigen van het *Abonnement*.
* Indien het gaat om het aangaan of aanpassen van een Abonnement, zal uiterlijk na de ontvangst van het verzoek de *Dienstverlener aanbieder*ervoor instaan dat de *Aanbieder*voor de betreffende *Gegevensdienst* überhaupt gezondheidsinformatie van die *Persoon* beschikbaar heeft, of anders de happy flow afbreken.
* Bij ontvangst van het resultaat verwerkt de *Dienstverlener persoon*het nieuwe, aangepaste of beëindigde *Abonnement* in het persoonlijke *Dossier*.
* Bij de informatie wordt ook de meta-informatie opgeslagen die wordt bedoeld in verantwoordelijkheden core.logging.100 en core.logging.101.
### Uitzonderingen op de Happy flow van de functie Abonneren
In onderstaande tabel staan de uitzonderingssituaties beschreven. Alle worden door de *Dienstverlener aanbieder*ontdekt. Ten alle tijden moet voorkomen worden dat de *Dienstverlener persoon*informatie over het bestaan van behandelrelaties verkrijgt zonder dat (al) bevestiging is gegeven door de *Dienstverlener persoon*.
| **nr.** | **uitzondering** | **actie** | **vervolg** |
|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Abonneren 1 | *Dienstverlener aanbieder* vindt het ontvangen verzoek ongeldig. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon*over deze uitzondering. *Dienstverlener persoon*informeert daarop *Persoon* hierover. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Abonneren 2 | *Dienstverlener aanbieder*stelt op enig moment namens *Aanbieder* vast dat niet wordt voldaan aan de beschikbaarheidsvoorwaarde. Hiervan is in elk geval sprake indien hetzij: * er geen behandelrelatie is aan te wijzen als grondslag voor het verzamelen; * *Persoon*nog geen zestien jaar oud is. Zie de toelichting op Beschikbaarheids- en ontvankelijkheidsvoorwaarde. | *Dienstverlener aanbieder*informeert *Dienstverlener persoon*dat verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Abonneren 3 | *Dienstverlener aanbieder* kan, zelfs na toestemming, de gezondheids- of *Abonnements*-informatie alsnog niet ter beschikking stellen aan de *Dienstverlener persoon*. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon* over deze uitzondering. *Dienstverlener persoon* informeert daarop *Persoon*hierover, met opgave van oorzaak. | Mocht de gezondheidsinformatie deels wel (geautoriseerd) ter beschikking staan, dan kan de flow dat nog verzorgen. |
| Abonneren 4 | [*Persoon*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#Persoon)annuleert het inloggen. | *Dienstverlener aanbieder* presenteert een annuleringspagina en biedt *Persoon*de optie om toch in te loggen. | Indien *Persoon*kiest niet in te willen loggen, kan het scherm gesloten worden. De flow wordt gestopt. *Persoon*kan er ook voor kiezen toch in te loggen. In dat geval vraagt *Dienstverlener aanbieder* weer om credentials. |
## Implementatie van de usecase Abonneren
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. De*DVP Server* start de flow door in de *User Agent*van de *Persoon*de mogelijkheid te presenteren om zich bij een zekere *Aanbieder* te *Abonneren* op *Notificaties* voor een bepaalde *Gegevensdienst*. Het gaat altijd om precies één *Gegevensdienst*. Uit de *Aanbiederslijst* weet de *DVP Server* op welke *Gegevensdiensten* een *Aanbieder* *Abonnementen* aanbiedt worden. Desgewenst worden de *Gegevensdienstnamen* uit de *Gegevensdienstnamenlijst* gebruikt.
2. De *Persoon* maakt expliciet zijn selectie en laat de *User Agent* een abonneer-verzoek sturen naar de *Authorization Server*. Het adres van het authorization endpoint komt uit de *Aanbiederslijst*. De `redirect_uri` geeft aan waarnaartoe de *Authorization Server* de *User Agent*verderop moet redirecten (met de authorization code). Binnen het autorisatieproces valt ook het eerst mogelijke moment waarop de *Dienstverlener aanbieder* moet instaan dat voor de *Gegevensdienst*waartoe een verzoek behoort de *Aanbieder*de gezondheidsgegevens beschikbaar heeft.
3. Daarop begint de *Authorization Server* de OAuth-flow (in zijn rol als *OAuth Authorization Server*) door een sessie te creëren.
4. De *Dienstverlener aanbieder* laat de *Persoon* zich authenticeren en geeft autorisatie af aan de *Dienstverlener persoon*.
5. Nu is de *DVP Server* gereed om het verzoek tot vaststelling van het *Abonnement* naar de *Subscription Server*te sturen. Het adres van het subscription endpoint haalt hij uit de *Aanbiederslijst*. Hij plaatst het access-token in het bericht en zorgt ervoor dat in het bericht geen BSN is opgenomen.
6. De *Subscription Server* controleert of het ontvangen token recht geeft op het gevraagde *Abonnement*. Dan breekt het uiterste moment aan waarop de *Subscription Server* ervoor moet instaan dat voor de betreffende *Gegevensdienst* de *Aanbieder* de gezondheidsgegevens beschikbaar heeft. Is dat zo, dan verstuurt de *Subscription Server* deze ze in de subscription response naar de *DVP Server*. Is dat niet zo, dan breekt de *Subscription Server* de happy flow af.
7. De *Subscription Server* legt het *Abonnement* vast zodanig dat bij een optredende wijziging in de *Gegevensdienst* voor deze *Persoon* een *Notificatie* verstuurd kan worden (zie functie Notificeren).
8. De *DVP Server* legt het *Abonnement* vast het *Dossier*van de *Persoon*.
In de regel worden bij een eenmalig gebruik van de functie *Abonneren* het authorization interface, het token interface en het subscription interface allemaal aangesproken, in die volgorde. Mocht de *DVP Server* echter nog beschikken over een nog niet verlopen access-token voor de betreffende *Aanbieder*-*Gegevensdienst*-*Interfaceversie*-combinatie, dan kan het onmiddellijk het subscription interface aanspreken.
Bij de implementatie van de voorwaarde op beschikbaarheid bij de *Aanbieder* voor de te verzamelen gezondheidsgegevens is het zaak rekening te houden met privacy-vereisten. Wanneer de *Dienstverlener aanbieder* ten behoeve van de beschikbaarheidsvoorwaarde nieuwe gegevensverzamelingen zou aanleggen, vindt een verwerking altijd onder de verantwoordelijkheid van één *Aanbieder* plaats. Het combineren van verwerkingen of het onvoldoende segregeren moet worden vermeden. Afwijking hiervan is alleen mogelijk onder expliciete instructie van de *Aanbieder(s)* en vereist een zorgvuldige voorafgaande afweging, vanwege de daaraan verbonden privacyrisico's.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Achtergrond
Steeds meer mensen willen inzicht in hun gezondheid. MedMij zorgt ervoor dat iedereen die dat wil kan beschikken over zijn gezondheidsgegevens in een zelfgekozen persoonlijke gezondheidsomgeving. Bijvoorbeeld in een app of een website. Daarvoor moet zo'n app of site veilig kunnen communiceren met alle plekken waar de informatie opgeslagen staat. Denk aan ziekenhuis, de huisarts, het consultatiebureau en de apotheek. MedMij is dé Nederlandse standaard voor het veilig en betrouwbaar uitwisselen van gezondheidsgegevens tussen jou en gezondheidsprofessionals.
## De persoonlijke gezondheidsomgeving
MedMij hanteert de volgende definitie van een persoonlijke gezondheidsomgeving (PGO), zoals deze oorspronkelijk door de Patiëntenfederatie Nederland is geformuleerd:
> Een persoonlijk gezondheidsdossier (PGD):
>
> * Is een universeel toegankelijk, voor leken begrijpelijk, gebruiksvriendelijk en levenslang hulpmiddel om relevante gezondheidsinformatie te verzamelen, te beheren en te delen, en om regie te kunnen nemen over gezondheid en zorg en om zelfmanagement te ondersteunen via gestandaardiseerde gegevensverzamelingen voor gezondheidsinformatie en geïntegreerde digitale zorgdiensten.
> * Wordt beheerd en/of gedeeld door de patiënt of zijn wettelijke vertegenwoordiger.
> * Is op zo danige wijze beveiligd dat de vertrouwelijkheid van gezondheidsgegevens en de privacy van de gebruiker worden beschermd.
> * Is geen wettelijk medisch dossier, tenzij aldus gedefinieerd en daarom onderworpen aan wettelijke beperkingen.
>
> Bron: Bierma, L. \& Heldoorn, M. (2013), *[Het persoonlijk gezondheidsdossier - De visie van patiëntenfederatie NPCF](https://kennisbank.patientenfederatie.nl/app/answers/detail/a_id/1823/~/persoonlijke-gezondheidsomgeving/)*.
Een persoonlijke gezondheidsomgeving is daarmee een digitale omgeving die je in staat stelt om al je relevante gezondheidsgegevens, die verspreid staan opgeslagen bij professionals, zorginstellingen en overheden, overzichtelijk en veilig in te zien, aan te vullen met eigen metingen en te delen met wie je dat wilt. Inhoudelijke functionaliteiten, bijvoorbeeld in de vorm van digitale zorgdiensten, zijn optioneel en zullen per individu verschillen op basis van persoonlijke behoefte en situatie. Een persoon moet daarbij kunnen kiezen voor één persoonlijke gezondheidsomgeving en niet gedwongen worden meerdere omgevingen bij te houden.
Leveranciers van PGO's maken gebruik van informatie uit achterliggende systemen van aanbieders en kunnen via hun persoonlijke gezondheidsomgeving waarde toevoegen aan die gegevens met behulp van digitale zorgdiensten. Ook zullen er aanbieders van losse functionaliteiten zijn, zoals van mobiele apps die bijvoorbeeld medicatie reminders geven, die via het MedMij Afsprakenstelsel gegevens kunnen uitwisselen.
Grip op je eigen gezondheidsgegevens en toegang tot eHealth toepassingen stellen je in staat op je zelfgekozen manier aan je eigen gezondheid te werken en je zorgproces te laten ondersteunen.
## Wat zijn kenmerken van een goed afsprakenstelsel?
Om tot een goed afsprakenstelsel voor gegevensuitwisseling met PGO's te komen, is naar voorbeelden in andere sectoren gekeken waar afspraken zijn gemaakt die barrières rond vertrouwen en interoperabiliteit wegnemen, onder waarborging van collectieve belangen. De afspraken hebben een wisselende mate van vrijwilligheid; veelal zijn afspraken eerst ontstaan in een vrijwillig kader en later verplichtend opgelegd. In onder andere de rechtspraak, het financiële systeem en rond elektronische identiteiten is veel ervaring opgedaan met stelsels van samenhangende afspraken. Enkele gemeenschappelijke kenmerken komen in al deze sectoren terug en als uitgangspunt gediend voor het MedMij Afsprakenstelsel.
De afspraken richten zich vrijwel altijd op professionele partijen, vaak intermediairs die optreden namens burgers of consumenten. De burgers zelf worden in hoge mate ontzorgd. Er is vaak sprake van professionele partijen die de interactie tussen twee partijen bevorderen. Een debiteur en een crediteur, een gedaagde en een eiser of een webwinkel en een klant maken gebruik van dienstverleners die de ingewikkelde uitvoering van de gewenste interactie mogelijk maken. Geld overmaken is voor de betaler en de ontvanger relatief gemakkelijk; banken handelen het ingewikkelde betalingsverkeer af voor hun klanten. Dat geldt ook voor het starten van een juridische procedure; advocaten en andere spelers in het rechtssysteem hanteren complexe procedures die gericht zijn op het bereiken van doelen voor hun cliënten. In deze sectoren is sprake van zakelijke dienstverlening door professionele partijen die onderling in een ander spel verwikkeld zijn dan degenen die zij vertegenwoordigen. Ook bij PGO's is een dergelijk model van toepassing; het zijn immers niet de persoon en de aanbieder zelf die de daadwerkelijke informatie-uitwisseling op zich nemen, maar aanbieders van ict-oplossingen.
Afspraken die worden gemaakt in stelsels met intermediaire dienstverleners richten zich veelal op twee niveaus. Allereerst worden regels gesteld voor de relatie tussen de vertegenwoordiger (dienstverlener) en de vertegenwoordigde. Dit zijn tamelijk statische afspraken die zich richten op het waarborgen dat de vertegenwoordiger de belangen van de vertegenwoordigde voldoende kan dienen. Zij gaan over zaken als transparantie, het voorkomen van belangenverstrengeling, het voldoen aan professionele normen, klacht- en verhaalsmogelijkheden, de redelijkheid van commerciële bepalingen, vertrouwelijkheid en het kunnen overstappen naar concurrenten. Deze afspraken dragen bij aan het vertrouwen van de uiteindelijke gebruiker, die wordt gecompenseerd voor de kennisvoorsprong van de professionele dienstverlener. Het verlaagt ook de transactiekosten en draagt bij aan een gezonde mededinging.
Voor elk afsprakenstelsel geldt dat een goede besturing ervan op de inzet, doorontwikkeling, beheer en het controleren van de afspraken een randvoorwaarde is. Daarin dient een heldere vertegenwoordiging van de betrokken partijen geregeld te zijn en moet de inbreng en besluitvorming transparant en open toegankelijk zijn. Voor vertrouwen in het stelsel is duidelijk toezicht ook noodzakelijk. De overheid kan in de besturing en het toezicht verschillende rollen en mate van invloed uitoefenen.
## Doel en scope van het MedMij Afsprakenstelsel
Het MedMij Afsprakenstelsel draagt eraan bij dat persoonsgebonden, gevoelige en vertrouwelijke gegevens op een veilige en gebruiksvriendelijke wijze uitgewisseld kunnen worden tussen PGO's enerzijds en anderzijds aanbieders (in eerste instantie), overheden en andere partijen (in een latere fase) die over relevante gezondheidsgegevens beschikken. De uitwisseling geschiedt in twee richtingen; personen kunnen gegevens ophalen en delen.
MedMij streeft naar het realiseren van interoperabiliteit voor het uitwisselen van persoonlijke gezondheidsgegevens tussen PGO-gebruikers en aanbieders. Hiertoe wordt een afsprakenstelsel overeengekomen, bestaande uit afspraken op juridisch, organisatorisch, financieel, communicatief, semantisch en technisch gebied, zodat PGO-gebruikers en aanbieders op een veilige manier gegevens kunnen uitwisselen. Partijen die deelnemen aan het MedMij Afsprakenstelsel committeren zich aan de afspraken, en kunnen diensten aanbieden op basis van de reeds overeengekomen afspraken.
Het afsprakenstelsel gaat uit van *centraal vertrouwen en decentrale operatie*. Dit houdt in dat het afsprakenstelsel eisen stelt waar deelnemers zich aan moeten houden. Dat stichting MedMij controleert of de deelnemers aan deze eisen voldoen. De decentrale operatie betekent dat de daadwerkelijke gegevensuitwisseling, zonder tussenkomst van MedMij, tussen deelnemers plaatsvindt. Het afsprakenstelsel biedt waarborgen voor een faire omgang met de belangen van de verschillende stakeholders. Bij de uitwisseling van gegevens via het MedMij-netwerk wordt uitgegaan van decentrale voorzieningen, tenzij er alleen een centrale voorziening beschikbaar is.
## De waarde van het MedMij Afsprakenstelsel voor de persoon en zijn persoonlijke gezondheidsomgeving
Door een persoonlijke gezondheidsomgeving te gebruiken die het MedMij-label draagt, kan iemand erop vertrouwen, dat deze PGO deelneemt aan het MedMij-netwerk en op een veilige manier gegevens kan uitwisselen met aanbieders. Voorwaarden opgelegd vanuit het MedMij Afsprakenstelsel borgen dat een persoonlijke gezondheidsomgeving met het MedMij-label op een veilige manier omgaat met gegevens. Er kunnen dus apps of eHealth-toepassingen zijn die niet kunnen of mogen werken via het MedMij Afsprakenstelsel.
Een persoonlijke gezondheidsomgeving met het MedMij-label is een waarborg voor betrouwbare grip op je gezondheidsgegevens. MedMij zegt dus iets over integriteit, validiteit, actualiteit en interoperabiliteit, maar niet over de inhoudelijke functionaliteit van een PGO. Het gebruik van aanvullende functionaliteiten stelt mensen in staat om gezonder te leven en actiever bij te dragen aan een behandeling.
De inrichting van een persoonlijke gezondheidsomgeving zal net zo gepersonaliseerd zijn met aanvullende functionaliteiten als een smartphone dat is met apps. Mensen zullen zelf de functionaliteiten en apps gebruiken en kiezen die zij goed vinden. Op die manier wordt ingespeeld op de behoefte van de PGO-gebruiker via marktwerking. MedMij zegt om deze redenen niets over inhoudelijke functionaliteit en apps. Dat kan veranderen onder invloed van de verdere afspraken over hetgeen preconcurrentieel en/of standaard gegarandeerd moet zijn in het MedMij Afsprakenstelsel.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Addendum aanbieder zonder behandelrelatie
## Begrippenlijst
| Begrip | Domein | Definitie | Synoniemen |
|--------------------------|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| Aanbieder | Zorgaanbiedersdomein | Dit betreft een rol in dit Addendum welke gespeeld kan worden door organisaties die op persoonsniveau gezondheidsinformatie beschikbaar hebben. Zij hebben een wettelijke basis om het BSN te gebruiken, maar geen behandelrelatie in de zin van de WGBO met de zorggebruiker. Vooralsnog is ervoor gekozen de Aanbieder in het zorgaanbiedersdomein te laten vallen en gelden de eisen en verantwoordelijkheden die voor de Zorgaanbieder in het afsprakenstelsel zijn beschreven uitgezonderd hetgeen in dit Addendum beschreven. | brondossierhouder |
| Dienstverlener aanbieder | Zorgaanbiedersdomein | Dit betreft een rol in dit Addendum. De Dienstverlener aanbieder levert diensten aan de Aanbieder gerelateerd aan de uitwisseling tussen Persoon en Aanbieder en committeert zich hiervoor aan de naleving van de afspraken van het MedMij Afsprakenstelsel. De afspraken die gelden voor de Dienstverlener zorgaanbieder zijn op de Dienstverlener aanbieder van toepassing uitgezonderd hetgeen in dit Addendum beschreven. | |
## Inleiding
Het MedMij afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en zorgaanbieders wanneer de zorggebruiker met de betreffende zorgaanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren. Dit addendum maakt het mogelijk om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door *Aanbieders*zonder behandelrelatie te ondersteunen.
## Voorwaarden en toepasselijkheid
Dit addendum is van toepassing op organisaties die op persoonsniveau gezondheidsinformatie beschikbaar hebben en een wettelijke basis hebben het BSN te gebruiken, maar geen behandelrelatie hebben. Tevens is de *Aanbieder* een 'Afnemer DigiD' in de zin van artikel 1 [Besluit verwerking persoonsgegevens generieke digitale infrastructuur](https://wetten.overheid.nl/BWBR0037987/2018-07-28#:~:text=Besluit%20van%2017%20mei%202016%2C%20houdende%20regels%20betreffende,bij%20de%20gratie%20Gods%2C%20Koning%20der%20Nederlanden%2C%20). Hoewel het hier strikt genomen geen zorgaanbieders betreft, zullen deze aanbieders en hun dienstverleners, uitgezonderd hetgeen bepaald in dit addendum, wel zo worden behandeld op het MedMij netwerk. Het toelaten van deze aanbieders op het MedMij netwerk bevindt zich in een experimentele fase. Om in deze fase grip te houden op het aanbod van aanbieders mogen zij enkel op het MedMij netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij. MedMij behoudt zich het recht voor, toestemming te weigeren of in te trekken. De verwachting is dat in de toekomst de inhoud van dit addendum integraal onderdeel wordt van het afsprakenstelsel en dat daarmee deze voorwaardelijkheid komt te vervallen.
Enkel deelnemers die zijn toegelaten in de rol van *Dienstverlener zorgaanbieder* mogen de rol van *Dienstverlener aanbieder* vervullen. Acceptatie voor de rol *Dienstverlener zorgaanbieder* is tegelijkertijd een acceptatie voor de rol van *Dienstverlener aanbieder*.
## Juridische context
Op de *Aanbieder* is sectorspecifieke wetgeving van toepassing (de WGBO is bijvoorbeeld niet van toepassing). Een implicatie is dat er geen controle op behandelrelatie kan en hoeft plaats te vinden en dat de uitwisseling met DVP's als derdenverstrekking dient te worden gezien in het kader van de AVG. Het is aan *Aanbieder* en *Dienstverlener aanbieder*om te bepalen welke additionele wetgeving van toepassing is.
De *Aanbieder*als Gebruiker van Diensten van de *Dienstverlener aanbieder* van het MedMij Afsprakenstelsel 'verwerkingsverantwoordelijke' voor de verwerking van persoonsgegevens in de zin van de AVG. In het geval de *Aanbieder*als 'verwerkingsverantwoordelijke' de *Dienstverlener aanbieder* inschakelt om in opdracht van hem (bijzondere) persoonsgegevens met de Persoon (via het MedMij- netwerk) te verwerken, is de *Aanbieder*voor deze verwerking van persoonsgegevens verplicht een verwerkersovereenkomst met de *Dienstverlener aanbieder* af te sluiten. MedMij stelt hiervoor een [modelverwerksovereenkomst](https://afsprakenstelsel.medmij.nl/v23/archief/modelverwerkersovereenkomst-addendum.md)beschikbaar.
## Processen en informatie; beschikbaarheids- en ontvankelijkheidstoets
Aangezien er geen behandelrelatie bestaat tussen *Aanbieder* en *Persoon* vervalt de voorwaarde op een controle op de behandelrelatie.
## Applicatie; Interfaces; User interface (Autorisatieserver)
Vanaf versie 2.0.0 van het afsprakenstelsel zijn de schermen in de Core van het afsprakenstelsel dusdanig opgezet dat deze ook voor dit addendum gebruikt kunnen worden. Daarom bevat dit addendum geen vervangende schermen meer.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Afsprakenset
De afsprakenset draagt bij aan veilige, interoperabele en betrouwbare gegevensuitwisseling tussen persoonlijke gezondheidsomgevingen en informatiesystemen van aanbieders. Deze afspraken moeten partijen voldoende vertrouwen en mogelijkheden geven om de onderlinge gegevensuitwisseling in de praktijk tot stand te brengen. De afsprakenset is preconcurrentieel. De afspraken zijn tot stand gekomen in samenwerking met diverse partijen in de zorg, zoals softwareleveranciers, het ministerie van Volksgezondheid, Welzijn en Sport, Patiëntenfederatie Nederland en vertegenwoordigers van aanbieders, onder andere via werkgroepen op de onderwerpen informatiestandaarden, gegevensuitwisseling/architectuur, juridisch en governance. Partijen die deelnemen aan het MedMij Afsprakenstelsel committeren zich aan de afspraken.
Het is mogelijk om beoogd deelname aan het afsprakenstelsel kenbaar te maken middels een aanmelding tot kandidaat-deelnemer. Zie voor meer informatie hierover .
De structuur van het afsprakenstelsel is boven weergegeven. Van binnen naar buiten zien we:
* De *Architectuur en technische specificaties* vanuit het Regiemodel.
* De Core voor de verplichte onderdelen.
* *Extensies* voor de optionele onderdelen.
* De beschikbare domeinen, voor nu alleen het zorgdomein.
Dit geheel is omgeven door Grondslagen, Juridische Context, Normenkader en Beleid.
## Leeswijzer
Wet- en regelgeving vormen de belangrijkste kaders voor de afsprakenset. De set beschrijft alleen dat wat nog niet in wet- en regelgeving is vastgelegd en wat nodig is voor het vertrouwen en de interoperabiliteit van deelnemers in de onderlinge gegevensuitwisseling.
De documentatie van de afsprakenset is als volgt opgebouwd:
* [Releaseinfo](https://afsprakenstelsel.medmij.nl/v23/archief/releaseinfo.md)**:**Het hoofdstuk biedt meta-informatie over deze release van de afsprakenset.
* [Grondslagen](https://afsprakenstelsel.medmij.nl/v23/archief/grondslagen.md): Een beschrijving van de achtergrond, criteria aan, principes voor, opzet van en begrippenlijst binnen het afsprakenstelsel.
* [Juridische context](https://afsprakenstelsel.medmij.nl/v23/archief/juridische-context.md): Een uitwerking van de juridische analyses.
* [Architectuur en technische specificaties](https://afsprakenstelsel.medmij.nl/v23/archief/architectuur-en-technische-specificaties.md)**:**De architectuurbeschrijving geeft een overzicht van de vereisten aan en vormgeving van de gegevensuitwisseling via MedMij. Dit is vertaald in technische specificaties die deelnemers, aangesloten op het MedMij-netwerk, dienen te implementeren om te voldoen aan de afspraken.
* [Normenkader informatiebeveiliging](https://afsprakenstelsel.medmij.nl/v23/archief/normenkader-informatiebeveiliging.md)**:** Het Normenkader informatiebeveiliging beschrijft de maatregelen die deelnemers minimaal dienen te treffen op het gebied van privacy en informatiebeveiliging. Deze maatregelen verminderen mogelijke risico's en komen voort uit een risicoanalyse die jaarlijks stelselbreed wordt uitgevoerd.
* [Beleid](https://afsprakenstelsel.medmij.nl/v23/archief/beleid.md)**:** Het beleid gaat in op de vraag hoe Stichting MedMij omgaat met een aantal belangrijke besturingsthema's en vormt de basis voor de [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md). Het beleid is richtinggevend voor het optreden van Stichting MedMij en de uitvoeringsorganisaties. Het bevat tevens verantwoordelijkheden voor deelnemers.
* [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md)**:** Een beschrijving van belangrijkste de operationele beheerprocessen die deelnemers raken.
* [Communicatie](https://afsprakenstelsel.medmij.nl/v23/archief/communicatie.md)**:** Het onderdeel communicatie bevat richtlijnen voor de communicatie over MedMij vanuit de deelnemers. Het bestaat uit afspraken over het gebruik van het merk MedMij, verplichte gebruikersvoorlichting en de opzet van een verplicht te gebruiken toestemmings- en bevestigingsverklaring.
* [Managementinformatie](https://afsprakenstelsel.medmij.nl/v23/archief/managementinformatie.md)**:** Managementinformatie beschrijft de sturingsinformatie die deelnemers periodiek dienen aan te leveren bij de beheerorganisatie.
Alle lezers wordt aangeraden om, alvorens de afsprakenset te bestuderen, eerst kennis te nemen van de stelselbrede [Introductie](https://afsprakenstelsel.medmij.nl/v23/archief/introductie.md) en [Afsprakenstelsel in de praktijk](https://afsprakenstelsel.medmij.nl/v23/archief/afsprakenstelsel-in-de-praktijk.md) (release-onafhankelijk) en daarna van de context van voorliggende afsprakenset ([Grondslagen](https://afsprakenstelsel.medmij.nl/v23/archief/grondslagen.md) en het [Juridisch kader](https://afsprakenstelsel.medmij.nl/v23/archief/juridisch-kader.md)). Deze drie delen samen vormen een goed beeld van de achtergrond bij en de reikwijdte van het afsprakenstelsel. De [Architectuur en technische specificaties](https://afsprakenstelsel.medmij.nl/v23/archief/architectuur-en-technische-specificaties.md), het [Normenkader informatiebeveiliging](https://afsprakenstelsel.medmij.nl/v23/archief/normenkader-informatiebeveiliging.md), het [Beleid](https://afsprakenstelsel.medmij.nl/v23/archief/beleid.md), de [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md), de afspraken rond [Communicatie](https://afsprakenstelsel.medmij.nl/v23/archief/communicatie.md) en [Managementinformatie](https://afsprakenstelsel.medmij.nl/v23/archief/managementinformatie.md) beschrijven vervolgens per onderwerp de verschillende afspraken.
[](http://creativecommons.org/licenses/by-nd/4.0/)
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Afsprakenstelsel in de praktijk
## Het verhaal van Roos Dalstra
Hallo, ik ben Roos Dalstra, een vrouw van 54 jaar. Leuk dat jullie dit verhaal willen lezen over mijn ervaringen met MedMij, een afsprakenstelsel waar de leverancier van mijn persoonlijke gezondheidsomgeving aan deelneemt, zodat ik met die toepassing op een veilige manier mijn gezondheidsgegevens kan verzamelen bij en delen met zorgaanbieders. Zorgaanbieder is geen woord dat ik zelf gebruik. Ik heb het liever over Marlou en Evelien, mijn huisarts en haar praktijkondersteuner, en Ed, mijn apotheker.
Voor mijn behandeling helpt het enorm om informatie van bijvoorbeeld Ed te krijgen over de medicatie die hij aan me heeft verstrekt. Eerder voelde ik mij onzeker en had ik geen overzicht van de medicijnen die ik moest slikken. Gevoelsmatig had ik er geen grip op. Daarom wil ik mijn ervaringen graag met jullie delen, zodat ook jullie kennis kunnen maken met MedMij.
### Een persoonlijke gezondheidsomgeving
Al een aantal jaren heb ik diabetes en sinds kort maak ik gebruik van een persoonlijke gezondheidsomgeving. In mijn geval is dat een combinatie van een persoonlijk gezondheidsplatform en andere apps en apparaten die ik gebruik die op dit platform kunnen aansluiten. Zo heb ik mijn smartwatch, mijn weegschaal en mijn bloedglucosemeter aangesloten en maak ik gebruik van een diabetes-app waarin ik verschillende overzichten kan bekijken. Het persoonlijke gezondheidsplatform zorgt ervoor dat het allemaal mooi samen komt en ik heb een eigen dashboard om het allemaal te beheren. Hierin heb ik bijvoorbeeld geregeld dat mijn diabetesapp gebruik kan maken van de gegevens die ik van de zorgaanbieder heb ontvangen in het platform.
### Informatie uitwisselen met mijn huisarts
Ik was laatst in de huisartspraktijk voor controle door Evelien en zat in de wachtkamer te wachten totdat ik aan de beurt was. Mijn oog viel op een poster aan de wand met daarop de boodschap "Wij doen mee MedMij!' met daaronder de unieke naam van de praktijk die binnen de MedMij-gegevensuitwisseling wordt gehanteerd en die je kan gebruiken om de praktijk te vinden in de persoonlijke gezondheidsomgeving. Van MedMij had ik al gehoord. Mijn zoon Bart heeft me laatst namelijk geholpen om een persoonlijke gezondheidsomgeving te kiezen. "Dat is helemaal van deze tijd!", had hij gezegd. Daar stond toen ook MedMij bij.
"Mevrouw Dalstra". Het was Evelien die me kwam ophalen voor de controle. Ik zat nog helemaal met mijn gedachten bij de avond dat ik met Bart een persoonlijke gezondheidsomgeving heb uitgekozen. Ik weet nog dat hij me een app liet zien waarvan ik dacht: "Wat moet ik daar nou mee? Veel te ingewikkeld allemaal." Hij had toen gezegd: "Mam, geen probleem. Laten we gewoon online kijken welke gezondheidsomgeving bij jou past. Elke aanbieder die zich aan de MedMij-spelregels houdt, kan op een veilige manier gegevens uitwisselen met zorgaanbieders die ook via MedMij kunnen uitwisselen. Er is al aardig wat aanbod."
We zochten online en vonden een persoonlijke gezondheidsomgeving speciaal voor mensen met diabetes, die ook echt ondersteuning biedt bij de behandeling. "Wat handig!" dacht ik. Hij is trouwens ook eenvoudig in het gebruik, wel zo fijn. Ik ben af en toe echt een kluns met apps. De week daarna heb ik zelf een beetje gespeeld met het dashboard van de omgeving. Dat ging zo makkelijk. Ik heb het voor elkaar gekregen om de bloedwaarden uit mijn bloedglucosemeter in te laden. Echt handig! De overzichten die ik normaal altijd bij Evelien zie, kwamen er zo uitrollen.
Al lopend naar de kamer vroeg ik Evelien wat dat MedMij precies inhoudt. "Wat leuk dat je ernaar vraagt. Daarmee kunnen we alle informatie die we zo gaan vastleggen op een veilige en betrouwbare manier ook met jou delen. Heb je al een eigen gezondheidsomgeving?" reageerde Evelien gelijk heel enthousiast. "Ja, die heb ik laatst uitgezocht met mijn zoon, Bart. Dat is toevallig, nietwaar?" reageerde ik. Evelien lachte naar me. "Wat mooi," dacht ik, "dan kan ik alles wat we zo bespreken straks even rustig nalezen." Het stelde me meteen gerust.
Evelien vroeg of ik al informatie had vastgelegd in de omgeving. "Uuh, ja," stamelde ik en ik greep mijn telefoon om de bloedwaarden te laten zien. "Ik gebruik deze app om mijn bloedwaarden en gewicht zelf bij te houden," vertelde ik aan Evelien. "Wat goed. De bedoeling is dat je die informatie ook met mij kan gaan delen. Blijf daar dus vooral mee doorgaan."
Na onze afspraak liep Evelien snel even met me mee. Ze gaf mij een kaartje met een QR-code. Als ik die zou scannen kon ik snel en gemakkelijk de gegevens mijn huisartsgegevens ophalen in mijn persoonlijke gezondheidsomgeving oftewel PGO. Evelien zei: "De stappen spreken voor zich." Evelien liep weg. Ik besloot thuis rustig verder te kijken.
Eenmaal thuis scande ik de QR-code met mijn telefoon en zocht mijn PGO op via de website van Verbind.MedMij. Na het inloggen in mijn PGO moest ik inloggen met DigiD om mijn gegevens op te kunnen halen. DigiD kende ik al van de toeslagen bij de Belastingdienst. Na het inloggen met DigD kwam ik op een scherm, waar ik toestemming moest geven voor de gegevensuitwisseling tussen mijn huisarts en mijn PGO. Ik gaf toestemming.
### Informatie uitwisselen met mijn apotheek
Nadat ik mijn huisarts had toegevoegd, ging ik kijken wie ik nog meer kon toevoegen. Na de keuze om een contact toe te voegen, ging ik naar het zoekscherm om te zoeken naar de apotheek van Ed. Nadat ik was ingelogd en toestemming had gegeven, kwam de gegevensuitwisseling gelijk tot stand. En zo kon ik ook het ziekenhuis en mijn tandarts toevoegen. In de gebruiksvoorlichting die de leverancier van de persoonlijke gezondheidsomgeving toonde in een informatiepagina vond ik nog veel meer informatie over MedMij en waar ik goed op moest letten.
De toestemming voor de gegevensuitwisseling tussen mijn persoonlijke gezondheidsomgeving en het apothekerssysteem van Ed was de eerste stap om een overzicht te krijgen van de medicatie die ik via de apotheek heb ontvangen. Een actueel medicatieoverzicht heet dat in de omgeving. Eenmaal akkoord gegeven zag ik de medicatiegegevens binnenkomen in het medicatieoverzicht van de app. Dit overzicht had ik vanaf dat moment altijd beschikbaar binnen de app door hierop in te loggen met mijn vingerafdruk.
Iedere keer als ik medicijnen van een herhaalrecept of van een nieuw recept kreeg, werkte ik mijn medicatieoverzicht bij door de nieuwe gegevens binnen te halen. Toen dat een keer niet goed ging, nam ik contact op met de leverancier van de app via de contactgegevens die ik daarin vond. Deze hielp mij direct verder waardoor ik alsnog de nieuwste gegevens ontving.
Ik vond het zo leuk dat mijn medicatieoverzicht steeds werd bijgewerkt, dat ik het aan Ed vertelde. Hij reageerde gelijk ook heel enthousiast: "Handig hè, om al jouw medicatie-informatie op één plek te hebben?" "Wat ben jij goed op de hoogte," zei ik verbaasd tegen Ed. Hij begon te lachen en zei: "Ja, ik vind het interessant en ik ben vorige week naar een presentatie over dit onderwerp geweest." Hij wees me ook op de gebruikersvoorlichting die standaard wordt geleverd over het uitwisselen van gegevens via MedMij. "Als apotheker heb ik ook voorlichting mee gekregen van de leverancier van mijn informatiesysteem. Daarin staan veel goede tips en achtergronden", zei hij enthousiast.
Voortaan houd ik alles bij met mijn gezondheidsomgeving, ook wat ik wel en niet gebruik aan medicatie. Naast dat ik die informatie kan gaan delen met Evelien en Ed, heb ik er vooral zelf veel baat bij. Ik heb overal en altijd een actueel overzicht van wat ik aan medicatie verstrekt krijg en wat ik gebruik. Zeker in gesprekken met artsen is dat super. Ook de extra mogelijkheden die de omgeving me bieden, helpen me om meer grip te krijgen op mijn eigen gezondheid. Dat geeft me veel vertrouwen.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Architectuur en technische specificaties
## Inleiding
Een onmisbaar deel van het MedMij Afsprakenstelsel betreft de verantwoordelijkheden die de deelnemers in het afsprakenstelsel hebben, elk in zijn eigen rol, tijdens het feitelijk verzorgen van het informatieverkeer tussen het Persoonsdomein en het Zorgaanbiedersdomein.
Deze verantwoordelijkheden zijn opgenomen in de architectuur en de technische specificaties van het MedMij Afsprakenstelsel, die in deze pagina's uiteen worden gezet.
Vaak wordt er in de verantwoordelijkheden verwezen naar een specificatie. Dit kan een specifiek voor MedMij gespecificeerde usecase zijn, maar is vaak ook een standaard, vooral voor informatie. De specificatie zal niet in de verantwoordelijkheid zelf staan uitgeschreven; er zal naar verwezen worden.
De rollen en verantwoordelijkheden zijn om te beginnen bondig en stellig als regel geformuleerd. Pas in tweede instantie zijn ze voorzien van toelichting. De opzet is dus niet die van een verhalende uiteenzetting van het stelsel, maar die van een set afspraken, artikelsgewijs. Dat maakt de architectuur geschikt om als verlengstuk van de deelnemersovereenkomst te worden gebruikt. De allereerste vraag is: *Wat is de afspraak?* In tweede instantie spelen vragen als: *Waarom is hiervoor gekozen?* en *Wat betekent die afspraak?*
Waar in de beschrijving van de architectuur, de daarin bevatte rollen en verantwoordelijkheden en de toelichtingen daarop, met een naam wordt gerefereerd aan architectuurcomponenten, zoals die voorkomen bij het onderwerp horende diagrammen, wordt de naam *italiek* en met Beginkapitaal geschreven. Dat geldt ook voor de pad-expressies in de invarianten bij de [Informatiemodellen](https://afsprakenstelsel.medmij.nl/v23/archief/informatiemodellen.md). Variabelen in die pad-expressies staan ook *italiek*, maar beginnen met een kleine letter.
Sommige architectuurcomponenten worden ook vertegenwoordigd door een klasse, attribuut, element of type in de [Informatiemodellen](https://afsprakenstelsel.medmij.nl/v23/archief/informatiemodellen.md). Omdat de spelling van de namen in de [Informatiemodellen](https://afsprakenstelsel.medmij.nl/v23/archief/informatiemodellen.md) formeler is, kan de naamgeving daar iets afwijken van die in de rest van de architectuur, in het gebruik van spaties en hoofdletters. In de [Informatiemodellen](https://afsprakenstelsel.medmij.nl/v23/archief/informatiemodellen.md) beginnen alle namen met een hoofdletter. Midden in de namen verschijnen bovendien hoofdletters wanneer, en alleen wanneer, het daar resterende deel van de naam ook als aparte naam voorkomt.
Technische code-fragmenten worden in `monospace` geciteerd.
## MedMij Core, Extensies en Domeinen
MedMij is opgedeeld in de MedMij Core en MedMij Extensies. Domeinen gelden als aspecten over de Core en Extensies heen.
1. [MedMij Core](https://afsprakenstelsel.medmij.nl/v23/archief/medmij-core.md)
1. [Verzamelen, delen,](https://afsprakenstelsel.medmij.nl/v23/archief/medmij-core.md)[autoriseren](https://afsprakenstelsel.medmij.nl/v23/archief/autoriseren.md) en [authenticeren](https://afsprakenstelsel.medmij.nl/v23/archief/authenticeren.md)
2. [MedMij Extensies](https://afsprakenstelsel.medmij.nl/v23/archief/medmij-extensies.md)
1. [Abonneren](https://afsprakenstelsel.medmij.nl/v23/archief/medmij-extensies.md)
2. [Vertegenwoordiging](https://afsprakenstelsel.medmij.nl/v23/archief/extensie-vertegenwoordiging.md)
1. [Vrijwillige vertegenwoordiging](/v23/archief/rollen-vertegenwoordiging.md)
3. [MedMij Domeinen](https://afsprakenstelsel.medmij.nl/v23/archief/medmij-domeinen.md)
1. [Zorg](https://afsprakenstelsel.medmij.nl/v23/archief/zorg.md)
### Abstractieniveaus
De onderwerpen worden beschreven volgens de basislagen van een architectuur.
#### Business
Om te beginnen moeten deelnemers er samen voor zorgen dat zich zekere bedrijfsprocessen voltrekken tussen het Persoonsdomein en het Zorgaanbiedersdomein. Deze bedrijfsprocessen gaan vooral over het verzamelen en delen van gezondheidsinformatie. Op dit abstractieniveau is nog geen sprake van geautomatiseerde afhandeling van deze processen, maar zijn de verantwoordelijkheden enkel nog geformuleerd in termen van de inhoud van die processen en van de gezondheidsinformatie die daarin omgaat.
#### Applicatie
Op het volgende abstractieniveau, de applicatielaag, komt ter sprake dat, en hoe, deze bedrijfsprocessen met de erin omgaande gezondheidsinformatie, geautomatiseerd moeten worden uitgevoerd, in samenwerking tussen de rollen. Het is de meest complexe laag.
#### Technologie
Op het onderste abstractieniveau, de technologielaag, zijn de verantwoordelijkheden opgenomen op het gebied van de netwerkinfrastructuur. Hierbij worden de verschillende generieke type nodes beschreven.
## Informatiemodellen
Een aparte pagina [Informatiemodellen](https://afsprakenstelsel.medmij.nl/v23/archief/informatiemodellen.md), met drie subpagina's, specificeert de conceptuele structuur van (een deel van) het begrippenapparaat van de architectuur van het MedMij Afsprakenstelsel en vertaalt die via logische modellen naar technische modellen van enkele componenten. Zo wordt tot op technisch niveau de interoperabiliteit op het MedMij-netwerk geborgd.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Authenticeren
## Inleiding
Op deze pagina staan de diagrammen behorende bij de functie *Authenticeren* . De diagrammen tonen alleen de situatie waarin alle acties slagen tot en met dat de *Persoon*zich heeft laten authenticeren (de zogenaamde happy flow). De oranje banen horen (conform de MedMij-huisstijl) tot het Persoonsdomein, de blauwe tot het Aanbiedersdomein en de grijze tot externe domeinen.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de genoemde rollen.
* De *Dienstverlener aanbieder* laat de *Persoon*zich authenticeren.
* Wanneer de *Persoon* de authenticatie heeft afgebroken toont de *Dienstverlener aanbieder* de Persoon een scherm met de melding dat het authenticatieproces is afgebroken door de Persoon. De [*Dienstverlener aanbieder*](https://vzvz.atlassian.net/wiki/display/medmijafsprakenstelsel150/Rollen%2C+Core#Rollen,Core-Dienstverleneraanbieder) biedt hierna de mogelijkheid alsnog te authentiseren of de flow af te breken.
### Uitzonderingen op de Happy flow van de functie Authenticeren
In onderstaande tabel staan de uitzonderingssituaties beschreven. Alle worden door de *Dienstverlener aanbieder* ontdekt.
| **nr.** | **uitzondering** | **actie** | **vervolg** |
|-----------------|---------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Authenticeren 1 | *Dienstverlener aanbieder* kan de identiteit van de *Persoon* niet vaststellen. | *Dienstverlener aanbieder* informeert *persoon* dat verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Authenticeren 2 | *Persoon* annuleert het inloggen. | *Dienstverlener aanbieder* presenteert een annuleringspagina met de melding waaruit op te maken valt dat het authenticatieproces is afgebroken door de Persoon en biedt *Persoon* de optie om toch in te loggen. | Indien *Persoon* kiest niet in te willen loggen, kan het scherm gesloten worden. Hiermee wordt de flow gestopt. *Persoon* kan er ook voor kiezen toch in te loggen. In dat geval vraagt *Dienstverlener aanbieder* weer om credentials. |
## Applicatielaag
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. de *User Agent* stuurt een authorization request naar de *Authorization Server* . Het adres van het authorization endpoint komt uit de *Aanbiederslijst* . De `redirect_uri` geeft aan waarnaartoe de *Authorization Server* de *User Agent* verderop moet redirecten (met de authorization code). Het authorization request mag desgewenst, onder voorwaarden, meerdere *Gegevensdiensten* van de *Aanbieder*bevatten.
2. Daarop begint de *Authorization Server* de OAuth-flow (in zijn rol als *OAuth Authorization Server*) door een sessie te creëren.
3. De *DVAuthn* toont de *Persoon* een inlogpagina voor de authenticatie.
4. De *Authorization Server* vraagt de *Persoon* via zijn *User Agent* om credentials.
5. Dan start de *Authorization Server* (nu in de rol van *Authentication Client* ) de authenticatieflow door de *User Agent* naar de *Authentication Server* te redirecten, onder meegeven van een `redirect_uri`, die aangeeft waarnaartoe de *Authentication Server* straks de *User Agent* moet terugsturen, na het inloggen van de *Persoon*.
6. De *Authentication Server* vraagt de *Persoon* via zijn *User Agent* om inloggegevens.
7. Wanneer deze juist zijn, redirect de *Authentication Server* de *User Agent*terug naar de *Authorization Server*, onder meegeven van een ophaalbewijs. Wanneer het inloggen is afgebroken toont de *Authorization Server* de *Persoon*de melding waaruit op te maken valt dat het authenticatieproces is afgebroken en biedt hetalsnog de mogelijkheid via zijn *User Agent* in te loggen.
8. Met dit ophaalbewijs haalt de *Authorization Server* rechtstreeks bij de *Authentication Server* het BSN op.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Authenticeren voor Vertegenwoordiging
## Inleiding
De functie *Authenticeren voor Vertegenwoordiging* is een afgeleide van de functie *Authenticeren* , die in de *Core* staat beschreven. Een groot gedeelte van de functie *Authenticeren* geldt ook voor de functie *Authenticeren voor Vertegenwoordiging* . Alleen de wijzigingen op de originele functie staan beschreven. De diagrammen tonen alleen de situatie waarin alle acties slagen (de zogenaamde happy flow). De oranje elementen horen (conform de MedMij-huisstijl) tot het Persoonsdomein, de blauwe tot het *Aanbiedersdomein*, de grijze tot het externe domein. Alleen de gewijzigde of nieuwe elementen zijn volledig zichtbaar.
## Businesslaag
Hieronder staat de authenticatieflow beschreven, die geldig is voor de functie *Vertegenwoordiging*.
De wijzigingen richten zich volledig op het toevoegen van de functie *Vertegenwoordiging*. De totale procesgang van de functie *Authenticeren voor Vertegenwoordiging* kent de volgende stappen:
* De *Dienstverlener aanbieder* ontvangt van de *Dienstverlener Persoon* een verzoek tot verzamelen op basis van vrijwillige *Vertegenwoordiging* of op basis van *Vertegenwoordiging* op grond van het ouderlijk gezag.
* De *Dienstverlener aanbieder* start de authenticatieflow voor vrijwillige *Vertegenwoordiging*, of start de authenticatieflow voor *Vertegenwoordiging* op grond van het ouderlijk gezag.
* De *Dienstverlener aanbieder* vraagt de *Dienstverlener authenticatie* de *Persoon* te authenticeren.
* De *Dienstverlener authenticatie* laat de *Persoon* inloggen en controleert de gegevens.
* De *Dienstverlener authenticatie* presenteert een lijst van *Vertegenwoordigden* waaruit de *Persoon* er één kiest.
* De *Dienstverlener authenticatie* geeft een authenticatieverklaring uit. Deze bevat identificerende gegevens van *Vertegenwoordigde* en *Vertegenwoordiger*.
* De *Dienstverlener Aanbieder* controleert de authenticatieverklaring op het gebruik van vertegenwoordiging en gaat verder in het proces.
### Uitzonderingen op de Happy flow van de functie Authenticeren voor Vertegenwoordiging
In onderstaande tabel staan de uitzonderingssituaties beschreven die als uitbreiding gelden voor de uitzondering op de functie *Authenticeren*.
| **nr.** | **uitzondering** | **actie** | **vervolg** |
|------------------------------------|----------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
| Authenticeren Vertegenwoordiging 1 | *Dienstverlener aanbieder* kan de identiteit van de *Vertegenwoordigde* niet met voldoende zekerheid vast (laten) stellen. | *Dienstverlener aanbieder* informeert eerst de *Persoon* en daarna *Dienstverlener persoon* dat het verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Authenticeren Vertegenwoordiging 2 | *Dienstverlener aanbieder* kan de machtiging niet vast (laten) stellen | *Dienstverlener aanbieder* informeert eerst de *Persoon* en daarna *Dienstverlener persoon* dat het verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
## Applicatielaag
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
De flow van de functie *Authenticeren*kent voor *Vertegenwoordiging*de volgende wijzigingen:
1. De *Dienstverlener aanbieder* ontvangt van de *Dienstverlener Persoon* een verzoek tot verzamelen op basis van vrijwillige *Vertegenwoordiging* of op basis van *Vertegenwoordiging* op grond van het ouderlijk gezag.
1. Wanneer de *Dienstverlener aanbieder* een verzoek tot verzamelen op basis van een vrijwillige *Vertegenwoordiging* ontvangt, vraagt de *Dienstverlener aanbieder* de *Dienstverlener authenticatie*, de authenticatie flow te starten voor *Vertegenwoordiging* op basis van een vrijwillige machtiging. De scope van het authorization request bevat de letterlijke waarde 'onbehalfof'.
2. Wanneer de *Dienstverlener aanbieder* een verzoek tot verzamelen op basis van *Vertegenwoordiging* op grond van het ouderlijk gezag ontvangt, vraagt de *Dienstverlener aanbieder* de *Dienstverlener authenticatie*, de authenticatie flow te starten voor *Vertegenwoordiging* op basis van het ouderlijk gezag. De scope van het authorization request bevat de letterlijke waarde 'onbehalfofchild'.
2. De *DVAuthn* toont de *Persoon* een inlogpagina voor de authenticatie.
3. Nadat de credentials van de *Persoon* zijn gevalideerd, worden de bij de *Persoon* behorende *Vertegenwoordigden* gepresenteerd.
4. De *Persoon* kiest één van de *Vertegenwoordigden* en maak dit kenbaar aan de *Authentication server*.
5. Voor het uitgeven van een authenticatieverklaring voegt de *Authentication server* hieraan de identificerende gegevens (BSN) van de *Vertegenwoordigde* en *Vertegenwoordiger* toe.
6. De *Authorization server* valideert of in de authenticatieverklaring de identificerende gegevens staan van de *Vertegenwoordigde* en *Vertegenwoordiger*:
1. De *Authorization server* stelt vast dat op de juiste manier gebruikgemaakt is van vrijwillige *Vertegenwoordiging*of van *Vertegenwoordigin*g op grond van het ouderlijk gezag. *Authorization server* gaat verder met de flow.
2. De *Authorization server* stelt vast dat geen gebruikgemaakt is van vrijwillige *Vertegenwoordiging*of van *Vertegenwoordiging* op grond van het ouderlijk gezag, of niet op de juiste manier. *Authorization server* stopt de flow onmiddellijk.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Authorization interface
De authorization interface hoort bij de hoofdfunctie [*Regie*](https://afsprakenstelsel.medmij.nl/v23/archief/coordinatie-regie-en-uitwisseling.md).
Op deze pagina staan alleen de verantwoordelijkheden inzake de authorization interface die nog niet genoemd staan in de [OAuth 2-specificatie](https://tools.ietf.org/html/rfc6749).
|---|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
| 1 | De [*OAuth Client*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md) voegt bij het versturen van een Authorization request twee `HTTP query parameters `toe, de eerste met de naam `MedMij-Request-ID`, de tweede met de naam `X``-Correlation-ID`. Het `MedMij-Request-ID` moet een willekeurige waarde bevatten en dient uniek te zijn voor ieder request binnen het MedMij netwerk. De waarde bestaat uit een UUID. Het `X``-Correlation-ID` moet een willekeurige waarde bevatten en dient uniek te zijn voor ieder authorization request binnen het MedMij netwerk. De waarde bestaat uit een UUID. | core.authint.208 |
| 2 | De onderstaande parameters in de authorization request zijn verplicht en moeten als volgt gevuld worden. | parameter | vulling | toelichting | |---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `response_type` | letterlijke waarde `code` | Dit is het gevolg van verantwoordelijkheid [core.autorisatie.201](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.autorisatie.201). | | `client_id` | de hostname, die in de *OAuth Client List* is opgenomen, van de *Node* van de [OAuth Client](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthClient) die de authorization request doet | | | `redirect_uri` | 1. zodanig dat de erin opgenomen hostname gelijk is aan de `client_id` en er geen poortnummer is opgenomen 2. de `redirect_uri` moet volledig zijn en verwijzen naar een `https`-beschermd endpoint 3. de redirect_uri moet urlencoded zijn (conform [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986)) | Zie verantwoordelijkheden [core.adressering.200](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.adressering.200), [core.adressering.201](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.adressering.201) en [core.adressering.202](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.adressering.202). De tweede eis is een maatregel tegen beveiligingsrisico's [4.1.5](https://tools.ietf.org/html/rfc6819#section-4.1.5), [4.2.4](https://tools.ietf.org/html/rfc6819#section-4.2.4), [4.4.1.1](https://tools.ietf.org/html/rfc6819#section-4.4.1.1), [4.4.1.5](https://tools.ietf.org/html/rfc6819#section-4.4.1.5) en [4.4.1.6](https://tools.ietf.org/html/rfc6819#section-4.4.1.6) in RFC 6819. Zie bovendien [Token interface](https://afsprakenstelsel.medmij.nl/v23/archief/token-interface.md), de toelichting onder verantwoordelijkheid 4. | | `scope` | Voor "verzamelen": * MedMij-naam van de Aanbieder Voor "delen": * één aanbieder-gegevensdienst-combinatie. Een aanbieder-gegevensdienst-combinatie bestaat uit: * één *Aanbiedernaam* , ontdaan van de suffix `@medmij` * gevolgd door een tilde (`~`) * gevolgd door één *GegevensdienstId* van een *Gegevensdienst* uit de *Gegevensdienstnamenlijst.* | Er worden geen andere scopes of onderdelen van scopes opgenomen dan de genoemde. Voorbeelden van syntactisch juiste scopes zijn: Verzamelen: * `"eenofanderezorgaanbieder"`, voor het uitwisselen van gegevens met `eenofanderezorgaanbieder@medmij`; Delen: * `"eenofanderezorgaanbieder~53"`, voor het eenmalig afnemen van *Gegevensdienst* `53` bij `eenofanderezorgaanbieder@medmij`; | | `state` | 1. conform [sectie 4.1.1. van RFC 6749](https://tools.ietf.org/html/rfc6749#section-4.1.1). | Hiermee geeft de [OAuth Client](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthClient) informatie mee aan de[OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer), waaraan eerstgenoemde later, bij de redirect, kan afleiden bij welk verzoek de authorization code hoort. Deze informatie is verder betekenisloos voor de [*OAuth* *Authorization Server*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer). De state MOET * een minimale lengte hebben van 128 karakters (Voldoende lang om niet raadbaar te zijn). * een maximale lengte hebben van 512 karakters (Praktische grens, rekening houdend met standaard libraries en maximale lengte uri's). | | `MedMij-Request-ID` | De waarde bestaat uit een UUID. | Het `MedMij-Request-ID` moet een willekeurige waarde bevatten en dient uniek te zijn voor ieder request binnen het MedMij netwerk. | | `X-Correlation-ID` | De waarde bestaat uit een UUID. | Het `X-Correlation-ID` moet een willekeurige waarde bevatten en dient uniek te zijn voor ieder authorization request binnen het MedMij netwerk. | Het onderstaande voorbeeld dient als toelichting hoe het authorization request opgevuld zou moeten worden in het geval van de functie Verzamelen: Authorisatie interface TYPE REQUEST: GET https://authorization-server.com/auth?response_type=code &client_id= medmij.deenigeechtepgo.nl &redirect_uri= https://medmij.deenigeechtepgo.nl &scope=eenofanderezorgaanbieder &state=xcoivjuywkdkhvusuye3kch &MedMij-Request-ID=57510be1-73e6-4a75-9db8-ee005cced48f &X-Correlation-ID=c0e7b545-9606-4eef-bea7-75d8addaa54b In het geval van de functie Delen verandert de scope naar: &scope=eenofanderezorgaanbieder~53 Conform de [OAuth 2- specificatie](https://tools.ietf.org/html/rfc6749#page-19)moeten overige parameters die meegestuurd worden in het request genegeerd worden. | core.authint.200 |
| 3 | De [OAuth Client](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthClient) zorgt ervoor dat voor het authorization request de http-methode `GET` wordt gebruikt, niet `POST`. Toelichting In de [OAuth-specificatie, sectie 3.1](https://tools.ietf.org/html/rfc6749#page-18) wordt de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) verplicht gesteld `GET` te accepteren en wordt `POST` optioneel gehouden. Omdat `GET` de verreweg meest in het MedMij Afsprakenstelsel passende http-methode is voor de authorization request, geldt, om de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) niet voor onnodige implementatiekosten te plaatsen, deze verantwoordelijkheid. Hoewel deze verantwoordelijkheid een verantwoordelijkheid van de [OAuth Client](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthClient) is, omdat deze onder de verantwoordelijkheid van een MedMij-deelnemer valt, wordt de request uiteindelijk door de [*User Agent*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-UserAgent) uitgevoerd. | core.authint.201 |
| 4 | Na ontvangst van een authorization request verifieert de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) dat: * de betreffende `client_id` voorkomt op de *OAuth Client List*; * de `redirect_uri` geldig is en voorkomt bij de betreffende `client_id` op de *OAuth Client List.* Als een van deze verificaties niet slaagt dan behandelt de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) dit als uitzondering 1a volgens verantwoordelijkheid [core.authint.207](https://medmij.atlassian.net/wiki/pages/viewpage.action?pageId=230529407). | core.authint.202 |
| 5 | Vervolgens verifieert de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md) dat: * bij de functie Verzamelen: * zij namens deze Aanbieder, voor de gehanteerde Interfaceversie, Gegevensdienst(en) ontsluit, in overeenstemming met de gepubliceerde Aanbiederslijst; * bij de functie Delen: * de gevraagde GegevensdienstId voor komt op de OAuth Client List, bij de betreffende client_id en voor de gehanteerde Interfaceversie; * de Gegevensdienst betrekking heeft op de functie Delen; * de hostnames van de AuthorizationEndpoints, waarop de Gegevensdienst wordt aangeboden, met elkaar overeenkomen; * de hostnames van de TokenEndpoints, waarop de Gegevensdienst wordt aangeboden, met elkaar overeenkomen. Als een van deze verificaties niet slaagt dan behandelt de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md) dit als uitzondering 1b volgens verantwoordelijkheid [core.authint.207](https://medmij.atlassian.net/wiki/pages/viewpage.action?pageId=230529407). Toelichting Zo voorkomt de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md) dat gevolg wordt gegeven aan een verzoek dat blijkens de *OAuth Client List* of *Aanbiederslijst* niet is toegestaan. | core.authint.203 |
| 6 | Tijdens de afhandeling van een authorization request laat de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)*,* in zijn rol als *Authentication Client* , voordat hij de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)om OAuth-autorisatie vraagt, de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) authenticeren door de [Authentication Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthenticationServer). Toelichting Conform [stroomdiagram](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md) onder 1. De [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder)in het Aanbiedersdomein, en dus BSN-domein, is verplicht bij het verstrekken van gegevens vanuit een gezondheidsdossier de identiteit van de persoon te verifiëren aan de hand van het BSN. *** ** * ** *** Het MedMij Afsprakenstelsel brengt het gebruik van de [Authentication Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthenticationServer) onder in de OAuth-flow, onder operationele verantwoordelijkheid van de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer). Laatstgenoemde handelt in dezen onder verantwoordelijkheid van individuele [Aanbieders](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder), want die zijn het waarvoor de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) zich authenticeert. De directe interactie van de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) met de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) is bedoeld om de [*DVP Server*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) te autoriseren om de [*Resource Server*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-ResourceServer) aan te spreken. Die levert de uiteindelijke *Gegevensdienst* pas. | core.authint.204 |
| 7 | Onmiddellijk na authenticatie van de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon), zoals bedoeld in verantwoordelijkheid [Authorization interface#core.authint.204](https://medmij.atlassian.net/wiki/pages/viewpage.action?pageId=230529407), en alleen als deze slaagt, vraagt de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)om een [*Toestemmingsverklaring*](https://vzvz.atlassian.net/wiki/spaces/MMAS2MIG/pages/1364493401/Toestemmingsverklaring+Core)(in het geval van [*Verzamele*n](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)) of een [*Bevestigingsverklaring*](https://vzvz.atlassian.net/wiki/spaces/MMAS2MIG/pages/1364493228/Bevestigingsverklaring+Delen+Core) (in het geval van [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)), volgens het daaromtrent bepaalde op de pagina [User interface (Autorisatieserver)](https://afsprakenstelsel.medmij.nl/v23/archief/schermen-user-interface-core.md), volgens de standaard [OAuth 2.0](https://tools.ietf.org/html/rfc6749), op de wijze waarop deze in het MedMij Afsprakenstelsel wordt toegepast. | core.authint.205 |
| 8 | Voorafgaand aan uitgifte van een authorization code via de in de authorization request opgenomen `redirect_uri`, administreert de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) die authorization code en de daarvoor gebruikte `redirect_uri`. Toelichting Dit is een maatregel tegen beveiligingsrisico's [4.4.1.3](https://tools.ietf.org/html/rfc6819#section-4.4.1.3), [4.4.1.5](https://tools.ietf.org/html/rfc6819#section-4.4.1.5) en [4.4.1.7](https://tools.ietf.org/html/rfc6819#section-4.4.1.7) uit RFC 6819 (zie verantwoordelijkheid [core.beveiliging.205](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.beveiliging.205)). Zie ook verantwoordelijkheid [core.tknint.206](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.tknint.206). | core.authint.206 |
| 9 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) en [*DVP Server*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) behandelen uitzonderingssituaties inzake het authorization interface af volgens onderstaande tabel. | Nummer | Implementeert uitzonderingen | Uitzondering | Actie | Melding | Vervolg | |----------------------------|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Authorization interface 1a | Verzamelen 1 Delen 1 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)*ontvangt een authorization request zonder (geldige)* *redirect_uri**en/of zonder een (geldige)* *client_id**.* | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)*informeert de Persoon over de technische fout, zonder de Persoon automatisch te redirecten.* | conform [OAuth 2.0-RFC 6749](https://tools.ietf.org/html/rfc6749#page-27), par. 4.1.2.1 | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | | Authorization interface 1b | Verzamelen 1 Delen 1 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) ontvangt een ongeldige authorization request, anders dan uitzondering 1. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over de technische fout. [*DVP Server*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) informeert [*Persoon*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon). | conform OAuth2.0-specificatie, [par. 4.1.2.1](https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc6749%23page-27&data=05%7C02%7Cafsprakenstelsel%40medmij.nl%7C8fc460041f43418d87eb08dc473145dc%7C72c2d0dba1e34b1691a167936a5cf3bf%7C1%7C0%7C638463525763457074%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C0%7C%7C%7C&sdata=M%2BVou7jJo4sNS0LFdqT3fkewG8HAY4HJus2vfgbo%2B6E%3D&reserved=0), een 'invalid request' of een zo specifiek mogelijke, toepasselijke error code. | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | | Authorization interface 2 | Authenticeren 1 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) kan de identiteit van de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) niet vaststellen. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)informeert de Persoon dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | | Authorization interface 3 | Autoriseren 1 Verzamelen 2 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) stelt tijdens de afhandeling van de authorization request vast dat: * in geval van de functie [Verzamelen](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md): van [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) bij [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder)voor geen van de gevraagde *Gegevensdiensten*gezondheidsinformatie beschikbaar is; * in geval van de functie [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md): [*Aanbieder*](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder) niet ontvankelijk is voor die *Gegevensdienst* van [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)*;* Zie de toelichting op [Beschikbaarheids- en ontvankelijkheidsvoorwaarde](https://afsprakenstelsel.medmij.nl/v23/archief/functies-en-gegevens-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Functiesengegevens,Core-Beschikbaarheids-enontvankelijkheidsvoorwaarde). | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)informeert de Persoon dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | | Authorization interface 4 | Autoriseren 2 | De autorisatievraag wordt ontkennend beantwoord. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over deze uitzondering. [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer)informeert daarop [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) hierover. | conform [OAuth 2.0-specificatie, par. 4.1.2.1](https://datatracker.ietf.org/doc/html/rfc6749#page-27) , error `access denied`, met in de error description "`Access denied`." | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | | Authorization interface 5 | Autoriseren 3 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) kan de autorisatie niet vaststellen. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over deze uitzondering. [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer)informeert daarop [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) hierover. | conform [OAuth 2.0-specificatie](https://tools.ietf.org/html/rfc6749#page-27), par. 4.1.2.1, error code `access denied`, met in de error description "`Authorization failed.`" | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[*Delen*](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md) onmiddellijk nadat de Persoon geïnformeerd is over de uitzondering. | Toelichting De uitzonderingssituaties kunnen gezien worden als de implementatie-tegenhangers van de uitzonderingen van de functies [Verzamelen](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md) en [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md). Op de Applicatielaag zijn deze echter per interface geordend. Alle uitzonderingen worden door de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) ontdekt. In deze versie van het MedMij Afsprakenstelsel is bepaald dat zij altijd leiden tot het zo snel mogelijk afbreken van de flow door alle betrokken rollen. Daartoe moeten echter eerst nog de andere rollen geïnformeerd worden. Om te voorkomen dat de [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) informatie over het bestaan van behandelrelaties verkrijgt zonder dat daarvoor (al) toestemming is gegeven, moet het onderscheid tussen de uitzonderingen 2, 3 en 4 niet te maken zijn door de [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer). Deze tabel bevat alleen die uitzonderingssituaties ten aanzien waarvan het MedMij afsprakenstelsel eigen eisen stelt aan de implementatie. In de [specificatie van OAuth 2.0](https://tools.ietf.org/html/rfc6749) staan daarnaast nog generiekere uitzonderingssituaties, zoals de situatie waarin de redirect URI ongeldig blijkt. Ook deze uitzonderingssituaties moeten geïmplementeerd worden. | core.authint.207 |
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Authorization interface, Abonneren
De authorization interface hoort bij de hoofdfunctie [*Regie*](https://afsprakenstelsel.medmij.nl/v23/archief/coordinatie-regie-en-uitwisseling.md).
Op deze pagina staan alleen de verantwoordelijkheden inzake de authorization interface die nog niet genoemd staan in de [OAuth 2-specificatie](https://tools.ietf.org/html/rfc6749). Deze verantwoordelijkheden vormen een uitbreiding op de al geldende verantwoordelijkheden voor de [Authorization interface vanuit de MedMij Core](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md).
|----|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------|
| 1. | De parameters in de authorization request worden als volgt gevuld: | parameter | vulling | toelichting | |-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `scope` | Voor "abonneren": * de letterlijke waarde `subscribe` * gevolgd door een tilde `~` * gevolgd door een niet-negatief geheel getal, aangevende de gevraagde maximale duur van het *Abonnement* * gevolgd door een forward slash `/` * gevolgd door één aanbieder-gegevensdienst-combinatie. Een aanbieder-gegevensdienst-combinatie bestaat uit: * één *Aanbiedernaam*, ontdaan van de suffix `@medmij` * gevolgd door een tilde (`~`) * gevolgd door één *GegevensdienstId*van een *Gegevensdienst* uit de *Gegevensdienstnamenlijst.* | Er worden geen andere scopes of onderdelen van scopes opgenomen dan de genoemde. Voorbeelden van syntactisch juiste scopes zijn: * `"subscribe~180/eenofanderezorgaanbieder~42"`, voor het aangaan van een *Abonnement* op *Gegevensdienst* `42` bij `eenofanderezorgaanbieder@medmij` van maximaal 180 dagen, of het aanpassen van het *Abonnement* op *Gegevensdienst* 42 bij `eenofanderezorgaanbieder@medmij` naar maximaal 180 dagen vanaf vandaag; * `"subscribe~0/eenofanderezorgaanbieder~42"`, voor het beëindigen van het *Abonnement* op *Gegevensdienst* `42` bij `eenofanderezorgaanbieder@medmij`. | Bovenstaande tabel is een uitbreiding op de tabel die is weergegeven in [core.authint.200](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.200) | ext.abo.authint.200 |
| 2. | Vervolgens verifieert de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) dat: * de gevraagde *GegevensdienstId* voorkomt op de *OAuth Client List,*bij de betreffende `client_id` en voor de gehanteerde *Interfaceversie*; * zij namens deze [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder), voor de gehanteerde *Interfaceversie*, deze *Gegevensdienst* ontsluit, in overeenstemming met de gepubliceerde *Aanbiederslijst*; * indien in de scope ook `subscribe` voorkomt (in geval van de functie Abonneren is dit verplicht): * de scope slechts één *GegevensdienstId* bevat; * bij de betreffende `client_id` en *Gegevensdienst* op de *OAuth Client List* ook een subscription notification endpoint en een resource notification endpoint voorkomen; * zij namens deze [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder) ook *Abonnementen* op deze *Gegevensdienst* ontsluit; * de waarde van de duur parameter in het request de waarde heeft van `0` of een waarde groter dan `0` die kleiner of gelijk is aan de maximale duur van het *Abonnement* zoals de betreffende [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder) deze aanbiedt. Als een van deze verificaties niet slaagt dan behandelt de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) dit als uitzondering 1b volgens verantwoordelijkheid [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.authint.207). Toelichting Zo voorkomt de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) dat gevolg wordt gegeven aan een verzoek dat blijkens de *OAuth Client List* of *Aanbiederslijst* niet is toegestaan. Dit geldt als uitbreiding op de verantwoordelijkheid zoals beschreven in [core.authint.203](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.authint.203). | ext.abo.authint.201 |
| 3. | Onmiddellijk na authenticatie van de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon), zoals bedoeld in verantwoordelijkheid [core.authint.204](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.authint.204), en alleen als deze slaagt, vraagt de [OAuth Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-OAuthAuthorizationServer) de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)om een [Toestemmingsverklaring](https://medmij.atlassian.net/wiki/display/MMOptioneel/Toestemmingsverklaring) (in het geval van [*Verzamele*n](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md) of [Abonneren](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md)) of een [Bevestigingsverklaring](https://medmij.atlassian.net/wiki/display/MMOptioneel/Bevestigingsverklaring) (in het geval van [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)), volgens het daaromtrent bepaalde op de pagina [User interface (Autorisatieserver)](https://medmij.atlassian.net/wiki/display/MMOptioneel/User+interface+(Autorisatieserver)%2C+Abonneren), volgens de standaard [OAuth 2.0](https://tools.ietf.org/html/rfc6749), op de wijze waarop deze in het MedMij Afsprakenstelsel wordt toegepast. Dit geldt als uitbreiding op de verantwoordelijkheid zoals beschreven in [core.authint.205](https://afsprakenstelsel.medmij.nl/v23/archief/verantwoordelijkheden-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Verantwoordelijkheden,Core-core.authint.205). | ext.abo.authint.202 |
| 4. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) en [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) behandelen uitzonderingssituaties inzake het authorization interface af volgens onderstaande tabel. | Nummer | Implementeert uitzonderingen | Uitzondering | Actie | Melding | Vervolg | |----------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Authorization interface 1a | Abonneren 1 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) ontvangt een authorization request zonder (geldige) `redirect_uri` en/of zonder een (geldige) `client_id`. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)informeert de Persoon over de technische fout, zonder de Persoon automatisch te redirecten. | conform [OAuth 2.0-RFC 6749](https://tools.ietf.org/html/rfc6749#page-27), par. 4.1.2.1 | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | | Authorization interface 1b | Abonneren 1 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) ontvangt een ongeldige authorization request, anders dan uitzondering 1. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over de technische fout. [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) informeert [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon). | conform [OAuth 2.0-RFC 6749](https://tools.ietf.org/html/rfc6749#page-27), par. 4.1.2.1 , met de daar genoemde, HTTP 302 'invalid_request'. | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | | Authorization interface 2 | Abonneren 2 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) kan de identiteit van de [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) niet vaststellen. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)informeert de Persoon dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | | Authorization interface 3 | Abonneren 3 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) stelt tijdens de afhandeling van de authorization request vast dat: * in geval van de functie [Verzamelen](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md): van [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) bij [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder)geen gezondheidsinformatie voor die *Gegevensdienst* beschikbaar is; * in geval van de functie [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md): [Aanbieder](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Aanbieder) niet ontvankelijk is voor die *Gegevensdienst* van [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)*;* * in geval van de functie [Abonneren](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md): [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) geen *Notificaties* beschikbaar maakt voor [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon) op die *Gegevensdienst*. Zie de toelichting op [Beschikbaarheids- en ontvankelijkheidsvoorwaarde](https://afsprakenstelsel.medmij.nl/v23/archief/functies-en-gegevens-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Functiesengegevens,Core-Beschikbaarheids-enontvankelijkheidsvoorwaarde). | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer)informeert de Persoon dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | | Authorization interface 4 | Abonneren 4 | De autorisatievraag wordt ontkennend beantwoord. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over deze uitzondering. [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) informeert [Persoon](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-Persoon)dat diens verzoek geen voortgang kan vinden, maar laat de oorzaak daarvan helemaal in het midden. | | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | | Authorization interface 5 | Abonneren 5 | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) kan de autorisatie niet vaststellen. | [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) informeert [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) over deze uitzondering. [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer)informeert daarop *Persoon* hierover. | conform [OAuth 2.0-specificatie](https://tools.ietf.org/html/rfc6749#page-27), par. 4.1.2.1, error code `access denied`, met in de error description "`Authorization failed.`" | Allen stoppen de flow van de functies [*Verzamelen*](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md)/[Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md)en [*Abonneren*](https://afsprakenstelsel.medmij.nl/v23/archief/abonneren.md) onmiddellijk nadat de Persoon is geïnformeerd over de uitzondering. | Toelichting De uitzonderingssituaties kunnen gezien worden als de implementatie-tegenhangers van de uitzonderingen van de functies [Verzamelen](https://afsprakenstelsel.medmij.nl/v23/archief/verzamelen.md) en de [Delen](https://afsprakenstelsel.medmij.nl/v23/archief/delen.md). Op de Applicatielaag zijn deze echter per interface geordend. Alle uitzonderingen worden door de [Authorization Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-AuthorizationServer) ontdekt. In deze versie van het MedMij Afsprakenstelsel is bepaald dat zij altijd leiden tot het zo snel mogelijk afbreken van de flow door alle betrokken rollen. Daartoe moeten echter eerst nog de andere rollen geïnformeerd worden. Om te voorkomen dat de [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer) informatie over het bestaan van behandelrelaties verkrijgt zonder dat daarvoor (al) toestemming is gegeven, moet het onderscheid tussen de uitzonderingen 2, 3 en 4 niet te maken zijn door de [DVP Server](https://afsprakenstelsel.medmij.nl/v23/archief/rollen-core.md#id-(MedMijAfsprakenstelsel2.2.6d)Rollen,Core-DVPServer). Deze tabel bevat alleen die uitzonderingssituaties ten aanzien waarvan het MedMij afsprakenstelsel eigen eisen stelt aan de implementatie. In de [specificatie van OAuth 2.0](https://tools.ietf.org/html/rfc6749) staan daarnaast nog generiekere uitzonderingssituaties, zoals de situatie waarin de redirect URI ongeldig blijkt. Ook deze uitzonderingssituaties moeten geïmplementeerd worden. | ext.abo.authint.203 |
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Authorization interface, Vertegenwoordiging
In onderstaande tabel is alleen de uitbreiding aan de scope opgenomen, zoals deze in de MedMij Core staat beschreven, en de verdere toelichtingen daarop.
|----|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------|
| 1. | | parameter | vulling | toelichting | |------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `scope` | Optioneel voor "vertegenwoordigen": * de letterlijke waarde `onbehalfof of onbehalfofchild` * met een spatie gescheiden van de andere onderdelen | Voorbeeld van een syntactisch juiste scope is: * `"onbehalfof"`, als indicatie dat hier sprake is van vertegenwoordiging * "`onbehalfofchild`", als indicatie dat hier sprake is van wettelijke vertegenwoordiging op basis van ouderlijk gezag | | `MedMij_geboortedatum` | De geboortedatum van de *Vertegenwoordigde*, geschreven in het formaat \. | Voorbeeld van een syntactische juiste geboortedatum: * `19700901` Oftewel 1 september 1970 | Bovenstaande tabel is een uitbreiding op de tabel die is weergegeven in [core.authint.200](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.200) | ext.vert.authint.200 |
| 2. | Alleen als onbehalfof in de scope voorkomt, verzoekt de *Authorization Server* de *Authentication* *Server*ook vrijwillige vertegenwoordiging toe te staan. Dit wordt gedaan volgens de voorwaarden van de *Authentication Server*. | ext.vert.authint.201 |
| 3. | Alleen als onbehalfofchild in de scope voorkomt, verzoekt de *Authorization Server* de *Authentication* *Server*ook vertegenwoordiging op grond van het ouderlijk gezag toe te staan. Dit wordt gedaan volgens de voorwaarden van de *Authentication Server*. | ext.vert.authint.204 |
| 4. | De *OAuth Authorization Server* vergewist zich ervan dat tijdens Authenticatie ook gebruik is gemaakt van vrijwillige Vertegenwoordiging of Vertegenwoordiging op grond van het ouderlijk gezag. Indien dit het geval is, geeft de *OAuth Authorization Server* een authorization-code uit (naar OAuth Client) voor de identiteit van de Vertegenwoordigde. | ext.vert.authint.202 |
| 5. | *OAuth**Authorization Server* behandelt uitzonderingssituaties inzake het token interface volgens onderstaande tabel. | Nummer | Implementeert uitzondering | Uitzondering | Actie | Melding | Vervolg | |----------------------------------------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Authorization interface Vertegenwoordiging 1 | | *De**OAuth**Authorization Server* stelt dat tijdens Authenticatie geen gebruik is gemaakt van vrijwillige Vertegenwoordiging, terwijl dit wel verwacht werd. | *OAuth Authorization Server*informeert daarop *Persoon*hierover. | | *OAuth**Authorization Server* stopt de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. | | Authorization interface Vertegenwoordiging 2 | | *De**OAuth**Authorization Server* stelt dat tijdens Authenticatie gebruik is gemaakt van vrijwillige Vertegenwoordiging, terwijl dit niet verwacht werd. | *OAuth Authorization Server*informeert daarop *Persoon*hierover. | | *OAuth**Authorization Server* stopt de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. | | Authorization interface Vertegenwoordiging 3 | Verzamelen Vert 1 | *De**OAuth**Authorization Server* stelt dat de parameter `MedMij_geboortedatum` mist in het Authorization request, terwijl de scope wel de waarde onbehalfof bevat. | Conform Authorization interface 1b, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | Conform Authorization interface 1b, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | Conform Authorization interface 1b, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | | Authorization interface Vertegenwoordiging 4 | Verzamelen Vert 1 | *De**OAuth**Authorization Server* stelt dat de waarde van de parameter `MedMij_geboortedatum` niet gelijk is aan de geboortedatum van de *Vertegenwoordigde* in het achterliggende systeem. | Conform Authorization interface 3, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | Conform Authorization interface 3, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | Conform Authorization interface 3, beschreven in [core.authint.207](https://afsprakenstelsel.medmij.nl/v23/archief/authorization-interface.md#id-(MedMijAfsprakenstelsel2.2.6d)Authorizationinterface-core.authint.207) | | Authorization interface Vertegenwoordiging 5 | | *De**OAuth**Authorization Server* stelt dat tijdens Authenticatie geen gebruik is gemaakt van Vertegenwoordiging op grond van het ouderlijk gezag, terwijl dit wel verwacht werd. | *OAuth Authorization Server*informeert daarop *Persoon*hierover. | | *OAuth**Authorization Server* stopt de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. | | Authorization interface Vertegenwoordiging 6 | | *De**OAuth**Authorization Server* stelt dat tijdens Authenticatie gebruik is gemaakt van Vertegenwoordiging op grond van het ouderlijk gezag, terwijl dit niet verwacht werd. | *OAuth Authorization Server*informeert daarop *Persoon*hierover. | | *OAuth**Authorization Server* stopt de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. | | Authorization interface Vertegenwoordiging 7 | Verzamelen Vert 5 | *De**OAuth**Authorization Server* stelt dat de parameter `MedMij_geboortedatum` mist in het Authorization request, terwijl de scope wel de waarde onbehalfofchild bevat. | Conform Authorization interface 1b, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | Conform Authorization interface 1b, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | Conform Authorization interface 1b, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | | Authorization interface Vertegenwoordiging 8 | Verzamelen Vert 6 | *De**OAuth**Authorization Server* stelt dat de waarde van de parameter `MedMij_geboortedatum` niet gelijk is aan de geboortedatum van de *Vertegenwoordigde* in het achterliggende systeem. | Conform Authorization interface 3, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | Conform Authorization interface 3, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | Conform Authorization interface 3, beschreven in [core.authint.207](https://vzvz.atlassian.net/wiki/display/MMOntwikkeling/.Authorization+interface+v2.0.0_202305#id-.Authorizationinterfacev2.0.0_202305-core.authint.207) | De *OAuth**Authorization Server* kan deze uitzonderingen alleen vaststellen als de *OAuth**Authorization Server* vrijwillige Vertegenwoordiging en/of Vertegenwoordiging op grond van het ouderlijk gezag ondersteunt. Omdat deze extensie optioneel is voor alle deelnemers, kan de situatie zich voordoen dat de uitzondering wel van toepassing is, maar niet opgemerkt wordt door de *OAuth**Authorization Server*. | ext.vert.authint.203 |
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Autoriseren
## Inleiding
Er zijn twee vormen van autoriseren:
* Autorisatie zonder aanwezige geldige langdurige toestemming. Hierbij wordt gebruikgemaakt van de functie authenticatie.
* Autorisatie met aanwezige geldige langdurige toestemming. Hierbij wordt een geldig refreshtoken ingeruild voor een access-token en een nieuw refresh-token met een geldigheidsduur van een half jaar.
Hieronder worden beide manieren van autoriseren beschreven.
## Businesslaag
Hieronder staan de diagrammen behorende bij de functie Autoriseren, zowel zonder als met geldige langdurige toestemming. De flow beschrijft alleen de situatie waarin alle acties slagen tot en met dat de Dienstverlener aanbieder geautoriseerd is (de zogenaamde happy flow). De oranje banen horen (conform de MedMij-huisstijl) tot het Persoonsdomein, de blauwe tot het Aanbiedersdomein en de grijze tot externe domeinen.
In de diagrammen en uitwerkingen wordt gesproken over toestemming. Dit heeft verschillende betekenissen:
1. Bij de functies *Verzamelen* en *Abonneren* wordt hier de *Toestemmingsverklaring* afgegeven, waarmee de *Dienstverlener aanbieder* toestemming wordt gegeven gezondheidsgegevens naar de *Dienstverlener persoon* te zenden.
2. Bij de functie *Abonneren* en *Beheren toestemmingen* kan ook een *Beëindigingsverklaring* worden afgegeven, waarmee de *Persoon* een abonnement stopt of de langdurige toestemming intrekt.
3. Bij de functies *Delen* wordt hier de *Bevestigingsverklaring* afgegeven, waarmee de *Dienstverlener aanbieder* toestemming wordt gegeven gezondheidsgegevens van de *Dienstverlener persoon* te ontvangen.
### Autoriseren zonder geldige langdurige toestemming
De totale procesgang van de functie *Autoriseren*zonder geldige langdurige toestemming is voor alle functies te gebruiken en kent de volgende stappen:
* De *Dienstverlener aanbieder* ontvangt een verzoek tot autorisatie.
* De *Dienstverlener aanbieder* presenteert de landingspagina
* De *Dienstverlener aanbieder* laat de *Persoon* zich authenticeren bij de *Dienstverlener authenticatie*.
* Nadat de persoon geauthenticeerd is, voert de Dienstverlener aanbieder optioneel de beschikbaarheidstoets of verplicht de ontvankelijkheidstoets uit en vraagt de Persoon om een toestemmings- of bevestigingsverklaring.
* De *Dienstverlener aanbieder* logt die toestemming en geeft een autorisatie af aan de *Dienstverlener persoon*.
### Autoriseren met geldige langdurige toestemming
De totale procesgang van de functie Autoriseren met geldige langdurige toestemming is alleen voor de functie Verzamelen te gebruiken en kent de volgende stappen:
* De Dienstverlener aanbieder ontvangt een verzoek tot autorisatie.
* De Dienstverlener aanbieder controleert het bewijs van langdurige toestemming en voert optioneel de beschikbaarheidstoets uit.
Als de beschikbaarheidstoets niet op dit moment uitgevoerd wordt, moet deze op de resource request plaatsvinden.
* De Dienstverlener aanbieder geeft autorisatie af aan de Dienstverlener persoon.
### Uitzonderingen op de Happy flow van de functie Autorisatie
In onderstaande tabel staan de uitzonderingssituaties beschreven. Alle uitzonderingssituaties worden door de Dienstverlener aanbieder ontdekt. Om te voorkomen dat de *Dienstverlener persoon* informatie over het bestaan van behandelrelaties verkrijgt zonder dat daarvoor (al) toestemming is gegeven, moet het onderscheid tussen de uitzonderingen 1 en 2 niet te maken zijn door de *Dienstverlener persoon*.
| nr. | uitzondering | actie | vervolg |
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
| autoriseren 1 | *Dienstverlener aanbieder* stelt op enig moment vast dat van *Persoon* bij *Aanbieder* geen gezondheidsinformatie voor die *Gegevensdienst* beschikbaar is. Zie de toelichting op Beschikbaarheids- en ontvankelijkheidsvoorwaarde. | *Dienstverlener aanbieder* informeert de Persoon dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| autoriseren 2 | De voorgelegde Toestemmingsverklaring wordt niet afgegeven. | *Dienstverlener aanbieder* informeert *DVP Server* over deze uitzondering. *DVP Server* informeert *Persoon*dat diens verzoek geen voortgang kan vinden, maar laat de oorzaak daarvan helemaal in het midden. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| autoriseren 3 | *Dienstverlener aanbieder* kan het antwoord op de toestemmingsvraag niet vaststellen. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon* over deze uitzondering. *Dienstverlener persoon* informeert daarop *Persoon* hierover. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
## Applicatielaag
### Autoriseren zonder geldige langdurige toestemming
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. De *User Agent* stuurt een authorization request naar de *Authorization Server*.
2. De *Authorization Server* presenteert hierop de landingspagina aan de *Persoon*.
3. Daarop begint de *Authorization Server* de OAuth-flow (in zijn rol als *OAuth Authorization Server*) door een sessie te creëren.
4. Dan start de *Authorization Server* (nu in de rol van *Authentication Client*) de authenticatieflow.
5. Na de authenticatieflow valideert de Authorization Server de identificerende gegevens en breekt het (vroegste) moment aan waarop of
1. de *Authorization Server* ervoor instaat dat de *Aanbieder* voor de betreffende Gegevensdienst(en) überhaupt gezondheidsinformatie van die *Persoon* beschikbaar heeft, of anders de happy flow afbreekt. Op dit moment is de beschikbaarheidstoets optioneel voor de functie verzamelen, omdat later in het proces dezelfde toets verplicht uitgevoerd moet worden.
2. de *Authorization Server* ervoor instaat dat voor de betreffende Gegevensdienst de *Aanbieder* ontvankelijk is voor de gezondheidsgegevens van de betreffende *Persoon* . Is dat zo, dan verstuurt de *Authorization Server* het access-token naar de *DVP Server* . Is dat niet zo, dan breekt de *Authorization Server* de happy flow af en stuurt zij geen access-token naar de *DVP Server*. Op dit moment is de ontvankelijkheidstoets verplicht.
6. Indien de *Aanbieder* kan instaan voor de beschikbaarheid van tenminste één Gegevensdienst of kan instaan dat de *Aanbieder* voor de betreffende Gegevensdienst überhaupt gezondheidsinformatie van die *Persoon* wenst te ontvangen, dan presenteert de *Authorization Server* via de *User Agent* aan *Persoon* in een Toestemmingsverklaring, de vraag of *Persoon* de *Aanbieder* toestaat de gevraagde persoonlijke gezondheidsinformatie uit te wisselen met de *DVP Server* (als *OAuth Client*).
7. Bij akkoord logt de *Authorization Server* dit als toestemming, genereert een authorization-code en stuurt dit als ophaalbewijs, door middel van een *User Agent* redirect met de in het authorization request ontvangen redirect_uri, naar de *DVP Server* . De *Authorization Server* stuurt daarbij de local state-informatie mee die hij in het authorization request van de *DVP Server* heeft gekregen. Laatstgenoemde herkent daaraan het verzoek waarmee hij de authorization-code moet associëren.
8. De *DVP Server* vat niet alleen deze authorization-code op als ophaalbewijs, maar leidt er ook uit af dat de toestemming is gegeven en logt het verkrijgen van het ophaalbewijs.
9. Met dit ophaalbewijs wendt de *DVP Server* zich weer tot de *Authorization Server* , maar nu zonder tussenkomst van de *User Agent*, voor een access-token.
10. De Authorization Server valideert de authorization-code. Nu is het vroegste moment dat de verplichte beschikbaarheidstoets uitgevoerd kan worden. De andere optie is het uitvoeren van de beschikbaarheidstoets op het resource endpoint. Eén van deze twee momenten is verplicht.
11. Daarop genereert de Authorization Server een access-token (en indien de Persoon langdurige toestemming geeft ook een referesh-token) en stuurt deze naar de *DVP Server*.
### Autoriseren met geldige langdurige toestemming
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. De DVP Server stuurt een refresh-token naar de Authorization Server.
2. Daarop begint de Authorization Server de OAuth-flow (in zijn rol als OAuth Authorization Server) door een sessie te creëren.
3. Dan controleert de Authorization Server het refresh-token
4. Hierna breekt het verplichte moment aan waarop of de Authorization Server ervoor instaat dat de Aanbieder voor de betreffende Gegevensdienst(en) überhaupt gezondheidsinformatie van die Persoon beschikbaar heeft, of anders de happy flow afbreekt. Zie ook de beschrijving over de beschikbaarheidstoets.
5. Indien de Aanbieder kan instaan voor de beschikbaarheid van tenminste één Gegevensdienst, genereert de Authorization Server een access-token en een nieuw refresh-token en stuurt deze naar de DVP Server.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Autoriseren voor Abonneren
## Inleiding
Hieronder wordt autoriseren voor *Abonneren* beschreven.
## Businesslaag
Hieronder staat het diagram behorende bij de functie Autoriseren voor *Abonneren*. De flow beschrijft alleen de situatie waarin alle acties slagen tot en met dat de Dienstverlener aanbieder geautoriseerd is (de zogenaamde happy flow). De oranje banen horen (conform de MedMij-huisstijl) tot het Persoonsdomein, de blauwe tot het Aanbiedersdomein en de grijze tot externe domeinen.
In de diagrammen en uitwerkingen wordt gesproken over toestemming. Dit betekent bij *Abonneren*:
1. Bij *Abonneren* wordt de *Toestemmingsverklaring* afgegeven, waarmee de *Dienstverlener aanbieder* toestemming wordt gegeven voor meldingen over gezondheidsgegevens naar de *Dienstverlener persoon* te zenden en/of een *Beëindigingsverklaring* worden afgegeven, waarmee de *Persoon* een abonnement stopt
### Autoriseren voor *Abonneren*
De totale procesgang van de functie *Autoriseren* voor *Abonneren* kent de volgende stappen:
* De *Dienstverlener aanbieder* ontvangt een verzoek tot autorisatie.
* De *Dienstverlener aanbieder* presenteert de landingspagina.
* De *Dienstverlener aanbieder* laat de *Persoon* zich authenticeren bij de *Dienstverlener authenticatie*.
* Nadat de persoon geauthenticeerd is, voert de *Dienstverlener aanbieder* optioneel de beschikbaarheidstoets uit en vraagt de Persoon om een toestemmingsverklaring voor *Abonneren*.
* De *Dienstverlener aanbieder* logt die toestemming voor het *Abonnement* en geeft een autorisatie af aan de *Dienstverlener persoon*.
### Uitzonderingen op de Happy flow van de functie Autorisatie
In onderstaande tabel staan de uitzonderingssituaties beschreven. Alle uitzonderingssituaties worden door de *Dienstverlener aanbieder* ontdekt. Om te voorkomen dat de *Dienstverlener persoon* informatie over het bestaan van behandelrelaties verkrijgt zonder dat daarvoor (al) toestemming is gegeven, moet het onderscheid tussen de uitzonderingen 1 en 2 niet te maken zijn door de *Dienstverlener persoon*.
| nr. | uitzondering | actie | vervolg |
|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
| autoriseren 1 | *Dienstverlener aanbieder* stelt op enig moment vast dat van *Persoon* bij *Aanbieder* geen gezondheidsinformatie voor die *Gegevensdienst* beschikbaar is. Zie de toelichting op Beschikbaarheids- en ontvankelijkheidsvoorwaarde. | *Dienstverlener aanbieder* informeert de *Persoon* dat diens verzoek geen voortgang kan vinden en noemt daarbij behorende reden. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| autoriseren 2 | De voorgelegde Toestemmingsverklaring voor A*bonneren*wordt niet afgegeven. | *Dienstverlener aanbieder* informeert *DVP Server* over deze uitzondering. *DVP Server* informeert *Persoon*dat diens verzoek geen voortgang kan vinden, maar laat de oorzaak daarvan helemaal in het midden. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| autoriseren 3 | *Dienstverlener aanbieder* kan het antwoord op de toestemmingsvraag niet vaststellen. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon* over deze uitzondering. *Dienstverlener persoon* informeert daarop *Persoon* hierover. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
## Applicatielaag
### Autoriseren voor *Abonneren*
Verantwoordelijkheden inzake uitzonderingen op de happy flow zijn opgenomen bij de respectievelijke interface, waar de uitzonderingen bij de functies zijn genoemd.
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. De *User Agent* stuurt een authorization request naar de *Authorization Server*.
2. Daarop begint de *Authorization Server* de OAuth-flow (in zijn rol als *OAuth Authorization Server*) door een sessie te creëren.
3. Dan start de *Authorization Server* (nu in de rol van *Authentication Client*) de authenticatieflow.
4. Na de authenticatieflow valideert de *Authorization Server* de identificerende gegevens en breekt het (vroegste) moment aan waarop de *Authorization Server* ervoor instaat dat de *Aanbieder* voor de betreffende Gegevensdienst(en) überhaupt gezondheidsinformatie van die *Persoon* beschikbaar heeft, of anders de happy flow afbreekt.
5. Indien de *Aanbieder* kan instaan voor de beschikbaarheid van tenminste één Gegevensdienst, presenteert de *Authorization Server* via de *User Agent* aan *Persoon* de Toestemmingsverklaring voor *Abonnement* met de vraag of *Persoon* de *Aanbieder* toestaat een melding te sturen als er iets wijzigt in de gegevens die de *Aanbieder* over de *Persoon* bijhoudt naar de *DVP Server* (als *OAuth Client*).
6. Bij akkoord logt de *Authorization Server* dit als toestemming en genereert een authorization-code. Vervolgens stuurt de *Authorization Server* dit als ophaalbewijs naar de *DVP Server* door middel van een *User Agent* redirect met de in het authorization request ontvangen redirect_uri. De *Authorization Server* stuurt daarbij de local state-informatie mee die hij in het authorization request van de *DVP Server* heeft gekregen. Laatstgenoemde herkent daaraan het verzoek waarmee hij de authorization-code moet associëren.
7. De *DVP Server* vat niet alleen deze authorization-code op als ophaalbewijs, maar leidt er ook uit af dat de toestemming is gegeven en logt het verkrijgen van het ophaalbewijs.
8. Met dit ophaalbewijs wendt de *DVP Server* zich weer tot de *Authorization Server* , maar nu zonder tussenkomst van de *User Agent*, voor een access-token.
9. De *Authorization Server* valideert de authorization-code. Nu is het vroegste moment dat de verplichte beschikbaarheidstoets uitgevoerd kan worden. De andere optie is het uitvoeren van de beschikbaarheidstoets op de subscription server. Eén van deze twee momenten is verplicht.
10. Daarop genereert de *Authorization Server* een access-token en stuurt deze naar de *DVP Server*.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Autoriseren voor Vertegenwoordiging
## Inleiding
De functie *Autoriseren voor Vertegenwoordiging* is een afgeleide van de functie *Autoriseren* , die in de *Core* staat beschreven. Een groot gedeelte van de functie *Autoriseren* geldt ook voor de functie *Autoriseren voor Vertegenwoordiging* . Alleen de wijzigingen op de originele functie staan beschreven. De diagrammen tonen alleen de situatie waarin alle acties slagen tot en met dat de *Dienstverlener persoon* geautoriseerd is (de zogenaamde happy flow). De oranje elementen horen, conform de MedMij-huisstijl, tot het *Persoonsdomein* , de blauwe tot het *Aanbiedersdomein*, de grijze tot externe domein.
## Businesslaag
De wijzigingen voor *Vertegenwoordiging* hebben vooral effect op de functie *Authenticeren* . Daarom is ook voor deze functie een afgeleide gemaakt. Daarnaast controleert de *Dienstverlener aanbieder* of tijdens authenticatie gebruikgemaakt is van vertegenwoordiging. Dezelfde controle wordt door de *Dienstverlener persoon* aan het einde van de flow uitgevoerd.
De totale procesgang van de *functie Autoriseren voor Vertegenwoordiging* kent de volgende stappen:
* De *Dienstverlener aanbieder* ontvangt van de *Dienstverlener Persoon* een verzoek tot verzamelen op basis van vrijwillige *Vertegenwoordiging* of op basis van *Vertegenwoordiging* op grond van het ouderlijk gezag.
* De *Dienstverlener aanbieder* vraagt de *Dienstverlener authenticatie* de *Persoon* te authenticeren.
* De *Dienstverlener aanbieder* controleert of tijdens authenticatie gebruikgemaakt is van vrijwillige *Vertegenwoordiging* of van *Vertegenwoordiging* op grond van het ouderlijk gezag .
* De *Dienstverlener aanbieder* vraagt aan de *Persoon* of hij toestemming geeft tot het verstrekken van de gevraagde informatie aan de *Dienstverlener persoon*. Deze vraag staat op de pagina Toestemmingsverklaring.
* De *Dienstverlener aanbieder* logt die toestemming en geeft een autorisatie af aan de *Dienstverlener persoon*.
* De *Dienstverlener persoon* controleert of gebruikgemaakt is van vrijwillige *Vertegenwoordiging* of op basis van *Vertegenwoordiging* op grond van het ouderlijk gezag.
### Uitzonderingen op de Happy flow van de functie Autoriseren voor Vertegenwoordiging
Naast de uitzonderingen die gelden voor de functie *Autorisatie* gelden voor deze uitbreiding de volgende uitzonderingen:
| **nr.** | **uitzondering** | **actie** | **vervolg** |
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------|
| Autoriseren Vertegenwoordiging 1 | *Dienstverlener aanbieder*ondersteunt geen vrijwillige vertegenwoordiging | *Dienstverlener* *aanbieder* breekt de flow af en informeert *Dienstverlener persoon* betreffende een onjuiste scope, of *Dienstverlener persoon*breekt de flow af zodra duidelijk is dat in het *Aanbiedersdomein*geen vrijwillige vertegenwoordiging gebruikt is. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Autoriseren Vertegenwoordiging 2 | *Aanbieder*- gegevensdienst combinatie ondersteunt geen vrijwillige vertegenwoordiging | *Dienstverlener persoon*biedt geen*vrijwillige vertegenwoordiging aan, of breekt de flow af zodra duidelijk is dat in het Aanbiedersdomein* geen vertegenwoordiging gebruikt is. | *Dienstverlener persoon* stopt de flow. |
| Autoriseren Vertegenwoordiging 3 | *Dienstverlener persoon* ondersteunt geen vrijwillige vertegenwoordiging | *Dienstverlener aanbieder*biedt geen vrijwillige vertegenwoordiging aan, of breekt de flow af zodra duidelijk is dat bij de *Authentication Server* vertegenwoordiging gebruikt is. | *Dienstverlener aanbieder*stopt de flow. |
| Autoriseren Vertegenwoordiging 4 | *Dienstverlener aanbieder* stelt op enig moment vast dat van vrijwillige *Vertegenwoordigde* bij *Aanbieder*geen gezondheidsinformatie voor die Gegevensdienst beschikbaar is. Hiervan is in elk geval sprake indien hetzij: * er geen behandelrelatie is aan te wijzen als grondslag voor het verzamelen; * *Vertegenwoordigde*nog geen zestien jaar oud is. Zie de toelichting op *Beschikbaarheids- en ontvankelijkheidsvoorwaarde*. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon* dat verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Autoriseren Vertegenwoordiging 5 | *Dienstverlener aanbieder*ondersteunt geen vertegenwoordiging op basis van het ouderlijk gezag | *Dienstverlener* *aanbieder* breekt de flow af en informeert *Dienstverlener persoon* betreffende een onjuiste scope, of *Dienstverlener persoon*breekt de flow af zodra duidelijk is dat in het *Aanbiedersdomein*geen vertegenwoordiging op basis van het ouderlijk gezag gebruikt is. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
| Autoriseren Vertegenwoordiging 6 | *Aanbieder*- gegevensdienst combinatie ondersteunt geen vertegenwoordiging op basis van het ouderlijk gezag | *Dienstverlener persoon*biedt geenvertegenwoordiging op grond van het ouderlijk gezagaan, of breekt de flow af zodra duidelijk is dat in het Aanbiedersdomein geen vertegenwoordiging op grond van het ouderlijk gezaggebruikt is. | *Dienstverlener persoon* stopt de flow. |
| Autoriseren Vertegenwoordiging 7 | *Dienstverlener persoon* ondersteunt geen vertegenwoordiging op basis van ouderlijk gezag | *Dienstverlener aanbieder*biedt geen vertegenwoordiging op grond van het ouderlijk gezag aan, of breekt de flow af zodra duidelijk is dat bij de *Authentication Server* vertegenwoordiging op grond van het ouderlijk gezag gebruikt is. | *Dienstverlener aanbieder*stopt de flow. |
| Autoriseren Vertegenwoordiging 8 | *Dienstverlener aanbieder* stelt op enig moment vast dat van de *Vertegenwoordigde*op basis van het ouderlijk gezag bij de *Aanbieder*geen gezondheidsinformatie voor die Gegevensdienst beschikbaar is. Hiervan is in elk geval sprake indien hetzij: * er geen behandelrelatie is aan te wijzen als grondslag voor het verzamelen; * *Vertegenwoordigde*12 jaar of ouder is. Dit is een uitbreiding van de *Beschikbaarheids- en ontvankelijkheidsvoorwaarde*. | *Dienstverlener aanbieder* informeert *Dienstverlener persoon*dat verzoek niet wordt ingewilligd. | Allen stoppen de flow onmiddellijk na geïnformeerd te zijn over de uitzondering. |
## Applicatielaag
De flow van de functie *Autoriseren*kent voor *Vertegenwoordiging*de volgende wijzigingen:
1. In plaats van de normale functie *Authenticeren*wordt een aangepast versie aangeroepen voor vrijwillige *Vertegenwoordiging* of *Vertegenwoordiging* op basis van ouderlijk gezag.
2. Na het verkrijgen van de authenticatieverklaring controleert de *Authorization server* of*Vertegenwoordiging*is toegepast binnen de functie *Authenticeren*is toegepast. Als *Vertegenwoordiging* is toegepast, dan wordt gecontroleerd of dit vrijwillige *Vertegenwoordiging* of *Vertegenwoordiging* op basis van het ouderlijk gezag betreft.
* ++Indien vrijwillige++++*Vertegenwoordiging*++++is toegepast:++
1.
1. De*Authorization server* stelt vast dat tijdens authenticatie vrijwillige *Vertegenwoordiging*is toegepast en gaat verder met de flow.
2. De *Authorization server*stelt vast dat er geen vrijwillige *Vertegenwoordiging*is toegepast tijdens authenticatie, terwijl dit wel gevraagd werd. De*Authorization server* stopt de flow onmiddellijk.
3. De *Authorization server* stelt vast dat de in het Authorization request meegestuurde geboortedatum gelijk is aan de geboortedatum van de *Vertegenwoordigde*, zoals deze bekend is in de achterliggende component(en).
* ++Indien++++*Vertegenwoordiging*++++op basis van het ouderlijk gezag is toegepast:++
1.
1. De *Authorization server* stelt vast dat tijdens authenticatie *Vertegenwoordiging* op basis van ouderlijk gezag is toegepast en gaat verder met de flow.
2. De *Authorization server* stelt vast dat er geen *Vertegenwoordiging* op basis van ouderlijk gezag is toegepast tijdens authenticatie, terwijl dit wel gevraagd werd. De *Authorization serve*r stopt de flow onmiddellijk.
3. De *Authorization serve*r stelt vast dat de in het Authorization request meegestuurde geboortedatum gelijk is aan de geboortedatum van de *Vertegenwoordigde*, zoals deze bekend is in de achterliggende component(en).
2. Na het verkrijgen van een access token controleert de *DVP server* de scope op het gebruik van *Vertegenwoordiging.*
* ++Indien vrijwillige++++*Vertegenwoordiging*++++is toegepast:++:
1.
1. De *DVP Server* stelt vast dat de scope van het access-token 'onbehalfof' bevat waar dit in de scope van het Authorization Request ook meegegeven was. *DVP Server* gaat verder met de flow.
2. De *DVP Server* stelt vast dat de scope van het access-token geen 'onbehalfof' bevat waar dit in de scope van het Authorization Request wel meegegeven was. *DVP Server* stopt de flow onmiddellijk.
3. De *DVP Server* stelt vast dat de scope van het access-token 'onbehalfof' bevat waar dit in de scope van het Authorization Request niet meegegeven was.*DVP Server* stopt de flow onmiddellijk.
* ++Indien++++*Vertegenwoordiging*++++op basis van het ouderlijk gezag is toegepast:++:
1.
1. De *DVP Server* stelt vast dat de scope van het access-token 'onbehalfofchild' bevat waar dit in de scope van het Authorization Request ook meegegeven was. *DVP Server* gaat verder met de flow.
2. De *DVP Server* stelt vast dat de scope van het access-token geen 'onbehalfofchild' bevat waar dit in de scope van het Authorization Request wel meegegeven was. *DVP Server* stopt de flow onmiddellijk.
3. De *DVP Server* stelt vast dat de scope van het access-token 'onbehalfofchild' bevat waar dit in de scope van het Authorization Request niet meegegeven was.*DVP Server* stopt de flow onmiddellijk.
De *DVP server* kan deze situaties alleen vaststellen als de *DVP server* vrijwillige *Vertegenwoordiging*en*/*of *Vertegenwoordiging*op basis van het ouderlijk gezag ondersteunt. Omdat deze extensie optioneel is voor alle deelnemers, kan de situatie zich voordoen dat de uitzondering wel van toepassing is, maar niet opgemerkt wordt door de *DVP Server*. Daarom heeft ook de *Authorization Server* de verantwoordelijkheid controles uit te voeren. Deze staan beschreven bij de Authorization interface.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Beëindigingsverklaring Abonnement
De Persoon moet een abonnement kunnen beëindigen. Om dit te faciliteren toont de Dienstverlener aanbieder dit scherm.
## Tekst
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Beëindigingsverklaring** Eerder heb ik ` `toestemming gegeven om ` `meldingen te sturen als er iets wijzigt in de gegevens die `` over mij bijhoudt. Het gaat hierbij om meldingen over veranderingen in: - `` Hierbij trek ik deze toestemming in. ` `mag mij geen meldingen meer sturen. **Toelichting op de beëindigingsverklaring** In een persoonlijke gezondheidsomgeving (PGO) kun je verbinding maken met de computer van jouw zorgaanbieder(s). Zoals van de huisarts of het ziekenhuis. Natuurlijk wil je dat dit veilig gebeurt. Hiervoor heeft Stichting MedMij strenge regels gemaakt. PGO's en zorgaanbieders met een MedMij-label volgen deze regels. Het MedMij-label betekent dat jij deze PGO op een veilige manier kunt verbinden met deze zorgaanbieders. En het betekent ook dat jouw gegevens veilig worden opgeslagen in jouw PGO. Door de Wet op de geneeskundige behandelingsovereenkomst is de zorgverlener, zoals je huisarts, verplicht om ervoor te zorgen dat 'anderen' (lees: jouw PGO) dan de patiënt (lees: jij) geen inlichtingen hebben over, inzage hebben in of een afschrift hebben van jouw medisch dossier, tenzij je hiervoor toestemming hebt gegeven. Eerder had je toestemming gegeven aan jouw zorgverlener om meldingen over veranderingen in jouw medische gegevens naar jouw PGO te sturen. Die toestemming trek je hierbij in. Jouw zorgverlener mag jou geen meldingen meer sturen. |
## Voorbeeld
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Beëindigingsverklaring langdurige toestemming, Core
Als een Persoon in het overzicht gekozen heeft een toestemming te verwijderen, moet dit scherm getoond worden. Zo is de Dienstverlener aanbieder zeker dat het om een bewuste actie van de Persoon gaat en kan de toestemming daadwerkelijk verwijderd worden.
Aanbevolen wordt om aan het scherm ook de knop 'Annuleren' toe te voegen. Kiest een Persoon voor annuleren dan komt deze terug op de [Overzichtspagina toestemmingen, Core](https://vzvz.atlassian.net/wiki/spaces/MMAS2MIG/pages/1364493443/Overzichtspagina+toestemmingen+Core). Hierbij hoeven er geen error codes mee teruggeven te worden.
## Tekst
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Titel: Beëindiging toestemming** Eerder gaf je **\** toestemming om gegevens die **\** heeft te delen met **\** Als je dit niet meer wilt, kun je de toestemming intrekken. **\** mag jouw gegevens niet meer delen met **\** |
## Voorbeeld
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Begrippenlijst
## Begrippen
| Begrip | Definitie | Domein | Synoniemen |
|-------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|-----------------------------------------------------------------|
| Aanbieder | Aanbieder is de term waarmee een grote diversiteit aan dienstverleners wordt bedoeld, die vanuit hun diensten gezondheidsinformatie kunnen aanbieden en ontvangen. | Aanbiedersdomein | |
| Aanbiedersdomein | Alle *Aanbieders* en alle D*ienstverlener aanbieder* vormen samen het aanbiedersdomein. | Aanbiedersdomein | |
| Aanbiederslijst | Een lijst met *Aanbieders*die Gegevensdiensten aanbieden en eventueel ook abonnementen daarop. Hier staan welke adressen daarbij worden ontsloten met een specifieke Interfaceversie. | Aanbiedersdomein | |
| Abonnement | Overeenkomst tussen een *Aanbieder* en een *Persoon* voor het (mogen) leveren van Notificaties door *Aanbieder* aan *Dienstverlener persoon*. Deze release van het MedMij Afsprakenstelsel beschrijft alleen Abonnementen die betrekking hebben op Gegevensdiensten die zijn gebaseerd op de functie Verzamelen. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Addendum aanbieder zonder behandelrelatie | Het addendum maakt het mogelijk om *Aanbieders* , die van de *Persoon* gezondheidsgegevens beschikbaar hebben, maar geen behandelrelatie met de *Persoon* hebben, gebruik te laten maken van het *MedMij-netwerk*. Dit Addendum maakt onderdeel uit van het MedMij Afsprakenstelsel en is hier onlosmakelijk mee verbonden. | Aanbiedersdomein | |
| Afsprakenstelsel | Set van afspraken op juridisch, organisatorisch, financieel, semantisch en technisch gebied om alle partijen voldoende vertrouwen te geven in hetgeen het stelsel hen biedt. Partijen die deelnemen aan het MedMij Afsprakenstelsel committeren zich aan de afspraken en kunnen op basis van de reeds overeengekomen afspraken, diensten aanbieden. | Alle domeinen samen | MedMij Afsprakenstelsel |
| Authentication Client | Een Authentication Client is een applicatie die gebruikmaakt van een Authentication Server om de identiteit van een OAuth Resource Owner vast te stellen. | | |
| Authentication Server | De Authentication Server is de server bij de *DVA* die de identiteit van de *Persoon*vaststelt. | | |
| Authorization Server | De Authorization Server is de server bij de *DVA* die controleert of de *Persoon* voor de applicatie toegangsrechten heeft. Als de *Persoon* toestemming geeft om gegevens uit te wisselen met de *DVP Server*, dan wordt deze toestemming vastgelegd en voor uitwisseling gecontroleerd. | | |
| Backchannel Node | Een Backchannel Node communiceert met andere backchannel nodes, waarbij voor identificatie gebruikgemaakt wordt van de verschillende lijsten die door [MedMij Registratie](#) worden geboden. | | |
| Backchannel-verkeer | Verkeer dat niet zichtbaar is voor de *Persoon* . Het gaat hierbij om verkeer tussen servers uit verschillende domeinen, die zonder tussenkomst van een *Persoon*met elkaar communiceren. | | |
| Catalogus | Verzameling van Gegevensdiensten die op enig moment door *Aanbieders*aangeboden mogen (of mochten) worden op het MedMij-netwerk. | Alle domeinen samen | |
| Deelnemer | Een partij die is toegetreden tot het MedMij Afsprakenstelsel na het doorlopen van het [toetredingsproces](https://afsprakenstelsel.medmij.nl/v23/archief/toetredingsproces.md) | Persoonsdomein of Aanbiedersdomein | |
| Dienstverlener aanbieder | Dit betreft een rol in het MedMij Afsprakenstelsel. Deze levert Diensten aan de *Aanbieder* gerelateerd aan de uitwisseling tussen *Persoon* en *Aanbieder*en committeert zich hiervoor aan de naleving van de afspraken in het MedMij Afsprakenstelsel. | Aanbiedersdomein | DVA |
| Dienstverlener authenticatie | De *Aanbieder*is verplicht bij het verstrekken van gegevens vanuit een dossier de identiteit van de persoon te verifiëren, al dan niet aan de hand van het BSN. MedMij gebruikt hiervoor de door het ministerie van Binnenlandse Zaken en Koninkrijksrelaties toegelaten authenticatiemiddelen. Vooralsnog is DigiD het enige toegelaten middel voor dit doel. | | DVAuthN |
| Dienstverlener persoon | Dit betreft een rol in het MedMij Afsprakenstelsel. Levert een persoonlijke gezondheidsomgeving, een dienst aan de *Persoon* voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de *Aanbieder*mogelijk maakt via het MedMij Afsprakenstelsel. | Persoonsdomein | DVP |
| Dossier Afspraken en Procedures | Dossier Afspraken en Procedures wordt gekoppeld aan een Service Level Agreement (SLA). In de SLA staan de serviceafspraken die een leverancier maakt met de klant over de serviceverlening (zie het artikel SLA). Waar de SLA ingaat op de servicenormen van de serviceverlening, gaat de DAP in op de administratie en organisatie rond de serviceverlening, bijvoorbeeld welke procedures worden uitgevoerd, welke rapportages worden geleverd en welke rollen/personen zijn betrokken bij de communicatie tussen de klant en de leverancier. | Alle domeinen | DAP |
| DVP Server | De DVP Server is de server die gezondheidsgegevens verzamelt en deelt op verzoek van de *Persoon* en hiermee het Dossier van de *Persoon*samenstelt. | Persoonsdomein | |
| Eigenaar MedMij | De rechtspersoon die (eind)verantwoordelijk is voor de ontwikkeling en het beheer van het afsprakenstelsel en de informatiestandaarden die nodig zijn om gegevens in dezelfde taal te kunnen uitwisselen. | | |
| Frontchannel Node | Een Frontchannel Node communiceert met de [*User Agent*](http://vzvz.atlassian.net/wiki/pages/resumedraft.action?draftId=131760376#Begrippenlijst-UserAgent) van de [*Persoon*](http://vzvz.atlassian.net/wiki/pages/resumedraft.action?draftId=131760376#Begrippenlijst-Persoon), waarbij de communicatie internet facing is. De rol van [*User Agent*](http://vzvz.atlassian.net/wiki/pages/resumedraft.action?draftId=131760376#Begrippenlijst-UserAgent) wordt hierbij ingevuld door een webbrowser. | | |
| Frontchannel-verkeer | Al het verkeer dat zichtbaar is voor de *Persoon*. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Functionaliteit | Alle functies, applicaties en koppelingen, die gerelateerd zijn aan het MedMij Afsprakenstelsel. | Alle domeinen | |
| Gebruiker | Een partij die gebruikmaakt van de dienstverlening van deelnemers aan het afsprakenstelsel. | Persoonsdomein of Aanbiedersdomein | |
| Gegevensdienst | Een gestandaardiseerde dienst voor gegevensuitwisseling met waarde voor de Gebruiker. Een Gegevensdienst kan via het MedMij-netwerk door een dienstverlener worden aangeboden. MedMij bepaalt, aan de hand van het volwassenheidsniveau, welke Gegevensdiensten ontsloten mogen worden via het MedMij-netwerk. Daarnaast biedt MedMij een faciliteit om het dienstenaanbod van de dienstverleners overzichtelijk weer te geven. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Gegevensdienstnamenlijst | Een lijst met de gebruiksvriendelijke namen van Gegevensdiensten. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Gemachtigde | Een partij die op grond van een machtiging de bevoegdheid krijgt om in naam van de *Machtigingsverlener* (lees: *Vertegenwoordigde* ) bepaalde handelingen te verrichten, waarvan de rechtsgevolgen worden toegerekend aan de *Machtigingsverlener* (lees: *Vertegenwoordigde*). | Persoonsdomein | Vertegenwoordiger |
| Gezondheidsgegeven | Een gegeven betreffende de geestelijke en/of lichamelijke gesteldheid van een *Persoon*. | Tussen Persoonsdomein en Aanbiedersdomein | Gezondheidsinformatie, persoonlijke gezondheidsinformatie, |
| Houder | Een rechtspersoon die eindverantwoordelijk is voor een gegevensdienst en de bijbehorende Informatiestandaard met de verantwoordelijkheden zoals beschreven in NEN 7522. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Ketenmachtiging | De situatie waarin meer dan één machtigingsrelatie gebruikt moet worden om aan te tonen dat degene die een bepaalde dienst wil afnemen daartoe bevoegd is namens een eerste *Machtigingsverlener* . De ene zijde van deze keten wordt gevormd door de eerste *Machtigingsverlener* . De andere zijde van de keten wordt gevormd door de (laatste) *Gemachtigde*die degene is die de handeling uitvoert. | Persoonsdomein | |
| Ketentest | Een testvariëteit die een business proces van begin tot eind test. Daarbij worden één of meer systemen getest met testgevallen die buiten het systeem beginnen en ook weer buiten het systeem eindigen. | Alle domeinen | |
| Machtiging | De vertegenwoordigingsbevoegdheid die de *Machtigingsverlener* (lees: *Vertegenwoordigde* ) verleent aan een ander (de *Gemachtigde* ++*)*++ om namens/in naam van de *Machtigingsverlener* , bepaalde rechtshandelingen te verrichten. Met de term *Machtiging*wordt de juridische vertegenwoordigingsbevoegdheid bedoeld zoals deze tussen partijen wordt afgesproken en niet de registratie daarvan die daarna in een Machtigingsregister wordt vastgelegd. | Persoonsdomein | Volmacht |
| Machtigingenregister | Een partij die de verantwoordelijkheid heeft voor het registreren, beheren, controleren van machtigingen en andere bevoegdheden en het afleggen van verklaringen over bevoegdheden (c.q. het op verzoek van de handelende natuurlijk persoon verstrekken van machtigingsverklaringen). | Tussen Persoonsdomein en Aanbiedersdomein | |
| Machtigingsverlener | Een partij (lees: *Vertegenwoordigde* ) die een (specifieke) machtiging verleent aan een andere partij (de *Vertegenwoordiger*). | Persoonsdomein | Vertegenwoordigde, Betroffene, Belanghebbende |
| Major release slot | Dit zijn de twee momenten waarop major en minor releases worden gepubliceerd. Deze release slots zijn de tweede dinsdag van april en oktober. Vallen deze data op een feestdag of in een vakantie dan wordt in overleg met de stakeholders de release op een andere datum gepland. | | |
| Major release | Release met wijzigingen die invloed hebben op de functionaliteit en niet backwards compatible is. | | |
| MedMij Beheer | De uitvoeringsorganisaties die invulling geven aan de operationele verantwoordelijkheden in het afsprakenstelsel, zoals het monitoren, beheren en publiceren van een aanbiederslijst en gegevensdienstnamenlijst. De Stichting MedMij kan ook zelf geheel of gedeeltelijk invulling geven aan deze rol. | | |
| MedMij Registratie | MedMij Registratie is de applicatie voor de administratie van *Deelnemers*, de gegevensdiensten die worden aangeboden en de endpoints die hierbij horen. Deze informatie wordt uitgegeven in de verschillende lijsten. | | |
| MedMij-netwerk | Alle *Dienstverleners persoon* en alle *Dienstverleners aanbieder* vormen samen het MedMij-netwerk. Elke *Dienstverlener persoon* moet met elke *Dienstverlener aanbieder* kunnen uitwisselen en vice versa. | Tussen Persoonsdomein en Aanbiedersdomein | Netwerk |
| Minor release | Release met wijzigingen die invloed hebben op de functionaliteit en die backwardscompatible zijn. | | |
| Notificatie | Kennisgeving van *Aanbieder* aan *Dienstverlener persoon*. | Tussen Persoonsdomein en Aanbiedersdomein | |
| Notification Client | Een geautomatiseerde rolvan*Dienstverlener aanbieder* voor het namens *Aanbieders*plaatsen van Notificaties. | | |
| Notification Server | Een geautomatiseerde rolvan *Dienstverlener persoon* waarop de *Aanbieder* Notificaties kan aanbieden. | | |
| OAuth Authorization Server | Een OAuth Authorization Server is een Authorization Server die gebruikmaakt van het OAuth 2.0 raamwerk. | | |
| OAuth Client | Een OAuth Client is een Resource Client die gebruik maakt van het OAuth 2.0 raamwerk. | | |
| OAuth Client List | Een lijst met de namen van *Dienstverleners persoon*, welke Gegevensdiensten zij ondersteunen en naar welke adressen mogelijk Notificaties in het kader van Abonnementen op die Gegevensdiensten kunnen worden gestuurd, met de bijbehorende Interfaceversie. | | |
| OAuth Resource Owner | Een OAuth Resource Owner is een *Persoon*die een OAuth Client autoriseert voor toegang tot een OAuth Resource Server. De toegang is beperkt tot het bereik van de verleende autorisatie. | | |
| OAuth Resource Server | Een OAuth Resource Server is een Resource Server die gebruikmaakt van het OAuth 2.0 raamwerk. | | |
| Opgever | De handelend natuurlijke persoon die opgave doet aan een Machtigingsregister van een verleende machtiging zodat deze gebruikt kan worden en de voor deze registratie vereiste bewijzen aanlevert. | | |
| Optionele versie | Dit is de versie van het afsprakenstelsel waar deelnemers aan mogen voldoen. Deze heette voorheen de optionele versie. | | |
| Ouderlijk gezaghebbende | Een partij die op grond van ouderlijk gezag de wettelijke bevoegdheid heeft om in naam van een kind van 0 tot 12 jaar (lees: Vertegenwoordiger) bepaalde handelingen te verrichten. | | Vertegenwoordiger |
| Patches | Kleine wijzigingen die geen invloed hebben op de functionaliteit en backwards compatible zijn. | | |
| Persoon | Degene op wie Gezondheidsgegevens betrekking hebben die via MedMij worden uitgewisseld en tevens de Gebruiker in het Persoonsdomein. | Persoonsdomein | Burger, individu, patiënt, cliënt, zorgconsument, zorggebruiker |
| Persoonlijke gezondheidsomgeving | Een persoonlijke gezondheidsomgeving is een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de *Aanbieder*mogelijk maakt via het MedMij Afsprakenstelsel. | Persoonsdomein | PGO, persoonlijk gezondheidsplatform |
| Persoonsdomein | Alle *Personen* en alle *Dienstverleners personen* vormen samen het persoonsdomein. | Persoonsdomein | |
| Release (slot) | Tijdssloten waarin wijzigingen worden opgenomen in de verplichte versie en de optionele versie. Er zijn 12 release slots in een jaar, waarvan er 2 major release slots zijn. | | |
| Resource Client | De Resource Client is de applicatie die verbinding maakt met een Resource Server. | | |
| Resource Server | De *Resource Server* is de applicatie waar gegevens kunnen worden verzameld of waarmee gegevens gedeeld kunnen worden. | | |
| Rol | Een samenhangende set van verwachte en overeengekomen verantwoordelijkheden en interacties in het MedMij Afsprakenstelsel. Aan een rol zijn afspraken gekoppeld die zijn vastgelegd in het MedMij Afsprakenstelsel. Een rol kan worden vervuld door een natuurlijke persoon en/of organisatie. | Alle domeinen samen | |
| Service Level Agreement | Een Service Level Agreement (SLA) is een overeenkomst waarin de kwaliteit is beschreven van de diensten die worden geleverd. De overeenkomst kan zowel een contract met externe als interne partijen zijn. Dankzij een SLA is een afnemer op de hoogte van de invulling en kosten van de diensten die hij inkoopt en kan de leverancier erop worden afgerekend als hij niet de afgesproken kwaliteit levert. | Alle domeinen | SLA |
| Simulator | Een speciaal t.b.v. testen gemaakt onderdeel dat de werking van de DVA of de DVP of een andere systeemfunctie nabootst. | Alle domeinen | |
| Simulatortest | Test van applicatie tegen simulator. | Alle domeinen | |
| Stichting MedMij | De rechtspersoon die (eind)verantwoordelijk is voor de ontwikkeling en het beheer van het afsprakenstelsel en de verwijzing naar de informatiestandaarden die nodig zijn om gegevens in dezelfde taal te kunnen uitwisselen. De Stichting MedMij is de eigenaar van het MedMij Afsprakenstelsel. | | |
| Subscription Client | Een geautomatiseerde rol van de *Dienstverlener persoon* voor het namens *Personen*aangaan van Abonnementen. | | |
| Subscription Server | Een geautomatiseerde rol van de *Dienstverlener Aanbieder* (met Authorization Server en Subscription Server) voor het namens *Aanbieders*aangaan van Abonnementen. | | |
| Substitutie | Het door de *Gemachtigde*doorgeven van zijn machtiging aan een ander persoon. | Persoonsdomein | |
| Testgeval | Een set van precondities, inputs, acties, verwachte resultaten en postcondities waarmee wordt onderzocht of het systeem onder gedefinieerde omstandigheden het gewenste gedrag vertoont. | Alle domeinen | |
| Testmethodiek | Plek met informatie behorend bij het hoofdstuk Testen in het MedMij Afsprakenstelsel. Bevat o.a. het Testplan, de acceptatiecriteria en overige informatie rondom testen. | Alle domeinen | Testbeleid |
| Testplan | Plan van aanpak als referentiekader gedurende het organiseren en de uitvoering van de tests inclusief een beschrijving van de activiteiten, de planning en testscenario's. Het testplan bevat dus NIET een beschrijving van de tests, zoals testgevallen, zelf. | Alle domeinen | Mastertestplan, Plan van aanpak |
| Testscenario | Opeenvolging van testgevallen om deze op een efficiënte manier handmatig of geautomatiseerd uit te voeren*.* | Alle domeinen | |
| Testscript | De test automatiseringscode behorend bij een of meer testscenario's om tests geautomatiseerd uit te voeren. | Alle domeinen | |
| Testtool | Een geautomatiseerd hulpmiddel dat ondersteuning biedt aan één of meer testactiviteiten, zoals plannen, beheren, specificeren of uitvoeren. | Alle domeinen | |
| Testvoorziening | Verzameling van testtools om tegen te kunnen testen. | Alle domeinen | |
| User Agent | De applicatie die de *Persoon*gebruikt om de MedMij-functies uit te voeren. | Persoonsdomein | |
| Validatie | Via objectief bewijs bevestigen dat de behoeften voor een specifiek gebruik zijn vervuld. ("is het juiste systeem gebouwd") Zie ook: verificatie. | Alle domeinen | |
| Verificatie | Via objectief bewijs bevestigen dat aan de beschreven specificaties is voldaan. ("is het systeem juist gebouwd") Zie ook: validatie. | Alle domeinen | |
| Verplichte versie | Dit is de versie waarop geaccepteerd wordt oftewel de versie waaraan de deelnemers moeten voldoen. Deze versie is gepubliceerd in de Confluence-omgeving MM Verplicht. | Persoonsdomein | |
| Vertegenwoordigde | Een partij (lees: Persoon) waarvoor een specifieke bevoegdheid uitgevoerd wordt door een andere partij op basis van: 1. een vrijwillige (specifieke) machtiging die de Vertegenwoordigde verleent aan die andere partij (de gemachtigde). 2. een wettelijke machtiging op grond van het ouderlijk gezag voor personen van 0 tot 12 jaar. | Persoonsdomein | |
| Vertegenwoordiger | Een partij die op basis van een vrijwillige Machtiging of wettelijke Machtiging op grond van het ouderlijk gezag de bevoegdheid verkrijgt om in naam van de Vertegenwoordigde bepaalde handelingen te verrichten. | Persoonsdomein | |
| Vertegenwoordiging | De rechtsfiguur die inhoudt dat van een door een bepaalde partij (de vertegenwoordiger) in naam van een andere partij (*Vertegenwoordigde*) met een derde een verrichte Rechtshandeling aan de Vertegenwoordigde wordt toegerekend. | Persoonsdomein | |
| Volmacht | De bevoegdheid die een volmachtgever (lees: *Vertegenwoordigde*) verleent aan de vertegenwoordiger, om namens hem/in zijn naam rechtshandelingen te verrichten. | Persoonsdomein | Machtiging |
| Voorziening ouderlijk gezag | Een partij die de verantwoordelijkheid heeft voor het controleren en het afleggen van verklaringen over bevoegdheden op basis van het ouderlijk gezag. Op basis van de registraties van het ouderlijk gezag in het Basis Register Persoonsgegevens (BRP). | | |
| Whitelist | Een lijst met welke Nodes actief mogen zijn op het MedMij-netwerk. | | |
| Wijzigingen | Dit zijn aanpassingen aan het MedMij Afsprakenstelsel. | | |
| Zorgaanbieder | Een zorgverlener of een verband van zorgverleners die behandelingsovereenkomsten kunnen aangaan met patiënten op grond van art. 7:446 BW en tevens de *Gebruiker*in het aanbiedersdomein. | Aanbiedersdomein | Zorginstelling, zorgorganisatie, brondossierhouder |
| Zorginformatiesysteem | Het systeem of geheel van de systemen waarin de zorgaanbieder het medisch dossier van de persoon bijhoudt. | Aanbiedersdomein | XIS |
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Beheren toestemmingen
## Business laag
Een Persoon moet een gegeven langdurige toestemming op elk moment kunnen intrekken bij de Dienstverlener aanbieder.
Hieronder staat flow behorende bij het intrekken van de langdurige toestemming.
Het intrekken van de langdurige toestemming kent de volgende stappen:
1. De Persoon selecteert in zijn PGO de Aanbieder bij wie hij de toestemming wil intrekken.
2. De Dienstverlener Persoon stuurt het verzoek voor intrekken toestemming naar de Dienstverlener aanbieder.
3. De Dienstverlener aanbieder presenteert de landingspagina
4. De Dienstverlener aanbieder laat de Persoon zich authenticeren bij de Dienstverlener authenticatie.
5. Nadat de Persoon geauthenticeerd is, toont de Dienstverlener Aanbieder een Toestemmingsoverzichtspagina met alle toestemmingen aan Aanbieders per Dienstverlener Persoon.
6. De Persoon selecteert de toestemming die hij wil intrekken.
7. De Dienstverlener aanbieder vraagt aan de Persoon of hij de toestemming voor het verstrekken van gegevens aan een Dienstverlener persoon wil intrekken. Deze vraag staat op de pagina Beëindigingsverklaring Toestemming.
8. De Persoon bevestigt het intrekken. Indien hij voor annuleren kiest, komt de Persoon terug op de Toestemmingsoverzichtspagina.
9. De Dienstverlener aanbieder logt het intrekken van de toestemming en trekt het refresh-token in en toont opnieuw de Toestemmingsoverzicht pagina aan de Persoon.
10. De Persoon kan kiezen om terug te gaan naar zijn PGO of kan nog een toestemming selecteren om in te trekken.
## Applicatielaag
In elke voltrekking van de in het diagram beschreven flow is steeds sprake van één van elk van de bovenaan genoemde rollen.
De flow kent de volgende stappen:
1. De User Agent vraag de Persoon een Aanbieder te selecteren.
2. De Persoon selecteert een Aanbieder bij wie hij de toestemming wil intrekken.
3. De User Agent stuurt een verzoek tot intrekken van de toestemming naar de Authorization Server. Het verzoek intrekken toestemming moet voldoen aan dezelfde eisen als het authorization request.
4. De *Dienstverlener aanbieder* toont de landingspagina aan de *Persoon* waar de *Persoon* kan kiezen voor de optie Toestemmingen aanpassen.
5. Daarop begint de Authorization Server de OAuth-flow (in zijn rol als OAuth Authorization Server) door een sessie te creëren.
6. Dan start de Authorization Server (nu in de rol van Authentication Client) de authenticatieflow.
7. Na de authenticatieflow valideert de Authorization Server de identificerende gegevens.
8. De Authorization Server presenteert via de User Agent aan Persoon in een Toestemmingsoverzicht de aanwezige toestemmingen en vraagt de toestemming te selecteren die hij wil intrekken.
9. De User Agent stuurt het verzoek tot intrekken van desbetreffende toestemming naar de Authorization Server.
10. De Authorization Server presenteert via de User Agent aan Persoon de Beëindigingsverklaring Toestemming.
11. Bij bevestiging door de Persoon logt de Authorization Server het intrekken van de toestemming en trekt het refresh-token in.
12. De Authorization Server presenteert via de User Agent aan Persoon het Toestemmingsoverzicht. Hier kan de Persoon kiezen om nog een toestemming in te trekken of om terug te gaan naar zijn Dienstverlener Persoon.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Beleid
Het beleid gaat in op de vraag hoe Stichting MedMij omgaat met een aantal belangrijke besturingsthema's en vormt de basis voor de [Operationele processen](https://afsprakenstelsel.medmij.nl/v23/archief/operationele-processen.md). Het beleid is richtinggevend voor het optreden van Stichting MedMij. Het bevat ook verantwoordelijkheden voor deelnemers. Indien de situatie daarom vraagt, mag Stichting MedMij na belangenafweging afwijken van het beleid.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Beleid inzake gecontroleerde livegang
Stichting MedMij biedt *Deelnemers* de gelegenheid om, wanneer zij zich gekwalificeerd hebben voor een specifieke *Gegevensdienst* , gefaseerd live te gaan met die *Gegevensdienst* op het MedMij-netwerk. Gedurende een zogenoemde 'gecontroleerde livegang' wordt tijdelijk afgedongen op het principe dat, indien een zekere *Aanbieder* een zekere *Gegevensdienst* aanbiedt op het MedMij-netwerk, alle daarvoor gekwalificeerde *Dienstverleners persoon* deze *Gegevensdienst* ook van deze *Aanbieder* moeten kunnen afnemen. Tijdens een gecontroleerde livegang is een *Aanbieder* , via diens *Dienstverlener aanbieder* , in de gelegenheid om die toegang te beperken tot een beperkte groep *Dienstverleners persoon*.
Zo wordt weliswaar afgedongen op een cruciaal principe van MedMij, maar staat dit in dienst van datzelfde principe: gecontroleerde livegangen zijn tijdelijk en beogen de inbedding van betrokkenen in het MedMij-netwerk waarin het principe volop geldig is.
Een gecontroleerde livegang wordt gekarakteriseerd door:
* één *Gegevensdienst*;
* één of meer *Aanbieders* die met deze *Gegevensdienst* gecontroleerd live willen gaan;
* één of meer *Dienstverleners aanbieder* die deze *Gegevensdienst* voor deze *Aanbieder(s)* ontsluiten;
* één of meer *Dienstverleners persoon* tot wie de toegang tot deze *Gegevensdienst* van deze *Aanbieder(s)* beperkt wordt gedurende de gecontroleerde livegang. *Dienstverleners persoon* kunnen desgewenst een deel van hun gebruikerskring afzonderen voor de gecontroleerde livegang, maar de organisatie en implementatie daarvan valt geheel binnen hun eigen verantwoordelijkheid.
Gecontroleerde livegangen worden alleen toegestaan op de *Interfaceversie* die hoort bij de op dat moment verplichte release. Zie [](https://medmij.atlassian.net/wiki/display/MMAS2MIG/Change-+en+releasebeleid+(oud)). Bij het verouderen van een tot dan toe verplichte release stopt de gecontroleerde livegang. Het is daarom aanbevelenswaardig gecontroleerde livegangen te starten kort na een releasemoment.
Gedurende een gecontroleerde livegang kunnen *Aanbieders* , *Dienstverleners aanbieder* en *Dienstverleners persoon* toetreden tot en uitreden uit een gecontroleerde livegang. Wanneer de laatste *Aanbieder* , de laatste *Dienstverlener aanbieder* of de laatste *Dienstverlener persoon* zou uittreden, wordt de gecontroleerde livegang definitief beëindigd. Uittreding van een *Aanbieder* kan gepaard gaan met een promotie, dat wil zeggen, met het opgaan van die *Aanbieder* met de betreffende *Gegevensdienst* in het MedMij-netwerk, buiten die gecontroleerde livegang. Promotie van alle deelnemende *Aanbieders* is het uiteindelijke doel van elke gecontroleerde livegang, maar geen verplichting. Promotie is een vrije keus van de betreffende *Aanbieder* en vereist geen nadere kwalificatie of acceptatie.
Een gecontroleerde livegang wordt na drie maanden definitief beëindigd. Op gezamenlijk verzoek van betrokken partijen is hierop een eenmalig uitstel van één maand mogelijk. Een *Aanbieder* mag op eenzelfde *Gegevensdienst* niet deelnemen in een gecontroleerde livegang wanneer hij minder dan drie maanden geleden ook al betrokken was bij een gecontroleerde livegang op die *Gegevensdienst* . Stichting MedMij behoudt zich het recht voor op te treden tegen situaties waarin een *Dienstverlener persoon* concurrentieel voordeel ontleent of beoogt te ontlenen aan de tijdelijke exclusiviteit die hem gedurende een gecontroleerde livegang wordt gegund in het afnemen van de betreffende *Gegevensdienst* van een betrokken *Aanbieder*.
Op een controleerde livegang zijn onverminderd alle verantwoordelijkheden van toepassing die betrokken partijen dragen uit hoofde van hun deelname aan MedMij. Gecontroleerde livegangen worden langs geheel administratieve weg georganiseerd door de MedMij Beheerorganisatie. Van de betreffende *Gegevensdienst* wordt een kopie-*Gegevensdienst* gecreëerd en in de *Catalogus* opgenomen, waarop alleen bij de gecontroleerde livegang betrokken *Dienstverleners* erkend worden, onder de voorwaarde dat zij gekwalificeerd zijn op de originele *Gegevensdienst* . Een kopie-*Gegevensdienst* kan geen origineel zijn voor een volgende kopie. Er kunnen van één origineel-Gegevensdienst onbeperkt veel kopieën bestaan, na elkaar of tegelijkertijd. Na beëindiging van de geldigheid van een kopie-*Gegevensdienst* wordt deze nooit opnieuw geldig.
De kopie-*Gegevensdienst* is alleen geldig gedurende de gecontroleerde livegang, maar nooit buiten de geldigheidsduur van de origineel-*Gegevensdienst* . In de *OAuth Client List* en de *Aanbiederslijst* verschijnen de betrokken partijen met de kopie-*Gegevensdienst* , net zoals ze met de origineel-*Gegevensdienst* zouden verschijnen. Een gecontroleerde livegang is dus weliswaar besloten, maar niet geheim. Alle uitwisselingen in het kader van een gecontroleerde livegang worden net zo behandeld als alle andere MedMij-uitwisselingen.
Een gecontroleerde livegang is dus geen proef-deelname, maar in alle opzichten een deelname aan het MedMij-netwerk, waarin evenwel een *Gegevensdienst* voor een *Aanbieder* gefaseerd live kan worden ontsloten naar alle daartoe gekwalificeerde *Dienstverleners persoon*.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Besluitvorming
## Besluitvorming over doorontwikkeling afsprakenstelsel
* Statuten Stichting MedMij: In de statuten is onder meer vastgelegd wat het doel is van de stichting, hoe het bestuur en de Raad van Toezicht wordt benoemd en wat hun taken zijn. De statuten zijn gepubliceerd op de [website van Stichting MedMij](https://medmij.nl/wp-content/uploads/2025/03/Statuten-Stichting-MedMij-10-03-2025.pdf).
* Reglement: In het Reglement is vastgelegd hoe stakeholders zijn betrokken bij de doorontwikkeling en toepassing van het MedMij Afsprakenstelsel en de roadmap. Het reglement is vastgesteld conform artikel 16 van de statuten van Stichting MedMij.
---
version: "MedMij Afsprakenstelsel 2.2.6d"
language: "nl"
---
# Bevestigingsverklaring Delen, Core
Na het succesvol authenticeren van de Persoon wordt, mits het resultaat van de ontvankelijkheidstoets positief is, de bevestigingsverklaring getoond aan de Persoon. De Dienstverlener aanbieder toont welke gegevens gedeeld mogen worden.
De tekst onder het kopje toelichting mag ook worden weergegeven in een uitklapbaar toelichtingsvenster.
## Tekst
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Titel: Bevestigingsverklaring** Ik wil persoons- en medische gegevens delen met \. Jouw zorgverlener bepaalt daarna of hij deze informatie opneemt in jouw medisch dossier en/of gebruikt voor jouw behandeling. Persoonsgegevens zijn bijvoorbeeld jouw naam en geboortedatum. Medische gegevens zijn gegevens die jouw zorgverlener bijhoudt over jouw behandeling, bijvoorbeeld de medicijnen die je slikt en bloeduitslagen. Hierbij geef ik \ toestemming om de volgende gegevens te delen met \. * \ * \ **Toelichting** In een persoonlijke gezondheidsomgeving (PGO) kun je verbinding maken met de computer van jouw zorgaanbieder(s), zoals van de huisarts of het ziekenhuis. Natuurlijk wil je dat dit veilig gebeurt. Hiervoor heeft de Stichting MedMij strenge regels gemaakt. PGO's en zorgaanbieders met een MedMij-label volgen deze regels. Het MedMij-label betekent dat jij deze PGO op een veilige manier kunt verbinden met deze zorgaanbieders. Het betekent ook dat jouw gegevens veilig worden opgeslagen in jouw PGO. \ wil zeker weten dat je je persoons- en/of medische gegevens met hem wil delen. Na jouw toestemming worden de gegevens vanuit je PGO naar \ gestuurd. Het is aan je zorgverlener om te beslissen of hij de informatie die je met hem deelt opneemt in je medische dossier. |
## Voorbeeld
[Next Page](https://afsprakenstelsel.medmij.nl/llms-full.txt/1)