Консоль управления ПроAPI Защита¶
Консоль управления ПроAPI Защита представляет собой компонент для управления нодами «ПроAPI Защита» и получения с них событий и метрик.
Требования¶
-
Установленный и настроенный Docker и Docker Compose.
-
Доступ к WebmonitorX docker registry:
wmx-public.gitlab.yandexcloud.net:5050
-
Спецификация:
- OpenAPI 3.0 для REST API приложения, которое должно быть защищено с помощью ПО ПроAPI Защита
Авторизация¶
На странице необходимо ввести свои учетные данные для входа в административную панель API Firewall Manager, после успешной авторизации открывается Дашборд.
Разделы¶
1. Дашборд¶
Основная цель дашборда — предоставить общую картину работы по всем или конкретному приложению. Здесь можно найти:
-
Счетчики запросов, блокировок, RPS за указанный период
-
Графики по запросам и блокировкам
-
Графики по ошибкам валидации и Shadow API событиям
2. События¶
Раздел События служит для просмотра и анализа событий, происходящих в процессе валидации трафика на соответствие OAS нодами.
В разделе:
-
Интерфейс для отображения событий
-
Выбор событий по конкретным приложениям или по всем сразу
-
Фильтрация по ключам и значениям
Информация об обнаруженных событиях отображается в общей таблице и включает следующие метрики:
-
Дата: дата и время запроса
-
Тип: тип cобытия
-
IP/Источник: IP‑адрес, с которого был отправлен запрос
-
Метод: метод запроса
-
Домен/Путь: домен и путь, на которые отправлен запрос
-
Параметр: параметр запроса, который не соответствует спецификации
-
Код: код ответа на запрос.
-
Цветовой индикатор отображается в столбце Код и указывает на статус блокировки атаки:
- Индикатор оранжевый, если запрос обнаружен, но не заблокирован (установлен режим мониторинга трафика)
- Индикатор красный, если запрос обнаружен и заблокирован
Для поиска событий можно использовать строку поиска или настроить фильтры поиска вручную.
3. Приложения¶
В разделе представлен список всех созданных приложений, к которым можно подключить фильтрующие ноды ПО ПроAPI Защита.
Возможности:
-
Получить общую картину по защищаемым приложением
-
Создать / редактировать / удалить приложение
-
Обновить спецификацию приложения
-
Получить подсказку по запуску docker контейнера фильтрующей ноды
4. Ноды¶
Раздел предоставляет пользователям возможность отображать информацию по фильтрующим нодам, доступна фильтрация по приложениям.
Доступны следующие свойства и метрики:
-
Уникальный идентификатор (UUID)
-
Имя
-
Количество RPS: среднее количество обработанных запросов в секунду
-
Количество запросов, обработанных за текущий месяц
-
IP‑адрес
-
Версия
-
Активность: время последней синхронизации с консолью управления
5. Настройки¶
Раздел предназначен для настройки работы Консоли управления ПроAPI Защита. В разделе можно изменить пароль, указать URL для подключения нод к консоли управления и просматривать историю авторизаций.
Просмотр истории авторизаций¶
История авторизаций помогает отслеживать активность пользователей в системе. Она содержит следующую информацию:
-
Дата и время каждой авторизации
-
IP-адрес, с которого была выполнена авторизация
Данные полезны для контроля доступа и выявления подозрительной активности и доступны для просмотра всем пользователям, имеющим доступ к системе.