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
| Mot | Ce que ça veut dire | Exemple |
|---|---|---|
| WASI | la 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éouvert | un dossier que l’hôte ouvre et remet au programme | --dir data |
| Variable d’environnement | un réglage nommé passé à un programme | CITY=Lyon |
| Descripteur de fichier | un nombre qui désigne un fichier ou un dossier ouvert | |
| Code d’erreur | un 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
docker exec wasm wasmtime run cat.wat notes.txtAffiché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
docker exec wasm wasmtime run --dir data cat.wat notes.txtAffiché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
docker exec wasm wasmtime run --dir data cat.wat ../private/key.txtAffiché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
| Commande | Affiché | Pourquoi |
|---|---|---|
| cat.wat notes.txt | WASI error 8 | Aucun dossier accordé, donc aucune poignée |
| --dir data cat.wat notes.txt | la liste de courses | Le fichier est dans le dossier |
| --dir data cat.wat ../private/key.txt | WASI error 63 | Le chemin sort du dossier |
| --dir data cat.wat missing.txt | WASI error 44 | Dedans, 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 ?
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
docker exec wasm wasmtime run env.watAffiché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
docker exec wasm wasmtime run --env CITY=Lyon env.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.