Shopify 在 2026 年 11 月 5 日把 IP allowlist 從建議措施改為公開 App 的必要設定。使用 bulk operations 的公開 App 必須在 11 月 12 日 11:59 PM ET 前完成,否則 bulk query 與 mutation 會被封鎖;其他公開 App 的期限是 11 月 20 日 11:59 PM ET,未完成者會從 App Store 下架並停止接受新安裝。官方社群公告另說明,既有安裝的 Admin API 請求並非在 11 月 20 日全面失效,而是預計到 2027 年 4 月 1 日才開始失敗。
這不是 Shopify 全站 API 故障,也不是 custom app 的通用期限。官方列出的影響範圍是 public apps;商家在 Dev Dashboard 或 Shopify Admin 建立的 App 不在這次要求內。團隊應先確認 distribution type、是否呼叫 Admin API、過去 180 天是否跑過 bulk operation,再依最早的適用日期排程,不能只看「既有商家還能用」就拖到明年。
固定 IP 與 ASN 不是同等強度的選項
Allowlist 啟用後,Shopify 會檢查使用 App token 呼叫 GraphQL Admin API 或 REST Admin API 的來源。固定 IP 架構可填單一公開 IP 或 CIDR,這是邊界最小的作法;服務若經 NAT gateway、固定 egress proxy 或雲端防火牆出站,應填真正被 Shopify 看到的出口,而不是容器內網位址。
Serverless 平台的出站位址經常變動,Shopify 同日新增以 ASN 加國家限制的方式,最多可填 10 個 ASN 與 10 個國家。不過 ASN 通常由同一雲端供應商的多個客戶共享;若攻擊者拿到 token,又能從被允許的 ASN 與國家發出請求,限制就比專用 IP 寬。能以固定出口整合的正式系統,應優先選 IP/CIDR;無法固定時才評估 ASN,並把國家縮到實際部署地區。
官方文件也列出不相容情境:Shopify Flow 的 Send HTTP request action 所使用的 access token,以及從 Oxygen storefront 發出的 GraphQL Admin API 請求,Shopify 無法確認來源,因此會被拒絕。若現有設計讓商家端、瀏覽器或第三方自動化直接持有 Admin API token,這次工作不應只是把更多網路放進白名單,而應把呼叫收斂到受控後端。
先從流量清冊找出真正出口
第一步盤點所有會代表 App 呼叫 Shopify 的執行點:主 API、webhook worker、排程、queue consumer、資料匯入工具、bulk operation 啟動器、臨時 migration job、維運腳本與災難復原環境。逐一記錄環境、hosting provider、region、公開出口、是否會自動擴區,以及 owner。不要只查目前在線的 web service,因為低頻排程最容易在 allowlist 上線數天後才第一次失敗。
接著比對 Dev Dashboard API logs 與雲端出口紀錄,至少涵蓋最近 30 天。將不認識的來源先查明,不要直接加入;它可能是遺漏的 worker,也可能是 token 已外洩的訊號。對 serverless ASN,要從供應商正式文件或已觀察流量確認 ASN 與國家,不猜測網路編號,也不要為了省事允許供應商的全球範圍。
如果同一 App 同時使用固定 IP 與動態 serverless 出口,要注意 Shopify 的設定是二選一:儲存 IP addresses 或 Networks(ASN)會取代另一種類型。此時可把 serverless 的 Shopify 呼叫經固定 egress 集中送出,或把所有合法執行點統一到經過風險評估的 ASN 方案,不能假設兩份清單會合併。
用測試模式驗證,再開 enforcement
在 Dev Dashboard 的 IP allowlist 設定輸入候選範圍後,先執行 Test against recent traffic,確認自己的近期請求是否會被阻擋。結果通過仍不等於完整驗收,因為測試資料不一定包含月結、低頻同步或故障切換區域。應在 staging 或 dev store 主動觸發 webhook、一般 GraphQL 查詢、mutation、bulk query、bulk mutation 與每一類背景工作。
開啟 enforcement 後,要從允許的出口確認成功,再從清單外的網路以測試 token 發出低風險請求並確認收到 403。監控要把 403 依 shop、job、部署 region、來源出口與 Shopify request ID 分類;403 也可能來自 scope、商店狀態或憑證問題,不能看到狀態碼就自動擴大 allowlist。
上線可先選低流量時段,保留能快速關閉 enforcement 的操作者與 runbook。回滾只是短期恢復措施,不能用來跳過期限;回滾期間要保存失敗請求、queue 游標與未完成 bulk operation,修正清單後再安全重送,避免同一訂單或庫存異動重複執行。
期限前的選擇建議
已有固定 egress 的團隊,現在就用 IP/CIDR 完成 recent traffic test 與外部 403 驗證。純 serverless App 可先評估供應商 ASN 與部署國家;若共用網路的風險超出資料保護要求,就在期限前加入 NAT gateway、固定出口服務或受控 proxy,而不是無限制放寬 ASN。
同時使用 bulk operations 的 App 應以 11 月 12 日為上線期限,並先測 bulk query 與 mutation。沒有 bulk operations 的公開 App 仍要在 11 月 20 日前完成,因為下架與停止新安裝已會直接影響獲客。IP allowlist 也不能取代 11 月 2 日文章整理的 expiring offline token 遷移:一個限制 token 能從哪裡使用,另一個限制能使用多久,兩項都應納入同一份憑證與網路安全清冊。
完成條件不是 Dashboard 出現一份清單,而是能證明所有合法工作都有明確出口、清單外請求必定被拒絕、低頻任務不會漏掉,且 403 發生時團隊知道該修網路、憑證還是權限。這樣才能在縮短 token 外洩攻擊面的同時,不把電商同步與商家營運一起擋在門外。