Форматы фильтрации для политик на основе списка URL-адресов

В этой статье описывается формат фильтра, используемый для политик на основе списка URL-адресов Microsoft Edge. Например, политики URLBlocklist, URLAllowList и CertificateTransparencyEnforcementDisabledForUrls .

1. Формат фильтра на основе списка URL-адресов

Используется следующий формат фильтрации:

    [scheme://][.]host[:port][/path][@query]

Поля в формате фильтрации:

Поле	Описание
схема (необязательно)	Это может быть http://, https://, ftp://, edge:// и т. д.
узел (обязательно)	Это должно быть допустимое имя узла, и можно использовать подстановочный знак ("*"). Чтобы отключить сопоставление поддоменов, добавьте необязательную точку (.) перед узлом. Можно указать одно имя узла литерала IP-адреса, но для имени узла литерала IP-адреса не поддерживается подстановочный знак.
порт (необязательно)	Допускаются значения в диапазоне от 1 до 65535.
путь (необязательно)	В пути можно использовать любую строку.
запрос (необязательно)	Запрос — это маркеры типа "ключ-значение" или "ключ", разделенные амперсандом ("&"). Маркеры типа "ключ-значение" следует разделять знаком равенства ("="). Чтобы указать соответствие префикса, можно использовать звездочку ("*") в конце запроса.

Сравнение формата фильтрации с форматом URL-адреса

Формат фильтрации похож на формат URL-адреса, за исключением следующих различий:

• Если в формат включено слово user:pass, оно игнорируется. Например http://user:pass@ftp.contoso.com/pub/example.iso.
• При добавлении идентификатора фрагмента ("#") он и все следующие за ним элементы игнорируются.
• Вы можете использовать подстановочный знак ("*") в качестве узла и префикс его с помощью точки (.).
• В качестве суффикса для узла можно использовать косую черту ("/") или точку (.). В этом случае суффикс игнорируется.

Условия выбора фильтра

Выбранный для URL-адреса фильтр — это наиболее точное совпадение, находимое после обработки следующих правил выбора фильтра.

1. Сначала выбираются фильтры самым длинным совпадением узла.
2. Из выбранных фильтров отбрасывается любой фильтр со схемой или портом, который не соответствует.
3. Из оставшихся фильтров выбирается фильтр с самым длинным совпадающим путем.
4. Из оставшихся фильтров выбирается фильтр с самым длинным набором маркеров запросов. На этом шаге фильтр списка разрешений имеет приоритет над фильтром списка блокировок, если оба фильтра имеют одинаковую длину пути и количество маркеров запроса .
5. Если допустимого фильтра нет, то крайний левый дочерний домен удаляется из узла, а процесс выбора начинается с шага 1. Поиск узла, отмеченного звездочкой ("*"), выполняется в последний момент, и он сопоставляется со всеми узлами.
6. Если фильтр доступен, он блокирует или разрешает URL-запрос.

Примечание.

Запрос URL-адреса разрешен по умолчанию при отсутствии совпадений при фильтрации.

Пример условий выбора фильтра

В этом примере при поиске совпадения с "https://sub.contoso.com/docs" выбор фильтра:

1. Найдите фильтр для sub.contoso.com. Если фильтр найден, поиск переходит к шагу 2. Если фильтр не найден, он пытается повторить попытку с contoso.com, и, наконец, com"".
2. Из выбранных фильтров все фильтры без элемента "http" в схеме удаляются.
3. Из оставшихся фильтров все фильтры с точным номером порта, отличным от "80", удаляются.
4. Из оставшихся фильтров все фильтры без префикса "/docs" для пути, удаляются.
5. Из оставшихся фильтров выбирается и применяется фильтр с самым длинным префиксом пути. Если фильтр не найден, процесс выбора начинается снова с шага 1. Процесс повторяется со следующим дочерним доменом.

Дополнительные сведения о фильтре

Если в фильтре перед узлом стоит точка ("."), фильтруются только точные совпадения узла. Пример

• contoso.com (без точки) соответствует contoso.com, www.contoso.comи sub.www.contoso.com
• .www.contoso.com (с префиксом точки) соответствует только www.contoso.com

Вы можете использовать как стандартную, так и пользовательскую схему. Поддерживаются следующие стандартные схемы:

• about, blob, content, edge, cid, data, file, filesystem, ftp, gopher, http, https, javascript, mailto, ws и wss.

Любая другая схема рассматривается как пользовательскаясхема, однако допускается использование только шаблонов schema:* и schema://*. Пример

• "custom:*" или "custom://*" соответствуют "custom:app"
• "custom:app" или "custom://app" являются недопустимыми

схема и узел не чувствительны к регистру. Пример

• http://contoso.com фильтр соответствует HTTP://contoso.com, http://contoso.COMи http://contoso.com

путь и запрос чувствительны к регистру. Пример

• http://contoso.com/path?query=A фильтр не соответствует http://contoso.com/Path?query=A или http://contoso.com/path?Query=A. Он соответствует http://contoso.COM/path?query=A.

2. Формат сопоставления доменов (для политик, относящихся к сайту)

В некоторых политиках вместо формата на основе списка используется более простой формат сопоставления доменов.

Правила

• Домен без префикса с [*.] подстановочными знаками соответствует только точному домену.
  • Пример: contoso.com → соответствует только contoso.com
• [*.]domain.com соответствует домену и всем поддоменам.
  • Пример: [*.]contoso.com → соответствует contoso.com, www.contoso.com, sub.contoso.com

Политики, использующие этот формат

Этот формат сопоставления доменов используется политиками, зависящими от сайта, такими как
CookiesAllowedForUrls и CookiesBlockedForUrls.

Другие политики, использующие сопоставление URL-адреса или источника, следуют тому же [*.]domain.com шаблону.
Дополнительные сведения см. на страницах отдельных политик, так как они ссылаются на эту статью.

Лицензия на содержимое

Примечание.

Некоторые части этой страницы представляют собой измененные материалы, созданные и предоставленные на сайте Chromium.org. Их использование регулируется условиями, описанными в лицензии Creative Commons Attribution 4.0 International License. Исходная страница Chromium находится здесь.

Эта работа предоставляется в рамках международной лицензии Creative Commons Attribution 4.0 International License.

См. также

• Целевая страница Microsoft Edge Enterprise