Dit is een versie van het Twiin Afsprakenstelsel voor consultatie

BgZ: PvE Overige Generieke functie-eisen

De eisen in dit hoofdstuk zijn de generieke eisen, benodigd voor deze toepassing. Waar aanvullende afspraken zijn gemaakt, vind je deze bij ‘Implicatie bij toepassing’ of is er een afgeleide van de basiseis aangemaakt. Toelichting over de opgenomen attributen is te vinden onder 1.3 | Schrijfwijze van objecten.

Generieke functie: Identificatie en authenticatie

TW-F-IA-001

Identificatie op basis van uniek ID

Status

Normatief

Omschrijving

Zorgverleners MOETEN geïdentificeerd worden op basis van een uniek ID. Dit is een UZI of een ander uniek tot één persoon te herleiden nummer.

Toelichting

Wanneer een eigen ID wordt gebruikt MOET dit een unieke combinatie van persoons-ID en organisatie-ID opleveren en dat dit herleidbaar blijft (ook na, bijvoorbeeld, vertrek van zorgverlener), uitgegeven op het op het juiste betrouwbaarheidsniveau. Deze eis is van toepassing op alle Twiin-transacties.

Vereiste

MOET

Functie

Identificatie Authenticatie

Rol

Twiin Deelnemer

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


TW-F-IA-002

Authenticatie op eIDAS-niveau hoog

Status

Normatief

Omschrijving

Zorgverlener/gebruiker (van het GTK) MOET (lokaal) geauthentiseerd worden op eIDAS-niveau hoog

Toelichting

Door de keten heen kan hier nog geen bewijs van worden meegeven zodat andere partijen de zorgverlener ook met zekerheid kunnen authenticeren. Deze eis is van toepassing op alle Twiin-transacties.

Vereiste

MOET

Functie

Identificatie Authenticatie

Rol

Twiin Deelnemer

Toetsingscategorie

Via Twiin

Toetsingsvorm

Zelfverklaring

Niveau

Generiek


TW-F-IA-003

Opzoekbaar maken publieke sleutel gebruikt voor ondertekening

Status

Normatief

Omschrijving

GTK Verzender en GTK Ontvanger MOETEN de publieke sleutel(s) die zij gebruiken voor de ondertekening van JWT’s via kid opzoekbaar maken voor GTK Ontvanger.

Toelichting

De wijze waarop de uitwisseling van publieke sleutels tussen GTK Verzender en GTK Ontvanger plaatsvindt is (nog) niet gebonden aan normatieve eisen. Het is aan GTK Verzender en GTK Ontvanger AANBEVOLEN om onderling en in afstemming met de gebruikte infrastructuur afspraken te maken over de wijze van uitwisseling van publieke sleutels.

Vereiste

MOET

Functie

Identificatie Authenticatie

Rol

GTK

Actor

GTK Ontvanger GTK Verzender

Referenties

10.4.2 | TTA FHIR - Authorization

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


TW-F-IA-004

Aanmaken client assertion

Status

Normatief

Omschrijving

GTK Verzender MOET een client assertion in de vorm van een authentication_grant kunnen aanmaken die voldoet aan de specificaties

Vereiste

MOET

Functie

Identificatie Authenticatie

Rol

GTK

Actor

GTK Verzender

Referenties

10.4.2 | TTA FHIR - Authorization

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


TW-F-IA-005

Identifiers GTK

Status

Normatief

Omschrijving

GTK Verzender en GTK Ontvanger MOETEN gebruik maken van dezelfde identifiers voor de systemen die opereren als autorisatie-servers (authorization server token endpoints)

Toelichting

Het toekennen en gebruiken van identifiers van systemen is (nog) niet gebonden aan landelijke normatieve eisen. GTK Verzender en GTK Ontvanger MOETEN daarom onderling en in afstemming met de gebruikte infrastructuur afspraken maken over de te gebruiken identifiers van systemen.

Voor nu is afgestemd dat de systeem identifiers zelf gekozen moeten zijn, maar de vorm van een FQDN of OID mogen hebben.

Vereiste

MOET

Functie

Authenticatie

Rol

GTK

Actor

GTK Ontvanger GTK Verzender

Toepassing

BgZ Correspondentie

Referenties

Zie `aud`-velden in Twiin-07 | Token Request

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


Generieke Functie: Autorisatie

TW-F-AU-001

Systeem identifiers autorisatie-clients

Status

Normatief

Omschrijving

GTK Verzender en GTK Ontvanger MOETEN gebruik maken van dezelfde identifiers voor de systemen die opereren als autorisatie-clients (OAuth clients).

Toelichting

Het toekennen en gebruiken van identifiers van systemen is (nog) niet gebonden aan normatieve eisen. GTK Verzender en GTK Ontvanger moeten daarom onderling en in afstemming met de gebruikte infrastructuur afspraken maken over de te gebruiken identifiers van systemen.

Vereiste

MOET

Functie

Autorisatie

Rol

