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

Wasmtime et le modèle des capacités

Après cette leçon: Je peux dire ce qu’une commande Wasmtime permet à un programme d’atteindre.

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

Un programme qui ne lit pas vos fichiers

Wasmtime lance un programme WebAssembly sans fichiers, sans variables d’environnement et sans réseau. Chacun doit être accordé sur la ligne de commande. C’est le modèle des capacités : un programme que vous n’avez pas écrit ne lit pas ce que vous ne lui avez pas donné.

Aujourd’hui, vous accordez un dossier et une variable, et vous voyez tout le reste refusé.

À la fin de cette leçon

Remarque

Je peux dire ce qu’une commande Wasmtime permet à un programme d’atteindre.

Mots-clés

MotCe que ça veut direExemple
WASIla WebAssembly System Interface, des imports standard pour les fichiers et le reste
Capacitéune poignée qui permet d’utiliser une seule chose
Dossier préouvertun dossier que l’hôte ouvre et remet au programme--dir data
Variable d’environnementun réglage nommé passé à un programmeCITY=Lyon
Descripteur de fichierun nombre qui désigne un fichier ou un dossier ouvert
Code d’erreurun nombre que WASI renvoie quand il refuse

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Pourquoi demander chaque fichier ?

Un programme ordinaire peut ouvrir tout fichier que son utilisateur peut lire. C’est l’autorité ambiante : le pouvoir flotte autour de lui, et une bibliothèque malveillante le reçoit tout entier.

Un programme WASI démarre sans rien. Pour lire des fichiers, l’hôte ouvre un dossier et lui remet un descripteur de fichier. Le programme peut alors ouvrir des chemins dans ce dossier, et dans aucun autre.

Demander un fichier sans rien accorder

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Accorder le dossier data et redemander

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Un dossier accordé est une clôture

L’erreur 8 veut dire qu’il n’y avait aucune poignée de dossier. Avec --dir data, le programme en a reçu une, et notes.txt s’est ouvert.

Demandez maintenant ../private/key.txt. Le dossier private est juste à côté de data, et l’utilisateur qui lance wasmtime pourrait le lire. WASI refuse quand même, car le chemin sort du dossier accordé.

Essayer de sortir du dossier

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

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é : ce que voulait dire chaque refus

CommandeAffichéPourquoi
cat.wat notes.txtWASI error 8Aucun dossier accordé, donc aucune poignée
--dir data cat.wat notes.txtla liste de coursesLe fichier est dans le dossier
--dir data cat.wat ../private/key.txtWASI error 63Le chemin sort du dossier
--dir data cat.wat missing.txtWASI error 44Dedans, mais ce fichier n’existe pas

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Erreur fréquente

Attention

On croit souvent qu’un programme WASI lit tout ce que l’utilisateur qui lance wasmtime peut lire. Il n’atteint que les dossiers donnés avec --dir, et rien au-dessus. Même lancé par root, il ne peut pas ouvrir un fichier hors de ses dossiers.

À vous : un chemin reste-t-il dedans ?

Code: python
def reste_dedans(chemin):
    # On parcourt le chemin morceau par morceau. ".." ne doit jamais remonter au-dessus du dossier.
    if chemin.startswith("/"):
        return False
    profondeur = 0
    for morceau in chemin.split("/"):
        if morceau == "..":
            profondeur = profondeur - 1
            if profondeur < 0:
                return False
        elif morceau != "" and morceau != ".":
            profondeur = profondeur + 1
    return True

for chemin in ["notes.txt", "semaine1/../notes.txt", "../private/key.txt", "/etc/passwd"]:
    print(chemin, "reste dedans :", reste_dedans(chemin))
# Ajoutez "semaine1/../../key.txt". Reste-t-il dedans ?

Les variables d’environnement ne sont pas transmises

Un programme lancé par un shell voit d’habitude toutes les variables du shell, mots de passe compris. Wasmtime n’en transmet aucune.

Utilisez --env NOM=valeur pour en fixer une, ou --env NOM pour transmettre celle que l’hôte a déjà. L’option -S inherit-env les transmet toutes : réservez-la à un programme de confiance. Le réseau suit la même règle : rien n’est joignable tant qu’une option -S ne l’accorde pas.

Lister les variables sans rien accorder

Commande
docker exec wasm wasmtime run env.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Accorder une variable et relister

Commande
docker exec wasm wasmtime run --env CITY=Lyon env.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

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