Sandboxing do Processo de Renderização
Ative e configure o sandboxing para limitar o acesso dos processos de renderização aos recursos do sistema, aumentando a segurança da sua aplicação.
Sandboxing do Processo de Renderização é uma aula grátis de Electron Desktop App Development no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Electron Desktop App Development, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Electron Desktop App Development inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
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.
Perguntas Frequentes
A aula “Sandboxing do Processo de Renderização” é grátis?
Sim — o texto completo de “Sandboxing do Processo de Renderização” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Electron Desktop App Development, atualize para CoddyKit PRO. O curso de Electron Desktop App Development inclui 4 aulas no total.
O que vou aprender em “Sandboxing do Processo de Renderização”?
Ative e configure o sandboxing para limitar o acesso dos processos de renderização aos recursos do sistema, aumentando a segurança da sua aplicação. Você pratica Electron Desktop App Development com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Electron Desktop App Development?
Nenhuma experiência prévia é necessária. Electron Desktop App Development no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Sandboxing do Processo de Renderização”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Electron Desktop App Development?
Sim. Cada aula de Electron Desktop App Development inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Padrões Seguros de IPC
- Isolamento de Contexto e Scripts de Pré-carregamento
- Sandboxing do Processo de Renderização
- Proteção contra Riscos de Conteúdo Remoto