Cách Linear gửi webhook

Linear yêu cầu phản hồi 200 trong 5 giây và thử lại tối đa 3 lần, sau 1 phút, 1 giờ và 6 giờ. Định dạng HMAC-SHA256 linear-signature và code xác minh Node.

Hành vi gửi

Lấy từ tài liệu của chính hãng, kiểm tra lần cuối 2026-08-06. Hãng không nêu con số nào thì bảng này cũng không ghi.

Thời hạn phản hồi5 giây

Kiểm tra handler của bạn có phản hồi kịp không

Thử lạiTối đa 3 lần, sau 1 phút, 1 giờ và 6 giờ
Ngừng gửiCó thể bị vô hiệu hóa nếu URL tiếp tục không phản hồi; ngưỡng không được công bố

Chữ ký

Kiểm chứng bằng một bộ xác minh chạy thật, có bộ test chứng minh, chứ không đọc từ tài liệu. Kiểm chứng lần cuối 2026-08-20.

Thuật toánHMAC-SHA256
Payload được kýraw body
Encodinghex
Headerlinear-signature
Dung saikhông quy định

Xác minh

Dùng raw body của request, đúng từng byte, trước mọi bước parse JSON. Mọi cơ chế trên trang này đều hỏng ngay khi framework serialize lại payload.

const crypto = require("node:crypto");

// hex(HMAC-SHA256(webhook secret, raw body))
const expected = crypto
  .createHmac("sha256", webhookSecret) // per webhook, on its detail page
  .update(rawBody)
  .digest("hex");
const received = Buffer.from(req.headers["linear-signature"] ?? "");
const wanted = Buffer.from(expected);
// timingSafeEqual throws on a length mismatch, so check that first.
const valid =
  received.length === wanted.length && crypto.timingSafeEqual(received, wanted);

Những chỗ dễ vấp

Payload có mang webhookTimestamp; so nó với đồng hồ là cách duy nhất để chống tấn công phát lại (replay attack), vì bản thân chữ ký không bao gồm dấu thời gian nào.

Đọc thêm

AnyHook đứng trước các endpoint nhận webhook từ Linear: trả lời sau khoảng 1 giây, tự thử lại theo lịch riêng khi server của bạn ngừng hoạt động, và giữ mọi sự kiện để bạn phát lại được. Đổi một URL, giữ nguyên code.

Cách hoạt động →