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 port.conf qui se trouve sous le répertoire /etc/apache2/
- Configuration du fichier gespage-ssl.conf qui se trouve sous le répertoire /etc/apache2/sites-availables/
- Configuration du fichier application.properties du répertoire /opt/Gespage/GespageCore/Geps/mobile-gateway/
- Redémarrage des services
Etape 1: Mise en place du certificat et de la clé privée
Pour cette étape, il vous suffit de copier le certificat ainsi que sa clé privée dans le répertoire /opt/apache2/ssl.
Exemple ci-dessous pour l'ajout du certificat gespage-test-26:
Etape 2: Configuration du fichier port.conf
Editer le fichier port.conf qui se trouve sous /opt/apache2/
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 gespage-ssl.conf
Editer le fichier gespage-ssl.conf qui se trouve sous /etc/apache2/sites-available/.
Dans ce fichier, nous allons devoir confirmer 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
- Remplacer le nom du certificat et de la clé d'origine par les votres
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 /opt/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:
- sudo systemctl restart apache2
- sudo systemctl restart 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: