- URL:https://<machine-url>/sslcertificates
- Operations:Generate, Import Existing Server Certificate, Import Root or Intermediate
- Child Resources:Certificate
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
This resource lists all the certificates (self-signed and CA-signed) created for the server machine. The server securely stores these certificates inside a key store within the configuration store.
Before you enable SSL on your server, you need to generate certificates and get them signed by a trusted certificate authority (CA). For your convenience, the server is capable of generating self-signed certificates that can be used during development or staging. However, it is critical that you get CA-signed certificates when standing up a production server. In order to get a certificate signed by a CA, you need to generate a CSR (certificate signing request) and then submit it to your CA. The CA will sign your certificate request which can then be imported into the server by using the import CA signed certificate operation.
Request parameters
Parameter | Description |
---|---|
f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample request URL for the sslCertificates resource:
https://machine.domain.com/webadaptor/admin/machines/MACHINE.DOMAIN.COM/sslcertificates?f=json
JSON Response syntax
{
"certificates": [
"<certificate1>",
"<certificate2>"
]
}
JSON Response example
{
"certificates": [
"selfsignedcertificate",
"myproductioncertificate"
]
}