Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

sandbox — restricciones de seguridad de iframe

El atributo sandbox impone restricciones adicionales al contenido de un iframe. Un valor vacío activa todas las restricciones, mientras que los tokens allow-* levantan algunas. La combinación de allow-scripts y allow-same-origin requiere especial cuidado.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

sandbox es un atributo de iframe que limita las capacidades del documento incrustado. Si se omite el atributo, no se aplican estas restricciones adicionales; sandbox="" o sandbox sin valor las activa todas. No es un atributo booleano: su valor es un conjunto desordenado de tokens únicos separados por espacios, sin distinguir entre mayúsculas y minúsculas ASCII.

De forma predeterminada, se bloquean, entre otras cosas, los scripts, el envío de formularios, las ventanas emergentes y algunas navegaciones. El documento recibe un origen opaco único. allow-scripts levanta la restricción de los scripts, allow-forms la de los formularios y allow-same-origin conserva el origen real del documento; no le asigna el origen del documento padre. Los tokens levantan restricciones de sandbox, pero no eluden otros controles de seguridad del navegador.

Si el contenido comparte el origen del documento padre, no combines allow-scripts con allow-same-origin: el documento puede quitar sandbox de su elemento de marco y volver a cargarse para salir de la sandbox. Sirve el contenido potencialmente malicioso desde un dominio independiente y dedicado: abrir su URL directamente elude la protección del marco.

Cambiar o quitar el atributo no modifica las restricciones de un documento ya cargado; la nueva configuración se aplica al navegar. Un marco anidado no puede levantar las restricciones heredadas de sus antecesores. sandbox no sustituye al atributo allow, que controla Permissions Policy.

Ejemplos

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

Resultado

Scripts blocked

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes