Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the...

6
Page 1 of 6 UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2 www.udsenterprise.com Introduction This document indicates the steps necessary to install SSL certificates in UDS Enterprise 2.2. Through a practical example it is explained how to upload the certificates to the server, the format of the same and the order in which they should be installed. In addition, the commands that must be executed to perform the installation are detailed. Note: To install certificates on UDS Enterprise, you should at least have the following files: Certificate.crt: Server Certificate in PEM format. Certificate.key: Private key file of the server certificate. (This file should not be protected by password, otherwise UDS Enterprise servers will not be able to boot). It is possible that for certain certification entities it is necessary to have the chain of certification file. Before beginning the installation, check if your certifying entity requires the following file: Certificate.ca-bundle: file that contains the certification chain.

Transcript of Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the...

Page 1: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 1 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

Introduction This document indicates the steps necessary to install SSL certificates in UDS Enterprise 2.2. Through a practical example it is explained how to upload the certificates to the server, the format of the same and the order in which they should be installed. In addition, the commands that must be executed to perform the installation are detailed. Note: To install certificates on UDS Enterprise, you should at least have the following files:

Certificate.crt: Server Certificate in PEM format. Certificate.key: Private key file of the server certificate. (This file should not be

protected by password, otherwise UDS Enterprise servers will not be able to boot).

It is possible that for certain certification entities it is necessary to have the chain of certification file. Before beginning the installation, check if your certifying entity requires the following file:

Certificate.ca-bundle: file that contains the certification chain.

Universal Desktop Services White Paper Versiones Software UDS

Page 2: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 2 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

Steps for installing certificates on UDS Server 1. Upload the certificates to the Virtual Appliance UDS Server. You can place them

on any route. In this example, we will upload it through WINSCP and copy it to the following directory: /cert.

2. You can establish a connection through an SSH client, or simply enter the server console:

3. Locate the folder where the certificates are saved as shown below:

# cd /cert/ # ls -la

Page 3: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 3 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

4. Execute the command “cert-installer --help”, this command helps you the

parameters to pass in order to install the certificates.

As you can see in the following screenshot, it shows how to install the three files that we mentioned before in this manual. We briefly detail the meaning of each of the letters that appear in the capture (-c -k -n). -c server certificate. -k private key of the server. -n server chain key.

5. Continuing with the example, for the server we will install the certificates (.crt and .key) executing the following command

cert-installer –c CERT_FILE.PEM –k KEY_FILE.PEM

Respecting the order as shown in the previous capture.

# cert-installer –c STAR_certificatename_com.crt –k certificatename.com.key

As a result, after having installed the certificates as explained previously, everything should appear Correct, if Failed shows up, you probably have had a problem with one of the files.

Page 4: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 4 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

Steps to install certificates on UDS Tunneler:

1. In this case we repeat the same operation as it was done on the server, remember to have the necessary files, as it is mentioned at the beginning of this manual, available on your computer, since you will have to upload them to a path in the server. In this example we will upload it through WINSCP and we will copy it in the following directory: /cert.

It is important to note that the installation of the certificates in the tunnel only applies to connections made through HTML5, since these connections (HTTPS) must go through SSL.

2. You can establish a connection through an SSH client or simply enter the console of the Server:

3. Locate the folder where the certificates are saved as shown below: # cd /cert/ # ls -la

Page 5: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 5 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

4. Execute the command "cert-installer --help", which indicates the form and

order that must be taken into account to install the certificates. As explained in the process of installing the certificates in the Server, the following screenshot shows the format and order that the files mentioned at the beginning of this document should have.

5. Continuing with the example, for the server we will install the certificates (.crt and .key) executing the following command

cert-installer –c CERT_FILE.PEM –k KEY_FILE.PEM

Respecting the order as shown in the previous capture.

# cert-installer –c STAR_certificatename_com.crt –k certificatename.com.key

Page 6: Install SSL Certificates on UDS Enterprise 2 · -c server certificate. -k private key of the server. -n server chain key. 5. Continuing with the example, for the server we will install

Page 6 of 6

UDS Enterprise Install SSL Certificates on UDS Enterprise 2.2

www.udsenterprise.com

Support and professional services VirtualCable markets UDS Enterprise through a subscription model, including support and updates, depending on the number of users. In addition, VirtualCable offers professional services to install and configure UDS Enterprise and other virtualization technologies. For more information, visit www.udsenterprise.com or send us an email at [email protected]