Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

sandbox — restrictions de sécurité des iframe

L’attribut sandbox impose des restrictions supplémentaires au contenu d’un iframe. Une valeur vide active l’ensemble des restrictions ; les jetons allow-* en lèvent certaines. La combinaison de allow-scripts et allow-same-origin exige une prudence particulière.

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

Syntaxe

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

sandbox est un attribut iframe qui limite les capacités du document intégré. Si l’attribut est absent, ces restrictions supplémentaires ne s’appliquent pas ; sandbox="" ou sandbox seul les active toutes. Ce n’est pas un attribut booléen : sa valeur est un ensemble non ordonné de jetons uniques séparés par des espaces, sans distinction entre les majuscules et les minuscules ASCII.

Par défaut, les scripts, l’envoi de formulaires, les fenêtres pop-up et certaines navigations sont notamment bloqués. Le document reçoit une origine opaque unique. allow-scripts lève la restriction sur les scripts, allow-forms celle sur les formulaires, et allow-same-origin conserve l’origine réelle du document ; il ne lui attribue pas celle du document parent. Les jetons lèvent les restrictions de sandbox, mais ne contournent pas les autres contrôles de sécurité du navigateur.

Pour un contenu partageant l’origine du document parent, ne combinez pas allow-scripts et allow-same-origin : le document peut retirer sandbox de son élément frame et se recharger pour sortir de la sandbox. Servez les contenus potentiellement hostiles depuis un domaine distinct qui leur est dédié : ouvrir directement leur URL contourne la protection du frame.

Modifier ou supprimer l’attribut ne change pas les restrictions d’un document déjà chargé ; les nouveaux paramètres prennent effet lors d’une navigation. Un frame imbriqué ne peut pas lever les restrictions héritées de ses ancêtres. sandbox ne remplace pas l’attribut allow, qui contrôle la Permissions Policy.

Exemples

<!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>

Résultat

Scripts blocked

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources