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

WebAssembly als Sandbox für Plugins

Nach dieser Lektion: Ich kann Grenzen wählen, die ein WebAssembly-Plugin davon abhalten, seinem Host zu schaden.

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

Fremden Code im eigenen Programm ausführen

Mit einer Plugin-Sandbox führt eine Anwendung Code aus, den jemand anderes geschrieben hat, ohne ihm zu vertrauen. Editoren, Web-Proxys, Datenbanken und Spiele nutzen WebAssembly dafür. Ein Plugin kann nur aufrufen, was der Host ihm importiert, und der Host kann es stoppen.

Heute stoppen Sie ein Plugin, das nie endet, und eines, das zu viel Speicher will.

Am Ende dieser Lektion

Notiz

Ich kann Grenzen wählen, die ein WebAssembly-Plugin davon abhalten, seinem Host zu schaden.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
PluginCode, der einem Host-Programm eine Funktion hinzufügt
Hostdas Programm, das das Plugin lädt und ausführt
Trapein Fehler, der den WebAssembly-Code sofort stoppt
Fuelein Arbeitsbudget, das beim Ausführen abnimmt-W fuel=100000
Timeouteine Grenze dafür, wie lange Code laufen darf-W timeout=2s
Seiteein Block WebAssembly-Speicher mit 64 KiB

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

Wie stoppt man ein Plugin ohne Ende?

spin.wat ist ein Plugin mit einer Schleife ohne Ausgang. So wie es ist, würde es den Prozessor für immer belegen.

Wasmtime hat zwei Bremsen. Ein Timeout zählt echte Zeit: Die Laufzeitumgebung erhöht einen Zähler, und der Code prüft ihn an Schleifen und Aufrufen. Fuel zählt Arbeit: Jede Anweisung verbraucht etwas davon, und das Plugin endet mit einem Trap, sobald der Tank leer ist.

Nach zwei Sekunden stoppen

Befehl
docker exec wasm wasmtime run -W timeout=2s spin.wat

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

Stoppen, wenn das Fuel aufgebraucht ist

Befehl
docker exec wasm wasmtime run -W fuel=100000 spin.wat

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

Beispiel: zwei Arten, ein Plugin zu stoppen

BremseWas sie zähltAusgegebener TrapGut für
TimeoutEchte Zeitwasm trap: interruptEine Anfrage, die schnell antworten muss
FuelGeleistete Arbeitwasm trap: all fuel consumed by WebAssemblyDieselbe Grenze auf jedem Rechner

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

Der Speicher eines Plugins hat eine Obergrenze

Speicher wächst immer um eine Seite mit 64 KiB. grow.wat verlangt so lange eine weitere Seite, bis die Antwort nein lautet. Dann gibt es aus, wie viele Seiten es hat.

Das Modul selbst sagt: höchstens 100 Seiten. Mit -W max-memory-size kann der Host eine niedrigere Grenze setzen. Fragt das Plugin nach mehr, antwortet memory.grow mit -1, und das Plugin macht weiter. Ein sorgfältiges Plugin kommt damit zurecht.

Das Plugin bis zu seiner Grenze wachsen lassen

Befehl
docker exec wasm wasmtime run grow.wat

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

Dem Plugin ein Mebibyte geben

Befehl
docker exec wasm wasmtime run -W max-memory-size=1048576 grow.wat

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

Probieren Sie es: eine Grenze in Seiten

Code: python
SEITE = 64 * 1024   # eine WebAssembly-Seite hat 64 KiB

for grenze in [1048576, 4 * 1048576, 64 * 1048576]:
    print(grenze, "Bytes erlauben", grenze // SEITE, "Seiten")
# Welche Grenze in Bytes erlaubt genau 100 Seiten?

Ein häufiger Fehler

Warnung

Viele glauben, die Sandbox mache ein Plugin sicher, egal was der Host ihm gibt. Ein Plugin kann aber jede Funktion missbrauchen, die der Host ihm importiert. Geben Sie ihm einen Ordner oder das Netzwerk, dann nutzt es beides. Die Sandbox nimmt nur weg, was Sie nicht gegeben haben.

Was die Sandbox nicht leistet

Wasm hält ein Plugin in seinem eigenen Speicher, aber manche Risiken bleiben. Ein Fehler in einer Host-Funktion, die Sie geschrieben haben, bleibt ein Fehler. Auch die Laufzeitumgebung selbst kann Fehler haben, halten Sie sie also aktuell. Mit Tricks über die Laufzeit können Geheimnisse zwischen Plugins in einem Prozess durchsickern.

Das Überqueren der Grenze kostet außerdem Zeit, weil Werte kopiert werden. Übergeben Sie Arbeit also gebündelt in einem Aufruf, nicht einen Wert pro Aufruf.

Ü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.