Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri