With the release of GSX Gizmo version 1.2.0, it is now possible to configure the GSX Gizmo site for access over HTTPS. A certificate.crt and privatekey.key are required.
Follow this article to learn how to secure access to the GSX Gizmo web interface with HTTPS.
Instructions
Configuring GSX Gizmo's website over HTTPS:
For this procedure to work you will need:
- GSX Gizmo version 1.2.0+
- One Certificate.crt
- One PrivateKey.key
In case you do not have an SSL certificate and private key yet, we provide help on how to generate a self-signed certificate and private key using OpenSSL.
- Open Windows File Explorer.
- Navigate to \GSX Groupware Solutions\Gizmo\.
- Double-click on "Stop Gizmo".
- Create a backup copy of the env.json file.
- \GSX Groupware Solutions\Gizmo\env.json
- Right-click the original env.json file.
- Select Edit via Notepad.
- Modify the below parameters with applicable port numbers and paths to your certificate and private key:
- "WEBAPP_PORT": 80,
- "WEBAPP_SSL_PORT": 443,
- "ALLOW_UNTRUSTED_CONNECTIONS": true,
- "SECURE": true,
- "CERTIFICATE_PATH": "path\\to\\the\\certificate\\to\\be\\used\\by\\HTTPS",
- "PRIVATE_KEY_PATH": "path\\to\\the\\private_key\\to\\be\\used\\by\\HTTPS",
- Save the env.json file.
- Double-click on "Start Gizmo".
You can now access GSX Gizmo over HTTPS.
We recommend to validate the modified JSON, this will ensure Gizmo starts properly.
If you are not familiar with JSON syntax, this can easily be done online using any SAAS JSON validator, one we like is JSONLint. For example, JSON special characters must be "escaped" for the env.json file to be valid. Therefore you should use "\\" instead of "\":
- "CERTIFICATE_PATH": "C:\\GSX Groupware Solutions\\Gizmo\\Security\\certificate.crt"