To retrieve the CA certificate configuration status, send the following request:
GET https://<IA_IP_address>:<port_number>/config/v1/x509/ca
Note
To use this request, your user account must have sudo access.
Required headers:
X-Username: <user> X-Role: <role>
Options
IA_IP_address—The IP address of the NDR appliance running the NDR API.
port_number—The port number of the NDR appliance running the NDR API.
user—The user ID.
role—The user's role.
Example
GET https://xxx.xxx.xxx.xxx:443/config/v1/x509/ca
Required headers:
X-Username: wheel X-Role: wheel Content-Type: application/json
CA certificate status: Response
HTTP/1.1 [Response Code] [Response Message]
Date: [Date]
Content-Type: [Content Type]
{
"state": "state"
}Response fields
Response code—A standard HTTP response code.
200—Request successful; the status was returned.
Response message—A standard HTTP response message.
OK—Request successful; the status was returned.
Date—Standard HTML date format.
Content type—The response format.
state—The status of the custom CA. The value can be
noneorcustom.
Example
HTTP/1.1 200 OK
Date: Thu, 03 Oct 2019 14:02:21 GMT
Content-Type: application/json; charset=utf-8
{
"state": "custom",
}cURL code sample: CA certificate status
curl -k --cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -H "X-Username: wheel" -H "X-Role: wheel" https://xxx.xxx.xxx.xxx:443/config/v1/x509/ca
This cURL sample includes the following options:
-k—This option explicitly allows cURL to perform insecure SSL connections and transfers, which allows you to test your SSL connection without installing a CA certificate.--cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"—This option specifies the authentication token for this session.-H "X-Username: wheel"—User name.-H "X-Role: wheel"—User role.https://xxx.xxx.xxx.xxx:443/config/v1/x509/ca—The CA certificate status request URL. Replacexxx.xxx.xxx.xxxwith the IP address of your NDR appliance.
Results
This example retrieves the CA certificate status.