To upload a custom CA certificate chain, send the following request:
POST https://<IA_IP_address>:<port_number>/config/v1/x509/ca/cert
Note
To use this request, your user account must have sudo access.
Prerequisite
A server certificate signing request has been initiated on the appliance.
Required headers:
Cookie: px=<token> 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.
token—This token authenticates the session. By default, the session times out after 24 hours.
user—The user ID.
role—The user's role.
Example
POST https://xxx.xxx.xxx.xxx:443/config/v1/x509/ca/cert
Required headers:
Cookie: px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X-Username: wheel X-Role: wheel
Upload custom CA: Response
HTTP/1.1 [Response Code] [Response Message] Server: [Server] Date: [Date]
Response felds
Response code—A standard HTTP response code.
200—Request successful; the CA certificate chain was uploaded.
Response message—A standard HTTP response message.
OK—Request successful; the CA certificate chain was uploaded.
Server—The server being used.
Date—Standard HTML date format.
Example
HTTP/1.1 200 OK Server: nginx Date: Fri, 16 Aug 2019 13:09:52 GMT
cURL code sample: Upload custom CA
curl http://xxx.xxx.xxx.xxx:8085/config/v1/x509/server/cert -H "X-Username: wheel" -H "X-Role: wheel" -X POST -F "f=@/path/to/ca.crt"
This cURL sample includes the following options:
-X POST—Specifies using the POST method.--cookie "px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"—This option specifies the authentication token for this session.-H "X-Username: wheel"—User name.-H "X-Role: wheel"—User role.http://xxx.xxx.xxx.xxx:8085/config/v1/x509/server/cert—The certificate request URL. Replacexxx.xxx.xxx.xxxwith the IP address of your NDR appliance.-f "f=@/path/to/ca.crt"—Specifies the file containing the custom CA certificate.
Results
This example uploads a custom CA certificate chain.