Для перехода в режим конфигурации интерфейса командной строки используется команда:
Admin@nodename> configure
В режиме конфигурации приглашение командной строки выглядит следующим образом:
Admin@nodename#
Команды интерфейса командной строки имеют следующую структуру:
<action> <level> <filter> <configuration_info>
Где:
<action> — действие, которое необходимо выполнить;
<level> — уровень конфигурации, который соответствует разделам веб-интерфейса WAF;
<filter> — идентификатор объекта, к которому происходит обращение;
<configuration_info> — значение параметров, которые необходимо применить к объекту.
|
Наименование |
Описание |
|---|---|
|
<action> |
В режиме конфигурации доступны следующие действия:
Например, для просмотра информации о всех интерфейсах необходимо выполнить команду: Admin@nodename# show network interface
С использованием следующей команды производится переход на уровень network interface. Текущий уровень будет отображен под командной строкой:
После перехода на уровень network interface для отображения всех интерфейсов используется команда show без указания уровня:
Для возвращения c уровня network interface обратно на общий уровень режима конфигурации необходимо набрать команду end два раза:
Для возврата на самый верхний уровень конфигурации с помощью одной команды можно использовать команду top:
|
|
<level> |
Уровни в командной строке повторяют веб-интерфейс UserGate WAF:
|
|
<filter> |
Идентификатор объекта, к которому происходит обращение. Идентификация происходит по имени объекта. Если имеются объекты с одинаковыми именами или удобнее идентифицировать объект по другому параметру, то используются круглые скобки, в которых необходимо указать параметры (<configuration_info>). В результате будет найден объект, для которого совпали все поля, указанные в круглых скобках. Например, необходимо вывести информацию об интерфейсе port0 на другом узле кластера. Если использовать команду: Admin@nodename# show network interface adapter port0
Будет отображена информация об интерфейсе port0 текущего узла WAF. Чтобы отобразить информацию об интерфейсе port0 другого узла (например, с именем another_node), необходимо в скобках явно указать имя узла: Admin@nodename# show network interface adapter ( node-name another_nodename interface port0 )
Важно! Круглые скобки должны быть отделены пробелами с обеих сторон
|
|
Указание параметра с аргументом. Параметр — имя поля, для которого нужно установить аргумент. Аргумент может быть одиночным или множественным. Одиночный аргумент — значение, соответствующее параметру. Если строка содержит пробелы, то необходимо использовать кавычки. Например, необходимо создать IP-лист в библиотеке с названием New list: Admin@nodename# create libraries ip-list name "New list"
Множественные аргументы используются для установки множества значений какого-либо параметра; записываются в квадратных скобках и разделяются пробелами. Например, необходимо в список «New list» добавить IP-адреса: 10.10.0.2 и 10.10.0.3. Параметру ips необходимо задать аргумент [ 10.10.0.2 10.10.0.3]:
Важно! Квадратные скобки должны быть отделены пробелами с обеих сторон
|
Команды имеет следующую структуру:
Admin@nodename# execute <command-name>
Список команд раздела execute.
|
Параметр |
Описание |
|---|---|
|
cache |
Очистка кэша LDAP-записей:
|
|
check-geoip |
Проверка географической принадлежности IP-адреса по текущей базе GeoIP:
|
|
clear-cli-history |
Удаление истории команд интерфейса CLI. Можно удалить историю всех введенных команд интерфейса CLI или только команд в одном из режимов работы интерфейса (в режиме конфигурации или в режиме диагностики):
|
|
configurate-cluster |
Генерация секретного кода, необходимого для добавления нового узла в кластер конфигурации:
Где:
Важно! Для использования данной команды необходимо наличие лицензии на модуль Cluster
|
|
date |
Просмотр текущих даты и времени на узле:
|
|
dig |
Проверка записи DNS домена:
|
|
factory-reset |
Возврат устройства в первоначальное состояние:
Все данные и параметры будут утеряны. Версия ПО не изменится: сохранится версия, актуальная на момент запуска команды. Команда доступна в версии 7.4.1 и выше |
|
firewall |
Применение всех правил межсетевого экрана заново с обрывом текущих сессий:
|
|
license |
Команда регистрации продукта: Admin@nodename# execute license activate <pin-code>
В качестве <pin-code> укажите код активации продукта |
|
logs |
Команда разовой отправки журналов по имеющемуся правилу экспорта журналов:
|
|
netcheck |
Проверка доступности стороннего HTTP и HTTPS-сервера. Можно задать следующие параметры:
|
|
ping |
Проверка доступности узла. Можно задать следующие параметры:
|
|
reboot |
Перезагрузка устройства:
|
|
restore-mac |
Восстановление mac-адреса интерфейса:
|
|
shutdown |
Выключение устройства:
|
|
termination |
Закрытие сессий администраторов или пользователей:
Подробнее — в разделе «Настройка сессий администраторов» |
|
traceroute |
Трассировка соединения до определенного узла. Параметры команды:
|
|
update |
Обновление:
|
Часть представленных выше команд, кроме команд обновления, регистрации продукта, управления сессиями администраторов и очистки кэша, также доступны в режиме диагностики и мониторинга. Для их выполнения используется команда:
Admin@nodename> <command-name>
Импорт доступен в разделах «Настройки», «Политики сети», «Глобальный портал».
В разделах «Политики сети» (network-policy), «Глобальный портал» (global-portal) вы можете импортировать правила, написанные на UPL. При использовании импорта, все существующие правила будут заменены на указанные.
В разделе «Настройки» (settings) вы можете импортировать сертификаты. Подробнее — в разделе «Настройка сертификатов».
В разделе «Политики сети» (network-policy) вы можете импортировать правила межсетевого экрана и балансировки нагрузки. Подробнее — в разделах: «Настройка правил межсетевого экрана» и «Настройка балансировки нагрузки».
В разделе «Глобальный портал» (global-portal) вы можете импортировать правила reverse-прокси. Подробнее о создании правил — в разделе «Настройка правил reverse-прокси».
Команда для экспорта сертификатов.
Admin@nodename# export settings certificates <certificate-name>
Admin@nodename# export settings certificates <certificate-name> with-chain on
Вы можете экспортировать сертификаты, всю цепочку сертификатов и CSR:
Подробнее об управлении сертификатами — в разделе «Настройка сертификатов».