Sandboxing-Lab: fremden Code in Namespaces, cgroups, seccomp und gVisor auf einer privaten Ubuntu-VM ausführen

Dieses Lab lehrt, wie man Code ausführt, den man nicht selbst geschrieben hat, etwa ein Skript eines KI-Agenten oder ein Programm, das Lernende oder Kunden hochgeladen haben, und zwar auf einer einzigen privaten Ubuntu-VM. Ein harmloser Platzhalter, agent.py, liest einen Schlüssel, ruft nach außen und startet Prozesse, und die Lernenden sperren ihn mit den eigenen Werkzeugen des Linux-Kernels ein, einen Zaun nach dem anderen. Ein Skript, das sie selbst mit allen Zäunen zugleich schreiben, bewertet eine Prüfung mit Werten, die sie nie sehen.

Auf dem Computer der Lernenden wird nichts installiert. Jedes Werkzeug ist das echte, installiert aus dem Ubuntu-Archiv: unshare und setpriv, cgroups v2, libseccomp, bubblewrap, nftables und runsc von gVisor. Das Lab ist durchgehend defensiv: Eingesperrt wird nur das eigene Programm des Labs, auf der eigenen Kopie der Lernenden.

Was die Lernenden lernen

Was fremder Code anrichten kann und wie jeder Zaun des Kernels einen Teil davon stoppt. PID-, Netz-, Mount-, UTS- und Benutzer-Namespaces verbergen Prozesse, das Netz, Dateien und die Macht von root. Eine cgroup setzt Grenzen für Speicher, CPU und Prozesse, und die Lernenden sehen, wie der Kernel ein Programm bei 64 MB beendet und den zwanzigsten Prozess ablehnt. Eine seccomp-Erlaubnisliste lehnt jeden Systemaufruf ab, den sie nicht nennt, Capabilities werden mit setpriv abgegeben, eine nftables-Erlaubnisliste entscheidet, wohin Code Verbindungen aufbauen darf, und bubblewrap baut eine schreibgeschützte Sicht mit einem verborgenen Ordner. Danach beantwortet gVisor die Systemaufrufe des Programms in einem eigenen Kernel, und Firecracker-MicroVMs werden erklärt.

Die sechs Teile

Erstens der Agent, dem nichts im Weg steht. Zweitens Namespaces, von Hand mit unshare gebaut. Drittens cgroups, über sbx limit, ein kurzes eigenes Hilfsskript. Viertens seccomp, über sbx seccomp, und Capabilities. Fünftens das Netz, über sbx egress und eine Erlaubnisliste in einer Datei, die Dateien mit bubblewrap und gVisor mit runsc. Sechstens run-agent.sh, das eine Skript, das die Lernenden schreiben: Es muss das Geheimnis, das Netz, Schreibzugriffe außerhalb eines Ordners, Speicher über 64 MB, mehr als 20 Prozesse und jeden Systemaufruf stoppen, der nicht auf ihrer Erlaubnisliste steht. README.md im Home-Ordner sagt, was zu tun ist, und gibt keine Antworten.

Im Browser ausführen

VM-Labs werden in einem Modul als Lab-Aufgabe eingerichtet, und das Beispiel steht auf der Seite des Labs. Die Maschine ist klein: eine CPU, 1 GB Arbeitsspeicher und 10 GB Festplatte. Alles stammt aus dem Ubuntu-Archiv, also kann auch die VM eines Besuchers es installieren, die nur dieses Archiv erreicht.

  1. Lab hinzufügen. Fügen Sie in einem Modul, das Sie unterrichten, eine Aufgabe hinzu und wählen Sie die Karte für das Ubuntu-VM-Lab. Die Seite zeigt statt einer Compose-Datei eine kurze Beschreibung der Maschine.
  2. Mit dem Beispiel beginnen. Die Seite bietet fertige Labs als Ausgangspunkt an. Wählen Sie Sandboxing. Ein Beispiel ersetzt den Text, und Rückgängig bringt Ihren eigenen zurück.
  3. Veröffentlichen und die eigene Kopie starten. Veröffentlichen Sie, dann Starten. Das Setup-Skript des Labs installiert bubblewrap, libseccomp, nftables und gVisor aus dem Ubuntu-Archiv und schreibt das Hilfsskript sbx, den Platzhalter-Agenten, die Dateien zum Arbeiten und die README, beim ersten Start der VM, in wenigen Minuten.
  4. Das Terminal öffnen. Öffnen Sie das Terminal und lesen Sie README.md im Home-Ordner. Im Browser öffnet sich nichts: Das Lab ist das Terminal.

Eine Basislektion zu diesem Lab

Sandboxing Basics ist eine kleine Lektion, die in diesem Lab, einer Ubuntu-VM, durchgeführt wird. Sie hat einen Einstieg, ein Ziel in der Form „Ich kann“, Schlüsselwörter, eine Startfrage, eine Kontrolle nach jeder Idee, einen häufigen Fehler und eine Abschlusskontrolle, und jeder Schritt hat eine Schaltfläche Ausführen, die seinen Befehl in das Terminal der Maschine tippt. Die Lernenden sehen zu, wie der Agent einen Schlüssel liest und nach außen ruft, und ziehen dann einen Zaun nach dem anderen um ihn: kein Netz, eine Speichergrenze, eine seccomp-Erlaubnisliste und einen verborgenen Ordner.

