Работа со шлюзами

Данный раздел описывает процесс работы со шлюзами в системе. Работа осуществляется в разделе Агенты → Шлюзы веб-интерфейса системы.

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

О шлюзах

Шлюз представляет собой промежуточный уровень в сети между агентами, установленными на конечных устройствах, и центральным кластером.

Шлюзы предназначены для управления потоками данных между агентами и центральным кластером. Они позволяют настраивать маршрутизацию, агрегацию и фильтрацию данных.

Подробности подключения агента к кластеру с использованием шлюзов описаны в разделе Подключение агента к системе.

Интерфейс раздела

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

Кнопка Создать () позволяет создать новый шлюз.
Кнопка позволяет обновить список шлюзов.
Кнопка позволяет удалить выбранные шлюзы.
Поле Поиск предназначено для быстрого поиска шлюзов в отображаемом списке по названию и пространству.
Кнопка Фильтр () позволяет открыть в правой части рабочей области панель для настройки фильтрации списка шлюзов.

В рабочей области раздела отображается таблица имеющихся шлюзов. Таблица содержит следующие столбцы:

Название — название шлюза, используемое для его идентификации.
Статус — текущий статус шлюза:
- В очереди — шлюз находится в очереди на запуск.
- Запускается — шлюз находится в процессе запуска.
- Запущен — шлюз запущен и готов к подключениям.
- Останавливается — шлюз находится в процессе остановки.
- Остановлен — шлюз остановлен и недоступен для взаимодействия.
- Ошибка — ошибка размещения шлюза в пространстве.
- Неизвестно — неизвестное состояние шлюза.
Пространство — название подключения к пространству, в котором создан шлюз.

При работе с таблицей шлюзов доступны следующие операции:

Поиск шлюзов по полям Название и Пространство.
Фильтрация шлюзов по полю Пространство. Пространство выбирается из выпадающего списка.
Сортировка шлюзов по полям Название и Пространство.
Настройка отображения таблицы шлюзов.

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

Работа со шлюзом

Доступные операции над шлюзом:

Создание шлюза
Просмотр шлюза
Изменение шлюза
Удаление шлюза
Запуск шлюза
Остановка шлюза

Создание шлюза

Чтобы создать шлюз:

Перейдите в раздел Агенты → Шлюзы. Система отобразит сведения об имеющихся шлюзах.
Нажмите на кнопку Создать () на панели инструментов. Система отобразит окно создания шлюза.
Задайте название шлюза. Название шлюза должно быть уникальным в рамках системы.
Особенности названия шлюза
Название может содержать только следующие символы:
- заглавные латинские буквы (A—Z);
- строчные латинские буквы (a—z);
- заглавные кириллические буквы (А—Я);
- строчные кириллические буквы (а—я);
- цифры (0—9);
- пробел — не может быть первым или последним символом;
- специальные символы:
  
  #$%&'()=+?@[]{}~`"^,.;
Максимальная длина названия — 255 символов.
Выберите подключение к пространству, в котором необходимо создать шлюз.
Выберите организацию, к которой должен принадлежать шлюз.

Укажите ресурсы, выделяемые для работы шлюза:

CPU — количество ядер процессора. Допустимый диапазон: 1—48.

По умолчанию установлено 2 ядра.
RAM — объем оперативной памяти в МБ. Допустимый диапазон: 256 — 16 384.

По умолчанию установлен объем в 4096 МБ.

Значения можно вводить вручную или задавать с помощью кнопок minus и plus .

При наведении курсора на иконку question над соответствующим полем отображается подсказка с количеством доступных ресурсов в каждом узле кластера выбранного пространства.

Выберите узел кластера выбранного пространства, на котором необходимо создать шлюз.

По умолчанию выбран вариант Автоматически, при котором узел кластера определяется случайным образом.
Укажите IP- или FQDN-адрес для подключения к шлюзу.
Особенности задания адресов для шлюза
Для подключения к шлюзу необходимо использовать адрес узла кластера, где создается шлюз. Так, например:
- Если шлюз создается в основном экземпляре системы, то используйте IP-адрес любого узла центрального кластера.
- Если шлюз создается в сателлите, используйте IP-адреса любого узла кластера сателлита.
FQDN-адрес можно использовать, только если в инфраструктуре существует DNS-сервер и администратор настроил прямую зону (forward zone). Проверить, настроена ли такая зона, можно с помощью утилиты nslookup:
nslookup <domain_name>
Здесь:
- <domain_name> — доменное имя.
Обратные DNS-запросы для определения FQDN-адресов по IP-адресам возможны, если на DNS-сервере настроена обратная зона (reverse zone). В ней хранятся записи, сопоставляющие IP-адреса с доменными именами. Проверить, настроена ли такая зона, можно также с помощью утилиты nslookup:
nslookup <IP_address>
Здесь:
- <IP_address> — IP-адрес узла.
Если обратная зона не настроена, свяжитесь с сетевым администратором.

