¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Wasmtime y el modelo de capacidades

Después de esta lección: Puedo decidir a qué deja llegar a un programa una orden de Wasmtime.

Lección de 60 min5 comandosLaboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

Un programa que no puede leer tus archivos

Wasmtime ejecuta un programa de WebAssembly sin archivos, sin variables de entorno y sin red, salvo que concedas cada cosa en la línea de órdenes. Es el modelo de capacidades: un programa que no escribiste no puede leer lo que no le diste.

Hoy concedes una carpeta y una variable, y ves cómo se rechaza todo lo demás.

Al terminar esta lección

Nota

Puedo decidir a qué deja llegar a un programa una orden de Wasmtime.

Palabras clave

PalabraQué significaEjemplo
WASIla interfaz de sistema de WebAssembly, importaciones estándar para archivos y más
Capacidadun permiso concreto que deja a un programa usar una cosa
Carpeta preabiertauna carpeta que el anfitrión abre y entrega--dir data
Variable de entornoun ajuste con nombre que se pasa a un programaCITY=Leeds
Descriptor de archivoun número que representa un archivo o una carpeta abiertos
Código de errorun número que WASI devuelve cuando se niega

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

¿Por qué pedir cada archivo?

Un programa normal puede abrir cualquier archivo que su usuario pueda leer. Es la autoridad ambiental: el poder está en el aire que lo rodea, y una biblioteca maliciosa lo recibe entero.

Un programa WASI empieza sin nada. Para leer archivos, el anfitrión abre una carpeta y le entrega un descriptor de archivo para ella. Así el programa puede abrir rutas dentro de esa carpeta, y ninguna otra.

Pide un archivo sin nada concedido

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Concede la carpeta data y vuelve a pedirlo

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Una carpeta concedida es una valla

El error 8 significa que no había ningún descriptor de carpeta. Con --dir data el programa recibió uno, y notes.txt se abrió.

Ahora pide ../private/key.txt. La carpeta private está justo al lado de data, y el usuario que ejecuta wasmtime podría leerla. WASI se niega igualmente, porque la ruta sale de la carpeta concedida.

Intenta salir de la carpeta

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: qué significó cada rechazo

OrdenImprimióPor qué
cat.wat notes.txtWASI error 8Sin carpeta concedida no hay descriptor
--dir data cat.wat notes.txtla lista de la compraEl archivo está dentro de la carpeta
--dir data cat.wat ../private/key.txtWASI error 63La ruta sale de la carpeta
--dir data cat.wat missing.txtWASI error 44Está dentro, pero ese archivo no existe

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que un programa WASI puede leer todo lo que lee el usuario que ejecuta wasmtime. Solo llega a las carpetas dadas con --dir, y a nada por encima de ellas. Aunque lo ejecute root, no puede abrir un archivo fuera de sus carpetas.

Pruébalo: ¿la ruta se queda dentro?

Código: python
def stays_inside(path):
    # Recorre la ruta trozo a trozo. ".." nunca puede subir por encima de la carpeta.
    if path.startswith("/"):
        return False
    depth = 0
    for part in path.split("/"):
        if part == "..":
            depth = depth - 1
            if depth < 0:
                return False
        elif part != "" and part != ".":
            depth = depth + 1
    return True

for path in ["notes.txt", "week1/../notes.txt", "../private/key.txt", "/etc/passwd"]:
    print(path, "se queda dentro:", stays_inside(path))
# Añade "week1/../../key.txt". ¿Se queda dentro?

Las variables de entorno no se pasan

Un programa lanzado desde una shell suele ver todas las variables que tiene la shell, contraseñas incluidas. Wasmtime no pasa ninguna.

Usa --env NOMBRE=valor para fijar una, o --env NOMBRE para pasar una que ya tiene el anfitrión. La opción -S inherit-env las pasa todas, así que úsala solo si confías en el programa. Con la red pasa lo mismo: no hay nada alcanzable hasta que una opción -S lo concede.

Lista las variables sin ninguna concedida

Comando
docker exec wasm wasmtime run env.wat

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Concede una variable y vuelve a listar

Comando
docker exec wasm wasmtime run --env CITY=Leeds env.wat

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Sobre este laboratorio y su código: Laboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.