Die Lektion verschafft nur einen Überblick und überlässt die eigentliche Aufgabe des Labs, das Skript mit allen Zäunen, den Lernenden, sodass sie keine Antworten verrät. Das Hochschulmodul Sandboxing für fremden und KI-geschriebenen Code wird im selben Lab bearbeitet.

Wie bewertet wird

Das Lab hat eine Prüfung. Sie läuft als root auf einer Kopie der gespeicherten Maschine und setzt ein eigenes Programm an die Stelle von agent.py. Sie führt run-agent.sh der Lernenden für jeden Test einmal aus: Das Programm muss unter einem seccomp-Filter ein Zufallswort drucken, darf ein frisches Geheimnis im Ordner secrets nie drucken, darf einen Listener auf einem zufälligen Port nie erreichen, muss eine Datei mit zufälligem Namen in dem einen erlaubten Ordner schreiben und nirgendwo sonst, muss gestoppt werden, bevor es 200 MB hält oder 20 Prozesse startet, und ein gefährlicher Systemaufruf, zufällig aus fünf gewählt, muss abgelehnt werden. Die erste Zeile der Ausgabe der Prüfung sagt, warum.

  1. Verteilen. Weisen Sie das Lab wie jede Aufgabe zu, auf Wunsch mit Abgabefrist. Jede Schülerin und jeder Schüler bekommt eine eigene VM, die zwischen den Sitzungen erhalten bleibt.
  2. Die Prüfung ausführen. Drücken Sie in der Zeile einer Schülerin oder eines Schülers in der Klassenliste auf Prüfung ausführen. Sie startet eine Kopie der gespeicherten Maschine, die nicht zurückgespeichert wird, führt das Prüfskript des Labs als root aus und zeigt, ob es bestanden wurde, was es ausgegeben hat und wann. Die Schülerin oder der Schüler erfährt das Ergebnis nicht.
  3. Bewerten. Lesen Sie die erste Zeile dessen, was die Prüfung ausgegeben hat: Sie sagt, was nicht stimmt, etwa ein Agent, der das Geheimnis gelesen, das Netz erreicht oder 200 MB gehalten hat, oder ein Systemaufruf, der nicht abgelehnt wurde. Geben Sie die Arbeit mit einer Begründung zurück, wenn mehr nötig ist.

Die Definition auf GitHub

Die Datei ist die ganze Lab-Definition, derselbe Text, den die Plattform ausführt: Größe, Setup-Skript, das Hilfsskript sbx, der Agent, die Dateien zum Arbeiten, die README und die Prüfung. Kopieren Sie sie und ändern Sie die Grenzen oder den Agenten, um ein längeres Lab zu machen.

Dieses Lab ausprobieren, und was es kostet

Mit einem kostenlosen persönlichen Konto können Sie die Grundlagenlektionen in diesem Lab durcharbeiten, mit genug kostenlosem Guthaben pro Monat für die meisten Lektionen und ohne Karte. Für eine Klasse sind die ersten 365 Tage für eine Schule kostenlos, für bis zu 50 Lernende; danach zahlt sie je lernender Person und Jahr, alle Labs inklusive und Lehrkräfte kostenlos.

Häufige Fragen

Braucht das Lab eine Lizenz?
Nein. bubblewrap, libseccomp, nftables, util-linux und gVisor sind Open Source, unter den Lizenzen LGPL, GPL und Apache-2.0. Sie werden beim Start auf der VM der Lernenden aus dem Ubuntu-Archiv installiert, wir verteilen also keinen davon.
Warum läuft Firecracker nicht?
Firecracker braucht /dev/kvm in der Maschine, auf der es läuft, und die VMs der Plattform bieten keine verschachtelte Virtualisierung. Die Lektionen erklären MicroVMs und führen gVisor aus, das kein KVM braucht.
Können die Lernenden etwas kaputt machen?
Nur ihre eigene Kopie. Das Programm, das sie einsperren, ist der eigene Platzhalter des Labs, sein Schlüssel ist ein Demo-Wert, und das Netz, das er erreicht, liegt in der VM. Macht jemand eine ausgegebene Datei kaputt, stellt sbx reset sie so wieder her, wie sie ausgegeben wurde.
Wurde das Lab in einer echten Schüler-VM getestet?
Das Setup, die Befehle jeder Lektion und die Prüfung, mit jeder Art, sie zu täuschen, liefen in einem privilegierten Ubuntu-26.04-Container, der die VM vertritt, auf einem arm64-Rechner. Eine gestartete Schüler-VM mit ihren AppArmor-Regeln und den amd64-Paketen sollten Sie vor einer Stunde einmal ausprobieren.