- URL:https://<sslCertificates-url>/importRootOrIntermediate(POST only)
- Required Capability:Single machine environment | Default administrator role | Security and infrastructure privilege
- Version Introduced:10.3
Description
This operation imports a certificate authority's (CA) root and intermediate certificates into the keystore.
To create a production quality CA-signed certificate, you need to add the CA 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 certificates are already available in the keystore, you can use this operation if you have a custom CA or specific intermediate certificates.
To import a signed certificate from a CA, use the Import Signed Certificate operation.
Note:
This operation is not accessible for highly available portals. In such instances, a counterpart Import Root or Intermediate Certificate operation, found under the Machines resource, should be used in place of this operation. For more information on high availability, please see Import a certificate into the portal.
Request parameters
Parameter | Details |
---|---|
alias | The name of the certificate. Example
|
file | The multipart POST parameter containing the certificate file. |
norestart | Introduced at 10.6. This value determines whether the portal should be prevented from restarting after importing the certificate. By default, this value is set as false and the portal will restart. Values: true | false |
f | The response format. The default response format is html. Values: html | json | pjson |
JSON Response example
{"status": "success"}