GTK

Actor

GTK Ontvanger GTK Verzender

Referenties

Zie `iss`-velden bij Twiin 07 | Token request

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


TW-F-AU-003

Aanmaken access token request voor resource endpoint

Status

Normatief

Omschrijving

De GTK Ontvanger MOET conform de specificaties een access token request voor toegang tot het resource-endpoint aan kunnen maken en aan GTK Verzender versturen.

Toelichting

Eventueel inclusief een eerder van GTK Verzender ontvangen authorization_grant, welke de digitale representatie van de veronderstelde toestemming (authorization_base) bevat.

Vereiste

MOET

Functie

Autorisatie

Rol

GTK

Actor

GTK Ontvanger

Referenties

Twiin-07 | Token Request | Access token request

Twiin-07 | Token Request | Authorization grant

Twiin-07 | Token Request | Authorization base

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


TW-F-AU-004

Aanmaken access token request voor resource endpoint

Status

Normatief

Omschrijving

GTK Verzender MOET conform de specificaties een access token request van GTK Ontvanger voor toegang tot het resource server endpoint af kunnen handelen.

Vereiste

MOET

Functie

Autorisatie

Rol

GTK

Actor

GTK Verzender

Referenties

Twiin-07 | Token Request

Toetsingscategorie

Via Twiin

Toetsingsvorm

Technisch

Niveau

Generiek


Generieke functie: Toestemming

TW-F-T-001

Aansluiting op Mitz

Status

Normatief

Omschrijving

Een GTK ZOU een aansluiting op Mitz MOETEN hebben.

Toelichting

Een GTK die uitwisselingen ondersteunt waar uitdrukkelijke toestemming voor nodig is, ZOU een Mitz Connector Aansluiting MOETEN ondersteunen. Op het moment dat de onderliggende bronsystemen zelf de controle op de toestemming voor gegevensuitwisseling uitvoeren, is er geen noodzaak voor het GTK om dit ook te doen.

Vereiste

ZOU MOETEN

Functie

Toestemming

Rol

GTK

Referenties

Mitz Afsprakenstelsel

Toetsingscategorie

Geen

Niveau

Generiek


Generieke functie: Adressering

TW-F-AD-001

Publiceren endpoints voor adresinformatie

Status

Normatief

Omschrijving

De GTK Ontvanger en GTK Verzender MOETEN de technische adressen van het resource-endpoint, het notificatie-endpoint en het token-endpoint kenbaar maken aan de Twiin Beheerorganisatie.

Toelichting

De wijze waarop technische adressen tussen GTK Verzender en GTK Ontvanger worden gecommuniceerd is (nog) niet gebonden aan normatieve eisen.

De Twiin Beheerorganisatie publiceert de endpoints en technische adressen in ZORG-AB. Om de technische adressen van een andere partij te achterhalen kan er worden gekozen om ZORG-AB te raadplegen (Zie ZORG-AB Transacties) maar dit is niet verplicht.

GTK Verzender en GTK Ontvanger kunnen bijvoorbeeld ook onderling afspraken maken over de wijze waarop technische adressen worden gecommuniceerd.

Vereiste

MOET

Functie

Adressering

Rol

GTK Twiin Deelnemer

Actor

GTK Ontvanger GTK Verzender

Referenties

10.6.5 | Addressing - ZORG-AB Transacties

Toetsingscategorie

Geen

Niveau

Generiek


Generieke functie: Logging

TW-F-LO-001

Loggen berichtuitwisseling

Status

Normatief

Omschrijving

Het GTK MOET alle berichtuitwisseling met andere GTK’s loggen.

Toelichting

Wat er functioneel gelogd moet worden is gespecificeerd in de norm NEN 7513:2024. Deze eis is van toepassing op alle Twiin-transacties.

Vereiste

MOET

Functie

Logging

Rol

GTK

Toepassing

BgZ Correspondentie

Referenties

NEN 7513:2024, tabel 3 - Format van logregel voor uiwisselingsgebeurtenissen

Toetsingscategorie

Via Twiin

Toetsingsvorm

Zelfverklaring

Niveau

Generiek


TW-F-LO-002

Loggegevens uitwisselen

Status

Normatief

Omschrijving

Het GTK MOET loggegevens over uitwisselingen met andere GTK's kunnen aanleveren aan die GTK's.

Toelichting

Eis uit NEN7512:2022 6.2.9:

“De communicatiepartijen moeten afspraken maken over de wederzijdse inzage in de logbestanden en de termijn waarbinnen deze mogelijk wordt gemaakt.”

Zolang er nog geen landelijke procedures en afspraken zijn opgesteld over de uitwisseling van de logging tussen GTK’s zal dit in de (uitzonderlijke) gevallen wanneer dit toch nodig is op ad hoc basis gedaan moeten worden.

Vereiste

MOET

Functie

Logging

Rol

GTK

Toepassing

BgZ Correspondentie

Referenties

NEN7512:2022 6.2.9

