Prerequisites:
- Gespage must be at least version 9.3.0
- Have a certificate
- Have the private key for the certificate
There are five steps to setting up this configuration:
- Installing the certificate on the Gespage server
- Configuring the httpd.conf file
- Configuring the httpd-ssl. conf file
- Configuration of the application.properties
- Restarting services
Step 1: Installing the certificate and private key
For this step, simply copy the certificate and its private key into the C:\Program Files\GespageCore\server\Apache24\conf\ssl directory:
Example below for adding the gespage-test-26 certificate:
By default, the directory contains the application's self-signed certificate under the name gespage-ui.
There is no need to delete these files.
Step 2: Configuring the httpd.conf file
Edit the httpd.conf file located in C:\Program Files\GespageCore\server\Apache24\conf\.
The service listens on port 7143 by default.
You therefore need to look in this file for the “Listen” parameter and change the value to 443.
Don't forget to save the changes.
Step 3: Configuring the httpd-ssl.conf file
Edit the httpd-ssl.conf file located under C:\Program Files\Gespage\GespageCore\server\Apache24\conf\extra\
In this file, we need to confirm the use of port 443 for SSL exchanges, and indicate the presence of our certificate.
The lines to be modified are as follows:
- <VirtualHost *:443>
- Add the ServerName parameter and enter the name of your server
- RequestHeader set X-Forwarded-Port "443"
- replace the name of the original certificate and key with your own.
Don't forget to save the changes.
Step 4: Declaration of port 443 for the Mobile-Gateway service
Edit the application.properties file in the C:\Program Files\GespageCore\Geps\mobile-gateway\ folder and modify the last line to replace port 7143 with 443 and save the changes:
Step 5: Restarting services
To apply the changes, the following services must be restarted:
- Gespage User Interface
- Gespage Mobile Gateway
Once the services are restarted, you can now connect to the Gespage user web page through the hostname on port 443:
