📘 KerioControlWeb - Веб-интерфейс для управления списками блокировки в Kerio Control

Это удобное веб-приложение для автоматизации и упрощения работы с фильтрами контента в межсетевом экране Kerio Control. Оно позволяет быстро и безопасно загружать списки индикаторов компрометации (IoC) в черные списки, экономя время администратора и минимизируя риск ошибок при ручном редактировании.

Приложение предназначено для пользователей, которым регулярно приходится обрабатывать письма от ФСТЭК и блокировать большое количество IP-адресов и URL. Однако оно также подходит для всех желающих, кто сталкивается с похожими задачами. Особенность приложения — функция распознавания адресов из PDF-документов, разработанная специально для писем от регуляторов. Для работы функции распознавания необходимо развернуть API (см. пункты 2 и 3).

---

✨ Ключевые возможности

🔐 Безопасная авторизация

• Подключение к серверу Kerio Control по IP-адресу.

• Аутентификация с помощью логина и пароля администратора.

• Автоматическое получение и использование sessionId для всех последующих запросов к API.

📥 Умный парсинг и загрузка данных

• Приложение умеет обрабатывать и нормализовать данные из различных форматов: IP-адреса (одиночные и в диапазонах).

• Доменные имена (с поддержкой до 6 уровней поддоменов).

• URL-адреса (включая полные пути).

• Автоматическая нормализация "замаскированных" индикаторов:

• Замена hxxp:// и hxxps:// на http:// и https://

• Очистка лишних пробелов и символов.

⚙️ Полноценная работа с API Kerio Control

• Чтение: Получение списка существующих групп (IpAddressGroups.get, UrlGroups.get).

• Создание: Легкое создание новых групп блокировки.

• Запись: Безопасное обновление содержимого групп (IpAddressGroups.set, UrlGroups.set).

• Пакетное выполнение: Отправка нескольких команд за один запрос (Batch.run) для повышения эффективности.

🖥 Удобный и интуитивный веб-интерфейс

• Комбо-боксы для выбора целевых групп IP-адресов и URL.

• Многострочное текстовое поле для легкой вставки больших списков индикаторов.

• Управляющие кнопки: Быстрое копирование, вставка и очистка поля ввода.

• Поле для описания при создании новой группы.

• Автоподтверждение операций изменения для удобства.

🛡 Гибкая система исключений

• Возможность задать список исключений (IP или доменов, которые не нужно блокировать).

• Исключения хранятся в локальном файле exclusions.txt и автоматически фильтруются из загружаемых данных.

💡 Для кого этот инструмент?

• Сисадмины и инженеры безопасности, обслуживающие Kerio Control.
• Аналитики SOC, которым необходимо оперативно применять угрозы.
• ИТ-отделы, желающие автоматизировать рутинную задачу обновления черных списков.

---

🚀 Быстрый старт

1️⃣ Установка и запуск

1. Установите программу https://drive.google.com/file/d/19H3v7fep5ORZqVtX67cuAP6MaF7YDqjB/view?usp=sharing
2. Запустите .exe
3. Откройте https://localhost:7135/

Можно поставить как службу через NSSM, чтобы постоянно не запускать вручную.

2️⃣ Python-сервис для распознавания PDF

1. Установите Python: python.org
   • При установке отметьте: ✔ Add Python to PATH
2. Создайте папку: C:\PythonIocService\
3. Скопируйте файл ioc_service.py https://drive.google.com/file/d/1ujEo5S98UqE8YYqffLLH3oMcIOvN2Pma/view?usp=sharing
4. Установите зависимости:

& "C:\Users\USER\AppData\Local\Programs\Python\PythonVERSION\python.exe" -m pip install fastapi uvicorn PyPDF2 python-multipart

3️⃣ NSSM — создание службы

1. Имя: IocPythonService
2. Path: C:\Users\USER\AppData\Local\Programs\Python\PythonVERSION\python.exe
3. Arguments: -m uvicorn ioc_service:app --host 0.0.0.0 --port 8000
4. Startup Dir: C:\PythonIocService
5. Environment:

PATH=C:\Users\USER\AppData\Local\Programs\Python\PythonVERSION;C:\Users\USER\AppData\Local\Programs\Python\PythonVERSION\Scripts
PYTHONPATH=C:\PythonIocService

USER и VERSION - ОБЯЗАТЕЛЬНО СМЕНИТЬ НА СВОИ!