Aanleveren individuele voertuigpassages (IVP)
Inleiding
Individuele voertuigpassages (IVP) moeten worden aangeleverd aan het NDW systeem DEXTER.
Hieronder is een overzicht opgenomen van de interface die voor deze datastroom gebruikt moet worden.
| Parameter | Waarde | Opmerking |
|---|---|---|
| Data formaat | DatexII v2.3 | Voor deze datastroom worden de individualMeasurementSiteTablepublication (IMSTP) en de IndividualMeasuredDataPublication (IMDP) gebruikt. Kijk hier voor de beschrijvingen van deze twee publicaties. |
| Protocol | Ketenprotocol AVG | |
| Updatefrequentie | TODO | |
| Compressie | GZIP | |
| Bestandsextensie | .gz | |
| Levermethode | Push methode AVG | |
| UpdateMethode | TODO | |
| Verbinding | HTTP (versie 1.1) | |
| XML-Schema | IVP DATEX II Profielen | Klik hier om naar de XSD's te gaan |
Aansluitproces op hoofdlijnen
Een data leverancier kan (Tijdig, bij voorkeur minimaal een maand voor beoogde levering) contact opnemen met de NDW Servicedesk en daar toegang vragen om data te mogen leveren. Nadat deze aanvraag is gebeurd kunnen de volgende stappen uitgevoerd worden:
-
Administatieve zaken
- NDW Checkt dat de leverancier mag leveren en dat er bekend is voor welke partner/provincie/gemeente/regio dit moet gebeuren
- Check na dat de juiste prefix/ID uitgedeeld is
- NDW maakt een service account aan in Keycloak
- NDW wijst de juiste rollen toe aan service account
- NDW deelt de client ID en secret van de service account met de leverancier
- Leverancier checkt of client ID en secret van NDW zijn ontvangen
-
Voorbereiden en uitvoeren van de aansluittest leverancier individuele voertuigpassage (IVP) op de testomgeving.
-
Na een succesvolle aansluittest op de testomgeving, wordt een moment vastgesteld dat de aansluiting in productie gaat.
Security
Voor beveiliging van de verbinding wordt gebruik gemaakt van Keycloak met OAuth en/of één of meerdere toegestane IP-adressen.
Aansluittest
De aansluittest wordt uitgevoerd op de test/staging omgeving:
- Zorg in ieder geval dat de leverancier data kan sturen naar de endpoints
- Los samen met de leverancier eventuele validatie fouten op
- Controleer dat de juiste records zijn opgestuurd
- Let hierbij vooral op de gebruikte prefix
Zodra de aansluiting op de test/staging omgeving helemaal rond is. Dan kan de data leverancier leveren naar productie. Voeg de juiste rollen toe op de service account.