База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

sandbox — ограничения за сигурност на iframe

Атрибутът sandbox налага допълнителни ограничения върху съдържанието на iframe. Празна стойност включва целия набор от ограничения, а токените allow-* премахват избрани ограничения. Комбинацията от allow-scripts и allow-same-origin изисква особено внимание.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

sandbox е атрибут на iframe, който ограничава възможностите на вградения документ. Ако атрибутът липсва, тези допълнителни ограничения не се прилагат; sandbox="" или само sandbox ги включва всички. Това не е булев атрибут: стойността му е неподредено множество от уникални токени, разделени с интервали, при които не се прави разлика между главни и малки ASCII букви.

По подразбиране се блокират, наред с други неща, скриптовете, изпращането на формуляри, изскачащите прозорци и някои навигации. Документът получава уникален непрозрачен произход. allow-scripts премахва ограничението за скриптове, allow-forms — това за формуляри, а allow-same-origin запазва действителния произход на документа; не му задава произхода на родителския документ. Токените премахват ограниченията на sandbox, но не заобикалят други мерки за сигурност на браузъра.

При съдържание със същия произход като родителския документ не комбинирайте allow-scripts с allow-same-origin: документът може да премахне sandbox от своя frame елемент и да се презареди, за да излезе от sandbox. Потенциално злонамерено съдържание предоставяйте от отделен домейн, предназначен за тази цел: директното отваряне на URL адреса му заобикаля защитата на рамката.

Промяната или премахването на атрибута не променя ограниченията на вече зареден документ; новите настройки влизат в сила при навигация. Вложен frame не може да премахне ограниченията, наследени от предшествениците си. sandbox не заменя атрибута allow, който управлява Permissions Policy.

Примери

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

Резултат

Scripts blocked

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници