Формат шаблонов URL для правил Chrome Enterprise
Для многих правил требуется указывать шаблоны URL, чтобы определить, к каким URL эти правила должны применяться. При указании таких шаблонов необходимо руководствоваться приведенными ниже правилами.
Допускаются указанные ниже форматы шаблонов (использовать их нужно без кавычек).
- “*”
- Этот шаблон соответствует любому URL с любой схемой, портом и путем.
- “scheme://domains:port/path”
- Поддерживаются схемы "http" и "https".
- Схему можно не указывать (опустив также и ее разделитель "://") или заменить подстановочным знаком ("*"), чтобы адрес соответствовал любой схеме.
- За доменом следует домен верхнего уровня, а перед ним может быть указан один или несколько субдоменов. В качестве альтернативы можно использовать хост, например "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, подстановочные знаки c адресами 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" будет соответствовать как "http://mysite.com:80/path", так и "https://mysite.com:443/path".
- Шаблон "[*.]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/myfile.html" является допустимым.
