Handleidingen TLS-certificaat

1. Download het zip bestand met de root- en intermediate certificaten die gebruikt worden door api.kvk.nl.
2. Pak het bestand uit. Bijvoorbeeld in ~/apicerts.
3. Ga naar de map met de cacerts truststore. Deze vind je normaliter in de lib/security sub map of in je java home mappen. In bash shell omgeving: cd $JAVA_HOME/lib/security.
4. Importeer de certificaten met de Java keytool tool:

   keytool -importcert -alias Staat_der_Nederlanden_Private_Root_CA -keystore cacerts -storepass changeit -file ~/apicerts/Staat_der_Nederlanden_Private_Root_CA_-_G1.crt

   keytool -importcert -alias Staat_der_Nederlanden_Private_Services_CA -keystore cacerts -storepass changeit -file ~/apicerts/Staat_der_Nederlanden_Private_Services_CA_-_G1.crt

   keytool -importcert -alias QuoVadis_PKIoverheid_Private_Services_CA -keystore cacerts -storepass changeit -file ~/apicerts/QuoVadis_PKIoverheid_Private_Services_CA_-_G1.crt

5. Zorg ervoor dat de certificaten correct geïmporteerd worden door het keytool -list commando te gebruiken:

   keytool -list -v -keystore ./cacerts -storepass changeit

1. Download het root en intermediate chain bestand hier.
2. Maak een omgevingsvariabele met het juiste pad naar het root en intermediate chain bestand. Bijvoorbeeld:

   NODE_EXTRA_CA_CERTS=./Private_G1_chain.pem

3. Controleer of het opgegeven bestand in de omgevingsvariabelen bestaat:

   cat $NODE_EXTRA_CA_CERTS

4. De 3 certificaten worden getoond in PEM formaat. Elk certificaat begint met "-----BEGIN CERTIFICATE-----".

PHP gebruikt de lijst met vertrouwde certificaten van je besturingssysteem. Zorg ervoor dat de root en intermediate certificaten op de lijst van vertrouwde certificaten komen te staan.

Check de CentOS, Debian en Windows tabs hieronder voor instructies.

1. Download het zip bestand met de root en intermediate certificaten die gebruikt worden door api.kvk.nl.
2. Pak het bestand uit in ~/apicerts
3. Installeer het ca-certificaten pakket:

   sudo yum install ca-certificates

   - Wanneer er gevraagd wordt of je verder wilt gaan selecteer dan ‘ja’.
4. Schakel de dynamische CA-configuratiefunctie in:

   sudo update-ca-trust force-enable

