1. 尋找計算機
  2. 輸入數字與單位
  3. 讀懂並信賴結果
  4. 儲存、分享與嵌入
  5. 使用 API 開發
  6. 帳號與方案
  7. 隱私與你的資料
  8. 解決問題

驗證 Webhook 簽章

根據 X-CalcLib-Signature 標頭組出字串 t.body,用你的密鑰計算 HMAC-SHA256,並在處理該次傳送內容之前先進行比對。

API 權杖、用量、供 AI 代理使用的 MCP 伺服器與 Webhook。

在 Webhooks 中新增的 webhook 端點,每當有人執行你的嵌入內容時,就會收到一個已簽署的 POST。每次傳送都會帶有 X-CalcLib-Signature 標頭,格式為 t=<unix time>,v1=<signature>。

先驗證,再解析

  1. 讀取原始的請求內容。如果解析後再重新序列化 JSON,位元組會改變,簽章就永遠無法相符。
  2. 從標頭取出 t,並組出字串 t.body:時間戳記、一個點,再接上原始內容。
  3. 使用你的端點密鑰,對該字串計算 HMAC-SHA256,並以十六進位表示。
  4. 以常數時間比較的方式,與每一個 v1 值進行比對。在輪換密鑰期間,標頭可能帶有兩個 v1 值,任何一個相符即可。
  5. 如果 t 與你的系統時間相差超過 5 分鐘,請拒絕該次傳送。

傳送失敗時

系統會在 1 分鐘、5 分鐘、30 分鐘、2 小時和 8 小時後重試。端點連續失敗 20 次就會被停用,我們也會寄信通知你,並依照通知中的產品開關設定。

這篇文章對你有幫助嗎?

還是沒解決? 聯絡客服 · 說明中心