SSL for On-Premises

Print this topicEmail this topic

SSL for On-Premises includes the following:

Generate a certificate signing request for SSL

Note: The Rally On-Premises Web server requires the (standard) X.509 digital certificate format.

Rally On-Premises solution is shipped with a default, self-signed SSL certificate. Customers can generate their own certificate, purchase a certificate from a third party vendor, or use the Rally certificate that is installed by default. The following commands outline how to generate a SSL certificate from a third party vendor:

Note: These steps are based on the assumption that the openssl command is available on the system used to create the private keys. You do not need to be on the Rally machine to do this, but the steps below were created using a Linux machine. The steps may differ on a Windows machine with OpenSSL.


  1. Generate a private key:
  2. openssl genrsa -des3 -out www.mydomain.com.key 1024

  3. Generate a Certificate Signing Request (this certificate will be used to generate our ssl certificate on the third party's site):
  4. openssl req -new -key www.mydomain.com.key –out www.mydomain.com.csr

  5. Remove the passphrase from the key:
  6. cp www.mydomain.com.key www.mydomain.com.key.org
    openssl rsa -in www.mydomain.com.key.org -out  www.mydomain.com.key

  7. Submit your request to your third party vendor.
  8. The SSL certificate that is obtained should be a single root or unchained certificate. This file will used in combination with the key generated in Step 1 to upload to our On-Premises image.

  9. Verify the format of your certificate by opening the crt file using a text editor. This file should have the same format as the one below:
  10. -----BEGIN CERTIFICATE----- MIIDdTCCAt6gAwIBAgIJAMCxA1Rf4qmoMA0GCSqGSIb3DQEBBQUAMIGEMQswCQYD VQQGEwJVUzELMAkGA1UECBMCQ08xEDAOBgNVBAcTB0JvdWxkZXIxGjAYBgNVBAoT EVJhbGx5IERldmVsb3BtZW50MRQwEgYDVQsxMC4zMi4xJNSuhdoNi44NDEkMCIGCSqG SIb3DQEJARYVaGF6ZXZlZG9AcmFsbHlkZXYuY29tMB4XDTE0MDQxMTAwNTUxNFoX DTE0MDUxMTAwNTUxNFowgYQxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDTzEQMA4G A1UEBxMHQm91bGRlcjEaMBgGA1UEChMRUmFsbHkgRGV2ZWxvcG1lbnQxFDASBgNV BAMTCzEwLjMyLjE2Ljg0MSKSBdlnQYJKoZIhvcNAQkBFhVoYXpldmVkb0ByYWxseWRl di5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMOOLNLGv4d/9oHTrN/a R49Lw5vYKpjZiGu/MoavjRiaCxgAQqha4xaMIDuMoIWzsbu7fNIdysMlmReyhTw5 2Fa5FHx3ZIJLBUtOSWjWbm6IvVdDPTv2Zu9lhq9zFzWgMm59nlG2ALDmJXcbjDVc S2geX1P6zEH3HvmwYV/bC+7tAgMBAAGjgewwgekwHQYDVR0OBBYEFFBVI+GcTu1U 56+9Ekq4ybUK76GBMIG5BgNVHSMEgbEwga6AFFBVI+GcTu1U56+9Ekq4ybUK76GB oYGKpIGHMIGEMQswSOHOVQQGEwJVUzELMAkGA1UECBMCQ08xEDAOBgNVBAcTB0Jv dWxkZXIxGjAYBgNVBAoTEVJhbGx5IERldmVsb3BtZW50MRQwEgYDVQQDEwsxMC4z Mi4xNi44NDEkMCIGCSqGSIb3DQEJARYVaGF6ZXZlZG9AcmFsbHlkZXYuY29tggkA wLEDVF/iqagwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQUFAAOBgQC7rq/Ts/bW YwTGV/fZ+I029iztg7KNP6dP3jA4DJwVSgnyvbqpGWqEqmLNqRpNOA6FLlmWC8eo mqKH6QLVALgUreAGu5NKyIWDAFDT8Z2jj/8fEz7CxX9fqeZNhrLqfKrAJev2ZS0Q lE1MK2Apss6uzxe9/Oiug48MMZTMwtx7Kw== -----END CERTIFICATE-----

  11. Use the crt file the vendor sends you in combination with the key file you generated to upload to your On-Premises Image.

Install an SSL certificate

  1. Generate or purchase your certificate (this should be a single root or unchained certificate) and copy your certificate (.cert) and key (.key) files to the Rally server.
  2. Copy them to a convenient place where you may easily access them for installation.

    Important: Do not create a password for your key file. If you create a password for your key file, the Apache web server prompt you for the password, and you will be unable to supply it through the console interface.

  3. From the Control Panel, click the Feature menu, then Server Settings.
  4. Click the SSL Certificate tab.
  5. Click Choose File next to the SSL Certificate indicator to locate your SSL certificate (.cert) file.
  6. Click Choose File next to the SSL Key indicator to locate your SSL key (.key) file.
  7. If your SSL Certificate is a chained certificate, click the Chain Certificate File check box.  
  8. Click Choose File next to the SSL Certificate Bundle indicator to locate your SSL Certificate Bundle file.
  9. Click Upload to upload and install your certificate and key files.
  10. Restart the server.

Load an SSL LDAP certificate

The SSL certificate used by your LDAP server needs to be copied to a machine that has access to the Rally On-Premises Control Panel. Once this is complete, do the following:

  1. From the Rally Control Panel, go to Server Settings → Java Keystore → Keystore.
  2. Click Browse and select the certificate file from the LDAP server, then click Upload.

Once the upload has completed, you will need to restart the Rally Application before the certificate can be used for LDAP Authentication.

English

Feedback

Please send us your feedback regarding our help site. For feedback regarding the Rally product, click here to open a support case or click here to submit a new feature request
English
By submitting this form, you accept the Mollom privacy policy.
© 2014 Rally Software Development Corp | Legal