yashh127/phishing-triage-workbench

# 🛡️ 自动化钓鱼邮件分拣工作台 ## 🌟 核心功能 * **✉️ Header 与 Envelope 遥测：** 解析 `From`、`To`、`Return-Path`、`Reply-To`、`Subject`，并检测 envelope 域名不匹配情况（Spoofing 指标）。 * **🔐 身份验证分析：** 解析 `Authentication-Results` 和 `Received-SPF` header 以获取 SPF、DKIM 和 DMARC 状态。 * **🌐 邮件服务器跳转链：** 自上而下可视化展示 `Received` header 的中继跳转，包含服务器主机名、IP 地址和时间戳。 * **🔗 Defang URL 与域名提取器：** 提取所有内嵌的正文链接，将其转换为安全的 defang 格式（`hXXp://domain[.]com`），检测可疑的 TLD（`.xyz`、`.top`），并标记凭据窃取关键字。 * **📎 附件哈希与欺骗检测：** 计算所有附件的 MD5 和 SHA256 哈希值，并标记恶意的双重扩展名欺骗行为（例如 `Invoice.pdf.exe`）。 * **📊 SOC 风险引擎（0-100 评分）：** 计算威胁严重性（`CRITICAL`、`HIGH`、`MEDIUM`、`LOW`），呈现推荐的 SOC playbook 响应操作，并一键生成 Markdown 工单。 * **⚡ 零配置演示：** 内置逼真的示例 EML 文件，可随时进行一键测试。 ## 🛠️ 技术栈 * **后端：** Python 3.10+、FastAPI、Uvicorn、Python 标准 `email` 库。 * **前端：** 现代 Vanilla HTML5/CSS3/JavaScript（暗黑主题、响应式网格、毛玻璃效果）。 * **安全与加密：** `hashlib`、`urllib.parse`、Defang 引擎、威胁评分算法。 ## 🚀 快速入门指南 ### 1. 前置条件 确保您的机器上已安装 Python 3.8+。 ### 2. 使用单条命令运行 执行启动脚本： ``` chmod +x run.sh ./run.sh ``` 或手动启动： ``` # 安装依赖 pip install -r requirements.txt # 启动 FastAPI server python3 -m uvicorn backend.app:app --host 0.0.0.0 --port 8000 --reload ``` ### 3. 访问仪表板 打开浏览器并导航至： 👉 **`http://localhost:8000`** 点击 **“🚨 加载凭据钓鱼样本”** 运行即时演示！ ## 📂 项目结构 ``` phishing-triage-workbench/ ├── backend/ │ ├── app.py # FastAPI server & routes │ ├── parser.py # Core EML parser, header hop tracer & defanger │ └── threat_intel.py # Threat scoring engine & API lookup integration ├── frontend/ │ ├── index.html # Dark-theme SOC dashboard UI │ ├── style.css # Custom CSS design system │ └── app.js # Client-side UI logic & export engine ├── samples/ │ ├── credential_harvesting_phish.eml # Sample malicious phishing email │ └── legitimate_newsletter.eml # Sample clean email ├── requirements.txt # Python package dependencies ├── run.sh # One-click startup script └── README.md # Documentation ``` ## 📝 作者与许可 为安全运营中心 (SOC) 分析师的作品集演示而开发。基于 MIT 许可协议开源。

标签：AV绕过, FastAPI, 企业安全, 威胁情报, 开发者工具, 网络资产管理, 逆向工具, 钓鱼邮件分析