Proces

De web services (APIs) voor het melden van centrale stooktoestellen zijn niet publiek beschikbaar. Softwareleveranciers moeten zich identificeren alvorens een melding kan gemaakt worden. Deze identificatie verloopt op basis van gangbare standaarden en moet worden ingebouwd in de software. Er is een eenmalige registratie nodig van de softwareleverancier.

Het proces loopt als volgt:

• Vraag als software leverancier softwareleverancier toegang tot de VEKA APIsAPI's

  • Mail vanuit uw domein naar klimatisatie.veka@vlaanderen.be

  • VEKA valideert de identiteit van de aanvrager

  bij de Software leverancier

• U ontvangt instructies voor het genereren van een certificaat

• U deelt public key (CSR) met VEKA

• VEKA voegt uw bedrijf de softwareleverancier toe als trusted gekende partner en activeert toegang op tot de VEKA API

• U implementeert de VEKA APIs in zijn/haar uw toepassing en gebruikt hiervoor een beveiligde verbinding op basis van het client certificaatuw uniek client certificaat

Instructies

Download RSA Key Pair software

• Download KeyStore Explorer: https://keystore-explorer.org/downloads.html

  • Er zijn ook andere tools die RSA Key Pairs kunnen genereren zoals PuTTY Key Generator en Crypto Stuff

• Installeer KeyStore Explorer en start de toepassing

Maak een client certificaat aan

• In de start scherm van KeyStore Explorer klik op ‘Create a new KeyStore’.

...

• Specifieer type ‘PKCS #12’ en klik op OK.

...

• In de menu bar klik op ‘Tools’ – ‘Generate Key Pair’.

  • In de popup vul ‘algorithm’ RSA en ‘Key Size’ 4096. Klik op OK

...

• Vul in de popup volgende informatie in en klik op Ok:

  • CN: CN ontvangen van VEKA (formaat: {code}.softwareleverancier.veka.vlaanderen.be)

  • OU: VEKA

  • O: Vlaamse Overheid

  • L: Brussel

  • ST: BrusselC: BE

...

• Controleer de informatie en klik op Ok

...

• Een nieuwe popup wordt getoond (alias), klik op OK.

• Een popup voor de password opent.

  • Laat het password leeg.

  • Klik op OK, de key-pair is aangemaakt.

...

Maak een CSR aan

• Selecteer de key-pair en klik op de rechter muis knop.

• Selecteer ‘Generate CSR’.

• Kies de folder waar de CSR zal opgeslaan worden en klik op OK.

  • De CSR is nu aangemaakt.

• Stuur de CSR naar het VEKA via mail.

...