Validation Authority REST APIs

Validation Authority REST APIs allow operators to register/update the user certificate issued by the Certificate Authority. In this section we will discuss about the API endpoints which Validation Authority supports. Validation Authority will capture all the activities carried out using the endpoints in Audit Logs.

Validation Authority REST API allows operator to do the followings:

Prerequisites:

The prerequisites to use the endpoints are:

  1. Add and whitelist the ipv4 addresses in web.xml file. Refer to Add ipv4 for more information.

  2. Certificate Issuer should be registered in the Validation Authority. Refer to Register New Certificate Issuer for more information.

  3. Issuer CRL should be registered and present in the Validation Authority. Visit Load CRLs for Each Certificate Authority for more information.

  • Register New Certificate into the Validation Authority

  • Get Certificate Status from the Validation Authority

  • Update the Existing Certificate Status

    Note:

    • Validation Authority REST APIs will work on both http and https endpoints.

    • User can pass the certificate serial number in a decimal or hex format. In case of hex format, add 0x infront of the certificate serial number (0x6008).

Add ipv4 addresses

Follow the below steps to add and whitelist ipv4 addresses:

  1. Open the web.xml file (VA installation directory /authority/server/WEB-INF).

  2. Add one or more IPs (separated by comma) in the web.xml file as shown below:

    (<param-value>192.168.0.1, 192.164.0.2</param-value>)

  3. Restart the Validation Authority services.

Topics in this section: