Certificaatvereisten en voorbeeld

Voor toegang tot Ons API is een TLS-clientcertificaat nodig dat door onze Certificate Authority is ondertekend. Een certificaat kan gelden voor een supplier, een connector of één klantomgeving. Voor toegang tot een klantomgeving blijft daarnaast goedgekeurde toestemming voor een versie van de connector nodig.

API-toegang regelen
Bekijk de certificaatscopes, common name-formaten, CSR-voorbeeldcommando’s en het aanvraagproces in API-toegang regelen.

CSR-vereisten

Gebruik een RSA-sleutel van ten minste 4096 bits. De vereiste inhoud van de CSR en de voorbeeldcommando’s per scope staan bij API-toegang regelen.

Gebruik je een andere tool dan OpenSSL (bijvoorbeeld BouncyCastle library) om een CSR te maken, zorg er dan voor dat je de meest recente versie van die tool gebruikt. Oudere versies genereren mogelijk ongeldige CSR’s die niet door ons ondertekend kunnen worden.

Technische details

TLS

• De minimale TLS versie is 1.2.
• Het framework waarvan je gebruik maakt, moet een SNI-extensie sturen tezamen met de TLS handshake.

Geldige ciphers
Elk van onderstaande ciphers kan gebruikt worden:

• ECDHE-ECDSA-AES256-GCM-SHA384
• ECDHE-ECDSA-AES128-GCM-SHA256
• ECDHE-ECDSA-CHACHA20-POLY1305
• ECDHE-RSA-AES256-GCM-SHA384
• ECDHE-RSA-AES128-GCM-SHA256
• ECDHE-RSA-CHACHA20-POLY1305
• DHE-RSA-AES256-GCM-SHA384
• DHE-RSA-AES128-GCM-SHA256

CA Chain
Als je framework, platform of ontwikkeltaal de volledige CA-chain vereist, dan is deze hier te verkrijgen:

• Production CA chain
• Staging CA chain
• Development CA chain

Legacy (Ondertekent geen nieuwe certificaten meer)

• Production CA chain (ondertekend voor 02-09-2025)
• Staging CA chain (ondertekend voor 28-08-2025)
• Development CA chain (ondertekend voor 20-08-2025)

Certificaat testen

Je kunt het certificaat testen door een GET-request te doen naar de /ping endpoint op Ons API. Gebruik de URL die overeenkomt met de omgeving waar het certificaat voor is bestemd; zie ook: API properties.

• Voorbeeld: GET https://api-development.ons.io/ping
• Resultaat:
  • 200: Het certificaat werkt.
  • 403: Het certificaat werkt niet in combinatie met de opgegeven URL.

Als je test met curl op Windows, zorg dan voor een recente versie van curl. Vaak is versie 7.55.1 geïnstalleerd, welke niet goed omgaat met client certificaten.

---