CKTIS / HTML
sandbox — sigurnosna ograničenja elementa iframe
Atribut sandbox nameće dodatna ograničenja sadržaju elementa iframe. Prazna vrijednost uključuje sva ograničenja, a tokeni allow-* uklanjaju odabrana ograničenja. Kombinacija allow-scripts i allow-same-origin zahtijeva poseban oprez.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>sandbox je atribut elementa iframe koji ograničava mogućnosti ugrađenog dokumenta. Ako atribut nije naveden, ova dodatna ograničenja ne primjenjuju se; sandbox="" ili samostalni sandbox uključuje ih sva. To nije logički atribut: njegova je vrijednost neuređen skup jedinstvenih tokena odvojenih razmacima, pri čemu se ne razlikuju velika i mala ASCII slova.
Prema zadanim postavkama blokiraju se, među ostalim, skripte, slanje obrazaca, skočni prozori i neke navigacije. Dokument dobiva jedinstveno neprozirno podrijetlo. allow-scripts uklanja ograničenje za skripte, allow-forms ograničenje za obrasce, a allow-same-origin zadržava stvarno podrijetlo dokumenta; ne dodjeljuje mu podrijetlo nadređenog dokumenta. Tokeni uklanjaju ograničenja sandboxa, ali ne zaobilaze druge sigurnosne kontrole preglednika.
Za sadržaj istog podrijetla kao nadređeni dokument nemojte kombinirati allow-scripts i allow-same-origin: dokument može ukloniti sandbox iz svojeg elementa frame i ponovno se učitati kako bi izašao iz sandboxa. Potencijalno zlonamjeran sadržaj poslužujte s odvojene domene namijenjene toj svrsi: izravno otvaranje njegova URL-a zaobilazi zaštitu okvira.
Promjena ili uklanjanje atributa ne mijenja ograničenja već učitanog dokumenta; nove postavke stupaju na snagu pri navigaciji. Ugniježđeni frame ne može ukloniti ograničenja naslijeđena od predaka. sandbox ne zamjenjuje atribut allow, koji upravlja pravilima Permissions Policy.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.