CKTIS / HTML
sandbox — varnostne omejitve elementa iframe
Atribut sandbox vsebini elementa iframe naloži dodatne omejitve. Prazna vrednost vključi vse omejitve, tokeni allow-* pa izbrane odpravijo. Kombinacija allow-scripts in allow-same-origin zahteva posebno previdnost.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>sandbox je atribut elementa iframe, ki omeji zmožnosti vdelanega dokumenta. Če atributa ni, te dodatne omejitve ne veljajo; sandbox="" ali samostojni sandbox jih vključi vse. To ni logični atribut: njegova vrednost je neurejena množica enoličnih tokenov, ločenih s presledki, pri katerih se ne razlikuje med velikimi in malimi črkami ASCII.
Privzeto so med drugim blokirani skripti, pošiljanje obrazcev, pojavna okna in nekatere navigacije. Dokument dobi enoličen neprosojen izvor. allow-scripts odpravi omejitev skriptov, allow-forms omejitev obrazcev, allow-same-origin pa ohrani dejanski izvor dokumenta; ne dodeli mu izvora nadrejenega dokumenta. Tokeni odpravijo omejitve peskovnika, vendar ne obidejo drugih varnostnih mehanizmov brskalnika.
Pri vsebini z istim izvorom kot nadrejeni dokument ne kombinirajte allow-scripts in allow-same-origin: dokument lahko iz svojega elementa frame odstrani sandbox in se znova naloži ter tako zapusti peskovnik. Morebitno zlonamerno vsebino objavite na ločeni domeni, namenjeni temu: neposredno odprtje njenega URL-ja zaobide zaščito okvirja.
Sprememba ali odstranitev atributa ne spremeni omejitev že naloženega dokumenta; nove nastavitve začnejo veljati ob navigaciji. Vgnezdeni frame ne more odpraviti omejitev, podedovanih od prednikov. sandbox ne nadomešča atributa allow, ki upravlja Permissions Policy.
Primeri
<!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>Rezultat
Scripts blocked
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.