Xác minh chữ ký webhook
Tạo chuỗi t.body từ header X-CalcLib-Signature, tính HMAC-SHA256 bằng khóa bí mật của bạn và so sánh trước khi xử lý lần gửi đó.
Điểm cuối webhook được thêm trong Webhook sẽ nhận một yêu cầu POST có chữ ký mỗi khi có người chạy mã nhúng của bạn. Mỗi lần gửi đều có header X-CalcLib-Signature với dạng t=<unix time>,v1=<signature>.
Xác minh trước khi phân tích
- Đọc nội dung thô của yêu cầu. Việc phân tích rồi tuần tự hóa lại JSON sẽ làm thay đổi các byte, và chữ ký sẽ không bao giờ khớp.
- Lấy
ttừ header và tạo chuỗit.body: dấu thời gian, một dấu chấm, rồi đến nội dung thô. - Tính HMAC-SHA256 của chuỗi đó bằng khóa bí mật của điểm cuối, ở dạng hex.
- So sánh với từng giá trị
v1trong thời gian không đổi. Khi bạn đang xoay vòng khóa bí mật, header có thể chứa hai giá trịv1; giá trị nào khớp cũng được. - Từ chối lần gửi nếu
tlệch hơn 5 phút so với đồng hồ của bạn.
Các lần gửi thất bại
Chúng được thử lại sau 1 phút, 5 phút, 30 phút, 2 giờ và 8 giờ. Điểm cuối thất bại liên tiếp 20 lần sẽ bị vô hiệu hóa và chúng tôi sẽ gửi email cho bạn, theo công tắc sản phẩm trong Thông báo.