Формат шаблонов URL для правил Chrome Enterprise
Для многих правил требуется указывать шаблоны URL, чтобы определить, к каким URL эти правила должны применяться. При указании таких шаблонов необходимо руководствоваться приведенными ниже правилами.
Если правило предполагает указание источников или относится к категории Настройки контента, пути URL недопустимы.
Допускаются указанные ниже форматы шаблонов (использовать их нужно без кавычек).
- “*”
- Этот шаблон соответствует любому URL с любой схемой, портом и путем.
- “scheme://domains:port/path”
- Поддерживаются схемы http, https, file, chrome-extension, chrome-search, chrome, chrome-untrusted, devtools и isolated-app.
- Чтобы адрес соответствовал любой схеме, ее можно вообще не указывать (опустив также разделитель "://") или заменить подстановочным знаком ("*").
- За доменом следует домен верхнего уровня, а перед ним может быть указан один или несколько субдоменов. В качестве альтернативы можно использовать хост, например localhost.
- Чтобы правило применялось к домену или любому из его субдоменов, можно добавить подстановочный знак "[*.]" перед доменом. При этом домен может быть субдоменом любого уровня. Обратите внимание, что подстановочный знак "[*.]" ставится непосредственно перед доменом или субдоменом. После этого знака точку ставить не нужно.
- Если домен указан без префикса в виде подстановочного знака, правило будет применяться только к этому домену, а субдомены учитываться не будут.
- В качестве номера порта можно указать любое число в диапазоне от 0 до 65535. Порт можно не указывать (опустив также разделитель ":") или заменить подстановочным знаком ("*"). В последне случае правило будет действовать для любого порта.
- Чтобы адрес соответствовал любому пути, путь можно вообще не указывать (опустив и разделитель "/") или заменить подстановочным знаком ("*").
- Подстановочные знаки нельзя использовать для частичного сопоставления схемы, домена, хоста, порта или пути.
- Использование нескольких подстановочных знаков в одном шаблоне, например "*://google.com:*/*", поддерживается.
- “scheme://a.b.c.d:port/path”
- Вместо домена можно использовать адрес IPv4 в формате "a.b.c.d". Правила для схем, портов и путей аналогичны тем, которые применяются к URL домена, но для IP-адресов нельзя использовать подстановочные знаки.
- “scheme://[a:b:c:d:e:f:g:h]:port/path”
- Также можно использовать адрес IPv6 в формате "[a:b:c:d:e:f:g:h]". Квадратные скобки при этом обязательны. Как и в случае с адресами IPv4, для адресов IPv6 подстановочные знаки не поддерживаются. Правила для схем, портов и путей аналогичны тем, что применяются для URL доменов и адресов IPv4.
- “file://path”
- Если используется схема file, путь должен начинаться с символа "/", то есть адрес "file://dir/myfile.html" является недопустимым. Верным будет шаблон "file:///dir/myfile.html" (с тремя символами косой черты после "file:"). Единственно допустимым URL файла с подстановочным знаком является "file:///*". Он соответствует любому действительному URL файла.
- Доменная часть URL файла должна быть пустой. Она будет соответствовать любому домену или порту localhost. Например, шаблон "file:///file.html" будет соответствовать адресам "file://localhost/file.html" и "file://mysite.com/file.html".
- Порты использовать нельзя.
Недопустимые шаблоны
- Шаблон [*.].mysite.com недействителен из-за точки перед "mysite".
- Шаблон "file://mysite.com/somefile.html" является недопустимым, так как в URL файла нельзя указывать домен.
- Шаблон "file://somefile.html" является недопустимым, так как в нем только два символа косой черты ("/") вместо необходимых трех.
- Шаблон "file://somefile.*" недопустим. Единственно верным URL файла с подстановочным знаком является "file:///*".
- Шаблон "[*.]127.0.0.1" недействителен, так как использование субдоменов и подстановочного знака с IP-адресами не поддерживается.
- Для правил, предполагающих указание источников или относящихся к категории Настройки контента, шаблоны "*://mysite.com:*/path" и "https://[::1]:8080/myfile.html" недопустимы, поскольку включают часть "/path".
Примеры шаблонов
- Шаблон "*://mysite.com:*" будет соответствовать адресам http://mysite.com:80 и https://mysite.com:443.
- Шаблон "[*.]mysite.com" будет соответствовать как mysite.com, так и subdomain.mysite.com, а также любой схеме, порту и пути.
- Шаблон "[*.]oogle.com" не будет соответствовать google.com, но будет соответствовать subdomain.oogle.com.
- Шаблон "file:///foo/bar.html" будет соответствовать адресам file://localhost/foo/bar.html и file://mysite.com/foo/bar.html.
- Шаблон "file:///*" является допустимым и будет соответствовать любому URL, начинающемуся с "file://".
- Схемы и порты можно использовать с IP-адресами. Например, шаблон "https://[::1]:8080" является допустимым.