Datadienst ontdekking
In het DSGO worden verschillende datadiensten aangeboden door verschillende datadienstaanbieders. Potentiële datadienstgebruikers moeten daarom weten welke datadiensten worden aangeboden in het DSGO en behoeven inzicht in de benodigde informatie over deze datadiensten om te ontdekken of zij daar gebruik van kan/wil maken.
Bij het ontdekken van een datadienst in het DSGO speelt het centrale participantenregister een cruciale rol. In het centrale participantenregister zijn voor iedere datadienstaanbieder de /capabilities en de /dataServices endpoints op te vragen. Op deze endpoints is meer informatie te vinden over respectievelijk de technische endpoints en de operationele en juridische voorwaarden van de datadiensten.
Elke datadienstaanbieder heeft de keuze om deze endpoints in het centrale participantenregister op te laten nemen. Deze pagina beschrijft de situatie waarbij de datadienstaanbieder de datadienst dit wil.
Als datadienstaanbieders wensen dat haar datadiensten vindbaar zijn in het centrale participantenregister, dan MOETEN zij deze registeren bij de Beheerorganisatie DSGO
Als datadienstaanbieders wensen dat haar datadiensten niet vindbaar is in het centrale participantenregister, dan ZOUDEN ze een bilateraal proces MOETEN faciliteren met de beoogde datadienstgebruikers
Merk op: Datadienstregistratie geldt voor een toetredende datadienstaanbieder (zie toetreding).
Interactiemodel
Het onderstaande figuur bevat de generieke interacties die plaatsvinden bij het ontdekken van een datadienst, de tabel bevat beschrijvingen van deze interacties.
# | Interacties | Omschrijving |
1 | Datadienstregistratie | De datadienstaanbieder registreert haar geïmplementeerde datadiensten bij de Beheerorganisatie DSGO. |
2 | Opname in register | De Beheerorganisatie DSGO neemt de /capabilities en /dataServices endpoints op in het centrale participantenregister. |
3 | Ontdekkingsverzoek | De datadienstgebruiker bevraagt het centrale participantenregister over /capabilities en /dataServices endpoints van een datadienstaanbieder |
4 | Ontdekkingsresponse | Het centrale participantenregister beantwoordt de vraag van de datadienstgebruiker |
5 | Beheer | de registratie van een datadienstspecificatie wordt beheerd door de Beheerorganisatie DSGO. |
1. Datadienstregistratie
De datadienstaanbieder definieert haar geïmplementeerde datadienst in een eigen /capabilities en /dataServices endpoint en stelt deze endpoints beschikbaar. Zie de pagina Datadienstspecificatie voor meer informatie.
De Beheerorganisatie DSGO MOET valideren dat de geïmplementeerde datadienst voldoet aan de rol-gerelateerde validatie datadienstaanbieder
Datadienstaanbieders MOETEN hun datadienst aanbieden conform hun datadienstspecificatie zoals beschreven in hun /capabilities en /data_services endpoint.
2. Opname in centrale participantenregister
Beheerorganisatie DSGO verwerkt de /capabilities en /data_services endpoints in het centrale participantenregister, wanneer datadienstregistratie correct is uitgevoerd en de rol-specifieke validaties van de datadienstaanbieder zijn gedaan. Registratie betekent het toevoegen van de /capabilities en /data_service endpoints aan de dataspaceMembership claim.
De Beheerorganisatie DSGO MOET /capabilities en /data_services endpoints opnemen in het Centraal participantenregister op verzoek van de datadienstaanbieder, na succesvolle validatie van het toetredingsproces
3. Ontdekkingsverzoek
Een potentiële datadienstgebruiker kan op twee manieren informatie over beschikbare datadiensten van een datadienstaanbieder ophalen.
Via de API van het centrale participantenregister https://api.digigo.nu/, door bevraging van het /parties endpoint met de Organisatie ID van de datadienstaanbieder.
4. Ontdekkingsresponse
Bevraging van het /parties endpoint van de API van het centrale participantenregister resulteert in de informatie zoals opgenomen in de dataspaceMembership claim van de datadienstaanbieder.
De ontdekkingsresponse op een /parties verzoek wordt getekend met een JWT waarmee de potentiële datadienstgebruiker juridische zekerheid heeft over de inhoud hiervan. Hiermee kan de ontdekkingsresponse bij incidenten worden gebruikt als bewijslast van de voorwaarden op basis waarvan de dienst afgenomen wordt.
Datadienstgebruikers ZOUDEN de ontdekkingsresponse MOETEN loggen
5. Beheer datadienstregistratie
Een registratie van een /capabilities en /data_service endpoint in de dataspaceMembership claim in het centrale participantenregister kan worden gewijzigd of verwijderd door de Beheerorganisatie DSGO.
Verwijdering van de endpoints uit het centrale participantenregister kan gebeuren op verzoek van de datadienstaanbieder zelf, bijvoorbeeld wanneer een update van de datadienst heeft plaatsgevonden, of als uitkomst van het handhavingsproces.
Datadienstaanbieders MOETEN een verzoek indienen bij de Beheerorganisatie DSGO om hun datadienstregistratie te wijzigen of verwijderen uit het centrale participantenregister
Let op: Datadienstaanbieders blijven zelf verantwoordelijk voor het up-to-date houden van hun /capabilities en /data_service endpoints.