WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

sandbox — Sicherheitseinschränkungen für iframe

Das Attribut sandbox schränkt den Inhalt eines iframe zusätzlich ein. Ein leerer Wert aktiviert alle Einschränkungen; allow-*-Tokens heben ausgewählte Einschränkungen auf. Die Kombination von allow-scripts und allow-same-origin erfordert besondere Vorsicht.

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

Syntax

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

sandbox ist ein iframe-Attribut, das die Möglichkeiten des eingebetteten Dokuments einschränkt. Fehlt das Attribut, gelten diese zusätzlichen Einschränkungen nicht; sandbox="" oder ein allein stehendes sandbox aktiviert sie alle. Es ist kein boolesches Attribut: Sein Wert ist eine ungeordnete Menge eindeutiger, durch Leerzeichen getrennter Tokens, bei denen die ASCII-Groß- und Kleinschreibung nicht unterschieden wird.

Standardmäßig werden unter anderem Skripte, das Absenden von Formularen, Pop-ups und bestimmte Navigationen blockiert. Das Dokument erhält einen eindeutigen, opaken Ursprung. allow-scripts hebt die Skripteinschränkung auf, allow-forms die Formulareinschränkung und allow-same-origin erhält den tatsächlichen Ursprung des Dokuments; es weist ihm nicht den Ursprung des übergeordneten Dokuments zu. Tokens heben Sandbox-Einschränkungen auf, umgehen aber keine anderen Sicherheitskontrollen des Browsers.

Bei Inhalten mit demselben Ursprung wie das übergeordnete Dokument sollten allow-scripts und allow-same-origin nicht kombiniert werden: Das Dokument kann sandbox aus seinem Frame-Element entfernen und sich neu laden, um die Sandbox zu verlassen. Stelle potenziell schädliche Inhalte über eine separate, eigens dafür vorgesehene Domain bereit: Wird ihre URL direkt geöffnet, umgeht das den Schutz des Frames.

Das Ändern oder Entfernen des Attributs ändert nicht die Einschränkungen eines bereits geladenen Dokuments; neue Einstellungen werden bei einer Navigation wirksam. Ein verschachtelter Frame kann Einschränkungen, die er von Vorfahren geerbt hat, nicht aufheben. sandbox ersetzt nicht das Attribut allow, das die Permissions Policy steuert.

Beispiele

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

Ergebnis

Scripts blocked

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen