用于 SPF/DKIM/DMARC、欺骗和钓鱼分析的电子邮件头与 .eml 分析器。100% 在浏览器中运行,因此你的电子邮件永远不会被上传。
[!IMPORTANT] 你的邮件永远不会离开你的设备。 托管版本通过 WebAssembly 在浏览器标签页内运行整个分析器。不存在 ESHA 服务器:你打开的邮件头和
.eml文件永远不会被上传、存储或共享,甚至不会与 GitHub 或 ESHA 项目共享。
- 无上传: 分析在页面内的后台 worker 中本地运行。
- 无第三方: 没有 CDN、分析、跟踪器,也没有 DNS 或信誉查询。
- 由浏览器强制执行: 页面的内容安全策略(
connect-src 'self')阻止其联系任何其他服务器。- 可验证: 打开浏览器的 DevTools,进入 Network,分析一条消息,你将看不到任何携带该消息的请求。
这使其适用于敏感或机密消息,例如同事提交的网络钓鱼报告或事件证据。
粘贴邮件的邮件头,或拖入整个 .eml 或 Outlook .msg 文件,ESHA 会告诉你消息的真正来源:SPF、DKIM 和 DMARC 是否通过,哪些身份与发件人不匹配,以及它显示出哪些网络钓鱼或欺骗迹象。分析完全在你的机器上运行,从不联系第三方服务。
专为分诊可疑邮件的 SOC 分析师、事件响应人员和 IT 管理员打造。ESHA 源自 @lnxg33k 的开源项目 MHA (E-Mail Header Analyzer),此后其分析引擎、界面、API 和命令行均已重写。
身份验证与不匹配
compauth)判定结果,取自接收服务器的 Authentication-Results,或在缺失时取自 Received-SPF 和 DKIM-Signaturep=none DMARC 策略、相互冲突的 SPF 结果,以及发件人插入的伪造 Authentication-Results 头l= 正文长度标签,或签名头过少的 DKIM 签名发件人身份
paypa1)、同形异义字符和西里尔/希腊混淆字符(раураl)、punycode、嵌入其他域的品牌名称acmecorp-hr.com 与 acme-corp.com),常见于发票和工资欺诈路由
内容(当包含正文时)
javascript: 和 data: 链接invoice.pdf.html),以及内容与文件名不符的文件atob、Blob、msSaveOrOpenBlob、大型 base64 数据).ics),其链接会被添加到链接表中Outlook .msg 文件:收到的消息保留其原始互联网标头,因此会像 .eml 一样被分析,包括附件和嵌入消息。从“已发送邮件”或“草稿”保存的消息没有传输标头;ESHA 会从 Outlook 属性重建发件人、收件人、主题和日期,并说明无法检查路由。仅以 RTF 存储的正文不会被解码。
垃圾邮件过滤器:Microsoft 365(SCL、BCL、SFV、CAT,例如 SPOOF 或 PHSH)和 SpamAssassin 的判定结果。
指标与导出
to_ids 属性,因此良性邮件服务不会被标记为恶意。所有结果会合并为一个 0–100 的风险评分。每项发现都有通俗易懂的解释、处置建议及其 MITRE ATT&CK 技术。报告分为多个选项卡:发现、路由、认证、链接与附件(当包含消息正文时)以及所有标头。该评分是启发式的:请将其视为分诊参考,而非确凿证据。
ESHA 作为静态站点发布在 GitHub Pages 上:https://0xanalyst.github.io/email-security-header-analyzer/
托管版本通过 Pyodide(WebAssembly)在你的浏览器标签页内运行相同的 Python 分析器。你打开的标头和 .eml 文件永远不会被上传。GitHub 仅提供页面文件,不会看到任何邮件内容。页面的内容安全策略(connect-src 'self')阻止其联系任何其他服务器,并且 Pyodide 与站点一同托管,而非从 CDN 加载。首次访问会下载约 14 MB(压缩后更少),之后浏览器会将其缓存。
自行构建并预览静态站点:
pip install -r requirements.txt
python scripts/build_site.py # writes ./site
python -m http.server -d site 8000 # http://127.0.0.1:8000
node scripts/check_site.js site tests/samples # optional smoke test of the in-browser engine
每次推送到 main 都会重新构建并部署站点(.github/workflows/pages.yml)。
你需要 Python 3.9 或更高版本。
macOS:在 Finder 中双击 Start ESHA.command,或在终端中运行 ./run.sh。如果 macOS 提示无法验证该文件,请右键点击它并选择 打开。如果端口 8080 被占用(Burp Suite 默认使用该端口),ESHA 会选择下一个空闲端口并打印出来。
Linux
./run.sh
Windows:双击 run.bat。
该脚本会创建虚拟环境、安装依赖,并在浏览器中打开 http://127.0.0.1:8080。按 Ctrl+C 停止。
手动方式
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m esha --open # options: -b 0.0.0.0 -p 9000
Docker
docker compose up -d # http://127.0.0.1:8080
该镜像以非 root 用户身份运行 gunicorn,使用只读文件系统,并带有健康检查。
python -m esha analyze message.eml # colour report in the terminal
python -m esha analyze message.msg # Outlook .msg works the same way
python -m esha analyze message.eml --json # full JSON report
pbpaste | python -m esha analyze - # headers from the clipboard (macOS)
其他格式,输出到标准输出或使用 -o 输出到文件:
python -m esha analyze message.eml -f html -o report.html # self-contained report for a ticket
python -m esha analyze message.eml -f csv # indicators as CSV
python -m esha analyze message.eml -f stix -o bundle.json # STIX 2.1 bundle
python -m esha analyze message.eml -f misp -o event.json # MISP event
python -m esha analyze message.eml -f iocs # indicators as JSON
analyze 在判定为高风险时以退出码 2 退出,因此可用于脚本中。--json 保持其原有行为,始终以 0 退出。
curl -s localhost:8080/api/analyze -H 'Content-Type: application/json' -d '{"headers": "..."}'
curl -s localhost:8080/api/analyze -F [email protected]
curl -s localhost:8080/api/analyze -H 'Content-Type: message/rfc822' --data-binary @message.eml
curl -s localhost:8080/api/analyze -F [email protected]
curl -s localhost:8080/api/analyze -H 'Content-Type: application/vnd.ms-outlook' --data-binary @message.msg
curl -s localhost:8080/api/health
# other formats: csv, iocs, stix, misp, html
curl -s 'localhost:8080/api/analyze?format=stix' -F [email protected] -o bundle.json
curl -s localhost:8080/api/export -H 'Content-Type: application/json' -d '{"report": {...}, "format": "misp"}'
报告在同一个主版本内只会新增字段(参见 CHANGELOG.md)。响应包含 iocs、score、findings(每项包含 rule_id、severity、title、detail、category、weight、description、remediation 和 attack)、auth(包括 alignment 表)、hops、origin、content(链接和附件)、spam、summary 以及解码后的 headers。
每条发现都来自一条具有稳定 ID(ESHA-001 至 ESHA-9xx)的规则,该规则包含描述、处置建议,以及在适用情况下的 MITRE ATT&CK 技术。完整列表见 docs/RULES.md,或运行:
python -m esha rules # table
python -m esha rules --json # machine-readable
每个发现项都会为 0–100 的评分增加分数:默认情况下,严重为 40,高危为 25,中危为 12,低危为 4,提示为 0。总分达到 60 或以上为高风险,达到 25 或以上为可疑。任何严重发现项都会将评分提升至至少 80。要更改此设置,请在运行 ESHA 的目录中创建 esha.json,或将 ESHA_CONFIG 指向某个文件:
{
"severity_weights": {"medium": 10, "low": 3},
"rule_weights": {"ESHA-105": 6, "ESHA-304": 0},
"thresholds": {"high": 65, "medium": 25},
"critical_floor": 80,
"disabled_rules": ["ESHA-209"]
}
ESHA_WEIGHTS 可在不使用文件的情况下覆盖单个值,例如 ESHA_WEIGHTS="ESHA-304=0,threshold.high=70,disable=ESHA-209"。配置无效时 ESHA 会拒绝启动,每份报告都会在 meta.scoring 中记录其使用的设置。GitHub Pages 站点始终使用默认值。
内置的 GeoLite2 Country 数据库来自 2018 年,因此部分位置信息已经过时。要更新该数据库,并添加城市和网络所有者查询:
MAXMIND_ACCOUNT_ID=123456 MAXMIND_LICENSE_KEY=xxxx python scripts/update_geoip.py
数据库保存到 esha/static/data。如需保存到其他位置,请使用 --dest /path 并设置 ESHA_GEOIP_DIR=/path。
127.0.0.1。在将其暴露到网络之前,请先置于身份验证之后。