To upload a custom server certificate, send the following request:
POST https://<IA_IP_address>:<port_number>/config/v1/x509/server/cert
Note
To use this request, your user account must have sudo access.
Prerequisite
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/server/cert
Required headers:
Cookie: px=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X-Username: wheel X-Role: wheel
Upload custom server certificate: Response
HTTP/1.1 [Response Code] [Response Message] Server: [Server] Date: [Date]
Response fields
Response code—A standard HTTP response code.
200—Request successful; the configuration was successful.
Response message—A standard HTTP response message.
OK—Request successful; the configuration was successful.
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 server certificate
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/server.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/server.crt"—Specifies the file containing the custom server certificate.
Results
This example uploads a custom certificate.