Если ваш компьютер имеет доступ к кластеру с установленным файлом конфигурации kubeconfig, вы можете получить сведения обо всех IP-адресах узлов кластера. Для сбора IP-адресов всех узлов в кластере и их вывода в виде строки используйте команду:
kubectl get node -o json --output='jsonpath={.items[*].status.addresses[0].address}'
Укажите порт для подключения к шлюзу. Допустимые значения: 30000—32767.

Порт должен быть уникальным в рамках инсталляции системы.

Задайте в поле Размер стрима для событий ИБ максимальный размер буфера в МБ для накопления и хранения событий ИБ.

Рекомендации по заданию размера буфера

Максимальный размер буфера следует задавать так, чтобы 80% от него составлял эффективный размер буфера.

Эффективный размер можно рассчитать по следующей формуле: B=(EPS_peak–EPS_avg)*T*S.

Здесь:

B — эффективный размер буфера.
EPS_peak — пиковое количество поступающих событий в секунду.
EPS_avg — среднее количество поступающих событий в секунду.
T — продолжительность времени в секундах, в течение которого наблюдается EPS_peak.
S — размер одного события.

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

Рассмотрим в качестве примера следующую конфигурацию:

EPS_peak: 5000.
EPS_avg: 3000.
T: 600 секунд (10 минут).
S: 4 КБ.

В таком случае эффективный размер буфера по формуле выше составит 4 800 000 КБ (4800 МБ).

Тогда размер стрима для событий ИБ, рекомендуемый для пиковой нагрузки, будет равен 6000 МБ.

Настройте уровни логирования шлюза.
Особенности настройки уровней логирования для шлюза
Уровни логирования настраиваются отдельно для бизнес-логики шлюза и запускаемого в рамках него NATS-сервера.
1. Для шлюза выберите из выпадающего списка уровень логирования. Доступные уровни:
  
  Error — записываются критические ошибки, которые могут влиять на работоспособность шлюза или препятствовать его работе.
  
  Warn — записываются предупреждения о потенциальных проблемах, которые могут требовать внимания, но не являются критическими. Также содержит в себе все логи уровня Error.
  
  Info — записывается общая информация о работе и состоянии шлюза. Также содержит в себе все логи уровня Warn.
  
  Debug — записываются подробные отладочные сообщения, которые могут использоваться для диагностики и устранения проблем со шлюзом. Также содержит в себе все логи уровня Info.
  
  Trace — самый подробный уровень логирования, предоставляющий внутреннюю информацию о каждом шаге работы шлюза. Также содержит в себе все логи уровня Debug.
2. Для NATS-сервера по умолчанию логируются все сообщения уровней Error, Warn и Info. При необходимости задайте дополнительные уровни:
  
  Установите флажок Включить Debug-сообщения в NATS шлюза, если для NATS-сервера требуется логировать сообщения уровня Debug.
  
  Флажок доступен, если для обертки выбран уровень логирования Debug или Trace.
  
  Установите флажок Включить Trace-сообщения в NATS шлюза, если для NATS-сервер требуется логировать сообщения уровня Trace.
  
  Флажок доступен, если для обертки выбран уровень логирования Trace.
По умолчанию новые логи накапливаются в буфере и с определенной периодичностью сохраняются на диск. Чтобы настроить данную периодичность, укажите интервал записи данных в следующем формате: <number><unit>. Здесь:
- <number> — количество временных единиц в интервале.
- <unit> — единица измерения. Доступные значения:
  
  m — минуты;
  
  s — секунды.
Максимальный допустимый интервал — 1 час (60m или 3600s).

По умолчанию установлен интервал в 2 минуты (2m).
Если же требуется сохранять новые логи на диск сразу при их появлении, установите флажок Сразу записывать данные на диск. В этом случае задание интервала записи данных станет недоступно.

Установка данного флажка может привести к повышенной нагрузке на шлюз.
При необходимости введите описание шлюза.

При необходимости шифрования потока данных между агентом и шлюзом через TLS установите переключатель Включить TLS в активное положение.

При включении TLS необходимо выбрать секрет типа Контейнер PKCS, хранящий данные сертификата TLS.

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

Все шлюзы в системе должны быть либо с TLS, либо без TLS. В ситуациях, когда для одной части шлюзов настроено TLS-шифрование, а для другой — нет, корректное подключение агентов к кластеру не гарантируется.

