Документация: ПО Факел — разрабатываемая версия

Веб-прокси

Обзор

Веб-прокси ПО Факел — служба кэширующего прокси-сервера 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>

Описание:
Задает домен по умолчанию, который добавляется к именам узлов без точки в запрашиваемых адресах (URL). Например, с доменом .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>

Описание:
Задает время в минутах, в течение которого веб-прокси хранит результат успешной проверки имени и пароля пользователя: повторные запросы клиента с теми же данными в это время на сервере LDAP не проверяются.

Синтаксис:

  • 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>

Описание:
Задает базовое DN для поиска в каталоге LDAP.
Параметр обязателен для аутентификации через LDAP.

Синтаксис:

  • 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>

Описание:
Задает DN, с которым веб-прокси входит на сервер LDAP перед поиском пользователя по фильтру 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>

Описание:
Задает фильтр поиска пользователя в каталоге LDAP. Если фильтр задан, веб-прокси ищет пользователя в 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>

Описание:
Задает пароль DN 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

Описание:
Включает постоянное соединение с сервером LDAP.

Синтаксис:

  • 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>

Описание:
Задает номер порта сервера LDAP.

Синтаксис:

  • 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>

Описание:
Задает сервер LDAP.
Параметр обязателен для аутентификации через LDAP.

Синтаксис:

  • 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

Описание:
Включает шифрование соединения с сервером LDAP командой StartTLS на порту 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>

Описание:
Задает атрибут LDAP, из которого вместе с именем пользователя и 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>

Описание:
Задает версию протокола LDAP.

Синтаксис:

  • 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>

Описание:
Задает имя области аутентификации (realm), например «My Company proxy server». Веб-прокси передает его клиенту в заголовке 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>

Описание:
Задает имя узла или IP-адрес сервера кэша <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>

Описание:
Задает порт ICP сервера кэша <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

Описание:
Отключает запись журнала доступа HTTP. Новые запросы в журнал не записываются; ранее записанные строки остаются, и команда 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>

Описание:
Задает доменное имя, доступ к которому блокируется. На запрос к такому домену клиент получает ответ с кодом HTTP 403.

Синтаксис:

  • 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>

Описание:
Задает IPv4-адрес, на котором веб-прокси принимает запросы.
Необходимо задать хотя бы один адрес, иначе проверка конфигурации завершается ошибкой.

Синтаксис:

  • 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-transparent

  • delete service webproxy listen-address <listen-address> disable-transparent

  • show 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>

Описание:
Задает IP-адрес, с которого веб-прокси отправляет исходящие запросы.
Адрес должен быть назначен интерфейсу маршрутизатора, иначе проверка конфигурации завершается ошибкой.

Синтаксис:

  • 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>

Описание:
Задает тип MIME ответов, которые блокируются. На такой ответ клиент получает ответ с кодом HTTP 403.

Синтаксис:

  • 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>

Описание:
Задает максимальный размер тела ответа в килобайтах. На запрос ответа большего размера клиент получает ответ с кодом HTTP 403.

Синтаксис:

  • 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>

Описание:
Добавляет порт к списку безопасных портов. Запрос к порту, которого нет в этом списке, веб-прокси отклоняет с кодом HTTP 403.

Синтаксис:

  • 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>

Описание:
Добавляет порт к списку безопасных портов SSL. Запрос CONNECT (туннель, например для HTTPS) к порту, которого нет в этом списке, веб-прокси отклоняет с кодом HTTP 403.

Синтаксис:

  • 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

Описание:
Отключает фильтрацию URL.

Синтаксис:

  • 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

Описание:
Разрешает адреса URL, заданные IP-адресом. Без этого параметра запросы, в которых вместо доменного имени указан IP-адрес, перенаправляются как заблокированные.

Синтаксис:

  • 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>

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

Синтаксис:

  • 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 local-block <local-block>

Описание:
Задает IP-адрес или доменное имя сайта, доступ к которому блокируется.

Синтаксис:

  • 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>

Описание:
Задает адрес 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>

Описание:
Задает IP-адрес или доменное имя сайта, доступ к которому разрешается.

Синтаксис:

  • 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>

Описание:
Задает адрес 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>

Описание:
Задает 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>

Описание:
Создает правило фильтрации URL <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

Описание:
Разрешает адреса URL, заданные IP-адресом в правиле <rule>.

Синтаксис:

  • set service webproxy url-filtering squidguard rule <rule> allow-ipaddr-url

  • delete service webproxy url-filtering squidguard rule <rule> allow-ipaddr-url

  • show 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>

Описание:
Задает действие по умолчанию фильтрации URL в правиле <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> local-block <local-block>

Описание:
Задает IP-адрес или доменное имя сайта, доступ к которому блокируется в правиле <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>

Описание:
Задает адрес 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>

Описание:
Задает IP-адрес или доменное имя сайта, доступ к которому разрешается в правиле <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>

Описание:
Задает адрес 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>

Описание:
Задает 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> 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>

Описание:
Обновляет базу блокируемых адресов веб-прокси, используя для загрузки указанный экземпляр VRF.

Синтаксис:

  • update webproxy blacklists vrf <vrf>

Аргументы:

  • <vrf> — имя экземпляра VRF. Формат: строка.

Режим: «Администрирование».


restart webproxy

Описание:
Перезапускает веб-прокси. Если веб-прокси не настроен, команда ничего не перезапускает и выводит сообщение Service WebProxy not configured.

Синтаксис:

  • restart webproxy

Режим: «Администрирование».

Уровень привилегий: «Администратор».