Shopify 应用 IP 白名单大限将至:11 月 20 日前必须配置
10 月 27 日,Shopify 还只是”推荐”公开应用配置 IP 白名单;11 月 5 日的 changelog 把措辞换成了 required。所有调用 Admin API 的公开应用,必须在 2026 年 11 月 20 日 23:59(美东时间)前开启;用了 bulk operations 的提前一周,11 月 12 日。
理由写在公告开头:旺季到了。
Shopify 在查什么
Enforcement 打开后,Shopify 检查每一个用你 app token 发出的 GraphQL 和 REST Admin API 请求的来源 IP。不在白名单里,返回 403;来源地址确认不了的,同样 403。token 泄露的后果从”账号丢了”降级成”只能在你自己的服务器上用”。
有两类请求配了也白配:Shopify Flow 的 Send HTTP request 动作里带的 access token,还有从 Oxygen 托管的 storefront 上用 token 发起的 Admin API 请求,原因都是来源 IP 无法确认。这类团队只能改成服务器端转发。dev store 预览、embedded 页面和 POS UI extensions 的 Direct API access 永远不被拦截。
静态 IP 十分钟配完,serverless 走 ASN
入口在 Dev Dashboard:打开应用,Settings,IP allowlist 区块点 Manage。
举个例子,一家做定制宠物画像的独立站,自研应用后端跑在两台 EC2 上,出口 IP 固定,把两个地址写进去就完事。规则:最多 250 条,一行一条;IPv4 掩码 /16 或更窄,IPv6 /32 或更窄;只填公网地址,机器在 NAT 后面填网关地址;范围要从网络地址起写,203.0.113.0/24 可以,203.0.113.7/24 不行;走 IPv6 出网的,IPv6 地址也要列上。
跑在 Vercel、AWS Lambda 上的,出口 IP 每次请求都在变,就按 ASN 放行:最多 10 个 ASN,AS 前缀可有可无,建议再勾国家收窄,最多 10 个。Shopify 靠 MaxMind GeoLite 数据判定来源归属,而 ASN 是共享网络,同 ASN 里别家的服务器也在放行范围内,能用固定 IP 就别用 ASN。
填完先别开 Enforcement,点 Run test,Shopify 拿你最近 30 天的真实流量回放一遍,有会被挡的地址就调整再测。干净了再开 Enforcement 保存,最后从白名单外发一个 Admin API 请求,看到 403 才算配完。
错过死线的连锁反应
11 月 20 日起,没配的应用从 App Store 下架、禁止新装,商家在 Settings > Apps 里会看到标记;已装店铺暂时照常跑。2027 年 1 月 15 日,商家 admin 里开始弹警告。2027 年 4 月 1 日,Admin API 请求直接被拒,应用停摆。
custom apps 也在范围内:要在组织外的店铺上新装,11 月 20 日起必须先配;已经装在组织外店铺的,2027 年 1 月 1 日前补上。只在自己组织店铺里用的不强制,官方原话是 highly recommend。
商家现在就能在 Settings > Apps 看到应用的安全配置,token 类型、有没有白名单,一目了然。买家看不到,但替店铺做技术选型的人看得见。
ASN 判定依赖 MaxMind 的数据,边缘地址查不到 ASN 或国家会被直接拒,误杀率官方没说。Run test 回放只覆盖 30 天,够不够稳我还没验证过,配完第一周盯一下 API 日志。
参考资料:
- https://shopify.dev/changelog/blog/app-security-updates-ip-allowlist-is-now-required
- https://shopify.dev/docs/apps/build/dev-dashboard/ip-allowlist