Sandbox e autorizzazioni
Implementi strategie per limitare ulteriormente le funzionalità dei moduli WASM e gestire le autorizzazioni negli ambienti host.
Sandbox e autorizzazioni è una lezione WebAssembly (WASM) for High Performance Apps gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento WebAssembly (WASM) for High Performance Apps, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso WebAssembly (WASM) for High Performance Apps include 4 lezioni in totale.
Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.
WASM's Security Sandbox
WebAssembly (WASM) is designed with security at its core. It operates within a tightly controlled environment known as a sandbox.
This sandboxing mechanism isolates WASM code from the host system, preventing it from directly accessing sensitive resources or executing arbitrary operations outside its allocated space.
Inherent Restrictions
By default, a WASM module has no direct access to common system capabilities such as:
- The host's file system
- Network interfaces
- Environment variables
- Arbitrary memory outside its linear memory
This strict isolation is a fundamental security feature, making WASM a safe choice for executing untrusted code.
Granting Powers via Imports
If a WASM module needs to perform tasks like logging, accessing a file, or making a network request, it cannot do so directly. Instead, it must import functions from its host environment.
The host (e.g., a web browser's JavaScript engine or a WASI runtime) acts as a gatekeeper, explicitly providing these capabilities. This gives the host full control over what the WASM module can and cannot do.
WASM Requests Host Functions
Here's how a Rust-compiled WASM module might declare its need for a host function. It expects the host to provide a function called host_log within the env module.
/* src/lib.rs */
// Link to an imported function from the 'env' module
#[link(wasm_import_module = "env")]
extern "C" {
fn host_log(ptr: *const u8, len: usize);
}
#[no_mangle]
pub extern "C" fn log_message_from_wasm() {
let message = "Hello from WASM!";
let ptr = message.as_ptr();
let len = message.len();
unsafe {
// Call the imported host function
host_log(ptr, len);
}
}Host Grants or Denies Permission
The JavaScript host decides whether to provide the host_log function. If it's provided, WASM can call it. If not, the WASM module will fail to instantiate, enforcing the permission.
Try running this example:
// host.js
async function loadWasmWithPermission() {
const wasmBytes = await fetch("log_module.wasm").then(res => res.arrayBuffer());
// Define the imports object for WASM
const imports = {
env: {
host_log: (ptr, len) => {
// This function is provided by JS to WASM
const memory = instance.exports.memory;
const data = new Uint8Array(memory.buffer, ptr, len);
const text = new TextDecoder("utf-8").decode(data);
console.log(`WASM says: ${text}`);
}
}
};
try {
const { instance } = await WebAssembly.instantiate(wasmBytes, imports);
instance.exports.log_message_from_from_wasm(); // Call the WASM function
} catch (e) {
console.error("WASM instantiation failed:", e);
}
}
loadWasmWithPermission();Controlling WASM Memory
Beyond functions, the host environment also controls the WASM module's linear memory. When instantiating a module, the host can specify the initial and maximum memory size (in 64KB pages).
This prevents a malicious or buggy WASM module from consuming excessive memory and impacting the host application.
// host.js
async function loadWasmWithMemory() {
// Create a WebAssembly.Memory object
const memory = new WebAssembly.Memory({ initial: 1, maximum: 2 });
// 1 page (64KB) initial, max 2 pages (128KB)
const wasmBytes = await fetch("memory_user.wasm").then(res => res.arrayBuffer());
const imports = {
env: {
memory: memory // Pass the controlled memory object to WASM
}
};
const { instance } = await WebAssembly.instantiate(wasmBytes, imports);
console.log("WASM module loaded with controlled memory.");
// WASM can now access and grow this memory up to 2 pages
}
loadWasmWithMemory();Principle of Least Privilege
A critical security practice when working with WASM is the Principle of Least Privilege.
This means you should grant a WASM module only the permissions and resources it absolutely needs to perform its intended function, and no more. Minimizing access reduces the attack surface and potential impact of vulnerabilities.
Beyond Browser: WASI & Host Capabilities
For environments outside the web browser (like servers or IoT devices), the WebAssembly System Interface (WASI) standardizes system-level access.
Even with WASI, the underlying WASI runtime (e.g., Wasmtime, Wasmer) is the host. It still enforces permissions, deciding which file paths, network sockets, or environment variables a WASI module can access.
Secure Interaction Tips
To build secure WASM applications:
- Minimize Imports: Only provide host functions that are strictly necessary.
- Validate Inputs: Always validate data passed from WASM to JavaScript (and vice-versa) to prevent injection or buffer overflow issues.
- Memory Boundaries: Set appropriate initial and maximum memory limits.
- Trusted Modules: Only load WebAssembly modules from trusted and verified sources.
Permission Check
Consider a WebAssembly module that needs to read from a specific file. Which entity is primarily responsible for granting or denying this capability?
Recap: Secure WASM
We've learned that WebAssembly modules operate within a secure sandbox, relying entirely on the host environment to provide any external capabilities. Managing imports and controlling memory are crucial for maintaining security and adhering to the principle of least privilege.
Understanding these mechanisms helps you build robust, high-performance, and secure WebAssembly applications.
Domande Frequenti
La lezione «Sandbox e autorizzazioni» è gratuita?
Sì — il testo completo di «Sandbox e autorizzazioni» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso WebAssembly (WASM) for High Performance Apps, passa a CoddyKit PRO. Il corso WebAssembly (WASM) for High Performance Apps include 4 lezioni in totale.
Cosa imparerò in «Sandbox e autorizzazioni»?
Implementi strategie per limitare ulteriormente le funzionalità dei moduli WASM e gestire le autorizzazioni negli ambienti host. Eserciti WebAssembly (WASM) for High Performance Apps con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare WebAssembly (WASM) for High Performance Apps?
Non è richiesta alcuna esperienza precedente. WebAssembly (WASM) for High Performance Apps su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Sandbox e autorizzazioni»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione WebAssembly (WASM) for High Performance Apps?
Sì. Ogni lezione WebAssembly (WASM) for High Performance Apps include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Il modello di sicurezza WASM
- Sandbox e autorizzazioni
- Strategie di deployment in produzione
- Sicurezza della supply chain e verifica dei moduli