Import Root Certificate

URL:
https://<root>/machines/<machine>/sslcertificates/importRootOrIntermediate
Methods:
POST
Required Capability:
Access allowed with the "Security and Infrastructure" privilege
Version Introduced:
10.1

Description

The importRootOrIntermediate operation imports a certificate authority (CA)'s root and intermediate certificates into the keystore. To create a production quality CA-signed certificate, you need to add the CA's certificates into the keystore that enables the SSL mechanism to trust the CA (and the certificates it has signed). While most of the popular CA's certificates are already available in the keystore, you can use this operation if you have a custom CA or specific intermediate certificates.

Request parameters

ParameterDescription

alias

A name for the certificate.

rootCACertificate

The multi-part POST parameter containing the certificate file.

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the importRootOrIntermediate operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
POST /webadaptor/admin/machines/MACHINE.DOMAIN.COM/sslcertificates/importRootOrIntermediate HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boundary=----boundary
Content-Length: []

------boundary
Content-Disposition: form-data; name="alias"

rootCert
------boundary
Content-Disposition: form-data; name="rootCACertificate"; filename=""
Content-Type: application/octet-stream

rootCACertificate.cer
------boundary
Content-Disposition: form-data; name="f"

pjson
------boundary
Content-Disposition: form-data; name="csrfPreventToken"

bT_yZ3IBwUl3GviU_g_4MqE4abE9lOD37wo7g9YLta5BQzG4TaP_poDQlXZEQEEEJAQLfagZ7Uzti3KMUvFXzWD39sLwglaOb7hsAQZ-Ctx2fSoC59XiOcJYCK61i1A48TrciSQgS8bfB3bxr7WJhOpXWcQy5W6xvjoz7drVpuPTV4hLYY2QoFVL8OXRsqfE,https://machine.domain.com/server/admin
------boundary--

JSON Response example

Use dark colors for code blocksCopy
1
{"status": "success"}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.