Aller au contenu

Installation du Bastion Guacamole

Bannière CUB


Informations

  • Auteur : Louis MEDO
  • Date : 01/10/2026
  • Domaine : Cybersécurité

1. Sommaire

2. Contexte

Le bastion Guacamole agit en tant que point d'accès centralisé et sécurisé pour l'administration des équipements et serveurs de l'infrastructure CUB. En s'appuyant sur la suite Apache Guacamole, il fournit des connexions RDP, SSH et VNC "clientless" directement via un navigateur web. Le déploiement s'effectue de manière conteneurisée à l'aide de Docker Compose, intégrant un service PostgreSQL pour la gestion des accès et un reverse proxy Nginx pour le chiffrement des flux en HTTPS.

3. Préparation de l'environnement de travail

3.1. Création du répertoire de travail. Initialisation de l'arborescence principale pour l'hébergement des volumes et configurations Docker.

sudo mkdir -p /opt/guacamole
cd /opt/guacamole
sudo chown etudiant:etudiant -R /opt/guacamole
  • sudo : Exécution avec les privilèges administrateur.
  • -p : Création des répertoires parents si inexistants.
  • -R : Application de la récursivité pour les droits de propriété.

Droits et Groupes

Pensez à ajouter l'utilisateur au groupe docker via sudo adduser etudiant docker. Il est nécessaire de redémarrer la connexion SSH pour que l'application de ce nouveau groupe soit effective.

3.2. Initialisation de la base de données. Création du dossier d'initialisation et exécution du script de génération des tables PostgreSQL.

mkdir -p ./initdb
docker run --rm 'guacamole/guacamole:1.6.0' /opt/guacamole/bin/initdb.sh --postgresql > ./initdb/initdb.sql
  • --rm : Le conteneur éphémère sera automatiquement supprimé à la fin de l'opération.
  • --postgresql : Spécifie le type de base de données à initialiser.

4. Configuration du Reverse Proxy et Certificats SSL

4.1. Création de l'arborescence Nginx. Préparation des dossiers pour le stockage des certificats et du template de configuration Nginx.

mkdir -p ./nginx/ssl
mkdir -p ./nginx/templates

4.2. Génération du certificat auto-signé. Création d'un certificat SSL et de sa clé privée pour sécuriser les flux web en HTTPS.

openssl req -nodes -newkey rsa:2048 -new -x509 \
-keyout nginx/ssl/self-ssl.key \
-out nginx/ssl/self.cert \
-subj '/C=FR/ST=Centre-Val-de-Loire/L=Tours/O=CUB/CN=bastion0.dortmund.cub.sioplc.fr'
  • -nodes : Ne pas chiffrer la clé privée (sans passphrase).
  • -newkey rsa:2048 : Génère une nouvelle clé RSA de 2048 bits.
  • -subj : Permet de renseigner les informations du certificat directement en ligne de commande.

4.3. Configuration du template Nginx. Définition des règles de reverse proxy.

Création du fichier de configuration
vim /opt/guacamole/nginx/templates/guacamole.conf.template

📄 Consulter guacamole.conf.template

5. Déploiement de l'Infrastructure Docker

5.1. Configuration des variables d'environnement. Renseignement des secrets et paramètres globaux de la stack.

Création du fichier d'environnement
vim /opt/guacamole/.env

📄 Consulter .env

5.2. Déclaration des services. Configuration du fichier définissant les services Guacamole, PostgreSQL et Nginx.

Création de la stack Docker Compose
# Créer le dossier pour stocker les enregistrements de sessions
mkdir /opt/guacamole/session-recording

vim /opt/guacamole/docker-compose.yml

📄 Consulter docker-compose.yml

6. Post-Installation et Sécurisation

6.1. Première authentification. Accéder à l'interface web via l'adresse IP du bastion et s'authentifier avec les identifiants initiaux.

  • Utilisateur : guacamole (ou guacadmin)
  • Mot de passe : guacamole (ou guacadmin)

Page de connexion Guacamole

6.2. Accès au menu des paramètres. Se rendre dans la zone d'administration en haut à droite.

Accès aux paremètres

6.3. Modification du mot de passe par défaut. Naviguer dans l'onglet Préférences, puis dans la section MODIFIER MOT DE PASSE. Renseigner un mot de passe robuste, puis cliquer sur Mettre à jour mot de passe.

Compte Administrateur

Le mot de passe par défaut historique du compte administrateur est guacadmin. Cette modification est impérative avant toute mise en production !

Changement du mot de passe