// travaux pratiques · Gestion de projets et gouvernance en informatique
TP01 - Déployer CISO Assistant avec Docker Compose
- TP 1 / 6
- 7 étapes
- ≈ 45 min
- Accès libre
Objectif : installer CISO Assistant sur une machine virtuelle Linux avec la méthode Docker Compose de l’éditeur, créer le premier superutilisateur, vérifier que les conteneurs tournent sans privilèges root et accéder à l’interface de façon sûre depuis le poste d’administration.
Contexte
Riviera Logistique, PME fictive de 80 salariés qui servira de fil rouge à ces travaux pratiques, vient d’apprendre qu’elle entre dans le champ de NIS 2 et que son principal client exige un plan de sécurité aligné sur l’ISO/IEC 27001. Le suivi actuel tient dans trois tableurs. La direction confie à l’équipe informatique la mise en place d’un outil de GRC auto-hébergé, sans abonnement, que l’on pourra évaluer avant de le généraliser.
Ce premier TP couvre l’installation de laboratoire telle que l’éditeur la documente. À la fin, vous saurez déployer l’instance, retrouver ses données sur le disque, lire ses journaux et y accéder sans l’exposer sur le réseau.
Prérequis : une machine virtuelle grc01 sous Debian 12 ou Ubuntu 24.04 (2 vCPU, 4 Go de mémoire et 20 Go de disque suffisent pour un laboratoire ; l’éditeur ne publie pas de dimensionnement minimal), un compte administrateur avec sudo, l’accès SSH depuis votre poste et Docker Engine installé depuis les dépôts officiels de Docker (le guide d’installation de docs.docker.com décrit la procédure pour chaque distribution).
Durée estimée : 45 minutes.
Actions à réaliser
1. Vérifier les versions de Docker et de Compose
L’éditeur exige une version récente de Docker, 27.0 ou ultérieure. Les distributions livrent parfois des paquets plus anciens, ou l’ancien binaire docker-compose au lieu du plugin docker compose : on contrôle donc avant de lancer quoi que ce soit.
docker --version
docker compose version
Résultat attendu : la première commande affiche une version 27.0 ou supérieure, la seconde la version du plugin Compose (v2). Si la seconde répond que compose n’est pas une commande Docker, le plugin manque : réinstallez Docker depuis le dépôt officiel, qui le fournit avec le moteur.
2. Récupérer le dépôt de l’éditeur
Le dépôt contient les fichiers Compose, les scripts de démarrage et de mise à jour. L’option --single-branch -b main ne télécharge que la branche principale, ce qui réduit la taille du clone. Travaillez dans un répertoire dédié, par exemple /opt, que vous inclurez plus tard dans les sauvegardes.
cd /opt
sudo git clone --single-branch -b main https://github.com/intuitem/ciso-assistant-community.git
sudo chown -R "$USER": /opt/ciso-assistant-community
cd /opt/ciso-assistant-community
ls
Résultat attendu : la liste comprend notamment docker-compose.sh, docker-compose.yml et update-ciso-assistant.sh. Le chown vous rend propriétaire du clone pour éviter de lancer la suite avec sudo.
3. Lancer le script de déploiement
Le script docker-compose.sh supprime les images précédentes, télécharge la dernière version stable publiée, démarre la pile et applique les migrations de la base. Il faut que votre compte puisse piloter Docker (membre du groupe docker, ou lancement via sudo).
./docker-compose.sh
Quand le script le demande, saisissez l’adresse électronique et le mot de passe du premier superutilisateur. Utilisez une adresse nominative et un mot de passe long, généré par votre gestionnaire de mots de passe : ce compte a tous les droits sur l’instance.
Résultat attendu : après le téléchargement des images et l’application des migrations, l’invite de création du superutilisateur s’affiche, puis le script rend la main avec la pile démarrée. Un répertoire db/ est apparu à la racine du dépôt.
4. Contrôler les conteneurs et l’utilisateur d’exécution
La pile comprend trois conteneurs : le backend (Django et l’API), le frontend (l’interface web) et le proxy Caddy qui publie l’ensemble en HTTPS. Depuis la version 3.16, ils s’exécutent avec l’utilisateur non privilégié 1001:1001, ce qui limite les dégâts en cas de compromission d’un conteneur.
docker compose ps
docker exec -it backend id
Résultat attendu : docker compose ps liste trois services à l’état « running » (ou « Up »). La seconde commande renvoie, selon la documentation de l’éditeur : uid=1001 gid=1001 groups=1001.
5. Repérer les données persistantes
Tout ce qui doit survivre à un redémarrage ou à une mise à jour se trouve dans db/ : la base SQLite et, plus tard, les pièces jointes des preuves. C’est ce répertoire qu’il faudra sauvegarder.
ls -ln db/
Résultat attendu : le fichier ciso-assistant.sqlite3 est présent ; les fichiers appartiennent à l’UID 1001, l’utilisateur des conteneurs.
6. Accéder à l’interface par un tunnel SSH
Le proxy écoute sur le port 8443 de grc01. Plutôt que d’ouvrir ce port sur le réseau, on le fait suivre par SSH jusqu’au poste d’administration : l’instance reste invisible du reste du réseau et l’adresse https://localhost:8443/, configurée par défaut, reste valable. Sur votre poste :
ssh -L 8443:localhost:8443 admin@grc01
Ouvrez ensuite https://localhost:8443/ dans le navigateur du poste. Caddy présente un certificat auto-signé : le navigateur affiche un avertissement, que l’on accepte en laboratoire.
Résultat attendu : la page de connexion de CISO Assistant s’affiche ; la connexion avec le compte du superutilisateur ouvre le tableau de bord, encore vide.
7. Lire les journaux
Savoir lire les journaux du backend est indispensable pour diagnostiquer une migration en échec ou une erreur d’import de bibliothèque.
docker compose logs --tail 50 backend
Résultat attendu : les dernières lignes du backend s’affichent, avec les requêtes correspondant à votre connexion. Aucune trace d’exception Python ne doit apparaître.
Vérification
Le TP est réussi si : docker compose ps montre trois services actifs ; docker exec -it backend id renvoie l’UID 1001 ; db/ciso-assistant.sqlite3 existe ; la connexion à https://localhost:8443/ par le tunnel SSH ouvre le tableau de bord avec le superutilisateur. Contrôlez enfin, depuis une autre machine du réseau, que le port 8443 de grc01 n’est pas joignable si vous avez activé un pare-feu local qui ne l’autorise pas.
Problèmes fréquents
- « permission denied » sur
/var/run/docker.sock: votre compte n’appartient pas au groupedocker. Ajoutez-le avecsudo usermod -aG docker "$USER", puis fermez et rouvrez la session SSH ; ou lancez le script avecsudo. - Le backend redémarre en boucle avec une erreur d’écriture dans
db/: le répertoire appartient à un autre utilisateur que 1001, typiquement après une copie ou une restauration faite en root. La documentation de l’éditeur donne la correction :sudo chown -R 1001:1001 ./db. Sur une distribution avec SELinux, il faut en pluschcon -Rt svirt_sandbox_file_t ./db. - Le conteneur Caddy ne démarre pas, port déjà utilisé : un autre service écoute sur 8443. Identifiez-le avec
sudo ss -ltnp | grep 8443et arrêtez-le, ou adaptez la publication de port dans le fichier Compose. - Mot de passe du superutilisateur perdu : la FAQ de l’éditeur fournit la commande
docker compose exec backend uv run python manage.py changepassword <adresse>. - La page ne s’affiche pas dans le navigateur : le tunnel SSH est fermé ou pointe vers un autre port ; vérifiez que la session
ssh -Lest toujours ouverte.
Bonnes pratiques et sécurité
- N’exposez pas l’instance sur Internet : elle contiendra l’inventaire de vos écarts de sécurité. Tunnel SSH, VPN ou réseau d’administration dédié.
- Laissez
DJANGO_DEBUGàFalseet fixezDJANGO_SECRET_KEYpour une instance durable ; l’éditeur déconseille la clé aléatoire en production. - En production, épinglez une version publiée (étiquette d’image) plutôt que la branche
main, comme l’éditeur le recommande. - Réservez le superutilisateur à l’administration ; chaque personne travaillera avec un compte nominatif (TP02).
Questions de contrôle
1. Pourquoi faire suivre le port 8443 par SSH plutôt que de l’ouvrir sur le réseau ?
Voir la réponse
L’instance reste inaccessible depuis le réseau : seul un administrateur authentifié en SSH sur grc01 peut l’atteindre, et l’adresse par défaut https://localhost:8443/ reste valable sans reconfiguration.
2. Quel répertoire contient la base et les pièces jointes ?
Voir la réponse
Le répertoire db/ du dépôt : la base SQLite db/ciso-assistant.sqlite3 et les pièces jointes dans db/attachments/.
3. Que vérifie la commande docker exec -it backend id ?
Voir la réponse
Que le processus du backend s’exécute avec l’utilisateur non privilégié 1001 et non en root.
Pour aller plus loin
Pour une instance partagée par plusieurs équipes, l’éditeur prend en charge PostgreSQL à la place de SQLite (variables POSTGRES_NAME, POSTGRES_USER, POSTGRES_PASSWORD, DB_HOST). Pour revoir les notions de conteneurs, d’images et de volumes, suivez le cours Introduction à Docker. Pour centraliser l’authentification de vos outils internes, l’article authentik : le fournisseur d’identité open source présente une solution auto-hébergée.
Conservez la machine virtuelle et l’instance : le TP suivant les utilise.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.