Le code d’un inconnu dans votre programme
Un bac à sable de plugins permet à une application de lancer du code écrit par quelqu’un d’autre sans lui faire confiance. Des éditeurs, des proxys web, des bases de données et des jeux utilisent WebAssembly pour cela. Un plugin ne peut appeler que ce que l’hôte lui importe, et l’hôte peut l’arrêter.
Aujourd’hui, vous arrêtez un plugin qui ne finit jamais et un autre qui veut trop de mémoire.
À la fin de cette leçon
Remarque
Je peux choisir des limites qui empêchent un plugin WebAssembly de nuire à son hôte.
Mots-clés
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| Plugin | du code qui ajoute une fonction à un programme hôte | |
| Hôte | le programme qui charge et lance le plugin | |
| Trap | une erreur qui arrête aussitôt le code WebAssembly | |
| Carburant | un budget de travail qui baisse à mesure que le code tourne | -W fuel=100000 |
| Délai | une limite sur la durée pendant laquelle le code peut tourner | -W timeout=2s |
| Page | un bloc de 64 Kio de mémoire WebAssembly |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
Comment arrêter un plugin sans fin ?
spin.wat est un plugin avec une boucle et aucune sortie. Lancé tel quel, il garderait le processeur pour toujours.
Wasmtime a deux freins. Un délai compte le temps réel : le runtime fait avancer un compteur, et le code le vérifie aux boucles et aux appels. Le carburant compte le travail : chaque instruction en dépense, et le plugin s’arrête par un trap quand le réservoir est vide.
L’arrêter au bout de deux secondes
docker exec wasm wasmtime run -W timeout=2s spin.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
L’arrêter quand son carburant s’épuise
docker exec wasm wasmtime run -W fuel=100000 spin.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Exemple travaillé : deux façons d’arrêter un plugin
| Frein | Ce qu’il compte | Le trap affiché | Utile pour |
|---|---|---|---|
| Délai | Le temps réel | wasm trap: interrupt | Une requête qui doit répondre vite |
| Carburant | Le travail fait | wasm trap: all fuel consumed by WebAssembly | La même limite sur toutes les machines |
Les cellules que les étudiants remplissent restent vides dans cet aperçu.
La mémoire d’un plugin a un plafond
La mémoire grandit d’une page de 64 Kio à la fois. grow.wat demande une page de plus jusqu’à ce que la réponse soit non, puis affiche combien il en a.
Le module lui-même annonce 100 pages au plus. L’hôte peut fixer un plafond plus bas avec -W max-memory-size. Au-delà, memory.grow répond -1 et le plugin continue : un plugin prudent peut donc s’en accommoder.
Laisser le plugin grandir jusqu’à sa limite
docker exec wasm wasmtime run grow.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Donner un mébioctet au plugin
docker exec wasm wasmtime run -W max-memory-size=1048576 grow.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
À vous : convertir un plafond en pages
PAGE = 64 * 1024 # une page WebAssembly fait 64 Kio
for plafond in [1048576, 4 * 1048576, 64 * 1048576]:
print(plafond, "octets permettent", plafond // PAGE, "pages")
# Quel plafond, en octets, permet exactement 100 pages ?
Erreur fréquente
Attention
On croit souvent que le bac à sable rend un plugin sûr, quoi que l’hôte lui donne. Un plugin peut détourner chaque fonction que l’hôte lui importe. Accordez-lui un dossier ou le réseau, et il pourra s’en servir. Le bac à sable retire seulement ce que vous n’avez pas donné.
Les limites du bac à sable
Wasm garde un plugin dans sa propre mémoire, mais certains risques restent. Un bug dans une fonction d’hôte que vous avez écrite reste un bug. Le runtime lui-même peut avoir des bugs : tenez-le à jour. Des astuces de mesure du temps peuvent faire fuir des secrets entre plugins d’un même processus.
Traverser la frontière coûte aussi du temps, car les valeurs sont copiées. Passez donc un lot de travail en un seul appel, pas une valeur par appel.