Prérequis:
- Gespage doit être en version 9.3.0 minimum
- Disposer d'un certificat
- Disposer de la clé privée pour le certificat
La mise en place de cette configuration s'effectue en cinq étapes:
- Mise en place du certificat sur le serveur Gespage
- Configuration du fichier httpd.conf
- Configuration du fichier httpd-ssl.conf
- Configuration du fichier application.properties
- Redémarrage des services
Etape 1: Mise en place du certificat et de la clé privé
Pour cette étape, il vous suffit de copier le certificat ainsi que sa clé privée dans le répertoire C:\Program Files\Gespage\GespageCore\server\Apache24\conf\ssl:
Exemple ci-dessous pour l'ajout du certificat gespage-test-26:
Le répertoire contient par défaut le certificat autosigné de l'application sous le nom gespage-ui.
Il n'est pas nécessaire de supprimer ces fichiers.
Etape 2: Configuration du fichier httpd.conf
Editer le fichier httpd.conf qui se trouve sous C:\Program Files\Gespage\GespageCore\server\Apache24\conf\.
Le service est par défaut en écoute sur le port 7143.
Il faut donc rechercher dans ce fichier le paramètre 'Listen' et modifier la valeur pour 443.
Il ne faut pas oublier de sauvegarder la modification.
Etape 3: Configuration du fichier httpd-ssl.conf
Editer le fichier httpd-ssl.conf qui se trouve sous C:\Program Files\Gespage\GespageCore\server\Apache24\conf\extra\
Dans ce fichier, nous allons devoir configurer l'usage du port 443 pour les échanges SSL, et indiquer la présence de notre certificat.
Les lignes à modifier sont les suivantes:
- <VirtualHost *:443>
- Ajouter le paramètre ServerName et y renseigner le nom de votre serveur
- RequestHeader set X-Forwarded-Port "443"
- Remplacer le nom du certificat et de la clé d'origine par le votre
Il ne faut pas oublier de sauvegarder la modification.
Etape 4: Déclaration du port 443 pour le service Mobile-Gateway
Editer le fichier application.properties du dossier C:\Program Files\Gespage\GespageCore\Geps\mobile-gateway\ et modifier la dernière ligne pour remplacer le port 7143 par le 443 puis sauvegarder la modification :
Etape 5: Redémarrage des services
Pour appliquer les modifications, il est nécessaire de redémarrer les services suivants:
- Gespage User Interface
- Gespage Mobile Gateway
Une fois les services redémarrés, vous pouvez désormais vous connecter sur la page Web utilisateur de Gespage au travers du nom d'hôte sur le port 443:
