Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

WebAssembly, un bac à sable pour plugins

Après cette leçon: Je peux choisir des limites qui empêchent un plugin WebAssembly de nuire à son hôte.

Leçon de 65 min4 commandesLab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

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

MotCe que ça veut direExemple
Plugindu code qui ajoute une fonction à un programme hôte
Hôtele programme qui charge et lance le plugin
Trapune erreur qui arrête aussitôt le code WebAssembly
Carburantun budget de travail qui baisse à mesure que le code tourne-W fuel=100000
Délaiune limite sur la durée pendant laquelle le code peut tourner-W timeout=2s
Pageun 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

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

Affiché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

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

Affiché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

FreinCe qu’il compteLe trap affichéUtile pour
DélaiLe temps réelwasm trap: interruptUne requête qui doit répondre vite
CarburantLe travail faitwasm trap: all fuel consumed by WebAssemblyLa 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

Commande
docker exec wasm wasmtime run grow.wat

Affiché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

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

Affiché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

Code: python
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.

À propos de ce labo et de sa source: Lab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.