♧ Godown 安全知识树

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 等)执行 Go text/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 并重新编译,而非仅改模板文件)。

利用步骤

  1. 在 models.Template 对应上下文结构体 PhishingTemplateContext 中新增 QrCode string 字段。
  2. 在 NewPhishingTemplateContext 中,取已注入 rid 的 phishURL.String(),用 qrcode.WriteFile(url, qrcode.Medium, 256, filename) 生成 PNG(文件名可用 UUID 避免并发冲突)。
  3. 读取 PNG 字节,base64.StdEncoding.EncodeToString 后拼成 data:image/png;base64,<...>,赋给 QrCode,并删除临时文件。
  4. 重新编译 Gophish,启动后在 Email Templates 中写 <img src="{{.QrCode}}" alt="QR">,保存不再报 QrURL 字段错误。
  5. 创建 Campaign 发送;收件人扫码访问带 rid 的 URL,Gophish 记录 Clicked Link。
  6. 在 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。