HideGuardTài liệu

Dashboard · Cấu hình

Webhooks

Đăng ký endpoint, đọc lần gửi, và vì sao chữ ký là bắt buộc.

Đẩy sự kiện sang hệ thống của bạn thay vì hỏi liên tục.

Đăng ký endpoint#

Khai URL của bạn và chọn loại sự kiện muốn nhận. Mỗi webhook có một signing secret (whsec_…), hiện một lần.

Luôn xác minh chữ ký#

Một endpoint webhook nhận POST từ bất kỳ ai tìm thấy URL của nó. Nếu không xác minh chữ ký, bạn đang để người lạ ghi vào hệ thống của mình.

Chi tiết header, cách tính và chống phát lại: Payload webhook.

Danh sách lần gửi#

Mỗi lần gửi được ghi lại: thời điểm, mã trạng thái endpoint trả về, thời lượng, và số lần thử lại. Mở một dòng để xem payload đã gửi và phản hồi nhận được.

Đây là nơi trả lời "chúng tôi có gửi không" một cách dứt khoát, thay vì tranh luận hai chiều.

Bảo vệ phía chúng tôi#

Mọi request tới URL do khách hàng khai đều đi qua một lớp kiểm tra địa chỉ, và địa chỉ được kiểm bên trong chính lần phân giải DNS của socket.

Lý do: một tên miền có thể phân giải ra địa chỉ nội bộ, và 169.254.169.254 là endpoint metadata của các nhà cung cấp cloud. Kiểm tra trước rồi mới kết nối sẽ để lọt trường hợp DNS trả lời khác nhau giữa hai lần.

Khi endpoint của bạn chết#

Lần gửi thất bại sẽ được thử lại. Thất bại liên tục kéo dài sẽ hiện ra trong danh sách, và đó là thứ bạn muốn đặt một cảnh báo lên.