############ ProbeManager ############

.. image:: https://www.ko-fi.com/img/donate_sm.png :alt: 捐赠 :target: https://ko-fi.com/mtreussart

|Licence| |Version|

.. image:: https://api.codacy.com/project/badge/Grade/afc2ab5226584ac3b594eb09ebcc2ccc?branch=master :alt: Codacy 评级 :target: https://app.codacy.com/app/treussart/ProbeManager?utm_source=github.com&utm_medium=referral&utm_content=treussart/ProbeManager&utm_campaign=badger

.. image:: https://api.codacy.com/project/badge/Coverage/8c16c475964d4db58ce0c7de0d03abbf?branch=master :alt: Codacy 覆盖率 :target: https://www.codacy.com/app/treussart/ProbeManager?utm_source=github.com&utm_medium=referral&utm_content=treussart/ProbeManager&utm_campaign=Badge_Coverage

+------------------+--------------------+ | 状态 | 操作系统 | +==================+====================+ | |Build_Status| | Linux x86_64 | +------------------+--------------------+

.. |Licence| image:: https://img.shields.io/github/license/treussart/ProbeManager.svg .. |Stars| image:: https://img.shields.io/github/stars/treussart/ProbeManager.svg .. |Forks| image:: https://img.shields.io/github/forks/treussart/ProbeManager.svg .. |Downloads| image:: https://img.shields.io/github/downloads/treussart/ProbeManager/total.svg .. |Version| image:: https://img.shields.io/github/tag/treussart/ProbeManager.svg .. |Commits| image:: https://img.shields.io/github/commits-since/treussart/ProbeManager/latest.svg .. |Build_Status| image:: https://travis-ci.org/treussart/ProbeManager.svg?branch=master :target: https://travis-ci.org/treussart/ProbeManager

介绍

我们经常看到许多IDS（入侵检测系统）的软件及其规则未能定期更新。这往往是因为软件和规则的管理过于复杂，对于通常缺乏系统安全专业知识和全职操作人员来监督各自IDS的中小企业来说，尤为棘手。这一发现促使我开发了一款应用程序（ProbeManager），用于更好地管理系统中的网络和机器检测探针。

ProbeManager 是一款集中管理入侵检测系统的应用程序。其目的是简化检测探针的部署，并将所有功能整合到单一界面中。ProbeManager 还允许您检查探针状态，并在出现故障或异常时接收通知。ProbeManager 并非 SIEM（安全信息和事件管理），因此它不显示探针的输出（警报、日志等）。

ProbeManager 目前兼容 NIDS Suricata 和 Bro，并即将支持 OSSEC。

功能特性

• 在所有探针中搜索规则。
• 列出已安装的探针及其状态（是否正在运行、运行时间等）。
• 安装、更新探针。
• 启动、停止、重新加载和重启探针。
• 推送、电子邮件通知（状态变更等）。
• RESTful API。
• 查看所有异步任务。

使用

.. image:: https://raw.githubusercontent.com/treussart/ProbeManager/master/docs/data/Deployement_example_of_Probemanager_in_a_network.png :alt: ProbeManager 在网络中的部署示例

.. image:: https://raw.githubusercontent.com/treussart/ProbeManager/master/docs/data/Deployement_example_of_Probemanager_in_a_VPS.png :alt: ProbeManager 在 VPS 中的部署示例

安装

操作系统

+------------+------------+-----------+ | 操作系统 | 生产 | 测试 | +============+============+===========+ | OSX 12+ | | X | +------------+------------+-----------+ | Debian 9 | X | | +------------+------------+-----------+ | Ubuntu 14 | X | | +------------+------------+-----------+

OSX 12+（仅用于项目开发）、Debian 稳定版以及 Ubuntu 14.04+ 均受支持并已通过测试。

依赖要求

• Python3.5+
• Pip
• Rabbitmq-server（通过安装脚本安装）
• Postgresql（通过安装脚本安装）

获取项目

GitHub 上的源代码 <https://github.com/treussart/ProbeManager/>_

.. code-block:: sh

git clone --recursive https://github.com/treussart/ProbeManager.git

安装

开发者模式： ^^^^^^^^^^^^^^^

.. code-block:: sh

./install.sh
./start.sh

生产环境： ^^^^^^^^^^^^^^^^

默认目标路径：/usr/local/share

若使用相同路径：.

请确保拥有目标路径的写权限。

.. code-block:: sh

./install.sh prod [destination path]

使用 Django 服务器（不推荐）：

.. code-block:: sh

[destination path]./start.sh prod

使用 Apache（仅限 Debian）：

.. code-block:: sh

 http://localhost

运行测试

（仅限开发者或 Travis）：

.. code-block:: sh

./test.sh

使用网页浏览器打开文件：

::

coverage_html/index.html

添加子模块

.. code-block:: sh

git submodule add -b master --name suricata https://github.com/treussart/ProbeManager_Suricata.git probemanager/suricata

模块需遵循以下规则：

• 一个 version.txt 文件（由安装脚本生成）
• 一个 README.rst 文件
• 一个 api 文件夹，其中 urls.py 包含变量 'urls_to_register'（可选）
• 安装脚本 install.sh（可选）
• 数据库初始化脚本 init_db.sh（可选）

文档

遵循标准：reStructuredText（RST）。

.. code-block:: sh

venv/bin/python probemanager/manage.py runscript generate_doc --settings=probemanager.settings.dev

使用网页浏览器打开文件：

::

docs/_build/html/index.html

或获取完整文档，请访问 此处 <https://treussart.github.io/ProbeManager/>_