samirkhurshid/SecureMail
GitHub: samirkhurshid/SecureMail
SecureMail 是一个端到端的邮件威胁检测与取证网关，通过多阶段分析流水线对邮件进行安全审计、信誉评估和风险评分，帮助安全分析师快速识别钓鱼、欺骗和恶意软件等威胁。
Stars: 0 | Forks: 0
# 🛡️ SecureMail — 邮件威胁情报网关与取证仪表盘
SecureMail
一个高级的网关邮件安全平台、钓鱼分析器和取证情报仪表盘。
## 📌 项目概述
**SecureMail** 是一个端到端的邮件威胁检测与取证网关。它解析原始邮件头和正文（`.eml` 或 `.msg`），进行自动化的 DNS 安全对齐检查，解析发件服务器 IP，通过全球信誉威胁情报引擎评估链接/附件，并计算出综合加权风险评分以对恶意活动进行分类。
该系统由三个核心组件组成：
1. **🚀 FastAPI 后端**：执行多阶段解析、DNS 审计、IP 查询、Tor 出口节点检测，并调用 VirusTotal 和 AbuseIPDB API。
2. **📊 Glassmorphic 前端**：提供实时邮件扫描分析、取证威胁源、网络路由跳数可视化以及 PDF/HTML 报告生成器的仪表盘。
3. **🔌 浏览器扩展**：与 Gmail 和 Outlook 无缝集成的 Chrome/Edge 浏览器插件，允许分析人员右键点击邮件文本进行即时信誉查询。
## ⚙️ 工作原理（7 阶段威胁流水线）
当原始邮件被加载到 SecureMail 网关时，它将经过一个全面的处理序列：
```
[ Raw Email (.eml) ] ➔ [ 1. Email Parser ] ➔ [ 2. DNS Auth Auditing ]
│ (SPF, DKIM, DMARC, ARC)
[ Weighted Risk Score ] 🠔 [ 7. Threat Classification ] 🠔 [ 3. Sender Verification ]
│ (Lookalike Domains, Spoofs)
[ 5. IP Reputation Audits ] 🠔 [ 4. URL Extraction & VT Rep ] 🠔 [ 6. Attachment Sandbox ]
(AbuseIPDB, Tor Exits) (Hash Lookup)
```
1. **邮件解析器**：提取邮件头、纯文本、HTML 结构和附件元数据。
2. **DNS 认证审计**：解码身份验证块以检查 **SPF**、**DKIM**、**DMARC** 和 **ARC** 状态。
3. **发件人验证**：检测显示名称欺骗、回复地址不匹配以及域名仿冒。
4. **URL 提取**：抓取所有嵌入式链接，并将其提交给 **VirusTotal API** 进行信誉评级。
5. **IP 审计**：追踪源头跳数，在 **AbuseIPDB** 上检查 IP，并映射发件人的 ISP/地理坐标。
6. **附件沙箱**：提取文件哈希，以便在公共威胁注册表中查找已知的恶意软件签名。
7. **风险评分计算**：根据加权安全警报计算从 0 到 100 的分数，并应用威胁分类（例如 `phishing`、`spoofing`、`malware`）。
## ✨ 功能特性
- **🚨 实时威胁情报源**：即时记录并就即将来临的严重威胁向安全分析师发出警报。
- **🗺️ 取证路由跳数审计**：以可视化方式映射出中间邮件传输服务器以追踪源头。
- **📝 钓鱼密度分析**：审计 HTML 和正文，以识别高密度的紧急触发词和欺诈相关关键字。
- **📑 导出套件**：即时下载适用于审计的专业且可直接打印的 **PDF 事件报告**或离线 **HTML 日志**。
- **🌓 自适应主题模式**：在暗色模式和亮色模式下均提供完全响应式的精美界面。
## 🛠️ 安装与设置
### 1. 后端设置（FastAPI 服务器）
确保您已安装 **Python 3.8+**。
```
# 导航到 Backend 文件夹
cd Backend
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
# 在 Windows 上：
venv\Scripts\activate
# 在 Linux/macOS 上：
source venv/bin/activate
# 安装依赖项
pip install -r requirements.txt
```
#### 设置环境密钥
在 `Backend` 目录中创建一个 `.env` 文件（从 `.env.example` 复制）：
```
VIRUSTOTAL_API_KEY=your_virustotal_api_key_here
ABUSEIPDB_API_KEY=your_abuseipdb_api_key_here
```
*（注意：`.env` 已在 `.gitignore` 中配置，以防在 GitHub 上暴露您的密钥）。*
#### 启动服务器
```
python -m uvicorn app.main:app --port 8000 --reload
```
API 文档将可在 `http://localhost:8000/docs` 查看。
### 2. 前端设置（仪表盘）
由于前端使用原生的 HTML、CSS 和 JS，因此不需要复杂的 node 编译：
1. 打开 `Frontend` 目录。
2. 在任何浏览器中启动 `index.html`。
3. 确保FastAPI 后端在端口 `8000` 上运行，以允许仪表盘获取实时数据。
### 3. 浏览器扩展安装
1. 打开 Google Chrome 或 Microsoft Edge 并导航到 `chrome://extensions`。
2. 开启右上角的**开发者模式**（Developer mode）。
3. 点击左上角的**加载已解压的扩展程序**（Load unpacked）按钮。
4. 选择本项目目录内的 `extension` 文件夹。
5. SecureMail 盾牌图标将出现在您的浏览器工具栏中，随时准备进行一键扫描！
## 📊 API 参考
| Endpoint | Method | Description |
| :--- | :--- | :--- |
| `/api/health` | `GET` | 用于验证后端状态的健康检查路由。 |
| `/api/scan/email` | `POST` | 扫描原始邮件文本块，生成综合报告。 |
| `/api/scan/url` | `POST` | 触发对自定义目标链接的信誉查询。 |
| `/api/attachments/scan` | `POST` | 上传文件或查询附件哈希。 |
| `/api/forensics/` | `GET` | 获取历史扫描日志。 |
| `/api/forensics/{id}` | `DELETE` | 删除一条威胁日志记录。 |
## 🔒 安全实践
API 凭证永远不会被推送到代码仓库中。该应用程序完全依赖 `.env` 文件进行配置。如果分享此项目，请确保排除本地的 `Backend/.env` 文件，并改为分发 `.env.example` 以供手动填充密钥。
## 🎓 毕业设计提交
作为毕业学术项目开发。
**作者**：Samir Khurshid
**项目名称**：SecureMail 邮件威胁情报仪表盘
标签：AV绕过, FastAPI, 后端开发, 多模态安全, 威胁情报, 安全网关, 开发者工具, 数据可视化, 电子取证, 逆向工具, 邮件安全, 钓鱼检测