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,因此您可以查看被拒絕的網址並將其加入清單。系統絕不會在未經通知的情況下刪除任何記錄。

相關內容