Voorbereiden implementatie

Uitgangspunt voor het aanbieden van een aanbiedermodule op PGO’s is deelname aan MedMij Afsprakenstelsel als Dienstverlenerpersoon (PGO) of Dienstverleneraanbieder (DVA). Of als module-leverancier voor het project KoppelMij. Dit laatste is niet van toepassing voor module-leveranciers voor het project Persoonsgerichte Hybride netwerkzorg. Uitwisseling volgt afspraken over het gebruik van bijvoorbeeld servercertificaten.
Op deze pagina een vereenvoudigd overzicht van de aanvullende stappen voor deelnemers.

Implementatiestappen leverancier van een aanbiedermodule

De aanbiedermodule-applicatie ondersteunt een endpoint waarop gebruikers binnenkomen met code. Deze code wisselt de module in bij DVA voor patiënttaakinformatie.

Verwachte implementatiedruk: lager.

1. Launch-url beschikbaar maken in de applicatie en vastleggen in FHIR-server.

2. Launch-code uitlezen en met SMART on FHIR omwisselen bij DVA-issuer voor launch-context.

3. Informatie uit launch-context gebruiken voor het ophalen en bewaren van gezondheidsgegevens.

4. Taakresultaat bijwerken bij zorgaanbieder.

5. Gebruiker aanbieden om terug te keren naar PGO als de applicatie eindigt.

Implementatiestappen dienstverleneraanbieder (DVA)

FHIR-server van zorgaanbieder ondersteunt het teruggeven van enkele resources zoals een taak,
en DVAuth-server ondersteunt ondermeer een een implementatie van Token Exchange voor launch-context.

Verwachte implementatiedruk: hoger.

1. Patiënt uitnodigen, bijvoorbeeld per e-mail met een Verbind.MedMij-link.

2. Toewijzen van een module, aanmaken van een taak in Koppeltaal
   met gekoppelde FHIR-resources ActivityDefinition, Endpoint.

3. Deze FHIR-resources aanbieden vanuit DVA op verzoek van PGO.

4. Token exchange ondersteunen voor het vastleggen van een eenvoudige launch-context
   en het terug geven van een launch-code.

5. Smart-on-FHIR-endpoint ondersteunen op .well-known/smart-configuration.

6. Optioneel: patiëntgebruiker aanvullend laten inloggen of een Step-Up
   met OAuth 2.0 Authorization-code-flow na weigeren token exchange.

Implementatiestappen dienstverlenerpersoon (PGO)

Software van PGO ondersteunt het verzamelen van taken en aanvragen van een launch-code.
Gebruiker begrijpt dat aanklikken van een taak maakt dat de browser naar een andere site gaat.

Verwachte implementatiedruk: lager.

• Optioneel: Verbind.MedMij-uitnodiginglinks ondersteunen.

• Verzamelen aanbiedertaken bij DVA en tonen langs weergaverichtlijnen.

• Launch-code aanvragen met token exchange. Bij error=invalid_grant de token-exchange afbreken en Step-Up beginnen: de gebruiker eerst met een gewone OAuth 2.0 Authorization-code-flow toestemming laten halen bij DVA en dan alsnog de launch-code aanvragen.

• Gebruiker naar de launch-url sturen met de code.

• Optioneel: het ondersteunen van een terugkeeradres.