kik-v

KIK-V Tutorial

This tutorial depends on the Network in a day workshop. Make sure you completed that one before starting this one.

In this tutorial you'll learn how to:

• Setup the network and register specific services required for KIK-V;
• Setup the triplestore to persist the data of a data station;
• Search and find an organization in the network
• Issue a 'validated query' credential;
• Present a validated query to an organisation to request an answer;
• Receive the request and send a response;
• Receive the response.

The code blocks will either show a shell/terminal command or a http request. Most code samples/shell commands are specific to the KIK-V bolt.

There are three roles within the KIK-V bolt: an authority as issuer, a data consumer and an organization to produce data. During the tutorial you will implement all three roles.

You can use Postman to execute the http request mentioned in this tutorial or any other tool you like.

Resources

• Node config: https://nuts-node.readthedocs.io/en/latest/pages/configuration/configuration.html
• Services manual: 1-service-registration.md
• Authorization credential manual: ../mini-manuals/5-authz-credentials.md
• Authentication manual: ../mini-manuals/7-authentication.md
• Access token manual: ../mini-manuals/6-access-token.md
• API descriptions: https://nuts-node.readthedocs.io/en/latest/pages/api.html

The KIK-V bolt uses the same architecture as all other programs on data exchange. So there is no specific KIK-V architecture. Zorginstituut Nederland and Nuts are happy that we follow the same principles and architectural choices. Thats why Nuts and Zorginstituut Nederland are working together in this hackathon.

The architectural description of Zorginstituut Nederland complies to the reference architecture DIZRA of Informatieberaad Zorg.

• Architectural Description: https://data-en-techniek.gitlab.io/explainers/architectuur/
• Specifications: https://gitlab.com/data-en-techniek/specificaties/

Roles

In the KIK-V bolt there are 3 organizational roles:

1. An authority which determines which queries can be performed and by whom. This authority is the credential issuer and issues the ValidatedQueryCredential to subjects.
2. The data consumer is the subject of the credential and is therefore also the credential holder.
3. A data producer, which advertises data in a data station, and allows authorized data consumers to run validated queries on the data. It therefore also has the role of credential verifier.

The Verifiable Data Registry (VDR) is provided by the Nuts Network.

The roles and their relationships