Sandbox del processo renderer
Abiliti e configuri il sandboxing per i processi renderer, limitandone l’accesso alle risorse di sistema e aumentando la sicurezza dell’applicazione.
Sandbox del processo renderer è una lezione Electron Desktop App Development gratuita su CoddyKit. Questa è la lezione 3 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 Electron Desktop App Development, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Electron Desktop App Development include 4 lezioni in totale.
Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.
What is Sandboxing?
Imagine your computer as a house. Some guests (apps) you trust completely, others you want to keep in a specific room with limited access.
Sandboxing is like putting your app's renderer process in a secure, isolated "room." It limits what that part of your app can do and access on your system.
This is crucial for security, especially when displaying untrusted web content or protecting against malicious scripts.
Why Sandboxing Matters
Electron apps combine web content (HTML, CSS, JS) with native desktop capabilities. Without proper isolation, a vulnerability in your web content could be exploited to access your user's file system or other system resources.
Sandboxing prevents this by isolating the renderer process, making it much harder for malicious code to "break out" and harm the user's system.
Chromium's Security Layer
Electron uses Chromium, the same engine that powers Google Chrome. A key security feature of Chromium is its renderer sandbox.
By default in browsers, web pages run in a sandboxed renderer process, meaning they can't directly interact with your operating system. Electron extends this robust security model to your desktop applications.
Activating the Sandbox
Enabling sandboxing in Electron is straightforward. You do it when creating a new BrowserWindow by setting the sandbox option to true in webPreferences.
This is a critical step for enhancing the security posture of your Electron application.
const { app, BrowserWindow } = require('electron');
function createWindow () {
const win = new BrowserWindow({
width: 800,
height: 600,
webPreferences: {
sandbox: true // Set to true to enable sandboxing
}
});
win.loadFile('index.html'); // Loads your web content
}
app.whenReady().then(createWindow);
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});Renderer Process Limitations
When a renderer process is sandboxed, it faces significant restrictions:
- It cannot directly access Node.js APIs (e.g.,
require,process,fs). - It cannot use native modules.
- Its access to system resources (like files) is severely limited.
This isolation prevents web content from performing unauthorized actions on the user's computer.
Node.js Access Denied Demo
Let's see what happens when a sandboxed renderer tries to access Node.js directly. The code below creates a window with sandboxing enabled and attempts to use the fs module.
Run this example and check the developer console (usually F12 or Cmd+Option+I) for the error message.
const { app, BrowserWindow } = require('electron');
function createWindow () {
const win = new BrowserWindow({
width: 600,
height: 400,
webPreferences: {
sandbox: true, // Sandboxing enabled
nodeIntegration: false, // Explicitly disabled (default with sandbox)
contextIsolation: true // Explicitly enabled (default with sandbox)
}
});
// Load HTML that tries to use Node.js 'fs' module
win.loadURL(`data:text/html;charset=utf-8,
<!DOCTYPE html>
<html>
<head>
<title>Sandboxed Demo</title>
</head>
<body>
<h1>Sandboxed Renderer Test</h1>
<p id="message">Attempting to access Node.js...</p>
<script>
try {
const fs = require('fs'); // This will fail!
document.getElementById('message').innerText = 'Node.js fs module loaded!';
} catch (error) {
document.getElementById('message').innerText = 'Error: ' + error.message;
console.error('Renderer error:', error);
}
</script>
</body>
</html>
`);
win.webContents.openDevTools(); // Open DevTools to see the error
}
app.whenReady().then(createWindow);
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});Secure Interaction: Preload
Since sandboxed renderers can't directly access Node.js, how do they perform system tasks?
You use preload scripts with context isolation. These scripts run before your web content, have Node.js access, and can securely expose a limited API to your sandboxed renderer via contextBridge.
This ensures that your main process controls exactly what functionality is exposed.
Sandbox & Context Isolation
It's important to note that when webPreferences.sandbox is true, both nodeIntegration will be false and contextIsolation will be true by default, regardless of what you explicitly set.
This combination provides the strongest security for your renderer processes.
Best Practices
- Always enable sandboxing: It's a fundamental security measure.
- Minimize exposed APIs: Only expose essential functionality via preload scripts.
- Validate all inputs: Any data passed from a renderer to the main process should be validated.
These practices create a robust and secure Electron application.
Quick Check
Understanding sandboxing is key to building secure Electron applications.
Recap: Securing Your App
In this lesson, we explored sandboxing in Electron. We learned that it's a critical security feature that isolates your renderer processes, preventing them from directly accessing system resources or Node.js APIs.
By setting webPreferences.sandbox: true, you activate this powerful protection, ensuring a safer application. Remember to use preload scripts with context isolation for secure communication between your sandboxed renderer and the main process.
Domande Frequenti
La lezione «Sandbox del processo renderer» è gratuita?
Sì — il testo completo di «Sandbox del processo renderer» è 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 Electron Desktop App Development, passa a CoddyKit PRO. Il corso Electron Desktop App Development include 4 lezioni in totale.
Cosa imparerò in «Sandbox del processo renderer»?
Abiliti e configuri il sandboxing per i processi renderer, limitandone l’accesso alle risorse di sistema e aumentando la sicurezza dell’applicazione. Eserciti Electron Desktop App Development 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 Electron Desktop App Development?
Non è richiesta alcuna esperienza precedente. Electron Desktop App Development su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Sandbox del processo renderer»?
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 Electron Desktop App Development?
Sì. Ogni lezione Electron Desktop App Development 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
- Pattern IPC sicuri
- Isolamento del contesto e script preload
- Sandbox del processo renderer
- Protezione dai rischi dei contenuti remoti