Директива local-network заголовка HTTP Permissions-Policy управляет тем, разрешено ли текущему документу отправлять сетевые запросы к локальным адресам.

Локальный адрес доступен только в локальной сети; его целевой объект будет различаться в разных сетях. Например, 192.168.0.1.

В частности, если определённая политика запрещает использование этой возможности, запросы к локальным адресам всегда будут завершаться ошибкой.

Подробнее см. в разделе Доступ к локальной сети.

Синтаксис

Permissions-Policy: local-network=<allowlist>;

<allowlist>

Список источников, которым разрешено использовать эту возможность. Подробнее см. в разделе Permissions-Policy > Синтаксис.

Политика по умолчанию

Список разрешённых источников по умолчанию для local-network — self. По умолчанию доступ к возможности local-network разрешён для контекста просмотра верхнего уровня и iframe с тем же источником.

Примеры

Основное использование

Компания SecureCorp Inc. хочет запретить local-network во всех iframe с другим источником, кроме тех, чей источник — https://example.com. Для этого она может отправить следующий заголовок HTTP-ответа, задающий политику разрешений:

Permissions-Policy: local-network=(self "https://example.com")

Компания SecureCorp Inc. также должна добавить атрибут allow для каждого элемента <iframe>, в котором требуется разрешить local-network:

<iframe src="https://example.com/lna" allow="local-network"></iframe>

Использование политики по умолчанию

Если список разрешённых источников для local-network не задан заголовком ответа Permissions-Policy, пользовательские агенты применяют список разрешённых источников по умолчанию self. В этом режиме local-network автоматически разрешено в контексте просмотра верхнего уровня и iframe с тем же источником, но не в iframe с другим источником.

Чтобы разрешить local-network в iframe с другим источником, добавьте атрибут allow к элементу <iframe>:

<iframe src="https://other.com/lna" allow="local-network"></iframe>

Спецификации

Совместимость с браузерами

См. также

• Доступ к локальной сети
• заголовок Permissions-Policy
• Политика разрешений