18.5 Certificate Maintenance

Micro Focus appliances ship with a self-signed digital certificate. However, you should use a trusted server certificate that is signed by a trusted certificate authority (CA) such as VeriSign or Equifax.

The certificate works for both the Micro Focus Appliance and the Filr software (ports 9443 and 8443). You do not need to update your certificate when you update the Filr software.

Complete the following sections to change the digital certificate for your Micro Focus Appliance. You can use the digital certificate tool to create your own certificate and then have it signed by a CA, or you can use an existing certificate and key pair if you have one that you want to use.

NOTE:If you are using a Godaddy SSL certificate with Filr, follow the steps in TID 7023569 at the Micro Focus Support website.

18.5.1 Using the Digital Certificate Tool

Creating a New Self-Signed Certificate

Path: Port 9443 Appliance Console

  1. Log in to the Micro Focus appliance at https://server_url:9443.

  2. Click Digital Certificates.

  3. In the Key Store drop-down list, ensure that Web Application Certificates is selected.

  4. Click File > New Certificate (Key Pair), then specify the following information:

    Alias: Specify a name that you want to use to identify and manage this certificate.

    Validity (days): Specify how long you want the certificate to remain valid.

    Key Algorithm: Select either RSA or DSA.

    Key Size: Select the desired key size.

    Signature Algorithm: Select the desired signature algorithm.

    Common Name (CN): This must match the server name in the URL in order for browsers to accept the certificate for SSL communication.

    Organizational Unit (OU): (Optional) Small organization name, such as a department or division. For example, Purchasing.

    Organization (O): (Optional) Large organization name. For example, Micro Focus

    City or Locality (L): (Optional) City name. For example, Provo.

    State or Province (ST): (Optional) State or province name. For example, Utah.

    Two-letter Country Code (C): (Optional) Two-letter country code. For example, US.

  5. Click OK to create the certificate.

    After the certificate is created, it is self-signed.

  6. Make the certificate official, as described in Getting Your Certificate Officially Signed.

Getting Your Certificate Officially Signed

  1. On the Digital Certificates page, select the certificate that you just created, then click File > Certificate Requests > Generate CSR.

  2. Complete the process of emailing your digital certificate to a certificate authority (CA), such as Verisign.

    The CA takes your Certificate Signing Request (CSR) and generates an official certificate based on the information in the CSR. The CA then mails the new certificate and certificate chain back to you.

  3. After you have received the official certificate and certificate chain from the CA:

    1. Revisit the Digital Certificates page by clicking Digital Certificates from the Micro Focus Appliance.

    2. Click File > Import > Trusted Certificate. Browse to the trusted certificate chain that you received from the CA, then click OK.

    3. Select the self-signed certificate, then click File > Certification Request > Import CA Reply.

    4. Browse to and upload the official certificate to be used to update the certificate information.

      On the Digital Certificates page, the name in the Issuer column for your certificate changes to the name of the CA that stamped your certificate.

  4. Activate the certificate, as described in Activating the Certificate.

Exporting a Self-Signed Certificate

Path: Port 9443 Appliance Console

  1. Log in to the Micro Focus appliance at https://server_url:9443.

  2. Click Digital Certificates.

  3. In the Key Store drop-down list, select Web Application Certificates.

  4. Select the self-signed_cert file.

  5. Click File > Export > Public Certificate.

    This downloads the self-signed_cert.crt certificate file.

18.5.2 Using an Existing Certificate and Key Pair

When you use an existing certificate and key pair, use a .P12 key pair format.

  1. Go to the Digital Certificates page by clicking Digital Certificates from the Micro Focus Appliance.

  2. Click File > Import > Trusted Certificate. Browse to and select your existing certificate, then click OK.

  3. Click File > Import > Trusted Certificate. Browse to your existing certificate chain for the certificate that you selected in Step 2, then click OK.

  4. Click File > Import > Key Pair, then browse to and select your .P12 key pair file, specify your password if needed, then click OK.

    Because of a browser compatibility issue with HTML 5, the path to the certificate is sometimes shown as c:\fakepath. This does not adversely affect the import process.

  5. Continue with Activating the Certificate.

18.5.3 Activating the Certificate

  1. On the Digital Certificates page, select the certificate that you want to make active, click Set as Active, then click Yes.

  2. Verify that the certificate and the certificate chain were created correctly by selecting the certificate and clicking View Info.

18.5.4 Managing Certificates

All certificates that are included with the IBM Java package that is bundled with the version of SLES that Filr ships with are installed when you install Filr.

Filr uses only the certificates that relate to LDAP and SMTP.

You can use the Digital Certificates tool on the Filr appliance to remove certificates that are not used by your organization if you are concerned about keeping them.

Also, you can use the Digital Certificates tool on the Filr appliance to maintain the certificate store by removing certificates that have expired and then installing new certificates as needed, according to your organization’s security policies.

To access the Digital Certificates tool:

  1. Click Digital Certificates from the Micro Focus Appliance.