Toetsingscategorie

Via Twiin

Toetsingsvorm

Zelfverklaring

Niveau

Generiek


Generieke functie: Routering

TW-GF-RO-001

Update van wijzigingen tussen adresboeken

Status

Draft

Omschrijving

GTK’s MOETEN een opvraag-mutatiequery kunnen doen richting de gekoppelde adresboeken.

Toelichting

Adresboeken ontvangen hiermee bruikbaar aanbod.

Vereiste

MOET

Implicatie bij toepassing

ZORG-AB vraagt nachtelijks aan adresboeken, zoals Zorgplatform Adresboek de routeringsgegevens op / Adresboeken, zoals Zorgplatform vragen nachtelijks bij ZORG-AB de routeringsgegevens op.

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-002

GTK’s bieden een interface voor updaten van wijzigingen tussen adresboeken

Status

Draft

Omschrijving

Indien een GTK een eigen adresboek heeft, MOETEN zij een interface aanbieden waarop andere GTK’s of leveranciers achter deze GTK deze kunnen bevragen.

Vereiste

ZOU MOETEN

Implicatie bij toepassing

Adresboeken, zoals Zorgplatform MOETEN een API/Interface beschikbaar stellen voor ZORG-AB om het adresboek te kunnen bevragen. Het adresboek filtert voor de vrager hierbij of het een test- of productie-endpoints zijn. ZORG-AB heeft een interface waarop specifieke adresboeken, zoals Zorgplatform op kunnen actualiseren of uitvragen.

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-003a

Rol leverancier bij routering: bulk-actualisatie

Status

Draft

Omschrijving

De leverancier achter het GTK MOET postvakken kunnen verwerken: zij dienen ZORG-AB te bevragen voor juiste routering OF zelf GTK('s) met adresboek bevragen.

Vereiste

MOET

Functie

Routering

Rol

GTK

Actor

EPD Ontvanger EPD Verzender

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-003b

Rol adresboeken bij routering: bulk-actualisatie

Status

Draft

Omschrijving

Adresboeken MOGEN NIET vaker dan 1x per 24u hun eigen gegevens bijwerken, daarom MOETEN ze andere adresboeken 1x per 24u raadplegen om gegevens te actualiseren.

Toelichting

In de toekomst is er de intentie om vaker dan 24u bevragen.

Vereiste

ZOU MOETEN

Implicatie bij toepassing

ZORG-AB dient Zorgplatform 1x per 24u te bevragen op aanpassingen. Een adresboek, zoals Zorgplatform Adresboek dient ZORG-AB 1x per 24u te bevragen.

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-004a

Rol leverancier bij routering: gerichte actualisatie (real-time)

Status

Draft

Omschrijving

Een deelnemer MOET per verwijzing een uitvraag naar het eigen adresboek kunnen doen en de laatste routeringsinformatie kunnen ontvangen.

Vereiste

MOET

Functie

Routering

Rol

GTK

Actor

EPD Ontvanger EPD Verzender

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-004b

Rol adresboeken bij routering: gerichte actualisatie (real-time)

Status

Draft

Omschrijving

Adresboeken ZOUDEN bij een gerichte actualisatievraag vanuit een leverancier gegevens realtime MOETEN opvragen bij de andere adresboeken

Toelichting

Real-time betekent vooralsnog (tot aan implementatie van mCSD) het opvragen van de reeds geüpdatet wijzigingen die gecached (kunnen) zijn.

Vereiste

ZOU MOETEN

Implicatie bij toepassing

ZORG-AB vraagt aan Zorgplatform de laatste actuele routeringsinformatie. Zorgplatform vraagt aan ZORG-AB de laatste actuele routeringsinformatie

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-005

Velden bij routering

Status

Draft

Omschrijving

GTK’s MOETEN de volgende velden bij voor routering bijhouden en kunnen meesturen:

  • URA

  • AD-omschrijving

  • Naam Zorgaanbieder

Vereiste

MOET

Implicatie bij toepassing

Zorgplatform deelt de volgende velden via hun interface:

  • Intern Zorgplatform-adresboek-ID wordt meegestuurd. Deze is betekenisloos voor de ontvanger, maar van belang om verwijzing op de juiste werklijst te zetten bij de ontvanger/HiX. De verzender dient dit ID te gebruiken

  • Omschrijvingsveld met inhoudelijke tekst om voor de verzender de relevantie te bepalen. De beheerder wijst de waarde hierin toe. Het betreft niet het Specialisme-veld.

  • De weergavenaam + OID van de zorginstelling(en)

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek


TW-GF-RO-007

Zorgaanbieders bevragen adresboeken

Status

Draft

Omschrijving

Indien een GTK een eigen adresboek met interface aanbiedt, MOGEN zorgaanbieders of leveranciers achter het GTK dit adresboek bevragen.

Vereiste

ZOU MOETEN

Functie

Routering

Rol

GTK

Toepassing

BgZ Correspondentie

Niveau

Generiek