5. Kopieer het rootcertificaatbestand naar /etc/pki/ca-trust/source/anchors/

   sudo cp ~/apicerts/* /etc/pki/ca-trust/source/anchors/

6. Controleer of de volgende bestanden bestaan in /etc/pki/ca-trust/source/anchors/:

   QuoVadis_PKIoverheid_Private_Services_CA_-_G1.crt
   Staat_der_Nederlanden_Private_Root_CA_-_G1.crt
   Staat_der_Nederlanden_Private_Services_CA_-_G1.crt

7. Update de truststore:

   sudo update-ca-trust extract

8. Test of alles werkt via

   curl https://ssltest.kvk.nl

1. Download het zip bestand met de root en intermediate certificaten die gebruikt worden door api.kvk.nl.
2. Pak de bestanden uit in ~/apicerts
3. Kopieer de crt-bestanden naar /usr/local/share/ca-certificates/

   sudo cp ~/apicerts/*.crt /usr/local/share/ca-certificates/

4. Controleer of de volgende bestanden bestaan in /usr/local/share/ca-certificates/:

   QuoVadis_PKIoverheid_Private_Services_CA_-_G1.crt
   Staat_der_Nederlanden_Private_Root_CA_-_G1.crt
   Staat_der_Nederlanden_Private_Services_CA_-_G1.crt

5. Update de vertrouwde certificaten:

   sudo update-ca-certificates

6. Test of alles werkt via

   curl https://ssltest.kvk.nl

1. Log in op Windows met een account met beheerdersrechten
2. Download het zip bestand met de root en intermediate certificaten die gebruikt worden door api.kvk.nl.
3. Pak het bestand uit op een willekeurige locatie.
4. Open mmc (druk op de windows toets en type mmc) en open mmc.exe.

5. Klik op "Bestand" en op "Module toevoegen/verwijderen...".

Kies "Module toevoegen/verwijderen...".



Selecteer 'Certificaten' in de lijst met Beschikbare modules en klik op 'Toevoegen >' om de Certificaat module toe te voegen



Selecteer 'Computeraccount' om de computeraccounts te beheren en klik op 'Volgende'



Selecteer 'Lokale computer'



Klik op 'Voltooien' om het 'Modules toevoegen/verwijderen' venster te sluiten

6. Voeg het Staat der Nederlanden Private Root CA_-_G1 certificaat toe aan de Vertrouwde basiscertificeringsinstanties/Certificaten sectie

Klap de sectie Certificaten (Lokale computer) uit en vervolgens de Vertrouwde basiscertificeringsinstanties sectie. Klik op 'Certificaten' om de vertrouwde basiscertificeringen te kunnen zien.



Klik met de rechtermuisknop op 'Certificaten', kies 'Alle taken' en klik op 'Importeren'



Klik op 'Volgende'

Selecteer het juiste bestand door op 'Bladeren' te klikken



Navigeer naar de map waar je de certificaten opgeslagen hebt. Selecteer het bestand "Staat_der_Nederlanden_Private_Root_CA_-_G1.crt" en klik op 'Openen' om het bestand-selectie venster te sluiten.



Klik op 'Volgende'



Selecteer 'Alle certificaten in het onderstaande archief opslaan' en klik op 'Volgende'



Controleer de informatie en klik op 'Voltooien' om de Wizard Certificaat importeren te voltooien



Een venster met het bericht: 'Het importeren is voltooid' zal verschijnen

Controleer of het certificaat Staat der Nederlanden Private Root CA_-_G1 in de lijst staat


7. Voeg het Staat der Nederlanden Private Services CA_-_G1 tussenliggende certificaat toe

Klap de sectie 'Tussenliggende certificeringsinstanties' uit en klik op Certificaten



Klik met de rechtermuisknop op 'Certificaten', kies 'Alle taken' en klik op 'Importeren'.



Klik op 'Volgende' om de wizard te starten

Selecteer het correcte bestand door op 'Bladeren' te klikken

Navigeer naar de map waar de certificaten zijn opgeslagen. Selecteer het bestand 'Staat_der_Nederlanden_Private_Services_CA_-_G1.crt' en klik op 'Openen'



Klik 'Volgende' in de Wizard Certificaat importeren



Controleer of 'Alle certificaten in het onderstaande archief opslaan' geselecteerd is en klik op 'Volgende'



Voltooi de wizard door op voltooien te klikken



Een venster met het bericht: 'Het importeren is voltooid' zal verschijnen

Controleer of het certificaat Staat der Nederlanden Private Services CA_-_G1 in de lijst staat van Tussenliggende Certificeringsinstanties


8. Voeg het QuoVadis_PKIoverheid_Private_Services_CA_-_G1 tussenliggende certificaat toe

Herhaal de stappen die je gedaan hebt voor "Voeg het Staat der Nederlanden Private Services CA_-_G1 tussenliggende certificaat toe" maar gebruik hiervoor het bestand QuoVadis_PKIoverheid_Private_Services_CA_-_G1.crt in plaats van Staat_der_Nederlanden_Private_Services_CA_-_G1.crt

Controleer of het QuoVadis PKIoverheid Private Services CA_-_G1 certificaat ook in de tussenliggende certificeringsinstanties lijst aanwezig is:


9. Test of alles werkt door de website https://ssltest.kvk.nl te openen met je browser.