CKTIS / HTML
sandbox — restrições de segurança de iframe
O atributo sandbox impõe restrições adicionais ao conteúdo de um iframe. Um valor vazio ativa todas as restrições, enquanto os tokens allow-* levantam algumas. A combinação de allow-scripts com allow-same-origin exige especial cuidado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>sandbox é um atributo de iframe que limita as capacidades do documento incorporado. Se o atributo for omitido, estas restrições adicionais não são aplicadas; sandbox="" ou sandbox sem valor ativa-as todas. Não é um atributo booleano: o seu valor é um conjunto não ordenado de tokens únicos separados por espaços, sem distinção entre maiúsculas e minúsculas ASCII.
Por predefinição, são bloqueados, entre outras coisas, os scripts, o envio de formulários, as janelas pop-up e algumas navegações. O documento recebe uma origem opaca única. allow-scripts levanta a restrição relativa aos scripts, allow-forms a relativa aos formulários e allow-same-origin mantém a origem real do documento; não lhe atribui a origem do documento principal. Os tokens levantam restrições de sandbox, mas não contornam outros controlos de segurança do navegador.
Para conteúdo com a mesma origem do documento principal, não combines allow-scripts com allow-same-origin: o documento pode remover sandbox do elemento frame e recarregar-se, saindo da sandbox. Disponibiliza conteúdo potencialmente malicioso num domínio separado e dedicado: abrir o respetivo URL diretamente contorna a proteção do frame.
Alterar ou remover o atributo não modifica as restrições de um documento já carregado; as novas definições entram em vigor quando ocorre uma navegação. Um frame aninhado não pode levantar restrições herdadas dos antecessores. sandbox não substitui o atributo allow, que controla a Permissions Policy.
Exemplos
<!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>Resultado
Scripts blocked
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.