- URL:https://[root]/portals/[portalID]/certificates/register(POST only)
Example usage
Below is a sample ArcGIS Online POST request for the register operation:
Note:
A placeholder has been added for the certificate parameter's input.
POST /sharing/rest/portals/0123456789ABCDEF/certificates/register HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
name=orgCert&domain=domain.com&certificate=...Description
The register HTTPS certificate operation (POST only, HTTPS only) allows administrator to register custom X.509 HTTPS certificates with their ArcGIS Online organizations. This will allow ArcGIS Online organization to trust the custom certificates used by a remote server when making HTTPS requests to it, i.e. store credentials required to access its resource and share with others.
A maximum of 5 certificates can be registered with an organization.
Note:
This operation is only available for ArcGIS Online organizations.
Request parameters
| Parameter | Details |
|---|---|
| name | Name for the certificate to be registered. Example |
| domain | Server domain that the certificate is used for. Example |
| certificate | Base64-encoded certificate text, enclosed between -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----. |
Response properties
| Property | Details |
|---|---|
| success | Indicates if the operation was successful. |
| certificateId | Id of the registered certificate. |
JSON Response syntax
{
"success": true,
"certificateId": "<certificateId>"
}JSON Response example
The following demonstrates a returned success response:
{
"success": true,
"certificateId": "adzf7nGZD1XCnyph"
}The following demonstrates a returned error message:
{
"error": {
"code": 500,
"messageCode": "ORG_1207",
"message": "The org has reached the max Custom SSL certificate allowed.",
"details": []
}
}