CKTIS / HTML
sandbox — beveiligingsbeperkingen voor iframe
Het sandbox-attribuut legt extra beperkingen op aan de inhoud van een iframe. Een lege waarde schakelt alle beperkingen in; allow-*-tokens heffen geselecteerde beperkingen op. De combinatie van allow-scripts en allow-same-origin vereist extra voorzichtigheid.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<iframe sandbox="[space-separated permission tokens]" src="…"></iframe>sandbox is een iframe-attribuut dat de mogelijkheden van het ingesloten document beperkt. Als het attribuut ontbreekt, gelden deze aanvullende beperkingen niet; sandbox="" of alleen sandbox schakelt ze allemaal in. Het is geen booleaans attribuut: de waarde is een ongeordende verzameling unieke, door spaties gescheiden tokens waarbij ASCII-hoofdletters en -kleine letters niet worden onderscheiden.
Standaard worden onder andere scripts, het verzenden van formulieren, pop-ups en bepaalde navigaties geblokkeerd. Het document krijgt een unieke, ondoorzichtige origin. allow-scripts heft de beperking op scripts op, allow-forms die op formulieren en allow-same-origin behoudt de echte origin van het document; het geeft het niet de origin van het bovenliggende document. Tokens heffen sandbox-beperkingen op, maar omzeilen geen andere beveiligingsmaatregelen van de browser.
Combineer allow-scripts niet met allow-same-origin voor inhoud met dezelfde origin als het bovenliggende document: het document kan sandbox van het frame-element verwijderen en zichzelf opnieuw laden om uit de sandbox te ontsnappen. Serveer mogelijk kwaadaardige inhoud vanaf een afzonderlijk, daarvoor bestemd domein: de URL rechtstreeks openen omzeilt de bescherming van het frame.
Het wijzigen of verwijderen van het attribuut verandert de beperkingen van een al geladen document niet; nieuwe instellingen worden van kracht bij navigatie. Een genest frame kan beperkingen die het van voorouders heeft geërfd niet opheffen. sandbox vervangt het attribuut allow niet; dat attribuut bepaalt de Permissions Policy.
Voorbeelden
<!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>Resultaat
Scripts blocked
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.