[x]

Site Alert(s):

  • Server maintenance Saturday Nov 22, 2008, 12:00 PM - 3:00 PM. The Knowledge Center will be unavailable during this time.
Rate this Article:
You must be signed in to rate again
Article Feedback Print View
Alternate Languages: N/A

Convert PFX Certificate to PEM Format for Use with Citrix Access Gateway

Document ID: CTX106028   /   Created On: Apr 22, 2005   /   Updated On: Apr 22, 2005
Average Rating: 3

Summary

For secure, trusted access you must install an SSL server certificate on the Access Gateway server. The uploaded certificate file must have the following characteristics:

• The server certificate must be issued by a Certification Authority (CA) that is trusted by end users. For best results, use a commercial CA such as VeriSign, Thawte or GeoTrust.

• The certificate must be in PEM format, a text-based format that is a Base64 encoding of the binary DER format.

• The certificate file must include a private key and the private key must not be encrypted. There should be no password required to use the PEM file.

• Any necessary intermediate certificates must also be appended to the end of the PEM file.

Procedure

If you have requested and installed a certificate onto a Windows server using the IIS certificate wizard, you can export that certificate with its private key to a PFX file. In order to import this certificate onto the Access Gateway, you must convert the PFX file to the unencrypted PEM format.

Use the open-source utility OpenSSL to perform the conversion from PFX to PEM. You can download a Win32 distribution of OpenSSL here:

http://gnuwin32.sourceforge.net/packages/openssl.htm

To convert a PFX file to a PEM file, follow these steps on a Windows machine:

1. Download and install the Win32 OpenSSL package from http://gnuwin32.sourceforge.net/packages/openssl.htm.

2. Create a folder c:\certs and copy the file yourcert.pfx into the c:\certs folder

3. Open a command prompt and change into the GnuWin32\bin directory:

cd %ProgramFiles%\GnuWin32\bin

4. Type the following command to convert the PFX file to an unencrypted PEM file (all on one line):

openssl pkcs12 -in c:\certs\yourcert.pfx -out c:\certs\cag.pem -nodes

5. When prompted for the import password, enter the password you used when exporting the certificate to a PFX file. You should receive a message that says MAC verified OK.

6. Point a browser to the Access Gateway administration portal or HTTPS port 9001: https://access-gateway-server:9001.

7. Log on as root. The default password is rootadmin.

8. Click the Maintenance link at the top of the page.

9. Click the Browse button next to the Upload certificate field. Browse to the c:\certs\cag.pem file and click Upload.


This document applies to:

Search
Knowledge Center
XenApp
XenApp Plugins (Clients)
XenServer
XenDesktop
NetScaler Application Delivery
Access Gateway
EdgeSight
Provisioning Server
WANScaler
Password Manager
Does it work with Citrix? Verify it - introducing the new Citrix Ready Community Verified