Shopify 安全与风控

shpat_ 令牌被推到 GitHub 公开仓库怎么处理

现象#

GitHub 发来 secret scanning 告警邮件,代码里明写着 X-Shopify-Access-Token: shpat_...,几天后后台出现陌生商品改动和一批发往转运仓的订单。

原因#

  • custom app 令牌长期有效,删掉 commit 也不会让已经抓取到的令牌失效
  • fork、PR 页面、CI 日志与包缓存都可能留有历史副本,只改当前分支不够
  • 令牌带着 write_orders 与 write_products,攻击者可直接改价、发货、导出客户
  • 仓库里常一起提交 .env 与 shopify.app.toml,client secret 和回调地址一并暴露

处理步骤#

  1. 先吊销:在 Develop apps > 该应用 卸载再重装,生成新令牌,不要先忙着删仓库
  2. 把新令牌写入服务器密钥管理,替换 SHOPIFY_ADMIN_TOKEN 并重启服务
  3. 用 git filter-repo --path .env --invert-paths 清理历史,再强制推送并删除旧 fork
  4. 在 GitHub 开启 secret scanning 与 push protection,CI 日志禁止打印请求头
  5. 查活动日志、订单与 webhook 订阅,回滚攻击者创建的折扣码、发货和改价

验收标准#

旧令牌请求返回 401,git log -S shpat_ 无结果,仓库与 CI 日志搜不到令牌,活动日志无陌生操作。

专项深读 · 可复现排查指南

访问令牌泄露:先止损,再排查历史调用

一旦私有访问令牌被提交到公开代码仓库,应按真实泄露处理;删除最新代码行并不能删除 Git 历史,也不能撤销已复制的凭据。

建议按以下顺序复现和定位

  1. 立即在可控的 App 管理入口撤销或轮换受影响凭据,并暂停可能造成进一步泄露的部署。
  2. 从服务器环境变量或秘密管理器替换所有使用旧令牌的服务,核对最小权限 scopes。
  3. 检查应用访问日志、订单与客户数据变更、异常 API 调用,保留事件时间线。
  4. 清理仓库历史及缓存(必要时联系代码托管平台),并检查 CI/CD、容器镜像与其他副本。
  5. 重新启用服务后监控异常访问,修订开发密钥管理规范。

可参考的示例(非真实客户环境)

# 防止再次提交敏感文件(示意)
.env
.env.local
*.secret
# 在 .gitignore 中添加以上规则;但它不会撤回历史已提交内容
注意:不要把泄露 token 粘贴进客服工单或在线代码助手。单纯撤下 GitHub 页面不构成完全修复,必须先撤销令牌。

交付与验证记录应该包含什么

旧令牌已不可用,新令牌只存在受控环境,敏感数据访问日志经过审查,仓库历史和 CI 都有检查结果。

原始技术资料:Shopify / Google 官方文档。本节为根据公开文档整理的排查方法与模拟示例,未宣称来自客户项目或已在您的店铺实测。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。