IP 白名單
驗證可證明_呼叫_者知曉您的密鑰。IP 允許清單會縮小呼叫可能來自的範圍,因此僅憑洩露的憑證本身並不足以進行呼叫。請在**「進階設定」→「IP 允許清單」**中,針對每個 webhook 進行設定。
此機制會套用在 webhook 所使用的任何驗證機制之上,包括**「無」**的情況。來自任何其他地址的請求,在尚未檢查憑證或簽名之前,便會因「403」而遭拒絕,並顯示原因「ip_not_allowed」。
填寫清單
每行一筆,最多 50 筆:
- 一個 IPv4 或 IPv6 位址,例如
203.0.113.10或2001:db8::1 - 一個 CIDR 範圍,例如
203.0.113.0/24或2001:db8::/32
大多數值得列入白名單的寄件者都會公開其外發 IP 範圍 - - Stripe、GitHub、Shopify 和 Square 皆是如此。將這些範圍加入白名單,並在寄件者宣布變更時重新核對:若白名單從未更新,最終將會誤拒合法流量。
它會檢查哪些請求
| 請求 | 白名單適用 |
|---|---|
| 對 webhook URL 的呼叫 | 是的 |
| 對應用程式代理伺服器 URL 的呼叫 | 不 - - 這些郵件是從 Shopify 的伺服器發送給我們的,並非來自您的寄件者 |
| 一趟預定行程 | 不 - - 我們會自行提出申請 |
| 呼叫此 Webhook 的 Shopify Flow 操作 | 不 |
| 從「歷史紀錄」中傳送測試資料與重播 | 不 |
正因如此,白名單無法取代身份驗證:有幾條通往 webhook 的合法路徑並未經過白名單檢查。
我們進行比對的地址
我們會根據請求實際發送的來源位址進行比對。若在發送者與我們之間存在任何中介層 - - 例如企業代理伺服器、API 閘道、隧道或 CDN - - 您必須將該位址加入白名單,而非原始伺服器的位址。
最快速的查找方法:發送一個白名單為空的請求,在 歷史與故障排除 中開啟該條目,並讀取我們記錄的地址。
當事情出錯時
已被拒絕的請求仍會出現在「歷史紀錄」中,並附有 403 和 ip_not_allowed,因此您可以查看被拒絕的網址並將其加入清單。系統絕不會在未經通知的情況下刪除任何記錄。
相關內容
- 驗證 - 憑證、持有人、基本參數及查詢參數。
- 驗證已簽名的 Webhook - 針對進行簽名的發件人進行 HMAC 驗證。
- 歷史與故障排除 - 每項請求,不論是否被接受。

