Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

sandbox — bezpečnostní omezení prvku iframe

Atribut sandbox ukládá obsahu prvku iframe další omezení. Prázdná hodnota zapne všechna omezení, zatímco tokeny allow-* vybraná omezení ruší. Kombinace allow-scripts a allow-same-origin vyžaduje zvláštní opatrnost.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>

sandbox je atribut prvku iframe, který omezuje možnosti vloženého dokumentu. Pokud atribut chybí, tato dodatečná omezení se neuplatňují; sandbox="" nebo samotné sandbox je zapne všechna. Nejde o booleovský atribut: jeho hodnota je neuspořádaná množina jedinečných tokenů oddělených mezerami, u nichž se nerozlišují velká a malá písmena ASCII.

Ve výchozím nastavení se blokují mimo jiné skripty, odesílání formulářů, vyskakovací okna a některé navigace. Dokument dostane jedinečný neprůhledný původ. allow-scripts ruší omezení skriptů, allow-forms omezení formulářů a allow-same-origin zachovává skutečný původ dokumentu; nepřiřadí mu původ nadřazeného dokumentu. Tokeny ruší omezení sandboxu, ale neobcházejí jiná bezpečnostní opatření prohlížeče.

U obsahu se stejným původem jako nadřazený dokument nekombinujte allow-scripts s allow-same-origin: dokument může ze svého prvku frame odstranit sandbox a znovu se načíst, čímž sandbox opustí. Potenciálně škodlivý obsah poskytujte z oddělené domény určené právě k tomuto účelu: přímé otevření jeho adresy URL obchází ochranu rámce.

Změna nebo odstranění atributu nezmění omezení již načteného dokumentu; nové nastavení se uplatní při navigaci. Vnořený frame nemůže zrušit omezení zděděná od předků. sandbox nenahrazuje atribut allow, který řídí Permissions Policy.

Příklady

<!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>

Výsledek

Scripts blocked

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje