Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti