Custom SSL Certificate

PA File Sight can use your own SSL certificate instead of the default self-signed certificate.

If at any time there are any problems with certificates, you can run the C:\Program Files\PA File Sight\CA\000_RESET_CERTIFICATES.cmd file (run as an administrator), and then restart the service. New certificates will be created. If things are really messed up, you can delete the C:\Program Files\PA File Sight\CA folder completely and restart the service to create a new CA folder.

Use your own existing certificate

1. You will need to get your certificate into PEM format if it isn't already. There are a number of utilities that can do this that you can find on the Internet. Try searching for something like 'convert {your cert type} to PEM'. Note that .pem, .crt, .cer, and .key are often used interchangably. If you look at the file with a text editor and see readable text, you have a .pem file.
   
   For example, to convert a .PFX file using OpenSSL (which is in the C:\Program Files\PA File Sight folder) run the following:
   
   Tell OpenSSL where to find its configuration file (do NOT use quotes, even if there are spaces in the path):
   
   set OPENSSL_CONF=C:\Program Files\PA File Sight\CA\openssl.cnf
   
   

   The conversion command:

   "C:\Program Files\PA File Sight\openssl.exe" pkcs12 -in "C:\My Files\myCert.pfx" -passin pass:current-pfx-password -out "C:\My Files\myNewCert.pem" -passout pass:new-pem-password
   
   

   current-pfx-password above is the current private key password for the .pfx file, and new-pem-password is the private key password for the output pem file.

   Look at the resulting .pem file in a text editor -- you'll see there are two sections. Split this into two separate files, like below:

   SSL_PRIVATE_KEY.pem file contents:
   
   -----BEGIN ENCRYPTED PRIVATE KEY-----
   MIIFDjBABgkfhkiG9w0BBQgwMzAbBgkqh1iG9w0BBQwwDgQIvSKYYbDSkPICAggA
   ... many more lines like those above ...
   4pvqu3DGh93oIV7YlC1Gn4BY/2jVd2F1NxRjIxvDsllhDvvFFMUWC41Xc5pZ6d9U
   pyY=
   -----END ENCRYPTED PRIVATE KEY-----
   
   SSL_CERT.pem file contents:
   
   -----BEGIN CERTIFICATE-----
   MIIFPzCCBCFgAwIBAgIS3SGXUxVkgYN9r5PZvhFNF148MA0GCSqGSIb3DQ5BBQUA
   ... many more lines like those above ...
   ITywFF+LW4hdG5TYw2smJmbBgkfbW7nusufXAzg7I0E5z2HyxRmLm+Eees4J00mo
   f6jn
   -----END CERTIFICATE-----

   You don't need the other lines that are in the file.

   IMPORTANT: if your .pem file does not have a PRIVATE KEY section, then you must already have the private key in another file somewhere else - you must find that file and get it into pem format. The private key is created when the CSR (Certificate Signing Request) was initially sent to the certificate vendor (Verisign, GlobalSign, etc). It CANNOT be generated later - the private key and the certificate are a matched set.

   If you want to include a full certificate chain in SSL_CERT.pem, make sure that:

   • The certifcates are listed in the order of Application Certificate, Intermediate Certificate(s), Root Certificate (possibly the reverse of what is in the original .pem file)
   • There needs to be a blank line between each --END CERTIFICATE-- and --BEGIN CERTIFICATE-- section

   Thank you Martin for these tips :)

2. Save the certificate's private key file to
   C:\Program Files\PA File Sight\CA\SSL_PRIVATE_KEY.pem
3. Save the SSL certificate to
   C:\Program Files\PA File Sight\CA\SSL_CERT.pem
4. PA File Sight will need to know the password for the private key. You can specify this by running the following command:
   
   "C:\Program Files\PA File Sight\diag.exe" /SETCONFIG=SSLCertPKPW:your-certificate-password
   
   The above command will encrypt and store the password with a machine-specific key in the registry.
   
   If you ever need to erase the password (such as if you delete the CA folder and go back to the self-signed certificate), run:
   
   "C:\Program Files\PA File Sight\diag.exe" /SETCONFIG=SSLCertPKPW:
5. Restart the PA File Sight service and it will now be using your SSL certificate.

Create your own new certificate

1. Go to the C:\Program Files\PA File Sight\CA folder
2. Create a folder inside CA named NewCert.
3. Copy Client.cnf from CA into NewCert
4. Open NewCert\Client.cnf in a text editor. Go to the PACA_dn section near the bottom and edit the values as you like (C=Country, ST=State/Province, L=City).
   
   If you want to change the private key file's password, change the entries on the lines for input_password and output_password.
   
   Change the CN value to the hostname of your server. Some SSL certificate providers expect to see a dot in the name, so the public name of your server would best (something like monitor.mydomain.com).
   
   Note that depending on the SSL provider that you use, the subjectAltName field might be ignored which is where additional machine names are mentioned.
5. Open a command prompt and change directory to
   C:\Program Files\PA File Sight\CA\NewCert
6. Run the following to tell OpenSSL where to find your configuration file (do NOT use quotes, even if there are spaces in the path):
   set OPENSSL_CONF=C:\Program Files\PA File Sight\CA\NewCert\client.cnf
   
   Then run the following to actually create the Certificate Signing Request file (also known as a CSR file). DO use quotes if there are spaces in the path: (note the below is all on one line)
   "C:\Program Files\PA File Sight\openssl.exe" req -newkey rsa:2048 -keyout "C:\Program Files\PA File Sight\CA\NewCert\SSL_PRIVATE_KEY.pem" -keyform PEM -out "C:\Program Files\PA File Sight\CA\NewCert\SSL_CERT_CSR.csr" -outform PEM -rand "C:\Program Files\PA File Sight\openssl.exe"
7. This will create two new files:
   SSL_CERT_CSR.csr -- this is the Certificate Signing Request file that you will send/copy to the SSL certificate vendor (like Verisign, GlobalSign, etc)
   SSL_PRIVATE_KEY.pem -- this is the private key file for this certificate. This file will need to remain on the server, but should be kept private.
8. To see what you are sending to the SSL provider, run:
   "C:\Program Files\PA File Sight\openssl.exe" req -in "C:\Program Files\PA File Sight\CA\NewCert\SSL_CERT_CSR.csr" -noout -text
9. After sending SSL_CERT_CSR.csr to a certificate provider, you will get back a certificate file. Save the file (in PEM format) to:
   C:\Program Files\PA File Sight\CA\SSL_CERT.pem
   

If you want to include a full certificate chain in SSL_CERT.pem, make sure that:

• The certifcates are listed in the order of Application Certificate, Intermediate Certificate(s), Root Certificate
• There needs to be a blank line between each --END CERTIFICATE-- and --BEGIN CERTIFICATE-- section

Thank you Martin for these tips :)

10. When the above file is copied, also copy
    C:\Program Files\PA File Sight\CA\NewCert\SSL_PRIVATE_KEY.pem
    into the CA folder.
11. PA File Sight will need to know the password for the private key. This password can be found in the client.cnf file on the line with input_password. You can give PA File Sight the password by running the following command:
    
    "C:\Program Files\PA File Sight\diag.exe" /SETCONFIG=SSLCertPKPW:private-key-pass-phrase
    
    The above command will encrypt and store the password with a machine-specific key in the registry.
12. You can optionally delete the NewCert folder at this point.
13. Restart the PA File Sight service and it will now be using your SSL certificate.