OmereKurt/gmail-phishing-reporter
GitHub: OmereKurt/gmail-phishing-reporter
一款 Google Workspace 插件，让用户在 Gmail 中直接报告钓鱼邮件并自动隔离与记录，简化用户驱动的事件响应。
Stars: 0 | Forks: 0
# 🛡️ Gmail 网络钓鱼报告与响应插件
## 🔍 概述
Gmail Phishing Reporter 是一个 Google Workspace 插件，允许用户在 Gmail 界面中直接报告网络钓鱼或可疑邮件。
该工具专注于通过自动将报告邮件移回收件箱并记录每个事件以供审计和分析，从而简化用户驱动的事件响应流程。
该项目展示了轻量级自动化如何减少用户接触恶意内容的风险，同时引入真实的安全工作流程。
## 🚀 功能特性
- 从 Gmail 侧边栏一键报告网络钓鱼
- 确认步骤以防止误操作
- 自动响应：将报告邮件移回收件箱（移至垃圾邮件）
- 使用 Google Sheets 的日志系统（时间戳、发件人、主题等）
- 轻量级审计追踪，用于记录和审查已报告邮件
## 🧠 安全背景
本项目探索了关键的事件响应和安全自动化概念，包括：
- 用户驱动的网络钓鱼报告工作流程
- 自动响应操作（移除/隔离）
- 事件记录与审计追踪
- 降低用户接触网络钓鱼威胁的风险
## ⚙️ 技术栈
- Google Apps Script（JavaScript）
- Gmail 插件（Google Workspace）
- Google Sheets（日志系统）
## 🧩 仓库结构
## 💻 设置与安装
1. 创建一个新的 Apps Script 项目
2. 用提供的文件替换 `Code.gs` 和 `appsscript.json`
3. 配置用于日志记录的 Google 表格
4. 部署为 Google Workspace 插件
5. 安装测试部署并授权所需权限
6. 打开 Gmail 并在侧边栏中测试插件
## 🔍 工作流程示例
1. 用户在 Gmail 中打开一封邮件
2. 插件显示在侧边栏
3. 用户点击 **报告网络钓鱼**
4. 显示确认提示
5. 确认后：
- 邮件从收件箱移除
- 事件记录在 Google 表格中
## 📊 示例日志输出
| 时间戳 | 发件人 | 主题 | 消息 ID | 线程 ID | 操作 |
|--------|--------|------|---------|---------|------|
| 2026-04-13 | test@example.com | Verify Account | ... | ... | 移至垃圾邮件 |
## 🔮 后续增强功能
- 为已报告邮件添加撤销/恢复功能
- 实现用于报告分析的仪表板
- 添加可疑邮件的自动检测规则
- 扩展日志记录，包含用户归属和分类
## 📄 许可证
本项目根据 MIT 许可证授权。
## 👤 作者
**Omer Kurt**
专注于事件响应、威胁检测和安全自动化的网络安全学生
标签：Gmail插件, Google Apps Script, Google Sheets, Google Workspace, 一键举报, 反钓鱼, 审计日志, 恶意内容防护, 报告机制, 收件箱清理, 检索词：Gmail钓鱼举报, 检索词：Workspace安全插件, 用户驱动安全, 职场安全工具, 自定义脚本, 轻量级自动化, 邮件安全, 邮件归档, 钓鱼邮件举报, 防护流程