Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Wasmtime und das Capability-Modell

Nach dieser Lektion: Ich kann festlegen, was ein Wasmtime-Befehl einem Programm erlaubt.

Lektion, 60 Min.5 BefehleWebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Ein Programm, das Ihre Dateien nicht lesen kann

Wasmtime startet ein WebAssembly-Programm ohne Dateien, ohne Umgebungsvariablen und ohne Netzwerk. Jedes davon müssen Sie auf der Befehlszeile einzeln freigeben. Das ist das Capability-Modell: Ein fremdes Programm kann nicht lesen, was Sie ihm nicht gegeben haben.

Heute geben Sie einen Ordner und eine Variable frei und sehen zu, wie alles andere abgelehnt wird.

Am Ende dieser Lektion

Notiz

Ich kann festlegen, was ein Wasmtime-Befehl einem Programm erlaubt.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
WASIdas WebAssembly System Interface, Standardimporte für Dateien und mehr
Capabilityein Handle, mit dem ein Programm genau eine Sache nutzen darf
Vorab geöffneter Ordnerein Ordner, den der Host öffnet und übergibt--dir data
Umgebungsvariableeine benannte Einstellung für ein ProgrammSTADT=Leipzig
Dateideskriptoreine Zahl, die für eine offene Datei oder einen Ordner steht
Fehlercodeeine Zahl, die WASI bei einer Ablehnung zurückgibt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Warum um jede Datei bitten?

Ein gewöhnliches Programm darf jede Datei öffnen, die sein Benutzer lesen darf. Das nennt man Ambient Authority: Die Macht liegt in der Luft, und eine bösartige Bibliothek bekommt sie ganz.

Ein WASI-Programm beginnt mit nichts. Damit es Dateien liest, öffnet der Host einen Ordner und gibt dem Programm einen Dateideskriptor dafür. Dann kann das Programm Pfade in diesem Ordner öffnen, und keine anderen.

Ohne Freigabe nach einer Datei fragen

Befehl
docker exec wasm wasmtime run cat.wat notes.txt

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den Ordner data freigeben und erneut fragen

Befehl
docker exec wasm wasmtime run --dir data cat.wat notes.txt

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein freigegebener Ordner ist ein Zaun

Fehler 8 heißt, dass es überhaupt kein Handle für einen Ordner gab. Mit --dir data bekam das Programm eines, also ließ sich notes.txt öffnen.

Fragen Sie jetzt nach ../private/key.txt. Der Ordner private liegt direkt neben data, und der Benutzer, der wasmtime startet, dürfte ihn lesen. WASI lehnt trotzdem ab, weil der Pfad aus dem freigegebenen Ordner hinausführt.

Aus dem Ordner hinausklettern

Befehl
docker exec wasm wasmtime run --dir data cat.wat ../private/key.txt

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: was jede Ablehnung bedeutete

BefehlAusgabeGrund
cat.wat notes.txtWASI error 8Kein Ordner freigegeben, also kein Handle
--dir data cat.wat notes.txtdie EinkaufslisteDie Datei liegt im Ordner
--dir data cat.wat ../private/key.txtWASI error 63Der Pfad verlässt den Ordner
--dir data cat.wat missing.txtWASI error 44Im Ordner, aber keine solche Datei

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein häufiger Fehler

Warnung

Viele glauben, ein WASI-Programm könne alles lesen, was der Benutzer von wasmtime lesen kann. Es erreicht aber nur die Ordner aus --dir und nichts oberhalb davon. Selbst unter root öffnet es keine Datei außerhalb seiner Ordner.

Probieren Sie es: bleibt ein Pfad drinnen?

Code: python
def bleibt_drinnen(pfad):
    # Den Pfad Teil für Teil gehen. ".." darf nie über den Ordner hinaus.
    if pfad.startswith("/"):
        return False
    tiefe = 0
    for teil in pfad.split("/"):
        if teil == "..":
            tiefe = tiefe - 1
            if tiefe < 0:
                return False
        elif teil != "" and teil != ".":
            tiefe = tiefe + 1
    return True

for pfad in ["notes.txt", "woche1/../notes.txt", "../private/key.txt", "/etc/passwd"]:
    print(pfad, "bleibt drinnen:", bleibt_drinnen(pfad))
# Nehmen Sie "woche1/../../key.txt" dazu. Bleibt der Pfad drinnen?

Umgebungsvariablen werden nicht weitergereicht

Ein Programm, das eine Shell startet, sieht normalerweise jede Variable der Shell, auch Passwörter. Wasmtime reicht keine einzige weiter.

Mit --env NAME=wert setzen Sie eine Variable, mit --env NAME reichen Sie eine weiter, die der Host schon hat. Die Option -S inherit-env reicht alle weiter, nutzen Sie sie also nur bei einem Programm, dem Sie vertrauen. Beim Netzwerk ist es genauso: Erst eine Option mit -S gibt es frei.

Die Variablen ohne Freigabe auflisten

Befehl
docker exec wasm wasmtime run env.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Eine Variable freigeben und erneut auflisten

Befehl
docker exec wasm wasmtime run --env STADT=Leipzig env.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Über dieses Lab und seinen Quellcode: WebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.