驗證 Webhook 簽章
根據 X-CalcLib-Signature 標頭組出字串 t.body,用你的密鑰計算 HMAC-SHA256,並在處理該次傳送內容之前先進行比對。
在 Webhooks 中新增的 webhook 端點,每當有人執行你的嵌入內容時,就會收到一個已簽署的 POST。每次傳送都會帶有 X-CalcLib-Signature 標頭,格式為 t=<unix time>,v1=<signature>。
先驗證,再解析
- 讀取原始的請求內容。如果解析後再重新序列化 JSON,位元組會改變,簽章就永遠無法相符。
- 從標頭取出
t,並組出字串t.body:時間戳記、一個點,再接上原始內容。 - 使用你的端點密鑰,對該字串計算 HMAC-SHA256,並以十六進位表示。
- 以常數時間比較的方式,與每一個
v1值進行比對。在輪換密鑰期間,標頭可能帶有兩個v1值,任何一個相符即可。 - 如果
t與你的系統時間相差超過 5 分鐘,請拒絕該次傳送。
傳送失敗時
系統會在 1 分鐘、5 分鐘、30 分鐘、2 小時和 8 小時後重試。端點連續失敗 20 次就會被停用,我們也會寄信通知你,並依照通知中的產品開關設定。