Документация: ПО Факел — разрабатываемая версия
Веб-прокси¶
Обзор¶
Веб-прокси ПО Факел — служба кэширующего прокси-сервера HTTP. Она принимает запросы клиентов на адресах и портах маршрутизатора, заданных командами service webproxy listen-address, загружает запрошенные ресурсы, хранит копии ответов в кэше и может фильтровать запрашиваемые адреса (URL) по категориям. Если для адреса не задан параметр disable-transparent, веб-прокси на этом адресе работает в прозрачном режиме. В текущей версии ПО Факел транзитный трафик HTTP, который пересылает FVE, на веб-прокси не перенаправляется: прозрачный режим не перехватывает запросы узлов сети (см. Ограничения). В прозрачном режиме проверка подлинности пользователей через LDAP недоступна — применение такой конфигурации завершается ошибкой.
Фильтрация URL¶
Фильтрация URL использует базу блокируемых адресов, разделенную на категории. Категории, запросы к которым нужно блокировать или разрешать, задаются командами service webproxy url-filtering squidguard block-category и allow-category. Если базы выбранной категории нет на маршрутизаторе, при применении конфигурации выводится предупреждение DB of category <category> does not exist с предложением выполнить update webproxy blacklists. При применении конфигурации с фильтрацией URL также выводится предупреждение о том, что фильтрация URL устарела и будет удалена в будущих версиях ПО Факел.
База блокируемых адресов не входит в поставку: до первого обновления команда show webproxy blacklist categories ничего не выводит. Базу загружает команда update webproxy blacklists:
архив базы загружается из внешнего источника в интернете, поэтому маршрутизатору нужен доступ в интернет; если доступ есть только через экземпляр VRF (Виртуальная маршрутизация), укажите его параметром
vrf;перед загрузкой проверяется свободное место на диске: нужно более 100 МиБ, иначе команда завершается сообщением
Error: not enough disk space;если архив не удалось загрузить, команда выводит сообщение
Unable to downloadс адресом источника;предыдущая версия базы сохраняется в архив, локальные списки, созданные из конфигурации веб-прокси, сохраняются;
после обновления в журнал системы (
show log) записывается сообщениеwebproxy blacklist entries updatedс числом записей до и после обновления.
Обновление базы выполняется только командой update webproxy blacklists; выполняйте ее периодически, чтобы база оставалась актуальной.
Журналы¶
Веб-прокси записывает каждый обработанный запрос в журнал доступа. Команда show webproxy log выводит его постранично, включая архивные части журнала. Если журнала доступа нет, команда выводит сообщение No WebProxy log. После отключения записи командой service webproxy disable-access-log новые запросы в журнал не записываются, а команда show webproxy log продолжает выводить ранее записанные строки.
Команды show webproxy … доступны пользователю уровня «Оператор», команда update webproxy blacklists — только администратору (см. Уровни пользователей).
Команда restart webproxy перезапускает веб-прокси. Если веб-прокси не настроен, команда выводит сообщение Service WebProxy not configured. Команда доступна только пользователю уровня «Администратор» (см. Уровни пользователей).
Настройка¶
Веб-прокси настраивается в разделе service webproxy. Хотя бы один адрес listen-address обязателен, иначе проверка конфигурации завершается ошибкой; порт задается для адреса или общим параметром default-port (по умолчанию 3128). Остальные параметры:
кэш — размер кэша на диске и в памяти (
cache-size,mem-cache-size), минимальный и максимальный размер объектов (minimum-object-size,maximum-object-size), домены, которые не кэшируются (domain-noncache), и другие серверы кэша в иерархии (cache-peer; для каждого обязателен адрес). С родительским сервером кэша (типparent) веб-прокси передает запросы через него и не обращается к узлам назначения напрямую: если сервер кэша недоступен, клиент получает ответ с кодом HTTP 503;ограничения — блокируемые домены (
domain-block) и типы MIME ответов (reply-block-mime), максимальный размер ответа (reply-body-max-size), безопасные порты (safe-ports,ssl-safe-ports). Запрос к порту, которого нет в списке безопасных портов, и запрос CONNECT (туннель, например для HTTPS) к порту, которого нет в списке безопасных портов SSL, веб-прокси отклоняет с кодом HTTP 403;исходящие запросы — адрес отправителя (
outgoing-address, должен быть назначен интерфейсу маршрутизатора) и домен, который добавляется к именам узлов без точки (append-domain; например, с.lab.exampleзапросhttp://www/направляется узлуwww.lab.example);аутентификация пользователей через LDAP (
authentication) — метод обязателен; для LDAP обязательны сервер и базовое DN, аbind-dnиpasswordзадаются вместе (подробнее — ниже);фильтрация URL (
url-filtering squidguard) — категории, локальные списки разрешенных и блокируемых адресов, перенаправление, а также правила (rule) для групп источников (source-group) и периодов времени (time-period). Запросы клиента, который входит в группу источников правила, проверяются по спискам этого правила: общие локальные списки разделаurl-filtering squidguardк ним не применяются. Запросы остальных клиентов проверяются по общим спискам и категориям.
Аутентификация через LDAP. Веб-прокси запрашивает у клиента имя и пароль (заголовок Proxy-Authenticate с областью realm) и проверяет их на сервере LDAP server (порт port, по умолчанию 389; версия протокола version, по умолчанию 3). Без filter-expression веб-прокси составляет DN пользователя из атрибута username-attribute (по умолчанию uid), имени пользователя и base-dn (например, uid=alice,dc=example,dc=com) и выполняет вход на сервер LDAP с этим DN и паролем пользователя. С filter-expression веб-прокси сначала входит на сервер с bind-dn и password (без них — анонимно), ищет пользователя в base-dn по фильтру (%s в фильтре заменяется именем пользователя, например (uid=%s)), а затем входит с найденным DN и паролем пользователя. Параметр use-ssl включает шифрование соединения командой StartTLS на том же порту. Успешная проверка запоминается на время credentials-ttl (по умолчанию 60 минут): повторные запросы клиента в течение этого времени сервер LDAP не проверяет. Неверный пароль или отказ сервера — ответ с кодом HTTP 407.
В текущей версии ПО Факел часть параметров фильтрации URL, LDAP и соседей кэша не работает (см. Ограничения).
Список команд¶
Режим «Конфигурирование»¶
service webproxy append-domain <append-domain>¶
.lab.example запрос http://www/ направляется узлу www.lab.example.Синтаксис:
set service webproxy append-domain
<append-domain>delete service webproxy append-domain
<append-domain>show service webproxy append-domain
Аргументы:
<append-domain>— доменное имя с точкой в начале, например.example.com. Значение без точки в начале отклоняется с сообщениемMust start append-domain with a '.'.
Режим: «Конфигурирование».
service webproxy authentication children <children>¶
Синтаксис:
set service webproxy authentication children
<children>delete service webproxy authentication children
<children>show service webproxy authentication children
Аргументы:
<children>— количество процессов. Формат: целое число. Значение по умолчанию: 5.
Режим: «Конфигурирование».
service webproxy authentication credentials-ttl <credentials-ttl>¶
Синтаксис:
set service webproxy authentication credentials-ttl
<credentials-ttl>delete service webproxy authentication credentials-ttl
<credentials-ttl>show service webproxy authentication credentials-ttl
Аргументы:
<credentials-ttl>— время в минутах. Формат: целое число. Значение по умолчанию: 60.
Режим: «Конфигурирование».
service webproxy authentication ldap base-dn <base-dn>¶
Синтаксис:
set service webproxy authentication ldap base-dn
<base-dn>delete service webproxy authentication ldap base-dn
<base-dn>show service webproxy authentication ldap base-dn
Аргументы:
<base-dn>— базовое DN. Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap bind-dn <bind-dn>¶
filter-expression.bind-dn и password задаются вместе, иначе проверка конфигурации завершается ошибкой.Синтаксис:
set service webproxy authentication ldap bind-dn
<bind-dn>delete service webproxy authentication ldap bind-dn
<bind-dn>show service webproxy authentication ldap bind-dn
Аргументы:
<bind-dn>— DN. Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap filter-expression <filter-expression>¶
base-dn (%s в фильтре заменяется именем пользователя) и проверяет пароль для найденного DN.Синтаксис:
set service webproxy authentication ldap filter-expression
<filter-expression>delete service webproxy authentication ldap filter-expression
<filter-expression>show service webproxy authentication ldap filter-expression
Аргументы:
<filter-expression>— фильтр LDAP, например(uid=%s). Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap password <password>¶
bind-dn для входа на сервер LDAP.Синтаксис:
set service webproxy authentication ldap password
<password>delete service webproxy authentication ldap password
<password>show service webproxy authentication ldap password
Аргументы:
<password>— пароль. Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap persistent-connection¶
Синтаксис:
set service webproxy authentication ldap persistent-connection
delete service webproxy authentication ldap persistent-connection
show service webproxy authentication ldap persistent-connection
Режим: «Конфигурирование».
service webproxy authentication ldap port <port>¶
Синтаксис:
set service webproxy authentication ldap port
<port>delete service webproxy authentication ldap port
<port>show service webproxy authentication ldap port
Аргументы:
<port>— номер порта. Формат: целое число. Диапазон значений: от 1 до 65535. Значение по умолчанию: 389.
Режим: «Конфигурирование».
service webproxy authentication ldap server <server>¶
Синтаксис:
set service webproxy authentication ldap server
<server>delete service webproxy authentication ldap server
<server>show service webproxy authentication ldap server
Аргументы:
<server>— адрес сервера LDAP. Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap use-ssl¶
port (по умолчанию 389). Если сервер не поддерживает StartTLS, проверка пользователей завершается неудачей.Синтаксис:
set service webproxy authentication ldap use-ssl
delete service webproxy authentication ldap use-ssl
show service webproxy authentication ldap use-ssl
Режим: «Конфигурирование».
service webproxy authentication ldap username-attribute <username-attribute>¶
base-dn составляется DN пользователя (например, cn=alice,dc=example,dc=com для атрибута cn). Если параметр не задан, используется атрибут uid.Синтаксис:
set service webproxy authentication ldap username-attribute
<username-attribute>delete service webproxy authentication ldap username-attribute
<username-attribute>show service webproxy authentication ldap username-attribute
Аргументы:
<username-attribute>— имя атрибута. Формат: строка.
Режим: «Конфигурирование».
service webproxy authentication ldap version <version>¶
Синтаксис:
set service webproxy authentication ldap version
<version>delete service webproxy authentication ldap version
<version>show service webproxy authentication ldap version
Аргументы:
<version>— версия протокола. Возможные значения:2— LDAP версии 2;3— LDAP версии 3. Значение по умолчанию: 3.
Режим: «Конфигурирование».
service webproxy authentication method <method>¶
authentication, метод обязателен.Синтаксис:
set service webproxy authentication method
<method>delete service webproxy authentication method
<method>show service webproxy authentication method
Аргументы:
<method>— метод аутентификации. Возможные значения:ldap— протокол LDAP.
Режим: «Конфигурирование».
service webproxy authentication realm <realm>¶
Proxy-Authenticate; браузер показывает его в окне ввода имени и пароля.Синтаксис:
set service webproxy authentication realm
<realm>delete service webproxy authentication realm
<realm>show service webproxy authentication realm
Аргументы:
<realm>— имя области. Формат: строка.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer>¶
<cache-peer> в иерархии кэшей. Через родительский сервер кэша (тип parent) веб-прокси передает запросы, не обращаясь к узлам назначения напрямую.address), иначе проверка конфигурации завершается ошибкой.Синтаксис:
set service webproxy cache-peer
<cache-peer>delete service webproxy cache-peer
<cache-peer>show service webproxy cache-peer
Аргументы:
<cache-peer>— имя сервера кэша. Формат: доменное имя.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer> address <address>¶
<cache-peer>.Синтаксис:
set service webproxy cache-peer
<cache-peer>address<address>delete service webproxy cache-peer
<cache-peer>address<address>show service webproxy cache-peer
<cache-peer>address
Аргументы:
<cache-peer>— имя сервера кэша.<address>— адрес сервера. Формат: IPv4-адрес (x.x.x.x) или имя узла.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer> http-port <http-port>¶
<cache-peer>.Синтаксис:
set service webproxy cache-peer
<cache-peer>http-port<http-port>delete service webproxy cache-peer
<cache-peer>http-port<http-port>show service webproxy cache-peer
<cache-peer>http-port
Аргументы:
<cache-peer>— имя сервера кэша.<http-port>— номер порта. Формат: целое число. Диапазон значений: от 1025 до 65535. Значение по умолчанию: 3128.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer> icp-port <icp-port>¶
<cache-peer>.Синтаксис:
set service webproxy cache-peer
<cache-peer>icp-port<icp-port>delete service webproxy cache-peer
<cache-peer>icp-port<icp-port>show service webproxy cache-peer
<cache-peer>icp-port
Аргументы:
<cache-peer>— имя сервера кэша.<icp-port>— номер порта ICP сервера кэша. Формат: целое число. Диапазон значений: от 0 до 65535;0— запросы ICP серверу кэша не отправляются. Значение по умолчанию: 0.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer> options <options>¶
<cache-peer>.Синтаксис:
set service webproxy cache-peer
<cache-peer>options<options>delete service webproxy cache-peer
<cache-peer>options<options>show service webproxy cache-peer
<cache-peer>options
Аргументы:
<cache-peer>— имя сервера кэша.<options>— параметры сервера кэша через пробел; строка передается веб-прокси без изменений (например,no-query defaultилиproxy-only). Формат: строка. Значение по умолчанию: no-query default.
Режим: «Конфигурирование».
service webproxy cache-peer <cache-peer> type <type>¶
<cache-peer>.Синтаксис:
set service webproxy cache-peer
<cache-peer>type<type>delete service webproxy cache-peer
<cache-peer>type<type>show service webproxy cache-peer
<cache-peer>type
Аргументы:
<cache-peer>— имя сервера кэша.<type>— тип сервера кэша. Возможные значения:parent— родительский узел;sibling— соседний узел;multicast— участник группы рассылки. Значение по умолчанию: parent.
Режим: «Конфигурирование».
service webproxy cache-size <cache-size>¶
Синтаксис:
set service webproxy cache-size
<cache-size>delete service webproxy cache-size
<cache-size>show service webproxy cache-size
Аргументы:
<cache-size>— размер в мегабайтах. Формат: целое число;0отключает кэш на диске. Значение по умолчанию: 100.
Режим: «Конфигурирование».
service webproxy default-port <default-port>¶
Синтаксис:
set service webproxy default-port
<default-port>delete service webproxy default-port
<default-port>show service webproxy default-port
Аргументы:
<default-port>— номер порта. Формат: целое число. Диапазон значений: от 1025 до 65535. Значение по умолчанию: 3128.
Режим: «Конфигурирование».
service webproxy disable-access-log¶
show webproxy log продолжает их выводить.Синтаксис:
set service webproxy disable-access-log
delete service webproxy disable-access-log
show service webproxy disable-access-log
Режим: «Конфигурирование».
service webproxy domain-block <domain-block>¶
Синтаксис:
set service webproxy domain-block
<domain-block>delete service webproxy domain-block
<domain-block>show service webproxy domain-block
Аргументы:
<domain-block>— доменное имя. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy domain-noncache <domain-noncache>¶
Синтаксис:
set service webproxy domain-noncache
<domain-noncache>delete service webproxy domain-noncache
<domain-noncache>show service webproxy domain-noncache
Аргументы:
<domain-noncache>— доменное имя. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy listen-address <listen-address>¶
Синтаксис:
set service webproxy listen-address
<listen-address>delete service webproxy listen-address
<listen-address>show service webproxy listen-address
Аргументы:
<listen-address>— IPv4-адрес. Формат: IPv4-адрес (x.x.x.x).
Режим: «Конфигурирование».
service webproxy listen-address <listen-address> disable-transparent¶
<listen-address>.Синтаксис:
set service webproxy listen-address
<listen-address>disable-transparentdelete service webproxy listen-address
<listen-address>disable-transparentshow service webproxy listen-address
<listen-address>disable-transparent
Аргументы:
<listen-address>— IPv4-адрес веб-прокси.
Режим: «Конфигурирование».
service webproxy listen-address <listen-address> port <port>¶
<listen-address>.Синтаксис:
set service webproxy listen-address
<listen-address>port<port>delete service webproxy listen-address
<listen-address>port<port>show service webproxy listen-address
<listen-address>port
Аргументы:
<listen-address>— IPv4-адрес веб-прокси.<port>— номер порта. Формат: целое число. Диапазон значений: от 1025 до 65535.
Режим: «Конфигурирование».
service webproxy maximum-object-size <maximum-object-size>¶
Синтаксис:
set service webproxy maximum-object-size
<maximum-object-size>delete service webproxy maximum-object-size
<maximum-object-size>show service webproxy maximum-object-size
Аргументы:
<maximum-object-size>— размер в килобайтах. Формат: целое число.
Режим: «Конфигурирование».
service webproxy mem-cache-size <mem-cache-size>¶
Синтаксис:
set service webproxy mem-cache-size
<mem-cache-size>delete service webproxy mem-cache-size
<mem-cache-size>show service webproxy mem-cache-size
Аргументы:
<mem-cache-size>— размер в мегабайтах. Формат: целое число. Значение по умолчанию: 20.
Режим: «Конфигурирование».
service webproxy minimum-object-size <minimum-object-size>¶
Синтаксис:
set service webproxy minimum-object-size
<minimum-object-size>delete service webproxy minimum-object-size
<minimum-object-size>show service webproxy minimum-object-size
Аргументы:
<minimum-object-size>— размер в килобайтах. Формат: целое число.
Режим: «Конфигурирование».
service webproxy outgoing-address <outgoing-address>¶
Синтаксис:
set service webproxy outgoing-address
<outgoing-address>delete service webproxy outgoing-address
<outgoing-address>show service webproxy outgoing-address
Аргументы:
<outgoing-address>— IP-адрес. Формат: IPv4-адрес (x.x.x.x).
Режим: «Конфигурирование».
service webproxy reply-block-mime <reply-block-mime>¶
Синтаксис:
set service webproxy reply-block-mime
<reply-block-mime>delete service webproxy reply-block-mime
<reply-block-mime>show service webproxy reply-block-mime
Аргументы:
<reply-block-mime>— тип MIME. Формат: тип MIME из списка, который предлагает командная строка, напримерimage/gif. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy reply-body-max-size <reply-body-max-size>¶
Синтаксис:
set service webproxy reply-body-max-size
<reply-body-max-size>delete service webproxy reply-body-max-size
<reply-body-max-size>show service webproxy reply-body-max-size
Аргументы:
<reply-body-max-size>— размер в килобайтах. Формат: целое число.
Режим: «Конфигурирование».
service webproxy safe-ports <safe-ports>¶
Синтаксис:
set service webproxy safe-ports
<safe-ports>delete service webproxy safe-ports
<safe-ports>show service webproxy safe-ports
Аргументы:
<safe-ports>— номер порта. Формат: целое число. Диапазон значений: от 1 до 1024. По умолчанию разрешены порты 21, 70, 80, 210, 280, 443, 488, 591, 777, 873 и 1025–65535. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy ssl-safe-ports <ssl-safe-ports>¶
Синтаксис:
set service webproxy ssl-safe-ports
<ssl-safe-ports>delete service webproxy ssl-safe-ports
<ssl-safe-ports>show service webproxy ssl-safe-ports
Аргументы:
<ssl-safe-ports>— номер порта. Формат: целое число. Диапазон значений: от 1 до 65535. По умолчанию разрешен порт 443. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering disable¶
Синтаксис:
set service webproxy url-filtering disable
delete service webproxy url-filtering disable
show service webproxy url-filtering disable
Режим: «Конфигурирование».
service webproxy url-filtering squidguard allow-category <allow-category>¶
Синтаксис:
set service webproxy url-filtering squidguard allow-category
<allow-category>delete service webproxy url-filtering squidguard allow-category
<allow-category>show service webproxy url-filtering squidguard allow-category
Аргументы:
<allow-category>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard allow-ipaddr-url¶
Синтаксис:
set service webproxy url-filtering squidguard allow-ipaddr-url
delete service webproxy url-filtering squidguard allow-ipaddr-url
show service webproxy url-filtering squidguard allow-ipaddr-url
Режим: «Конфигурирование».
service webproxy url-filtering squidguard auto-update update-hour <update-hour>¶
Синтаксис:
set service webproxy url-filtering squidguard auto-update update-hour
<update-hour>delete service webproxy url-filtering squidguard auto-update update-hour
<update-hour>show service webproxy url-filtering squidguard auto-update update-hour
Аргументы:
<update-hour>— час. Формат: целое число. Диапазон значений: от 0 до 23. Значение по умолчанию: 0.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard block-category <block-category>¶
Синтаксис:
set service webproxy url-filtering squidguard block-category
<block-category>delete service webproxy url-filtering squidguard block-category
<block-category>show service webproxy url-filtering squidguard block-category
Аргументы:
<block-category>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard default-action <default-action>¶
Синтаксис:
set service webproxy url-filtering squidguard default-action
<default-action>delete service webproxy url-filtering squidguard default-action
<default-action>show service webproxy url-filtering squidguard default-action
Аргументы:
<default-action>— действие. Возможные значения:allow— разрешить;block— заблокировать.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard enable-safe-search¶
Синтаксис:
set service webproxy url-filtering squidguard enable-safe-search
delete service webproxy url-filtering squidguard enable-safe-search
show service webproxy url-filtering squidguard enable-safe-search
Режим: «Конфигурирование».
service webproxy url-filtering squidguard local-block <local-block>¶
Синтаксис:
set service webproxy url-filtering squidguard local-block
<local-block>delete service webproxy url-filtering squidguard local-block
<local-block>show service webproxy url-filtering squidguard local-block
Аргументы:
<local-block>— IPv4-адрес или доменное имя сайта. Формат: IPv4-адрес (x.x.x.x) или доменное имя. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard local-block-keyword <local-block-keyword>¶
Синтаксис:
set service webproxy url-filtering squidguard local-block-keyword
<local-block-keyword>delete service webproxy url-filtering squidguard local-block-keyword
<local-block-keyword>show service webproxy url-filtering squidguard local-block-keyword
Аргументы:
<local-block-keyword>— ключевое слово или регулярное выражение. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard local-block-url <local-block-url>¶
Синтаксис:
set service webproxy url-filtering squidguard local-block-url
<local-block-url>delete service webproxy url-filtering squidguard local-block-url
<local-block-url>show service webproxy url-filtering squidguard local-block-url
Аргументы:
<local-block-url>— URL без префиксаhttp://. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard local-ok <local-ok>¶
Синтаксис:
set service webproxy url-filtering squidguard local-ok
<local-ok>delete service webproxy url-filtering squidguard local-ok
<local-ok>show service webproxy url-filtering squidguard local-ok
Аргументы:
<local-ok>— IPv4-адрес или доменное имя сайта. Формат: IPv4-адрес (x.x.x.x) или доменное имя. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard local-ok-url <local-ok-url>¶
Синтаксис:
set service webproxy url-filtering squidguard local-ok-url
<local-ok-url>delete service webproxy url-filtering squidguard local-ok-url
<local-ok-url>show service webproxy url-filtering squidguard local-ok-url
Аргументы:
<local-ok-url>— URL без префиксаhttp://. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard log <log>¶
Синтаксис:
set service webproxy url-filtering squidguard log
<log>delete service webproxy url-filtering squidguard log
<log>show service webproxy url-filtering squidguard log
Аргументы:
<log>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard redirect-url <redirect-url>¶
Синтаксис:
set service webproxy url-filtering squidguard redirect-url
<redirect-url>delete service webproxy url-filtering squidguard redirect-url
<redirect-url>show service webproxy url-filtering squidguard redirect-url
Аргументы:
<redirect-url>— адрес страницы без указания схемы, напримерblock.example.com/blocked.html: перед адресом добавляетсяhttp://. Формат: строка. Значение по умолчанию: block.fakel.io.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule>¶
<rule> для группы источников.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>delete service webproxy url-filtering squidguard rule
<rule>show service webproxy url-filtering squidguard rule
Аргументы:
<rule>— номер правила. Формат: целое число. Диапазон значений: от 1 до 1024.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> allow-category <allow-category>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>allow-category<allow-category>delete service webproxy url-filtering squidguard rule
<rule>allow-category<allow-category>show service webproxy url-filtering squidguard rule
<rule>allow-category
Аргументы:
<rule>— номер правила фильтрации URL.<allow-category>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> allow-ipaddr-url¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>allow-ipaddr-urldelete service webproxy url-filtering squidguard rule
<rule>allow-ipaddr-urlshow service webproxy url-filtering squidguard rule
<rule>allow-ipaddr-url
Аргументы:
<rule>— номер правила фильтрации URL.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> block-category <block-category>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>block-category<block-category>delete service webproxy url-filtering squidguard rule
<rule>block-category<block-category>show service webproxy url-filtering squidguard rule
<rule>block-category
Аргументы:
<rule>— номер правила фильтрации URL.<block-category>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> default-action <default-action>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>default-action<default-action>delete service webproxy url-filtering squidguard rule
<rule>default-action<default-action>show service webproxy url-filtering squidguard rule
<rule>default-action
Аргументы:
<rule>— номер правила фильтрации URL.<default-action>— действие. Возможные значения:allow— разрешить;block— заблокировать.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> enable-safe-search¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>enable-safe-searchdelete service webproxy url-filtering squidguard rule
<rule>enable-safe-searchshow service webproxy url-filtering squidguard rule
<rule>enable-safe-search
Аргументы:
<rule>— номер правила фильтрации URL.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> local-block <local-block>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>local-block<local-block>delete service webproxy url-filtering squidguard rule
<rule>local-block<local-block>show service webproxy url-filtering squidguard rule
<rule>local-block
Аргументы:
<rule>— номер правила фильтрации URL.<local-block>— IPv4-адрес или доменное имя сайта. Формат: IPv4-адрес (x.x.x.x) или доменное имя. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> local-block-keyword <local-block-keyword>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>local-block-keyword<local-block-keyword>delete service webproxy url-filtering squidguard rule
<rule>local-block-keyword<local-block-keyword>show service webproxy url-filtering squidguard rule
<rule>local-block-keyword
Аргументы:
<rule>— номер правила фильтрации URL.<local-block-keyword>— ключевое слово или регулярное выражение. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> local-block-url <local-block-url>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>local-block-url<local-block-url>delete service webproxy url-filtering squidguard rule
<rule>local-block-url<local-block-url>show service webproxy url-filtering squidguard rule
<rule>local-block-url
Аргументы:
<rule>— номер правила фильтрации URL.<local-block-url>— URL без префиксаhttp://. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> local-ok <local-ok>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>local-ok<local-ok>delete service webproxy url-filtering squidguard rule
<rule>local-ok<local-ok>show service webproxy url-filtering squidguard rule
<rule>local-ok
Аргументы:
<rule>— номер правила фильтрации URL.<local-ok>— IPv4-адрес или доменное имя сайта. Формат: IPv4-адрес (x.x.x.x) или доменное имя. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> local-ok-url <local-ok-url>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>local-ok-url<local-ok-url>delete service webproxy url-filtering squidguard rule
<rule>local-ok-url<local-ok-url>show service webproxy url-filtering squidguard rule
<rule>local-ok-url
Аргументы:
<rule>— номер правила фильтрации URL.<local-ok-url>— URL без префиксаhttp://. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> log <log>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>log<log>delete service webproxy url-filtering squidguard rule
<rule>log<log>show service webproxy url-filtering squidguard rule
<rule>log
Аргументы:
<rule>— номер правила фильтрации URL.<log>— имя категории. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> redirect-url <redirect-url>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>redirect-url<redirect-url>delete service webproxy url-filtering squidguard rule
<rule>redirect-url<redirect-url>show service webproxy url-filtering squidguard rule
<rule>redirect-url
Аргументы:
<rule>— номер правила фильтрации URL.<redirect-url>— URL. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> source-group <source-group>¶
<rule>. Запросы клиентов группы проверяются по спискам этого правила; общие локальные списки к ним не применяются.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>source-group<source-group>delete service webproxy url-filtering squidguard rule
<rule>source-group<source-group>show service webproxy url-filtering squidguard rule
<rule>source-group
Аргументы:
<rule>— номер правила фильтрации URL.<source-group>— имя группы источников. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard rule <rule> time-period <time-period>¶
<rule>.Синтаксис:
set service webproxy url-filtering squidguard rule
<rule>time-period<time-period>delete service webproxy url-filtering squidguard rule
<rule>time-period<time-period>show service webproxy url-filtering squidguard rule
<rule>time-period
Аргументы:
<rule>— номер правила фильтрации URL.<time-period>— имя периода времени. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group>¶
<source-group> для правил фильтрации URL.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>delete service webproxy url-filtering squidguard source-group
<source-group>show service webproxy url-filtering squidguard source-group
Аргументы:
<source-group>— имя группы источников. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> address <address>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>address<address>delete service webproxy url-filtering squidguard source-group
<source-group>address<address>show service webproxy url-filtering squidguard source-group
<source-group>address
Аргументы:
<source-group>— имя группы источников.<address>— адрес. Формат: IPv4-адрес (x.x.x.x), IPv4-префикс (x.x.x.x/x) или диапазон IPv4-адресов. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> description <description>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>description<description>delete service webproxy url-filtering squidguard source-group
<source-group>description<description>show service webproxy url-filtering squidguard source-group
<source-group>description
Аргументы:
<source-group>— имя группы источников.<description>— описание. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> domain <domain>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>domain<domain>delete service webproxy url-filtering squidguard source-group
<source-group>domain<domain>show service webproxy url-filtering squidguard source-group
<source-group>domain
Аргументы:
<source-group>— имя группы источников.<domain>— доменное имя. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> ldap-ip-search <ldap-ip-search>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>ldap-ip-search<ldap-ip-search>delete service webproxy url-filtering squidguard source-group
<source-group>ldap-ip-search<ldap-ip-search>show service webproxy url-filtering squidguard source-group
<source-group>ldap-ip-search
Аргументы:
<source-group>— имя группы источников.<ldap-ip-search>— выражение поиска LDAP. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> ldap-user-search <ldap-user-search>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>ldap-user-search<ldap-user-search>delete service webproxy url-filtering squidguard source-group
<source-group>ldap-user-search<ldap-user-search>show service webproxy url-filtering squidguard source-group
<source-group>ldap-user-search
Аргументы:
<source-group>— имя группы источников.<ldap-user-search>— выражение поиска LDAP. Формат: строка. Можно задать несколько значений.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard source-group <source-group> user <user>¶
<source-group>.Синтаксис:
set service webproxy url-filtering squidguard source-group
<source-group>user<user>delete service webproxy url-filtering squidguard source-group
<source-group>user<user>show service webproxy url-filtering squidguard source-group
<source-group>user
Аргументы:
<source-group>— имя группы источников.<user>— имя пользователя. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard time-period <time-period>¶
<time-period> для правил фильтрации URL.Синтаксис:
set service webproxy url-filtering squidguard time-period
<time-period>delete service webproxy url-filtering squidguard time-period
<time-period>show service webproxy url-filtering squidguard time-period
Аргументы:
<time-period>— имя периода времени. Формат: строка.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard time-period <time-period> days <days>¶
<time-period>.Синтаксис:
set service webproxy url-filtering squidguard time-period
<time-period>days<days>delete service webproxy url-filtering squidguard time-period
<time-period>days<days>show service webproxy url-filtering squidguard time-period
<time-period>days
Аргументы:
<time-period>— имя периода времени.<days>— дни недели. Возможные значения:Sun— воскресенье;Mon— понедельник;Tue— вторник;Wed— среда;Thu— четверг;Fri— пятница;Sat— суббота;weekdays— с понедельника по пятницу;weekend— суббота и воскресенье;all— все дни недели.
Режим: «Конфигурирование».
service webproxy url-filtering squidguard time-period <time-period> days <days> time <time>¶
<days> периода <time-period>.Синтаксис:
set service webproxy url-filtering squidguard time-period
<time-period>days<days>time<time>delete service webproxy url-filtering squidguard time-period
<time-period>days<days>time<time>show service webproxy url-filtering squidguard time-period
<time-period>days<days>time
Аргументы:
<time-period>— имя периода времени.<days>— дни недели.<time>— интервал времени. Формат:hh:mm - hh:mm(24-часовой формат).
Режим: «Конфигурирование».
service webproxy url-filtering squidguard time-period <time-period> description <description>¶
<time-period>.Синтаксис:
set service webproxy url-filtering squidguard time-period
<time-period>description<description>delete service webproxy url-filtering squidguard time-period
<time-period>description<description>show service webproxy url-filtering squidguard time-period
<time-period>description
Аргументы:
<time-period>— имя периода времени.<description>— описание. Формат: строка.
Режим: «Конфигурирование».
Режим «Администрирование»¶
webproxy blacklist categories¶
Синтаксис:
show webproxy blacklist categories
Режим: «Администрирование».
webproxy log¶
No WebProxy log.Синтаксис:
show webproxy log
Режим: «Администрирование».
webproxy update-log¶
Update log not found. В текущей версии ПО Факел команда update webproxy blacklists не ведет этот журнал, поэтому команда всегда выводит Update log not found; сведения об обновлении записываются в журнал системы (см. Ограничения).Синтаксис:
show webproxy update-log
Режим: «Администрирование».
update webproxy blacklists¶
Синтаксис:
update webproxy blacklists
Режим: «Администрирование».
update webproxy blacklists vrf <vrf>¶
Синтаксис:
update webproxy blacklists vrf
<vrf>
Аргументы:
<vrf>— имя экземпляра VRF. Формат: строка.
Режим: «Администрирование».
restart webproxy¶
Service WebProxy not configured.Синтаксис:
restart webproxy
Режим: «Администрирование».
Уровень привилегий: «Администратор».