Gophish 模板新增 QrCode 变量:带 rid 的 phishURL 生成 base64 PNG 内联二维码并统计扫码
pentest/initial-access · verified
一句话结论
原版 Gophish 的邮件模板只接受白名单变量({{.URL}}、{{.FirstName}}、{{.TrackingURL}} 等),写 {{.QrURL}} 会报 can't evaluate field;在 models.PhishingTemplateContext 中新增 QrCode 字段,并在 NewPhishingTemplateContext 里用 go-qrcode 把已带 rid 的 phishURL 生成 256px PNG、读取后转成 data:image/png;base64,...,模板即可用 {{.QrCode}} 作为 <img src> 内联二维码;收件人扫码访问带 rid 的钓鱼 URL,Gophish 的 Clicked Link 统计随之上报。
原理
- 模板变量白名单:Gophish 的
models.Template.Validate()调用ValidateTemplate(t.HTML),后者用固定的PhishingTemplateContext(BaseRecipient、BaseURL、URL、TrackingURL、Tracker、From、Rid等)执行 Gotext/template;模板中出现不存在的字段(如QrURL)会直接报错,因此必须改数据模型而不是只改模板。 - 二维码生成位置:
NewPhishingTemplateContext(ctx, r, rid)负责为每个收件人构造上下文。其内部已把templateURL解析为phishURL并q.Set(RecipientParameter, rid)注入追踪参数;在此处对phishURL.String()调用qrcode.WriteFile(..., qrcode.Medium, 256, filename)生成 PNG,再读取文件、base64.StdEncoding.EncodeToString,拼成data:image/png;base64,前缀存入新增的QrCode字段,最后删除临时文件。 - 为什么用 data URI:HTML 模板里只需
<img src="{{.QrCode}}">,二维码随邮件正文内联渲染,不需要额外附件/CID;每个收件人的上下文独立生成,二维码中的rid也不同,扫码即访问phishURL。 - 统计闭环:二维码内容就是
phishURL(模板 URL +rid查询参数),手机扫码后请求 Gophish 的追踪路由,后端按rid把该收件人标记为 Clicked Link;原文实测 campaign 面板 Email Sent/Opened/Clicked Link 均变为 1。 - 为什么有效:邮件正文不含明文钓鱼链接,只有 base64 图片;不主动解码二维码的邮件网关看不到 URL,而用户手机扫码后进入钓鱼页,形成检测管道与人类视觉之间的信息差(Quishing)。
触发条件
- 攻击者能获取 Gophish 源码并自行编译、部署(自建钓鱼基础设施);
- 目标邮件客户端能渲染
data:image/png;base64内联图片(主流客户端通常支持); - 收件人使用手机扫码,且扫码后能访问 Gophish 的追踪 URL/钓鱼页;
- Gophish 使用的二维码库(如
skip2/go-qrcode)与 Go 版本兼容,改动能编译通过; - 需要模板引擎支持新增字段(即修改
PhishingTemplateContext并重新编译,而非仅改模板文件)。
利用步骤
- 在
models.Template对应上下文结构体PhishingTemplateContext中新增QrCode string字段。 - 在
NewPhishingTemplateContext中,取已注入rid的phishURL.String(),用qrcode.WriteFile(url, qrcode.Medium, 256, filename)生成 PNG(文件名可用 UUID 避免并发冲突)。 - 读取 PNG 字节,
base64.StdEncoding.EncodeToString后拼成data:image/png;base64,<...>,赋给QrCode,并删除临时文件。 - 重新编译 Gophish,启动后在 Email Templates 中写
<img src="{{.QrCode}}" alt="QR">,保存不再报QrURL字段错误。 - 创建 Campaign 发送;收件人扫码访问带
rid的 URL,Gophish 记录 Clicked Link。 - 在 Dashboard/Campaign 面板查看扫码统计,按收件人
rid关联后续凭据提交或下载行为。
PoC
核心 Go 代码(按原文改造逻辑归纳):
// models.PhishingTemplateContext 增加字段
type PhishingTemplateContext struct {
BaseRecipient
BaseURL string
URL string
QrCode string // 新增:data:image/png;base64,...
TrackingURL string
Tracker string
From string
Rid string
}
// NewPhishingTemplateContext 内生成二维码
id, _ := uuid.NewRandom()
filename := id.String() + ".png"
qrcode.WriteFile(phishURL.String(), qrcode.Medium, 256, filename) // phishURL 已带 rid
file, _ := os.Open(filename)
defer file.Close()
data, _ := io.ReadAll(file)
imgBase64 := "data:image/png;base64," + base64.StdEncoding.EncodeToString(data)
os.Remove(filename)
return PhishingTemplateContext{
BaseRecipient: r,
BaseURL: baseURL.String(),
URL: phishURL.String(),
QrCode: imgBase64,
TrackingURL: trackingURL.String(),
Tracker: "<img alt='' style='display: none' src='" + trackingURL.String() + "'/>",
From: fn,
Rid: rid,
}, nil
邮件模板:
<p>请使用手机扫描下方二维码查看:</p>
<img src="{{.QrCode}}" alt="QR" width="256" height="256">
变体与关联
- 关联:
pentest-initial-access-phishing-cid-dynamic-qr-url-hiding讲 CID 附件内嵌动态二维码 +rid追踪,本卡讲 Gophish 模板上下文内联data:URI 二维码的二次开发;前者是 MIME 层手法,后者是平台模板/统计实现,可组合使用(CID 或 data URI 二选一)。 - 关联:
pentest-initial-access-gophish-fingerprint-removal同属 Gophish 二次开发,但目标是去工具指纹;本卡增加的是二维码投递与扫码统计能力。 - 变体:可用外部二维码 API 生成图片再下载;可把二维码中心叠加企业 Logo 提升可信度;可改为 CID 内嵌以规避部分客户端对 data URI 的限制。
- 边界:依赖收件人手机扫码;纯桌面端用户可能不扫;邮件网关若做二维码解码/OCR,隐藏效果下降。
检测与防御
- 网关检测:对邮件图片做二维码解码,提取 URL 后走信誉/沙箱;对
data:image/png;base64大块内联图片提高警惕。 - 终端/邮件客户端:限制或提示内联 data URI 图片;对二维码内容做预览与域名提示。
- 检测 Gophish 改造:结合 Gophish 指纹卡(X-Gophish 头、Server 头、/track 路由、rid 参数)与模板中
{{.QrCode}}/data URI 特征做规则。 - 防御:用户培训强调扫码前核对域名;企业移动设备管理限制扫码跳转;封禁已知钓鱼域名与追踪 URL。