Citrix Gateway

Importing and Installing an Existing Certificate

October 5, 2020

Contributed by:

You can import an existing certificate from a Windows-based computer running Internet Information Services (IIS) or from a computer running the Secure Gateway.

When you export the certificate, make sure you also export the private key. In some cases, you cannot export the private key, which means you cannot install the certificate on Citrix Gateway. If this occurs, use the Certificate Signing Request (CSR) to create a new certificate. For details, see Creating a Certificate Signing Request.

When you export a certificate and private key from Windows, the computer creates a Personal Information Exchange (.pfx) file. This file is then installed on Citrix Gateway as a PKCS#12 certificate.

If you are replacing the Secure Gateway with Citrix Gateway, you can export the certificate and private key from the Secure Gateway. If you are doing an in-place migration from the Secure Gateway to Citrix Gateway, the fully qualified domain name (FQDN) on the application and the appliance must be the same. When you export the certificate from the Secure Gateway, you immediately retire the Secure Gateway, install the certificate on Citrix Gateway, and then test the configuration. The Secure Gateway and Citrix Gateway cannot be running on your network at the same time if they have the same FQDN.

If you are using Windows Server 2003 or Windows Server 2008, you can use the Microsoft Management Console to export the certificate. For more information, see the Windows online Help.

Leave the default values for all the other options, define a password, and save the .pfx file to your computer. When the certificate is exported, you then install it on Citrix Gateway.

To install the certificate and private key on Citrix Gateway

In the configuration utility, click the Configuration tab and then in the navigation pane, click Citrix Gateway.
In the details pane, under Getting Started, click Citrix Gateway wizard.
Click Next, select an existing virtual server and then click Next.
In Certificate Options, select Install a PKCS#12 (.pfx) file.
In PKCS#12 File Name, click Browse, navigate to the certificate and then click Select.
In Password, type the password for the private key.

This is the password you used when converting the certificate to PEM format.
Click Next to finish the Citrix Gateway wizard without changing any other settings.

When the certificate is installed on Citrix Gateway, the certificate appears in the configuration utility in the SSL > Certificates node.

To create a private Key

In the configuration utility, on the Configuration tab, in the navigation pane, click SSL.
In the details pane, under SSL Keys, click Create RSA Key.
In Key Filename, type the name of the private key or click Browse to navigate to an existing file.
In Key Size (Bits), type the size of the private key.
In Public Exponent Value, select F4 or 3.

The public exponent value for the RSA key. This is part of the cipher algorithm and is required for creating the RSA key. The values are F4 (Hex: 0x10001) or 3 (Hex: 0x3). The default is F4.
In Key Format, select PEM or DER. Citrix recommends PEM format for the certificate.
In PEM Encoding Algorithm, select DES or DES3.
In PEM Passphrase and Verify Passphrase, type the password, click Create and then click Close.

Note: To assign a passphrase, the Key Format must be PEM and you must select the encoding algorithm.

To create a DSA private key in the configuration utility, click Create DSA Key. Follow the same steps above to create the DSA private key.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Importing and Installing an Existing Certificate

October 5, 2020

Contributed by:

October 5, 2020

Contributed by:

Importing and Installing an Existing Certificate

To install the certificate and private key on Citrix Gateway

To create a private Key

In this article