rahulmajhi26/SentinelX
GitHub: rahulmajhi26/SentinelX
SentinelX 是一个基于 VirusTotal API 的 Linux 网络威胁情报工具,用于收集和分析威胁指标以支持安全运营。
Stars: 1 | Forks: 0
# 哨兵X
SentinelX 是一款专为 Linux 系统构建的强大网络威胁情报 (CTI) 工具。它使网络安全专业人员和分析师能够从各种来源收集、分析和关联威胁数据,帮助他们快速有效地检测、追踪和应对网络威胁。
## 目录
- [功能](#features)
- [安装说明](#installation)
- [使用指南](#usage)
- [配置](#configuration)
- [API 集成](#api-integration)
- [工作原理](#how-it-works)
- [参与贡献](#contributing)
- [许可证](#license)
- [联系方式](#contact)
## 功能
- **VirusTotal 集成:** 使用 VirusTotal 的公共 API 分析文件、IP 地址、URL 和域名,检测恶意软件、网络钓鱼和可疑活动。
- **IOC 收集与分析:** 输入威胁指标(哈希值、IP 地址、域名)以获取详细的威胁情报。
- **威胁行为者追踪:** 汇聚威胁数据,帮助分析并监控潜在的攻击者。
- **自动化报告生成:** 生成详细的 HTML 和文本报告,总结调查结果。
- **模块化命令行界面:** 易于使用、具有模块化设计的命令行界面,便于扩展。
- **跨平台兼容性:** 主要为 Linux 设计,但也兼容其他类 UNIX 系统。
- **实时警报模拟:** 模拟实时检测警报,为安全运营做好准备。
## 安装说明
### 前置条件
- Python 3.7 或更高版本
- Git
- 互联网连接(用于 API 调用)
### 步骤一:克隆代码仓库
```
git clone https://github.com/yourusername/SentinelX.git
cd SentinelX
```
### 步骤二:安装依赖
推荐使用 Python 虚拟环境:
```
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
```
*如果 `requirements.txt` 文件尚不存在,你可以手动安装依赖,例如 `requests`。*
### 步骤三:配置 API 密钥
在 [VirusTotal](https://www.virustotal.com/) 上注册以获取免费的 API 密钥。
在根目录下创建一个 `.env` 文件并添加你的 API 密钥:
```
VT_API_KEY=your_virustotal_api_key_here
```
## 使用指南
使用 Python 运行主工具脚本:
```
python3 sentinelx.py
```
你将看到一个交互式命令行菜单,可以进行以下操作:
* 扫描 IP 地址
* 扫描域名
* 扫描文件哈希值 (MD5, SHA256)
* 生成详细报告
## 配置
* API 密钥通过 `python-dotenv` 从 `.env` 文件加载(请确保已安装该库)。
* 如有需要,可以在脚本内自定义输出文件夹和报告格式。
## API 集成
SentinelX 目前支持使用 VirusTotal API 获取威胁情报。该工具向 VirusTotal 的端点发送请求,以检索关于提交的 IOC 的信息。
*注意:* VirusTotal 的免费 API 有请求频率限制。对于大量使用,请考虑升级你的 API 订阅计划。
## 工作原理
1. **用户输入:** 用户输入一个 IOC(IP 地址、域名、文件哈希值)。
2. **API 查询:** SentinelX 使用该 IOC 查询 VirusTotal API。
3. **数据处理:** 工具处理 JSON 响应,提取相关的威胁详情。
4. **威胁关联:** 关联恶意软件检测结果、相关 URL 和威胁行为者等数据。
5. **报告生成:** 生成一份易于阅读的报告,总结所有发现。
## 许可证
本项目采用 **MIT 许可证** — 详情请参阅 [LICENSE](LICENSE) 文件。
## 联系方式
由 **Rahul Majhi** 创建和维护
* Twitter(X): [https://x.com/r_dex_26](https://x.com/rdex_group_x)
* 电子邮件: workforrdex@gmail.com
* 电子邮件: rdexgroup.industry@gmail.com
## 免责声明
本工具仅用于**教育和道德用途**。作者不对因误用或使用本工具造成的任何损害负责。
*感谢使用 SentinelX!保持警惕,确保安全。*
标签:AMSI绕过, API集成, CTI工具, DAST, IOC分析, Python, 可观测性, 威胁情报, 威胁数据收集, 威胁检测, 威胁跟踪, 安全事件响应, 安全运营, 实时警报, 开发者工具, 恶意软件分析, 扫描框架, 无后门, 网络安全, 网络安全研究, 自动化报告, 逆向工具, 钓鱼检测, 隐私保护