# 1. Koppeling leggen

## Relevante TA Notified Pull hoofdstukken

* 3.1 Network level security: mTLS 1.3

## Beveiliging

Om een beveiligde koppeling tot stand te brengen kiest VIPLive voor het gebruik van mTLS met een PKIoverheid-certificaat. Dit is in lijn met de TA Notified Pull.

**Let op**: Voorafgaand aan de implementatie van de koppeling dient het PKIOverheid-certificaat te zijn aangevraagd en ingeregeld door de koppelende partij.

## Koppelinformatie

Voor de uiteindelijke beschikbaarstelling van gegevens zullen een aantal zaken uitgewisseld moeten worden tussen VIPLive en de koppelpartij. 

Deze onderdelen staan opgesomd in onderstaande tabel en worden verder toegelicht in dit hoofdstuk. 

**Let op**: De betreffende informatie van de koppelpartij dient voorafgaand aan de implementatie van de koppeling bij VIPLive te worden aangeleverd middels een ingevulde checklist. Deze is hier te downloaden:

{% file src="/files/MovKVv9n7BFZu7FAFndX" %}

<table><thead><tr><th width="218">Onderdeel</th><th>VIPLive</th></tr></thead><tbody><tr><td>FHIR-server base URL</td><td><p><strong>Test:</strong> <a href="https://fhir.test-datakluis.shared.topicuszorg.nl/fhir/stu3">https://fhir.test-datakluis.shared.topicuszorg.nl/fhir/stu3</a></p><p><strong>Acceptatie:</strong> <a href="https://fhir.acceptatie-datakluis.shared.topicuszorg.nl/fhir/stu3">https://fhir.acceptatie-datakluis.shared.topicuszorg.nl/fhir/stu3</a></p><p><strong>Productie:</strong> <a href="https://fhir.datakluis.shared.topicuszorg.nl/fhir/stu3">https://fhir.datakluis.shared.topicuszorg.nl/fhir/stu3</a></p></td></tr><tr><td>SMART on FHIR-configuratie</td><td>[FHIR-server base URL]/.well-known/smart-configuration</td></tr><tr><td>JWKS endpoint</td><td><p><strong>Test:</strong> <a href="https://fhir.test-datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks">https://fhir.test-datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks</a></p><p><strong>Acceptatie:</strong> <a href="https://fhir.acceptatie-datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks">https://fhir.acceptatie-datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks</a></p><p><strong>Productie:</strong> <a href="https://fhir.datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks">https://fhir.datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks</a></p></td></tr><tr><td>Client-id</td><td><code>viplive-databroker</code></td></tr></tbody></table>

### Soorten ontvangers

De Notified Pull is opgesteld voor uitwisseling van gegevens tussen zorgaanbieders. Vanuit het VIPLive platform wordt deze uitwisselingsstandaard ook ingezet voor de uitwisseling tussen zorgaanbieder en systemen. Zie hieronder de mogelijke opties:

1. #### Ontvanger is een zorgaanbieder binnen het systeem

De gegevensuitwisseling vindt plaats tussen een zorgaanbieder in VIPLive én een zorgaanbieder  in het systeem van de koppelpartij. De koppelpartij kan de zorgaanbieder identificeren en adresseren op basis van AGB-code.

Let op: Het is ook mogelijk dat gegevensuitwisseling plaatsvindt tussen VIPLive en de koppelpartij voor dezelfde zorgaanbieder.

2. #### **Ontvanger is het systeem:**

De gegevensuitwisseling vindt plaats tussen een zorgaanbieder in VIPLive én het systeem van de koppelpartij. De gegevens zijn niet geadresseerd aan een specifieke zorgaanbieder binnen het systeem van de koppelpartij.

### FHIR Server URL

* Van de ontvangende partij (nodig bij [3. Notify afleveren](/viplive-notified-pull/notified-pull/3.-notify-afleveren.md))
  * Test, acceptatie en productie
* Van de verzendende partij (nodig bij [5. Pull uitvoeren](/viplive-notified-pull/notified-pull/5.-pull-uitvoeren.md))
  * **Test:** <https://fhir.test-datakluis.shared.topicuszorg.nl/fhir/stu3>
  * **Acceptatie:** <https://fhir.acceptatie-datakluis.shared.topicuszorg.nl/fhir/stu3>
  * **Productie:** <https://fhir.datakluis.shared.topicuszorg.nl/fhir/stu3>

### Andere endpoints

Naast standaard FHIR Server communicatie zijn er nog andere endpoints nodig bij Notified Pull communicatie. Deze hebben vooral te maken met tokens en validatie daarvan.

#### Token

Het token endpoint bevat de URL waarop partijen een token kunnen aanvragen. Nodig bij [2. Token request verzender](/viplive-notified-pull/notified-pull/2.-token-request-verzender.md) en [4. Token request ontvanger](/viplive-notified-pull/notified-pull/4.-token-request-ontvanger.md).

VIPLive heeft ervoor gekozen om SMART on FHIR configuratie in te richten. In deze configuratie staat een token\_url. Bij gebruik van SMART on FHIR dient de configuratie via het endpoint `/.well-known/smart-configuration` bereikbaar te zijn.&#x20;

*Voor de VIPLive testomgeving is de volledige URL van dat endpoint dus:* [*https://fhir.test-datakluis.shared.topicuszorg.nl/fhir/stu3/.well-known/smart-configuration*](https://fhir.test-datakluis.shared.topicuszorg.nl/fhir/stu3/.well-known/smart-configuration)*.*

#### JWKS

Voor validatie van het token request dient de ontvangende partij een JWKS endpoint aan te leveren. \
Voor VIPLive is dat te vinden op  `/.well-known/openid-connect/jwks`.

*Voor de VIPLive testomgeving is de volledige URL van dat endpoint:* [*https://fhir.test-datakluis.shared.topicuszorg.nl/.well-known/*&#x6F;penid-connect/jwks](https://fhir.test-datakluis.shared.topicuszorg.nl/.well-known/openid-connect/jwks)*.*

### Client-id

Het client-id is onderdeel van het token request. De waarde die VIPLive aanhoudt is `viplive-databroker`. Dit is terug te vinden in [2. Token request verzender](/viplive-notified-pull/notified-pull/2.-token-request-verzender.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://viplive-interop.gitbook.io/viplive-notified-pull/notified-pull/1.-koppeling-leggen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.