Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

sandbox — bezpečnostné obmedzenia prvku iframe

Atribút sandbox ukladá obsahu prvku iframe ďalšie obmedzenia. Prázdna hodnota zapne všetky obmedzenia, zatiaľ čo tokeny allow-* vybrané obmedzenia rušia. Kombinácia allow-scripts a allow-same-origin si vyžaduje osobitnú opatrnosť.

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

Syntax

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

sandbox je atribút prvku iframe, ktorý obmedzuje možnosti vloženého dokumentu. Ak atribút chýba, tieto dodatočné obmedzenia sa neuplatňujú; sandbox="" alebo samotné sandbox ich zapne všetky. Nie je to booleovský atribút: jeho hodnota je neusporiadaná množina jedinečných tokenov oddelených medzerami, pri ktorých sa nerozlišujú veľké a malé písmená ASCII.

Predvolene sa blokujú okrem iného skripty, odosielanie formulárov, vyskakovacie okná a niektoré navigácie. Dokument dostane jedinečný nepriehľadný pôvod. allow-scripts ruší obmedzenie skriptov, allow-forms obmedzenie formulárov a allow-same-origin zachováva skutočný pôvod dokumentu; nepriradí mu pôvod nadradeného dokumentu. Tokeny rušia obmedzenia sandboxu, no neobchádzajú iné bezpečnostné opatrenia prehliadača.

Pri obsahu s rovnakým pôvodom ako nadradený dokument nekombinujte allow-scripts s allow-same-origin: dokument môže zo svojho prvku frame odstrániť sandbox a znova sa načítať, čím opustí sandbox. Potenciálne škodlivý obsah poskytujte z oddelenej domény určenej na tento účel: priame otvorenie jeho adresy URL obchádza ochranu rámca.

Zmena alebo odstránenie atribútu nezmení obmedzenia už načítaného dokumentu; nové nastavenia sa uplatnia pri navigácii. Vnorený frame nemôže zrušiť obmedzenia zdedené od predkov. sandbox nenahrádza atribút allow, ktorý riadi Permissions Policy.

Prí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ýsledok

Scripts blocked

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje