krajeshbiswaldir/VirusTotal-Threat-Intelligence-Reporter
GitHub: krajeshbiswaldir/VirusTotal-Threat-Intelligence-Reporter
基于VirusTotal API v3的Python威胁情报报告工具,用于快速分析恶意IP地址和文件哈希值并生成结构化报告。
Stars: 0 | Forks: 0
# VirusTotal 威胁情报报告工具
一个基于 Python 的威胁情报报告工具,集成了 [VirusTotal API](https://www.virustotal.com?utm_source=chatgpt.com),用于分析恶意 IP 地址和文件哈希值。该脚本分别为 IP 指标和文件哈希生成结构化且易读的报告,帮助安全分析师更快地进行调查和 IOC 验证。
## 功能特性
* 分析恶意 IP 地址
* 分析文件哈希值
* MD5
* SHA1
* SHA256
* 分别为 IP 和哈希生成报告
* 清晰易读的终端输出
* 使用 VirusTotal API v3
* 易于自定义和扩展
* 轻量级且对初学者友好
## 项目结构
```
project/
│
├── ip_report.py
├── hash_report.py
├── requirements.txt
├── README.md
└── reports/
```
## 环境要求
* Python 3.8+
* VirusTotal API 密钥
## 安装说明
克隆仓库:
```
git clone https://github.com/your-username/your-repository-name.git
```
进入项目目录:
```
cd your-repository-name
```
安装依赖:
```
pip install -r requirements.txt
```
## 获取 VirusTotal API 密钥
1. 在 [VirusTotal](https://www.virustotal.com?utm_source=chatgpt.com) 上创建一个账号
2. 导航到您的个人资料
3. 复制您的 API 密钥
## 配置说明
在脚本中添加您的 VirusTotal API 密钥:
```
API_KEY = "YOUR_API_KEY"
```
或使用环境变量:
```
export VT_API_KEY="YOUR_API_KEY"
```
# 使用方法
## 分析恶意 IP 地址
```
python ip_report.py
```
示例输入:
```
8.8.8.8
```
示例输出:
```
IP Address: 8.8.8.8
Country: US
ASN: Google LLC
Malicious Detections: 5
Suspicious Detections: 2
Harmless Detections: 70
Reputation Score: -10
```
## 分析文件哈希
```
python hash_report.py
```
示例输入:
```
44d88612fea8a8f36de82e1278abb02f
```
示例输出:
```
Hash: 44d88612fea8a8f36de82e1278abb02f
Type: PE32 executable
Malicious: 48
Suspicious: 3
Undetected: 20
File Names:
- malware.exe
- trojan_sample.exe
```
## 支持的哈希类型
* MD5
* SHA1
* SHA256
## 应用场景
* IOC 验证
* 威胁狩猎
* SOC 调查
* 恶意软件分析
* 应急响应
* 威胁情报丰富
## 后续改进计划
* 将报告导出为 PDF 或 CSV
* GUI 版本
* 批量 IOC 扫描
* 域名和 URL 分析
* 与 SIEM 平台集成
* 多线程扫描
## 免责声明
本项目仅出于教育和防御性网络安全目的而开发。用户有责任遵守 [VirusTotal 服务条款](https://support.virustotal.com/hc/en-us/articles/115002168385-Public-API-vs-Private-API?utm_source=chatgpt.com)。
## 作者
由 Rajesh Biswal 开发
网络安全分析师 | 威胁检测 | SOC 运营
## 许可证
本项目基于 MIT 许可证授权。
标签:API集成, Ask搜索, DAST, IOC验证, MD5, SHA1, SHA256, VirusTotal, 可观测性, 失陷标示, 威胁情报, 安全分析师, 安全报告生成, 开发者工具, 开源安全工具, 恶意IP检测, 恶意软件分析, 文件哈希分析, 新手友好, 终端工具, 轻量级工具, 逆向工具, 逆向工程平台