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
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| WASI | la interfaz de sistema de WebAssembly, importaciones estándar para archivos y más | |
| Capacidad | un permiso concreto que deja a un programa usar una cosa | |
| Carpeta preabierta | una carpeta que el anfitrión abre y entrega | --dir data |
| Variable de entorno | un ajuste con nombre que se pasa a un programa | CITY=Leeds |
| Descriptor de archivo | un número que representa un archivo o una carpeta abiertos | |
| Código de error | un 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
docker exec wasm wasmtime run cat.wat notes.txtSe 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
docker exec wasm wasmtime run --dir data cat.wat notes.txtSe 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
docker exec wasm wasmtime run --dir data cat.wat ../private/key.txtSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejemplo: qué significó cada rechazo
| Orden | Imprimió | Por qué |
|---|---|---|
| cat.wat notes.txt | WASI error 8 | Sin carpeta concedida no hay descriptor |
| --dir data cat.wat notes.txt | la lista de la compra | El archivo está dentro de la carpeta |
| --dir data cat.wat ../private/key.txt | WASI error 63 | La ruta sale de la carpeta |
| --dir data cat.wat missing.txt | WASI error 44 | Está 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?
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
docker exec wasm wasmtime run env.watSe 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
docker exec wasm wasmtime run --env CITY=Leeds env.watSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.