Zorginzage V6 hackathon spec
DitThis document heeftis de statusin DRAFT
Zorginzage V6 hackathon purposePurpose
The purpose of the zorgingzhackathon is to demonstrate a simple implementation of Nuts Zorginzage in Nuts V6. The present Nuts Zorginzage 2022 spec uses Nuts V5, but has several limitations, which is why the intention is to make use of Nuts V6 in the future. This hackathon is the stepping stone towards creating V6 Zorginzage usecases in the future.
Scope
- add Martijn's draft of the scope with some clarifications what is out of scope and what is optional. To be enriched with more specific plans of participating vendors.
Functional design
Discovery Service (adressbook & use-case whitelist)
The Discovery Service serves the function of an adressbook for the organisationsorganizations that are compliant and available for this specific usecase. The Discovery Service has its own use-case specific schema: Presentation Definition (PD). All the vendors in the usecaseus ecase prove their compliance with the PD by periodically publishing their PD to the discovery service.
*For more info in DS see: https://docs.google.com/presentation/d/1LRnY5JfMAcMwwqEonX3n_uEDT1geQ3Kj_IKxS-ZeeVA/edit#slide=id*.g1f525990acb_0_159
Presentation defintion:defintion
PD componentVCs
The PDs credibility is determined by verifiability of the required credentials (VC). Only one verifiable credential will be used for the hackaton.hackathon. This is very similiarsimilar to the Nuts OrganitionOrganization Credential in V5, but the primary difference is that it is no longer self-issued, but rather issued by a governing authority
Credential contents:
- URA (logical identifier)
- Adress
- ?
Credential issuer:
There will be one trusted party that issues these VCs to the server-side-wallets of the other vendors in this usecase. We can use the following open open-source implementation to issue the credentials:
- Add link from Rein
- Decide who spins it up
Presentation definition:PD logistical information component
Alongside the VCs in the presentation definition, there following logistical information must also be presented
UsecaseUse case ID:
-
Max validity:
60 minutes
-
Server
endpoint(sendpoint -
?
What else?
Localization
By localization we mean “finding out where a patient is in treatment”. That will not be in scope for this hackaton.hackathon. Instead, we will request directly to the other organisationsorganizations in the discovery service without checking/finding out if there is a patient file there.
Data-access policies
Wheter or not a requestor gets access to the data they are requesting depends on whether they pass the access-polices of the bronhouder.source (bronhouder). To ensure interoperability, a uniform standard for the data-acces policies is described for each usecase. The intention for the hackaton is to define this in the Open Policy Agent (OPA) scripting languagen.
PractionerPractitioner identification & authentication
The practionerpractitioner that initiates the request must be identifiable so that it can be verified at a later momentmoment, who iniatedinitiated what action (in line with NEN7513). Just having the identification information present has been deemed insufficient because that lacks the proof that a human performed an action (as opposed to a machine). To ensure the action is preformed by a human, an Employee Identity Credential is a required and checked in the data-access policy.
- Expand and describe how
Authorization policy (checking legal base)
It is the responsiblityresponsibility of the bronhouder to check wheterwhether the requestor has a legal-base for accessing the data. For this Hackaton it is not astrictly requirementrequired to perform this check, nor does it have to be standardized. In current Nuts V5 implementations, the authorization is always explicit-consent based, which is why that will be the focus of V6.
- Decide if and how we define authorization policy.
However, it is important that we standardize the error-responses to be used and what they indicate.
-
AreDecideweerror-responsesindeed not going to do anyfor authorization
More thispolicies? hackton?Run-time?
- Add if relevant
Access token specification
The eventual access-token will look like thisthis....
- to-do
Resources
The aim is to validate that a simple data-request can be succesful. Therefore the set of resources is deliberately limited.
Data-exchange
- Patient resource (link to Stu3 profile)
- Consent resource (link to Stu3 profile)
Technical design
- Todo: sequence diagrams
- Todo: architecture map
- Todo: specifying VC schemas
Dit document beschrijft het zorgtoepassingprofiel huisartsinzage in het thuiszorgdossier. Het profiel is gebaseerd op de Nuts Bolt Zorginzage 2022 en bevat specifieke afspraken de gelden voor de zorgtoepassing huisartsinzage in het thuiszorgdossier.
Dit artikel beschrijft achtereenvolgens
de identifier van de zorgtoepassing;de governance;de informatiestandaarden;de toegestane authenticatiemiddelen;de toegestane grondslagen;organisatiebeleid ende access policy.
Identifier van de zorgtoepassing
De identifier van de zorgtoepassing huisartsinzage in het thuiszorgdossier is ‘zorginzage-thuiszorgdossier-door-huisarts’
Governance
Governance van het zorgtoepassingsprofiel wordt uitgevoerd door intiatiefnemende leveranciers, te weten: Nedap, HINQ, Ecare en Topicus. Leveranciers die op een later moment ook het zorgtoepassingsprofiel zullen ondersteunen maken daarmee per direct onderdeel uit van ‘governance groep’. Partijen zorgen zelfstandig voor het raadplegen van de achterban om te komen tot een goede beslisvoering.
Partijen streven naar het overdragen van deze governance aan zorgpartijen als InEen en Actiz.
Informatiestandaarden
Er is op dit moment geen informatiestandaard beschikbaar rondom de inzage van het thuiszorgdossier. Zolang deze nog niet beschikbaar gebruiken we de resources die verderop in het document vermeld worden.
Daarbij is het belangrijk dat we een invulling geven aan het niet onnodig delen van rapportages die niet van nut zijn voor huisartsen. Het verdient aandacht om te zien op basis van welk criteria we daar het filter op kunnen zetten (bij de bron).
Toegestane authenticatiemiddelen
Om veilig gegevens te kunnen delen, tussen verschillende zorgaanbieders, is zorgaanbieder-overstijgende authenticatie van zorgverleners essentieel. Vanuit de NEN wordt gewerkt aan een norm met betrekking tot identificatie en authenticatie. Op het moment dat deze norm gepubliceerd wordt, is deze norm leidend. Om op korte termijn informatie uitwisseling mogelijk te maken, tot publicatie van de norm, zal vertrouwd worden op de authenticatie van het raadplegende systeem.
Toegestane grondslagen en bewijzen
Voor de zorgtoepassing huisartsinzage in het thuiszorgdossier worden de volgende grondslagen ondersteund:
‘expliciete toestemming vooraf’
In een later stadium kan onder de in de Nuts Bolt Zorginzage beschreven voorwaarden desgewenst de ‘Wabvpz-toestemming vooraf’' worden toegevoegd.
Voor ‘expliciete toestemming vooraf’ zijn de volgende bewijzen toegestaan:
registratie in het bronsysteem (bijvoorbeeld door middel van een 'vinkje')ingescand, door de betrokkene ondertekend, toestemmingsformulier
Toestemming gebeurd op organisatie niveau. Daarom gaan we uit van een autorisatie op AGB-niveau.
Expliciete toestemming wordt vooraf afgegeven voor mogelijk meerdere AGB’s.
Organisatiebeleid
Iedere partij die de zorgtoepassing huisartsinzage in het thuiszorgdossier aanbiedt is zelf verantwoordelijk voor de beschikbaarheid van de eigen infrastructuur, het bron- en/of afnemersysteem en de Nuts-node.De leveranciers van de actor voldoet aan de eisen zoals gesteld in de NEN7510, NEN7512 en NEN7513.De leveranciers van de actor voldoet aan de eisen zoals gesteld in de Algemene verordening gegevensbescherming (AVG).De leveranciers van de actor voldoet aan de eisen zoals gesteld in de Wet aanvullende bepalingen verwerking persoonsgegevens in de zorg (Wabvpz).
Access Policy
Niet-persoonsgebonden resources
Momenteel niet van toepassing.
Persoonsgebonden resources
Dit hoofdstuk beschrijft de afspraken die gelden voor persoonsgebonden resources.
Autorisatie-record
Het ophalen van huisartsinzage in het thuiszorgdossier vereist een geregistreerd autorisatie-record in de vorm van een Nuts Authorization Credential. Het credential moet voldoen aan de volgende eisen:
De issuer moet het DID bevatten van de bronhouder.credentialSubject.id moet het DID van de afnemer bevattencredentialSubject.purposeOfUse moet gelijk zijn aan zorginzage-thuiszorgdossier-door-huisarts.credentialSubject.legalBase.consentType moet gelijk zijn aan implied bij veronderstelde toestemming of explicit bij expliciete toestemmingcredentialSubject.subject moet het BSN bevatten als OID: urn:oid:2.16.840.1.113883.2.4.6.3:999999990.
Normatieve einddatum autorisatie
Bij het aanmaken van een autorisatie-record dient door middel van het veld 'expirationDate' een einddatum aan de autorisatie te worden gegeven. Ten eerste dient deze einddatum gebaseerd te zijn op de wensen van de cliënt in kwestie. De zorgverlener dient de cliënt te vragen naar de gewenste duur van een toestemming. Wanneer de wens van de cliënt ten aanzien van de duur van de toestemming niet is vastgelegd, gelden de volgende normen
Bij een 'expliciete toestemming vooraf' is geen einddatum.
Intrekken autorisatie
Er zijn verschillende redenen denkbaar voor het intrekken van een autorisatie:
Wanneer een autorisatie is gebaseerd op een expliciete toestemming dient deze te worden ingetrokken wanneer de expliciete toestemming wordt ingetrokken. Het autorisatie-record moet in deze gevallen worden ingetrokken door de bronhouder.
Access token
Bij de aanvraag van het access token moet het autorisatie-record volgens bovenstaande eisen worden meegestuurd in het credentials-element. Daarnaast moet er gebruikersinformatie meegestuurd worden in het uzi-element. Het purposeOfUse-element moet de waarde ‘zorginzage-thuiszorgdossier-door-huisarts‘ bevatten.
Levensduur access token: 300 seconden (5 minuten)
Authenticatiecontract
Levensduur authenticatiecontract: 36.000 seconden (10 uur)
Authenticatie vindt plaats op basis van inrichting van het bevragend systeem. Bij deze bevraging wordt het UZI-nummer meegegeven als identificatie voor in de logging.
Autorisatie policy
Wanneer een bronhouder een binnenkomend request afhandelt moet op basis van de BSN, zoals vermeld in het autorisatie-record, toegang worden gegeven tot de gerelateerde resources zoals benoemd in het hoofdstuk Resources.
Er wordt gewerkt met een eenvoudig autorisatiemodel op basis van de identiteit van de raadplegende organsiatie. De gebruikersrol wordt niet meegenomen in de autorisatie beslissing.
Resources
Deze sectie beschrijft de ZIBS en bijbehorende FHIR profielen die moeten worden ondersteund.
Voor deze resources wordt een bundel opgesteld. Iedereen die dit zorgtoepassingsprofiel ondersteund voldoet aan de voorgestelde bundel. Deze zal op een later moment ingediend worden bij NICTIZ.