Общие положения (Описание)

UserGate NGFW имеет возможность управления через интерфейс командной строки — CLI (Command Line Interface). С помощью CLI администратор может выполнять команды диагностики и мониторинга, производить настройку устройства, а также перезагружать или выключать устройство.

CLI полезно использовать для диагностики сетевых проблем или в случае, когда доступ к веб-консоли утерян, например, некорректно указан IP-адрес интерфейса или ошибочно установлены параметры контроля доступа для зоны, запрещающие подключение к веб-интерфейсу.

Подключение к CLI можно выполнить через стандартные порты VGA/клавиатуры (при наличии таких портов на оборудовании NGFW), через последовательный порт или с помощью SSH по сети.

 CLI имеет два режима работы — режим диагностики и мониторинга, и режим конфигурации.

В режиме диагностики и мониторинга доступны команды, позволяющие посмотреть следующее:

• Доступность сетевых ресурсов.

• Статистику и информацию об интерфейсах.

• Информацию о записях ARP.

• Произвести отслеживание пакетов по установленным правилам.

• Мониторинг трафика.

• Информацию о маршрутах.

• Мониторинг состояния кластера.

• Мониторинг заблокированных СОВ IP-адресов.

• Отображение системной информации.

• Диагностику работы протоколов динамической маршрутизации.

• Информацию об авторизованных пользователях.

Приглашение командной строки в режиме диагностики и мониторинга имеет следующий вид:

Admin@NGFW> 

Настройка устройства производится в режиме конфигурации. 

Для перехода в режим конфигурации используется команда:

Admin@NGFW> configure

После перехода в режим конфигурации приглашение командной строки будет выглядеть следующим образом:

Admin@NGFW#

Для просмотра подсказки о текущих возможных значениях или для автодополнения команд в обоих режимах работы CLI необходимо нажать клавишу Tab. В подсказке могут использоваться следующие вспомогательные символы:

* — обязательное поле в командах create и ряде других команд;

+ — необязательное/вариативное поле;

> — вложенное поле, после его введения предыдущий список полей становится недоступным, появляется новый список полей, которые можно ввести.

Например:

Admin@NGFW# set network virtual-router default 
+ interfaces           List of network interfaces attached to this virtual router
> routes               List of static network routes

Для подключения к CLI с использованием монитора и клавиатуры необходимо выполнить следующие шаги:

Для подключения к CLI с использованием последовательного порта необходимо выполнить следующие шаги:

Для подключения к CLI по сети с использованием протокола SSH необходимо выполнить следующие шаги:

После успешной авторизации в CLI пользователь попадает в режим диагностики и мониторинга, появляется строка, ожидающая ввода команды.

Для просмотра доступных команд, текущих возможных значений команды или автодополнения необходимо использовать клавишу Tab.

Для отмены ввода текущей команды используется сочетание Ctrl + C; для просмотра истории команд — ↑, ↓.

Все команды интерфейса командной строки имеют следующую структуру:

<action> <level> <filter> <configuration_info>

где:

<action>: действие, которое необходимо выполнить.

<level>: уровень конфигурации; уровни соответствуют разделам веб-интерфейса NGFW.

<filter>: идентификатор объекта, к которому происходит обращение.

 <configuration_info>: значение параметров, которые необходимо применить к объекту <filter>.

CLI поддерживает ввод команды в несколько строк (многострочный ввод). Для перехода на новую строку необходимо добавить "\" в конце строки. Начиная со второй строки ввод "\" необязателен; чтобы завершить ввод необходимо ввести одну пустую строку:

Admin@nodename# set users user example \
... name username1
... enabled on
... groups [ "Default Group" ]
...
Admin@nodename#