The SSL tab in the ALOHA Web user interface allows you to oversee various TLS/SSL-related tasks, such as:

  • List available SSL/TLS certificates

  • Update / delete an existing SSL/TLS certificate

  • Create a new SSL/TLS certificate

Note

To know how to configure the ALOHA to use SSL/TLS certificate, refer to the following sections:

List available SSL/TLS certificates

When you open the SSL tab, the ALOHA displays the list of the SSL/TLS certificate it contains, including the following information:

Name

Label used to reference this certificate in HAProxy's configuration

Domain

Common Name (or CN) of the certificate

Not Before

Date from when the certificate is valid

Not After

Date until when the certificate is valid. When a certificate expires, this date appears in bold red.

Verify

State of the validation of the certificate. The following states are available:

Broken chain

When a certificate chain is incomplete or the full chain cannot be validated (outdated intermediary, etc.)

CA only (no key)

When a certificate can be used to validate client certificates only.

Incomplete

When either the private Key and the certificate or the certificate is missing

Valid

When everything is fine and safe

Self-Signed

When the certificate was generated and signed by the ALOHA itself

Example of an SSL tab output:

//cdnvz.haproxy.com/de/documentation/aloha/9-0/_assets/images/ssl_tab_index.png

Create a new SSL/TLS certificate

The creation of a new certificate involves three main steps:

  1. Give a Name to this certificate: this is the reference of this certificate. This name is used in HAProxy's configuration to point to this certificate.

  2. Handle the private key. You have two options:

    • Generation of a new private key

    • Upload of an existing private key

  3. Handle the certificate itself, either by:

    • generating a certificate request (CSR), and then generating a self-signed certificate

    • uploading an existing certificate

Choose a certificate name

  1. Open the SSL tab and click on the new button.

  2. Fill in the box choose SSL certificate name. Only letters, digits and underscore are allowed.

Generate a new private key

  1. Ensure that the button generate a private key is checked.

  2. Choose the size of the new key.

  3. Click on the "Generate" button.

Note

If the certificate will be public facing, we recommend 2048 bits. For internal use, 1024 bits is enough.

Upload an existing private key

  1. Ensure that the button generate a private key is checked.

  2. You can either:

    • Copy/paste the key in the dedicated text area

    • Upload the key using the form below:

      //cdnvz.haproxy.com/de/documentation/aloha/9-0/_assets/images/ssl_tab_upload.png

      Note

      If the file is password-protected, type the password in the box file or key password.

  3. Click on the "Upload" button.

Generate a certificate request

  1. Ensure the button generate a private key is checked.

  2. Complete the form below:

    //cdnvz.haproxy.com/de/documentation/aloha/9-0/_assets/images/ssl_tab_csr_form_331x123.png

    Note

    Only the Domain (CN) is required. However, if the certificate is to be published over the internet, you must complete all information.

  3. Click on the "Request" button.

  4. Copy/paste the CSR and send it to your certification authority to receive the permanent certificate.

    In the meantime, you can start working with a self-signed certificate.

    When your certificate authority replies with the permanent certificate, you can upload the certificate using the form available on the same page, or follow the procedure to update an existing certificate.

Generate a self-signed certificate

  1. Ensure that the radio button auto-sign request is checked.

  2. Choose the number of days you want this self-signed certificate to be valid.

  3. Click on the "Sign" button.

  4. Upload the certificate.

Upload an existing certificate

  1. Ensure that the button upload certificate is checked.

  2. You can either:

    • Copy/paste the certificate in the dedicated text area

    • Upload the key using the form below:

      //cdnvz.haproxy.com/de/documentation/aloha/9-0/_assets/images/ssl_tab_upload1_438x20.png

      Note

      If the file is password-protected, type the password in the box file or key password.

  3. Click on the "Upload" button.

Create a TLS certificate to validate client certificates

To validate TLS certificates from clients, the ALOHA Load-balancer only needs a TLS certificate and not the associated private key.

  1. Follow the procedure to create a new SSL/TLS certificate.

  2. At the private key generation step, choose a key size of 0 bits.

  3. Upload the certificate.

Update an existing certificate

You may need to update an existing certificate in any of the following cases:

  • When a certificate expires

  • To replace a temporary self-signed certificate with a permanent one from the certification authority

To update an existing certificate:

  1. Open the SSL tab and click on the edit_icon icon.

    Two options are available:

    • Copy/paste the certificate in the dedicated text area and check the button update certificate above.

    • Upload the key using the form below and check its button:

    Note

    If the file is password-protected, type the password in the box file or key password.

  2. Click on the "Upload" button.

Delete an existing certificate

  1. Open the SSL tab and click on the delete_icon icon.

  2. A prompt displays for confirmation. Click on OK.

Manage chained certificates

When a certificate relies on intermediaries and/or a root certificate, it is called a chain.

Generally, you build this chain when a certificate is validated by a certification authority. The certification authority must provide a valid chain.

To update a chain:

  1. Update the certificate

  2. Copy/paste intermediaries and/or root certificates below it. The chain must lo**OK** like this:

    Server certificate
            |
            v
    Intermediary certificate #1
            |
            v
    Intermediary certificate #2
            |
            v
    root certificate
Server certificate

It is the one signed by the certification authority. It is dedicated to host the service.

Other certificates

Are provided by the certification authority. They are used to build a valid chain.