Un programme qui ne touche que ce que tu lui donnes
WebAssembly est un petit format binaire pour les programmes, qui tourne sur n'importe quelle machine équipée d'un runtime. Hors du navigateur, il fait tourner des plugins et des outils dans un bac à sable : le programme n'atteint aucun fichier, aucun réglage et aucun réseau, sauf si l'on dit au runtime de les lui donner. Ce lab utilise Wasmtime, le runtime de la Bytecode Alliance.
À la fin de cette leçon
Remarque
Je peux lancer un programme WebAssembly avec Wasmtime et ne lui accorder que ce dont il a besoin.
Mots-clés
- WebAssembly : un format binaire portable pour les programmes.
- Runtime : le programme qui fait tourner WebAssembly, ici Wasmtime.
- WASI : la façon standard dont un programme WebAssembly demande des fichiers et des réglages.
- Capacité : une chose précise qu'on a donnée au programme, comme un dossier.
- Composant : un programme WebAssembly avec des imports et des exports typés.
- Carburant : un budget de travail qui arrête le programme quand il est épuisé.
Pour commencer : ce que tu sais déjà
Remarque
Réponds dans ta tête. 1. Un programme construit pour un ordinateur portable tourne-t-il tel quel sur un téléphone ? 2. À quoi sert un droit sur un dossier ? 3. Pourquoi ne lancerais-tu pas le programme d'un inconnu sur ton ordinateur ? Réponses : en général non, il a été construit pour un seul type de processeur ; à dire qui peut lire ou modifier les fichiers ; il pourrait lire ou effacer tes fichiers.
Avant de commencer
Remarque
Appuie sur Démarrer le lab dans la barre en haut de la leçon et attends qu'il indique qu'il est en marche. Il y a deux services. wasm fait tourner Wasmtime et n'a pas de shell, donc chaque bouton lance docker exec wasm wasmtime .... tools a Python et un shell, et les deux voient le même dossier. Chaque bouton Exécuter ci-dessous tape sa commande dans le terminal de ton lab, l'une après l'autre, dans la même session. Pour suivre les commandes ou taper les tiennes, appuie sur Ouvrir le terminal (nouvel onglet) dans la barre.
Lancer un premier programme
hello.wat est un programme WebAssembly écrit en format texte, que Wasmtime lit directement. Il demande une seule chose à WASI, un moyen d'écrire du texte, et il affiche Hello from WebAssembly. Les programmes du lab écrivent en anglais.
docker exec wasm wasmtime run hello.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Demander un fichier sans rien accorder
cat.wat affiche un fichier. Ici, aucun dossier n'a été accordé : il n'a nulle part où chercher et affiche cannot open notes.txt: WASI error 8. Le fichier est pourtant là, dans le dossier data, mais le programme n'a pas reçu ce dossier.
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 un seul dossier
L'option --dir data donne au programme le dossier data, et rien d'autre. Il affiche maintenant la liste de courses : Shopping for Saturday, bread, milk, eggs. Un chemin qui sort du dossier, comme ../private/key.txt, serait toujours refusé.
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.
Accorder un seul réglage
env.wat liste ses variables d'environnement. Wasmtime n'en transmet aucune sans qu'on le lui demande, donc un mot de passe rangé dans les réglages de la machine reste privé. Avec --env CITY=Leeds, il affiche CITY=Leeds, et rien de plus.
docker exec wasm wasmtime run --env CITY=Leeds env.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Vérifie
Astuce
Pourquoi cat.wat a-t-il échoué la première fois alors que notes.txt existe ? Réponse : aucun dossier n'était accordé, donc le programme n'avait aucun moyen d'atteindre un fichier.
Appeler un composant par son nom
calc.wat est un composant : un programme avec des fonctions typées, décrites dans calc.wit. Wasmtime appelle sa fonction add avec les nombres 2 et 3, et elle affiche 5.
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Lancer deux composants réunis en un seul
doubler.wat a besoin d'une fonction add qu'il n'a pas. app.wat le relie à calc.wat, si bien que doubler utilise le add de calc. Pour doubler 21, il affiche 42. Lancé seul, doubler serait refusé, car rien ne lui fournit add.
docker exec wasm wasmtime run --invoke 'double(21)' app.watAffichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.
Arrêter un programme qui ne finit jamais
spin.wat tourne en boucle pour toujours. Avec un budget de 100000 unités de carburant, il tourne jusqu'à l'avoir dépensé, puis Wasmtime l'arrête avec wasm trap: all fuel consumed by WebAssembly. Wasmtime, lui, continue.
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.
Une erreur fréquente
Attention
Beaucoup pensent qu'un programme WebAssembly peut lire tout ce que peut lire la personne qui le lance. Il ne peut utiliser que ce que Wasmtime lui donne, comme un dossier ou un réglage. Donne-lui le minimum dont il a besoin, car tout ce que tu accordes, il peut s'en servir.
Vérification finale
Astuce
Réponds sans revenir en arrière. 1. Quelle option donne un dossier à un programme ? 2. Quelles variables d'environnement un programme voit-il par défaut ? 3. Pourquoi doubler.wat a-t-il été refusé seul ? 4. Qu'est-ce qui arrête un programme qui ne finit jamais ? Réponses : --dir ; aucune ; rien ne lui fournissait add ; un budget de carburant ou une limite de temps.
Pour les enseignants
Astuce
Cette leçon est un petit exemple de leçon travaillée dans un lab : les étapes et les boutons Exécuter sont la leçon, et le lab est la copie de chaque élève. Le lab compte deux services, Wasmtime sans shell et un service Python qui écrit les fichiers, et rien ici ne se corrige tout seul : l'élève rend un court compte rendu d'une expérience, avec les commandes tapées et ce que Wasmtime a affiché. Points clés : 1. Un programme WebAssembly n'atteint que ce que le runtime lui accorde. 2. Un composant a des imports et des exports typés, et on peut en réunir deux. 3. Le carburant ou une limite de temps arrête un programme emballé. Erreur fréquente : croire que le programme lit tout ce que son utilisateur peut lire. Matériel : le lab et un navigateur. Conseil : montrez côte à côte les dossiers data et private avant le troisième Exécuter. Copiez-la dans votre propre module et modifiez-la, ou créez-en une de zéro avec le menu Lab du créateur de leçons.