Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes