Skip to content
Projects

GenRockeR/mpsiemlib

View on GitHub

GenRockeR/mpsiemlib has 33 GitHub stars and 21 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-14 18:11 UTC. Last push 2026-10-15.

How these counts are measured

33 stars21 Forks

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

MP SIEM SDK

Security

README.md

Original

Maxpatrol SIEM API SDK

Неофициальный SDK для работы с MP SIEM через API.
В SDK используется как UI API, так и прямые вызовы к микросервисам вследствие того, что UI API имеет ряд ограничений.
Пример использования можно посмотреть в tests и examples.

Поддерживаемые версии

R26.0.x - R28.0.x

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

  1. Unit-тесты для проверки совместимости с новыми версиями MP SIEM.
  2. Аутентификация с Core, Marketing Core, KB (в том числе по PAT-токену).
  3. Журналирование и его настройка.
  4. Хранение параметров и передача модулям.
  5. Работа с активами
  6. Работа с событиями через API (модуль Events - отдельный extra mpsiemlib[events], работает напрямую с Elasticsearch 7.17.x; на ядрах с storage Logspace неприменим)
  7. Работа с фильтрами событий и белыми списками.
  8. Работа с инцидентами.
  9. Работа с табличными списками.
  10. Работа с контентом в KB (включая базы контента и макросы).
  11. Работа с задачами сбора.
  12. Работа со встроенным мониторингом SIEM.
  13. Работа со встроенным мониторингом источников.
  14. Работа с пользователями и ролями в IAM.
  15. Работа с конвейерами (Conveyor).

Сетевой доступ и права

Для работы SDK необходимы следующие сетевые разрешения:

  • MP Core: tcp 443
  • MP Marketing Core (IAM/лицензии, требуется с R27.0): tcp 3334
  • PT KB: tcp 8091
  • Storage (Elasticsearch, только модуль Events): tcp 9200

SDK аутентифицируется в Core, PT KB, PT MC Ряд функций требует административной учетной записи в IAM, PT KB, SIEM.

Запуск

Добавить переменные окружения:

  • MP_CORE_HOSTNAME: IP/Hostname для доступа к MP CORE (без схемы http(s))
  • MP_PAT_TOKEN: PAT-токен из MC (рекомендуемый способ, MP SIEM 26.0+)
  • MP_STORAGE_HOSTNAME: IP/Hostname для доступа к MP Storage (Elasticsearch) (без схемы http(s)); только для модуля Events
  • MP_SIEM_HOSTNAME: IP/Hostname для доступа к MP SIEM Server (без схемы http(s))
  • MP_LOGIN: учетная запись с ролью администратора в PT KB, IAM, SIEM (для Local/LDAP)
  • MP_PASSWORD: пароль (для Local/LDAP)
  • USE_LOCAL_AUTH: true
  • CLIENT_SECRET: токен из MP SIEM (для SECRET-аутентификации)

PAT-токен выпускается в Marketing Core; CLIENT_SECRET можно взять так:

  sudo grep ClientSecret /var/lib/deployer/role_instances/core*/params.yaml

Спасибо за помощь

mkosmach, srublev

Release Notes

CHANGELOG.md