Como verificar a assinatura de um webhook
Monte a string t.body a partir do cabeçalho X-CalcLib-Signature, calcule o HMAC-SHA256 com o seu segredo e compare antes de processar a entrega.
Um endpoint de webhook adicionado em Webhooks recebe um POST assinado sempre que alguém executa o seu embed. Cada entrega traz um cabeçalho X-CalcLib-Signature no formato t=<unix time>,v1=<signature>.
Verifique antes de interpretar
- Leia o corpo bruto da requisição. Interpretar e serializar o JSON de novo altera os bytes, e a assinatura nunca vai coincidir.
- Pegue o
tdo cabeçalho e monte a stringt.body: o timestamp, um ponto e o corpo bruto. - Calcule o HMAC-SHA256 dessa string com o segredo do seu endpoint, em hexadecimal.
- Compare o resultado com cada valor
v1em tempo constante. Enquanto você faz a rotação de um segredo, o cabeçalho pode trazer dois valoresv1; qualquer um deles pode coincidir. - Rejeite a entrega se
testiver a mais de 5 minutos do seu relógio.
Entregas que falham
Elas são reenviadas após 1 minuto, 5 minutos, 30 minutos, 2 horas e 8 horas. Um endpoint que falha 20 vezes seguidas é desativado e enviamos um e-mail a você, de acordo com a opção do produto em Notificações.