Generate Certificate

URL:
https://<root>/generateCertificate
Methods:
POST
Required Capability:
Access allowed with the "Security and Infrastructure" privilege
Version Introduced:
10.8

Description

The generateCertificate operation can be used to create a self-signed certificate or as a starting point for getting a production-ready CA-signed certificate. ArcGIS Enterprise portal will generate a certificate for you and store it in its keystore.

Request parameters

ParameterDetails

alias

(Required)

The name of the certificate.

Example
Use dark colors for code blocksCopy
1
alias=myselfsignedcertificate

keyAlg

The algorithm used to generate the key pairs. The default is RSA.

Example
Use dark colors for code blocksCopy
1
keyAlg=RSA

keySize

The size of the key. The default is 1024.

Example
Use dark colors for code blocksCopy
1
keySize=2048

sigAlg

The algorithm used to sign the self-signed certificates. The default is derived from the keyalg parameter.

Example

Example
Use dark colors for code blocksCopy
1
sigAlg=SHA256withRSA

cn

(Required)

The common name used to identify the server for which the certificate is to be generated.

Example
Use dark colors for code blocksCopy
1
cn=SERVER.DOMAIN.COM

orgUnit

The department in which this server resides.

Example
Use dark colors for code blocksCopy
1
orgUnit=development

org

(Required)

The name of the organization.

Example
Use dark colors for code blocksCopy
1
org=DOMAIN.COM

city

The name of the city.

Example
Use dark colors for code blocksCopy
1
city=Buffalo

state

The name of the state.

Example
Use dark colors for code blocksCopy
1
state=NY

country

The two-letter abbreviation for the country.

Example
Use dark colors for code blocksCopy
1
country=US

validity

The expiration time for the certificate in days. The default is 90.

Example
Use dark colors for code blocksCopy
1
validity=120

san

The certificate's Subject Alternative Name. This value can be a machine name or an IP address, but it must be prefixed by either DNS: or IP:. Multiple values are supported, and must be separated by a comma without any spaces.

Example
Use dark colors for code blocksCopy
1
san=DNS:SERVER.DOMAIN.COM

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 generateCertificate operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /webadaptor/portaladmin/machines/MACHINE.DOMAIN.COM/sslCertificates/generate HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

alias=mycert&keyAlg=RSA&keySize=2048&sigAlg=SHA256withRSA&cn=MACHINE.ESRI.COM&orgUnit=Development&org=ESRI&city=Redlands&state=California&country=US&validity=90&san=DNS:machine.esri.com

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.