Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

sandbox — ograniczenia bezpieczeństwa ramki iframe

Atrybut sandbox nakłada dodatkowe ograniczenia na zawartość iframe. Pusta wartość włącza pełny zestaw ograniczeń, a tokeny allow-* znoszą wybrane z nich. Szczególnej ostrożności wymaga połączenie allow-scripts z allow-same-origin.

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

Składnia

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

sandbox jest atrybutem iframe, który ogranicza możliwości osadzonego dokumentu. Brak atrybutu nie nakłada tych dodatkowych ograniczeń; sandbox="" lub samo sandbox włącza je wszystkie. To nie jest atrybut logiczny: wartość jest nieuporządkowanym zbiorem unikatowych tokenów rozdzielonych spacjami, bez rozróżniania wielkości liter ASCII.

Domyślnie blokowane są m.in. skrypty, wysyłanie formularzy, wyskakujące okna i część nawigacji. Dokument otrzymuje unikatowe, nieprzezroczyste pochodzenie. allow-scripts znosi blokadę skryptów, allow-forms — formularzy, a allow-same-origin zachowuje rzeczywiste pochodzenie dokumentu; nie nadaje mu pochodzenia rodzica. Tokeny znoszą ograniczenia piaskownicy, ale nie omijają innych zabezpieczeń przeglądarki.

Dla treści o tym samym pochodzeniu co rodzic nie łącz allow-scripts z allow-same-origin: dokument może usunąć sandbox z elementu ramki i przeładować się, wychodząc z piaskownicy. Potencjalnie wrogie treści udostępniaj z osobnej, dedykowanej domeny — bezpośrednie otwarcie ich adresu omija ochronę ramki.

Zmiana lub usunięcie atrybutu nie zmienia ograniczeń już załadowanego dokumentu; nowe ustawienia działają przy nawigacji. Zagnieżdżona ramka nie może znieść ograniczeń odziedziczonych po przodkach. sandbox nie zastępuje atrybutu allow, który steruje Permissions Policy.

Przykłady

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

Wynik

Scripts blocked

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła