Lab Bac à sable : exécuter du code non fiable dans des namespaces, des cgroups, seccomp et gVisor sur une VM Ubuntu privée
Ce lab apprend à exécuter du code que l’on n’a pas écrit, comme un script produit par un agent d’IA ou un programme envoyé par un étudiant ou un client, sur une seule VM Ubuntu privée. Un remplaçant inoffensif, agent.py, lit une clé, appelle l’extérieur et lance des processus, et l’étudiant l’enferme avec les outils du noyau Linux, un à la fois. Un seul script écrit par l’étudiant, avec toutes les clôtures à la fois, est noté par une vérification qui utilise des valeurs que l’étudiant ne voit jamais.
Rien n’est installé sur l’ordinateur de l’étudiant. Chaque outil est le vrai, installé depuis l’archive d’Ubuntu : unshare et setpriv, cgroups v2, libseccomp, bubblewrap, nftables et le runsc de gVisor. Tout est défensif : le seul programme enfermé est celui du lab, sur la copie de l’étudiant.
Ce que les étudiants apprennent
Ce que peut faire du code non fiable, et comment chaque clôture du noyau en arrête une partie. Les namespaces PID, réseau, de montage, UTS et user cachent les processus, le réseau, les fichiers et le pouvoir de root. Un cgroup fixe des limites de mémoire, de processeur et de processus, et l’étudiant voit le noyau tuer un programme à 64 Mo et refuser le vingtième processus. Une liste d’autorisation seccomp refuse tout appel système qu’elle ne nomme pas, les capacités sont retirées avec setpriv, une liste nftables décide où le code peut se connecter, et bubblewrap construit une vue en lecture seule avec un dossier caché. gVisor répond ensuite aux appels système du programme dans un noyau à lui, et les microVM Firecracker sont expliquées.
Les six parties
D’abord l’agent sans rien sur son chemin. Deuxièmement les namespaces faits à la main avec unshare. Troisièmement les cgroups, par sbx limit, une petite aide à nous. Quatrièmement seccomp, par sbx seccomp, et les capacités. Cinquièmement le réseau, par sbx egress et une liste dans un fichier, les fichiers avec bubblewrap, et gVisor avec runsc. Sixièmement run-agent.sh, le seul script que l’étudiant écrit, qui doit arrêter le secret, le réseau, les écritures hors d’un dossier, la mémoire au-delà de 64 Mo, plus de 20 processus et tout appel système absent de sa liste. README.md dans le dossier personnel dit quoi faire et ne donne aucune réponse.
Le lancer dans votre navigateur
Les labs VM se donnent comme tâche de lab dans un module, et l’exemple se trouve sur la page du lab. La machine est petite : un processeur, 1 Go de mémoire et 10 Go de disque. Tout vient de l’archive d’Ubuntu, donc la VM d’un visiteur, qui ne joint que cette archive, peut l’installer.
- Ajouter le lab. Dans un module que vous enseignez, ajoutez une tâche et choisissez la carte Lab VM Ubuntu. La page affiche une courte description de la machine au lieu d’un fichier compose.
- Partir de l’exemple. La page propose des labs prêts à l’emploi pour démarrer. Choisissez Bac à sable. Utiliser un exemple remplace le texte, et Annuler rend le vôtre.
- Publier et démarrer votre propre copie. Publiez, puis Démarrez. Le script setup du lab installe bubblewrap, libseccomp, nftables et gVisor depuis l’archive d’Ubuntu, et écrit l’aide sbx, l’agent de remplacement, les fichiers de travail et le README, au premier démarrage de la VM, en quelques minutes.
- Ouvrir le terminal. Ouvrez son terminal et lisez README.md dans le dossier personnel. Rien ne s’ouvre dans le navigateur : le lab, c’est le terminal.
Une leçon de base sur ce lab
Sandboxing Basics est une petite leçon donnée dans ce lab, une VM Ubuntu. Elle a une accroche, un objectif « Je peux », des mots-clés, une question de départ, une vérification après chaque idée, une erreur courante et une vérification finale, et chaque étape a un bouton Exécuter qui tape sa commande dans le terminal de la machine. L’étudiant regarde l’agent lire une clé et appeler l’extérieur, puis pose une clôture à la fois autour de lui : pas de réseau, une limite de mémoire, une liste seccomp et un dossier caché.
La leçon regarde autour d’elle et laisse à l’étudiant la tâche propre au lab, le script avec toutes les clôtures : elle ne donne donc aucune réponse. Le module universitaire Isoler le code non fiable et le code écrit par une IA se travaille dans le même lab.
Comment il est noté
Le lab a une vérification. Elle s’exécute sur une copie de la machine enregistrée, en root, et met un programme à elle à la place d’agent.py. Elle lance le run-agent.sh de l’étudiant une fois par test : le programme doit afficher un mot tiré au hasard sous un filtre seccomp, ne jamais afficher un secret neuf écrit dans le dossier des secrets, ne jamais joindre un écouteur sur un port tiré au hasard, écrire un fichier au nom tiré au hasard dans le seul dossier permis et nulle part ailleurs, être arrêté avant de détenir 200 Mo ou de lancer 20 processus, et voir refusé un appel système dangereux, tiré au hasard parmi cinq. La première ligne de ce que la vérification a affiché dit pourquoi.
- Le distribuer. Attribuez le lab comme n’importe quelle tâche, avec une échéance si vous le souhaitez. Chaque étudiant reçoit une VM à lui, conservée d’une séance à l’autre.
- Lancer la vérification. Sur la ligne d’un étudiant dans la liste de la classe, appuyez sur Lancer la vérification. Elle démarre une copie de sa machine enregistrée, qui n’est pas sauvegardée ensuite, exécute le script de vérification du lab en root et indique s’il a réussi, ce qu’il a affiché et quand. L’étudiant n’est pas informé du résultat.
- Noter. Lisez la première ligne de ce que la vérification a affiché : elle dit ce qui ne va pas, par exemple un agent qui a lu le secret, joint le réseau ou gardé 200 Mo, ou un appel système qui n’a pas été refusé. Renvoyez le travail avec un motif s’il faut aller plus loin.
La définition sur GitHub
Le fichier est la définition complète du lab, le texte même que la plateforme exécute : taille, script setup, l’aide sbx, l’agent, les fichiers de travail, le README et la vérification. Copiez-le et changez les limites ou l’agent pour faire un lab plus long.
Essayer ce lab, et ce qu’il coûte
Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.
Questions fréquentes
- Le lab demande-t-il une licence ?
- Non. bubblewrap, libseccomp, nftables, util-linux et gVisor sont open source, sous licences LGPL, GPL et Apache-2.0, et s’installent depuis l’archive d’Ubuntu au démarrage de la VM de l’étudiant : nous n’en distribuons aucun.
- Pourquoi Firecracker n’est-il pas lancé ?
- Firecracker a besoin de /dev/kvm dans la machine où il tourne, et les VM de la plateforme n’offrent pas de virtualisation imbriquée. Les leçons expliquent les microVM et lancent gVisor, qui n’a pas besoin de KVM.
- Les étudiants peuvent-ils abîmer quelque chose ?
- Seulement leur propre copie. Le programme qu’ils enferment est le remplaçant du lab, sa clé est une valeur de démonstration, et le réseau qu’il joint est dans la VM. Si un étudiant abîme un fichier fourni, sbx reset le remet tel qu’il était.
- Le lab a-t-il été testé dans une vraie VM d’étudiant ?
- Le setup, les commandes de chaque leçon et la vérification, avec chaque façon de tricher, ont été lancés dans un conteneur Ubuntu 26.04 privilégié qui tient lieu de VM, sur une machine arm64. Une VM d’étudiant démarrée, avec ses règles AppArmor et les paquets amd64, mérite un essai avant une classe.