Enabling SSL using an existing SSL certificate
In this topic
- Import the SSL certificate into ArcGIS Server
- Configure ArcGIS Server to use the SSL certificate
- Configure each GIS server in your deployment
- Enable SSL for your site
- Import the certificate into the OS certificate store
- Access your site using SSL
If you already have an SSL certificate issued by a commercial or internal Certificate Authority (CA), you can use this existing certificate to enable SSL for ArcGIS Server. To import this certificate into ArcGIS Server, the certificate and its associated private key must be stored in the PKCS#12 format, which is represented by a file with either the .p12 or .pfx extension. The steps to enable SSL using an existing SSL certificate are as follows:
Import the SSL certificate into ArcGIS Server
- Log in to the ArcGIS Server Administrator Directory as the primary site administrator or a user with administrative privileges, for example, http://gisserver.domain.com:6080/arcgis/admin.
- Browse to machines > [machine name] > sslcertificates.
- Since the certificate you are importing was issued by a CA, you must first import the CA's root or intermediate certificate. Click importRootOrIntermediate to import the CA's root or intermediate certificate.
- Click importExistingServerCertificate to import the SSL server certificate.
- In the Certificate password field, type the password to unlock the file containing the SSL certificate.
- In the Alias field, type a unique name that easily identifies the certificate.
- Click Browse to choose the .p12 or .pfx file that contains the SSL certificate and its private key.
- Click Import to import the SSL certificate.
Configure ArcGIS Server to use the SSL certificate
To specify the SSL certificate that ArcGIS Server should use, complete the following steps:
- Log in to the ArcGIS Server Administrator Directory at http://gisserver.domain.com:6080/arcgis/admin.
- Browse to machines > [machine name].
- Click edit.
- Type the name of the SSL certificate that you want to use in the Web server SSL Certificate field.
- Click Save Edits to apply your change.
- On the current page, view the property Web server SSL Certificate to verify that the desired SSL certificate will be used for SSL.
Configure each GIS server in your deployment
If you have a multiple machine deployment of ArcGIS Server, you must repeat the steps in the previous sections for each GIS server that participates in your site.
Enable SSL for your site
- Log in to the ArcGIS Server Administrator Directory: http://gisserver.domain.com:6080/arcgis/admin.
- Browse to security > config > update.
- For the Protocol parameter, choose the HTTPS Only option and click Update. Your ArcGIS Server site is automatically restarted. In a developer environment, you may also choose to use the HTTP and HTTPS option. With this option, users will be able to access ArcGIS Server through either HTTP or HTTPS.
Note:
It takes ArcGIS Web Adaptor one minute to recognize changes to the communication protocol of your site.
Legacy:
In 10.2.1 and earlier versions, you were required to reconfigure ArcGIS Web Adaptor after updating the communication protocol of ArcGIS Server. In 10.2.2 and later versions, this is no longer necessary.
Import the certificate into the OS certificate store
Import the CA's root certificate into the operating system's certificate store:
- On the machine hosting ArcGIS Server, open the init_user_param.sh script in a text editor by navigating to the <ArcGIS Server installation directory>/arcgis/server/usr directory.
- Locate the line export CA_ROOT_CERTIFICATE_DIR=<Location_to_CA_Root_Certificate>, and specify a location where all CA root certificates are stored on the system. Note that the specified directory needs to be accessible by the account that was used to install ArcGIS Server. You need to uncomment the lines by removing the pound sign [#] characters.
- Save and close the init_user_param.sh script.
- Repeat steps 1-3 for each GIS server in your site.
- Restart ArcGIS Server. You can do this by running the startserver.sh script on each GIS server in your site.
Access your site using SSL
Once SSL has been configured, ArcGIS Server listens on port 6443 for HTTPS requests. Use the URLs below to securely access ArcGIS Server:
ArcGIS Server Manager | https://gisserver.domain.com:6443/arcgis/manager |
ArcGIS Server Services Directory | https://gisserver.domain.com:6443/arcgis/rest/services |
Note:
If you rename ArcGIS Server while SSL is enabled, you can continue to access ArcGIS Server using SSL; however, you must generate a new SSL certificate and configure ArcGIS Server to use it.