Conferir a assinatura
Todo webhook vem assinado. Confira a assinatura antes de confiar no conteúdo: assim ninguém finge ser a Grinny Pay para liberar um acesso.
Como funciona
O cabeçalho X-Grinny-Signature traz o horário do envio (t, em segundos desde 1970) e a assinatura (v1):
X-Grinny-Signature: t=1760549530,v1=5f2b8c0d...e91a- Pegue o corpo cru do pedido, exatamente como chegou (antes de transformar em JSON).
- Monte o texto
t + "." + corpo. - Calcule o HMAC-SHA256 desse texto com o segredo do webhook (
whsec_...), em hexadecimal. - Compare com o
v1usando uma comparação segura (tempo constante). - Recuse se o
testiver a mais de 5 minutos do seu relógio. - Ignore se já processou um evento com o mesmo
id.
Exemplos
<?php
$corpo = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_GRINNY_SIGNATURE'] ?? ''), $s);
$esperado = hash_hmac('sha256', ($s['t'] ?? '') . '.' . $corpo, getenv('GRINNY_WEBHOOK_SECRET'));
if (!hash_equals($esperado, $s['v1'] ?? '') || abs(time() - (int) ($s['t'] ?? 0)) > 300) {
http_response_code(401);
exit;
}
$evento = json_decode($corpo, true);
// Já processou este $evento['id']? Responda 200 e pare aqui.
if ($evento['tipo'] === 'venda.aprovada') {
// libere o acesso do pedido $evento['dados']['referencia']
}
http_response_code(200);import crypto from 'node:crypto';
import express from 'express';
const app = express();
// Corpo cru: a assinatura é calculada sobre os bytes exatos que chegaram.
app.post('/webhooks/grinny', express.raw({ type: 'application/json' }), (req, res) => {
const partes = Object.fromEntries(
String(req.get('X-Grinny-Signature') || '').split(',').map((p) => p.split('='))
);
const esperado = crypto
.createHmac('sha256', process.env.GRINNY_WEBHOOK_SECRET)
.update(`${partes.t}.${req.body}`)
.digest('hex');
const ok = partes.v1 && partes.v1.length === esperado.length &&
crypto.timingSafeEqual(Buffer.from(esperado), Buffer.from(partes.v1));
if (!ok || Math.abs(Date.now() / 1000 - Number(partes.t)) > 300) return res.sendStatus(401);
const evento = JSON.parse(req.body);
// Já processou evento.id? Responda 200 e pare aqui.
if (evento.tipo === 'venda.aprovada') {
// libere o acesso do pedido evento.dados.referencia
}
res.sendStatus(200);
});import hashlib
import hmac
import os
import time
from flask import Flask, request
app = Flask(__name__)
def assinatura_valida(corpo: bytes, cabecalho: str) -> bool:
partes = dict(p.split("=", 1) for p in cabecalho.split(",") if "=" in p)
t, v1 = partes.get("t", ""), partes.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False
esperado = hmac.new(
os.environ["GRINNY_WEBHOOK_SECRET"].encode(),
t.encode() + b"." + corpo,
hashlib.sha256,
).hexdigest()
return hmac.compare_digest(esperado, v1)
@app.post("/webhooks/grinny")
def webhook():
# get_data() devolve os bytes exatos que chegaram (antes de virar JSON).
corpo = request.get_data()
if not assinatura_valida(corpo, request.headers.get("X-Grinny-Signature", "")):
return "", 401
evento = request.get_json(force=True)
# Já processou evento["id"]? Responda 200 e pare aqui.
if evento["tipo"] == "venda.aprovada":
pass # libere o acesso do pedido evento["dados"]["referencia"]
return "", 200package main
import (
"crypto/hmac"
"crypto/sha256"
"encoding/hex"
"encoding/json"
"io"
"net/http"
"os"
"strconv"
"strings"
"time"
)
func assinaturaValida(corpo []byte, cabecalho string) bool {
var t, v1 string
for _, p := range strings.Split(cabecalho, ",") {
kv := strings.SplitN(p, "=", 2)
if len(kv) != 2 {
continue
}
switch kv[0] {
case "t":
t = kv[1]
case "v1":
v1 = kv[1]
}
}
ts, err := strconv.ParseInt(t, 10, 64)
if err != nil || time.Now().Unix()-ts > 300 || ts-time.Now().Unix() > 300 {
return false
}
mac := hmac.New(sha256.New, []byte(os.Getenv("GRINNY_WEBHOOK_SECRET")))
mac.Write([]byte(t + "." + string(corpo)))
esperado := hex.EncodeToString(mac.Sum(nil))
return hmac.Equal([]byte(esperado), []byte(v1))
}
func webhook(w http.ResponseWriter, r *http.Request) {
corpo, err := io.ReadAll(http.MaxBytesReader(w, r.Body, 1<<20))
if err != nil || !assinaturaValida(corpo, r.Header.Get("X-Grinny-Signature")) {
w.WriteHeader(http.StatusUnauthorized)
return
}
var evento struct {
ID string `json:"id"`
Tipo string `json:"tipo"`
Dados json.RawMessage `json:"dados"`
}
if json.Unmarshal(corpo, &evento) != nil {
w.WriteHeader(http.StatusBadRequest)
return
}
// Já processou evento.ID? Responda 200 e pare aqui.
if evento.Tipo == "venda.aprovada" {
// libere o acesso do pedido (leia "referencia" em evento.Dados)
}
w.WriteHeader(http.StatusOK)
}
func main() {
http.HandleFunc("/webhooks/grinny", webhook)
http.ListenAndServe(":3000", nil)
}Nunca libere acesso só porque chegou um POST no seu endereço. Sem conferir a assinatura, qualquer pessoa que descobrir a URL consegue mandar um falso venda.aprovada.
Se o segredo vazar
Exclua o webhook no painel e cadastre de novo: nasce um segredo novo. Atualize o seu servidor antes de apagar o antigo para não perder avisos.