Inleiding

DOV-services die we aanbieden op internet en waarvoor authenticatie nodig is, worden standaard beveiligd met certificaten. We gebruiken hiervoor standaard de VO-PKI.

...

Onderstaande screenshots geven aan welke info u dient in te vullen en hoe u het certicaat kan downloaden.

Aanspreken DOV-services

Met een getekend certificaat kan men requests uitvoeren tegen de DOV REST API. Hiervoor dient volgend stappenplan gevolgd te worden:

1. Definieer een HTTPS-connectie gebruikmakend van uw certificaat
2. Stuur het request naar https://services.dov.vlaanderen.be/[APP]/[REST], waarbij 
   1. APP de applicatienaam in DOV is die men wenst aan te spreken
   2. REST het url-patroon is om gegevens op te vragen of door te sturen

Testen van certificaat

De eenvoudigste manier om een certificaat te testen is om een curl command te gebruiken:

curl -k https://services.dov.vlaanderen.be/dov-xdov-server/logs/count --key <full path to you private key> --cert <full path to your certificate> -v

Voor java ontwikkelaars

Er is een java quickstart project beschikbaar die demonstreert hoe de services opgeroepen kunnen worden:  https://github.com/DOV-Vlaanderen/dov-services-quickstart gemaakt

Heel specifiek, alles wat betreft het opbouwen van een secure connection met een certificaat staat in  https://github.com/DOV-Vlaanderen/dov-services-quickstart/blob/master/config/src/main/java/be/vlaanderen/dov/services/config/ClientConfig.java

Voor python ontwikkelaars

Hier is nog geen voorbeeldcode beschikbaar.

De beschrijving zoals bvb op https://www.techcoil.com/blog/how-to-send-a-http-request-with-client-certificate-private-key-password-secret-in-python-3/ gegeven wordt kan gevolgd worden

In de subpagina's worden enkele voorbeelden aangehaald voor het gebruik van DOV REST API:

...