CKTIS / HTML
sandbox — restrizioni di sicurezza per iframe
L’attributo sandbox impone ulteriori restrizioni ai contenuti di un iframe. Un valore vuoto attiva l’intero insieme di restrizioni, mentre i token allow-* ne rimuovono alcune. La combinazione di allow-scripts e allow-same-origin richiede particolare attenzione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>sandbox è un attributo iframe che limita le capacità del documento incorporato. Se l’attributo è omesso, queste restrizioni aggiuntive non vengono applicate; sandbox="" o sandbox senza valore le attiva tutte. Non è un attributo booleano: il suo valore è un insieme non ordinato di token univoci separati da spazi, senza distinzione tra maiuscole e minuscole ASCII.
Per impostazione predefinita vengono bloccati, tra le altre cose, gli script, l’invio di moduli, le finestre popup e alcune navigazioni. Al documento viene assegnata un’origine opaca univoca. allow-scripts rimuove la restrizione sugli script, allow-forms quella sui moduli e allow-same-origin mantiene l’origine effettiva del documento; non gli assegna l’origine del documento padre. I token rimuovono le restrizioni di sandbox, ma non aggirano gli altri controlli di sicurezza del browser.
Per contenuti che condividono l’origine del documento padre, non combinare allow-scripts e allow-same-origin: il documento può rimuovere sandbox dal proprio elemento frame e ricaricarsi, uscendo così dalla sandbox. Pubblica contenuti potenzialmente ostili su un dominio separato e dedicato: aprirne direttamente l’URL aggira la protezione del frame.
Modificare o rimuovere l’attributo non cambia le restrizioni di un documento già caricato; le nuove impostazioni entrano in vigore con una navigazione. Un frame annidato non può rimuovere le restrizioni ereditate dagli antenati. sandbox non sostituisce l’attributo allow, che controlla la Permissions Policy.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Sandbox demo</title>
<iframe title="Sandboxed content" sandbox=""
srcdoc="<!doctype html><html lang='en'><meta charset='utf-8'><title>Content</title><p id='status'>Scripts blocked</p><script>document.getElementById('status').textContent = 'Scripts ran';</script></html>">
</iframe>
</html>Risultato
Scripts blocked
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.