Нажмите на кнопку Создать. Система создаст шлюз и отобразит соответствующее уведомление. Созданный шлюз отобразится в списке раздела и будет запущен.

Просмотр шлюза

Чтобы просмотреть шлюз:

Перейдите в раздел Агенты → Шлюзы. Система отобразит сведения об имеющихся шлюзах.
Нажмите на строку шлюза в списке. Система отобразит в правой части экрана карточку этого шлюза с подробной информацией о нем.

Название шлюза отображается в верхней части карточки.

Карточка содержит следующие сведения о шлюзе:

ID шлюза — уникальный идентификационный код шлюза, генерируемый автоматически при его создании.
Название — имя шлюза, используемое для его идентификации в системе.
Описание — краткое описание функциональности шлюза.
Статус — текущий статус шлюза:
- В очереди;
- Запускается;
- Запущен;
- Останавливается;
- Остановлен;
- Ошибка;
- Неизвестно.
IP-адрес или FQDN — IP- или FQDN-адрес для подключения к шлюзу.
Порт — порт для подключения шлюза к другим системам.
Пространство — название подключения к пространству, в котором создан шлюз.
Организация — организация, к которой принадлежит шлюз.
CPU — количество ядер процессора, выделенных для шлюза.
RAM — объем оперативной памяти в МБ, выделенной для шлюза.
Размер стрима для событий ИБ — максимальный размер буфера для хранения событий ИБ. Если размер буфера меньше 1024 МБ, то значение отображается в МБ, иначе — в ГБ.
Уровень логирования — уровень логирования шлюза:
- Error — записываются критические ошибки, которые могут влиять на работоспособность шлюза или препятствовать его работе.
- Warn — записываются предупреждения о потенциальных проблемах, которые могут требовать внимания, но не являются критическими. Также содержит в себе все логи уровня Error.
- Info — записывается общая информация о работе и состоянии шлюза. Также содержит в себе все логи уровня Warn.
- Debug — записываются подробные отладочные сообщения, которые могут использоваться для диагностики и устранения проблем со шлюзом. Также содержит в себе все логи уровня Info.
- Trace — самый подробный уровень логирования, предоставляющий внутреннюю информацию о каждом шаге работы шлюза. Также содержит в себе все логи уровня Debug.
Интервал записи данных на диск — временной интервал, в течение которого новые логи накапливаются в буфере и затем сохраняются на диск.
Шифрование — текущий статус шифрования через TLS. Доступные значения:
- Включено — шифрование соединения к шлюзу через TLS включено.
- Выключено — шифрование соединения к шлюзу через TLS выключено.
Секрет — секрет, использующийся для TLS-шифрования.

Чтобы просмотреть секрет на странице раздела Секреты, нажмите на кнопку Открыть.

Изменение шлюза

Вы можете изменить шлюз следующими способами:

через меню действий в карточке шлюза;
через изменение полей в карточке шлюза.

При изменении следующих настроек шлюз будет автоматически перезапущен:

CPU;
RAM;
Узел;
Интервал записи данных на диск;
Сразу записывать данные на диск.

Удаление шлюза

Вы можете удалить шлюз следующими способами:

через кнопку в карточке шлюза;
через массовое удаление шлюзов.

Шлюз автоматически удаляется из системы при удалении организации, в которой он состоит. Удаление шлюза происходит независимо от того, какое поведение выбрано для объектов при удалении организации.

Запуск шлюза

Чтобы запустить остановленный шлюз:

Перейдите в раздел Агенты → Шлюзы. Система отобразит сведения об имеющихся шлюзах.
Нажмите на строку шлюза в списке. Система отобразит в правой части экрана карточку этого шлюза с подробной информацией о нем.
Установите переключатель в верхней части вкладки в активное положение. Система запустит шлюз и отобразит соответствующее уведомление. Шлюз перейдет в статус Запущен.

Остановка шлюза

Чтобы остановить запущенный шлюз:

Перейдите в раздел Агенты → Шлюзы. Система отобразит сведения об имеющихся шлюзах.
Нажмите на строку шлюза в списке. Система отобразит в правой части экрана карточку этого шлюза с подробной информацией о нем.
Установите переключатель в верхней части вкладки в неактивное положение. Система остановит шлюз и отобразит соответствующее уведомление. Шлюз перейдет в статус Остановлен.

Если для агента включена возможность переключения между шлюзами и агент остается в статусе Онлайн, то после остановки шлюза агент автоматически подключится к кластеру системы через другой шлюз в рамках своей организации и останется в том же статусе. В противном случае после остановки шлюза агент перейдет в статус Офлайн.

Подробные сведения о данном механизме приведены в описании параметра gateway_discovery_enabled файла конфигурации rpoint.conf.

Была ли полезна эта страница?