Skip to main content
Version: Reality 5.5 SP1

SSL Configuration

Reality Hub 1.6.3 provides native SSL support for configuring SSL (Secure Sockets Layer) to secure communications between clients and the server.

info

Reality Hub, by default, uses HTTP port 80 to serve its front-end to browser.

info

To configure SSL, you must obtain a valid certificate from an authorized provider. Please consult your network administrator to get help obtaining the certificate.

SSL Configuration Interface

alt text

SSL Configuration

  • Generate Self-Signed Certificate: Generates a self-signed SSL certificate.
  • Upload Certificate (PEM): Allows uploading an SSL certificate file in PEM format.
  • Upload Private Key (PEM): Allows uploading a private key file in PEM format.

Steps

1. Generating a Self-Signed Certificate

alt text

Create Self-Signed Certificate & Key Pair

Click on "Generate Self-Signed Certificate" button. This will opens a new window:

  • Common Name: The fully qualified domain name (FQDN) for the certificate.
  • Organization Name: The name of your organization.
  • Short Name: A short name for the certificate.

Fill in the details and click "Ok". The interface will display the message "Self Signed certificate generated and saved."

2. Uploading Certificate (PEM)

alt text

Uploading Certificate

Click on "Upload Certificate (PEM)" Button. This will open Upload Certificate (PEM) window:

  • Name: The name you want to assign to the certificate.
  • File: Clicking this button opens Windows Explorer to select the PEM file.
  • Select the Certificate File
  • Choose the PEM file from your local machine.
  • Click "Import"

With this action, the certificate is now stored in Reality Hub Server.

3. Uploading a Private Key (PEM)

alt text

Uploading Private Key

Click on "Upload Private Key (PEM)" Button. This will open Private Key (PEM) window.

  • Name: The name you want to assign to the private key.
  • File: Clicking this button opens Windows Explorer to select the PEM file.
  • Select the Private Key File
  • Choose the PEM file from your local machine and click "Import".

The private key will be uploaded to Reality Hub Server.

4. Enabling SSL

To apply the SSL configuration, restart the server with the --ssl 1 parameter. Follow these steps:

alt text

Registry Editor

  • Open Registry Editor

alt text

Reality Hub AppParameters

  • Navigate to Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\reality-hub\Parameters.
  • Edit the Key: AppParameters
  • Add --ssl 1 at the beginning of the value of the key (make sure you add a space after “1”).

alt text

Reality Hub Services

  • Restart Reality Hub Service to apply the changes.