mragentsmith/nmsweb repository overview

⁠Neurasoft Mail Spider Web

Система фильтрации, анализа и управления почтовым трафиком с веб-интерфейсом.

Основные функции:

• Бальная система оценки спама
• Поиск в теле, теме, заголовках писем на совпадения
• Переопределние баллов фильтров
• Белые/черные списки IP-адресов и доменов
• Проверка IP-адресов по RBL
• Проверка доменных имен по DBL
• Отправка в карантин
• Проверка типов расширений у вложений
• Ограничение подключений в минуту

---

⁠📋 Основные разделы системы

⁠1. Правила

В разделе настройки правил администратор может задавать критерии фильтрации входящей почты и присваивать им баллы (score):

• Типы проверок:
  • Regex (1): Проверка темы или тела письма по регулярному выражению.
  • Subject (2): Поиск подстроки в теме письма (Subject).
  • Body (3): Поиск подстроки в теле письма (Body или Body_text).
  • Header (4): Проверка конкретного почтового заголовка (например, X-Mailer, Authentication-Results и др.) по заданному имени (HeaderName) и значению (Data).
• Балльная система позволяет начислять положительные или отрицательные очки за срабатывание каждого критерия для формирования итогового вердикта по письму.

⁠2. Списки

• Система оперирует глобальными списками правил и фильтров, подгружаемыми в память почтового шлюза (мильтера) для быстрой обработки входящего потока SMTP-соединений.
• Белые/черные списки могут содержать адреса подсетей и домены. Белый список добавляет -100 очков к рейтингу письма. Черный список добавляет +100 очков к рейтингу письма
• RBL и DBL используют публичные сервисы проверки черных списком IP-адресов и доменов.

⁠3. Карантин

• Письма, похожие на утечку данных задерживаются в карантине
• Администратор может просматривать содержимое подозрительных писем, анализировать причины срабатывания триггеров (AnalyzeDescription) и принимать решение об их выпуске или удалении.

⁠4. Управление пользователями и пароли

• Доступ к веб-интерфейсу защищен механизмом авторизации ([Authorize]).
• Управление учетными записями и смена паролей пользователей осуществляются через защищенный контур приложения для предотвращения несанкционированного доступа к настройкам фильтрации и карантину.

⁠5. ⚙️ Основные разделы настроек

⁠1. Домены компании

• Назначение: Указание доверенных доменов организации. Письма, не принадлежащие корпоративным доменам, могут отклоняться шлюзом.

⁠2. Порог спама и лимиты

• Порог баллов (Threshold): Числовой лимит спам-рейтинга. При превышении этого значения письмо получает статус спама.
• Лимит подключений (RateLimit): Ограничение количества входящих SMTP-соединений с одного IP-адреса в минуту. При превышении выдается ошибка TEMPFAIL.

⁠3. Заголовок письма

• Назначение: Текстовая метка (например, СПАМ), которая автоматически добавляется в начало темы письма, если его рейтинг превысил порог.

⁠4. Запрещённые вложения

• Назначение: Список расширений файлов, которые блокируются шлюзом в составе вложений (например, exe).

⁠5. Переопределения очков правил

• Назначение: Позволяет администратору точечно изменять вес (баллы) для конкретных правил фильтрации без изменения исходного кода.
• Интерфейс: Поддерживает добавление, редактирование и удаление весов по имени правила.

⁠6. SMTP-настройки

Параметры для отправки служебных уведомлений, системных алертов и писем из карантина

⁠7. Настройки карантина

Управление политикой изоляции подозрительных сообщений

---

⁠🗄 База данных (PostgreSQL)

⁠Требования

• PostgreSQL 14+ (проверено на PostgreSQL 17).
• Строка подключения — ConnectionStrings:Default в appsettings.json. Пароль не хранится в репозитории: передавайте его переменной окружения ConnectionStrings__Default или через dotnet user-secrets (в .csproj задан UserSecretsId). Для локальной разработки строка с паролем задана в appsettings.Development.json.