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
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| WASI | das WebAssembly System Interface, Standardimporte für Dateien und mehr | |
| Capability | ein Handle, mit dem ein Programm genau eine Sache nutzen darf | |
| Vorab geöffneter Ordner | ein Ordner, den der Host öffnet und übergibt | --dir data |
| Umgebungsvariable | eine benannte Einstellung für ein Programm | STADT=Leipzig |
| Dateideskriptor | eine Zahl, die für eine offene Datei oder einen Ordner steht | |
| Fehlercode | eine 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
docker exec wasm wasmtime run cat.wat notes.txtHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Den Ordner data freigeben und erneut fragen
docker exec wasm wasmtime run --dir data cat.wat notes.txtHier 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
docker exec wasm wasmtime run --dir data cat.wat ../private/key.txtHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: was jede Ablehnung bedeutete
| Befehl | Ausgabe | Grund |
|---|---|---|
| cat.wat notes.txt | WASI error 8 | Kein Ordner freigegeben, also kein Handle |
| --dir data cat.wat notes.txt | die Einkaufsliste | Die Datei liegt im Ordner |
| --dir data cat.wat ../private/key.txt | WASI error 63 | Der Pfad verlässt den Ordner |
| --dir data cat.wat missing.txt | WASI error 44 | Im 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?
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
docker exec wasm wasmtime run env.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Variable freigeben und erneut auflisten
docker exec wasm wasmtime run --env STADT=Leipzig env.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.