Os cabeçalhos
Cada entrega traz quatro cabeçalhos:Como a assinatura é montada
A assinatura é um HMAC-SHA256, com o segredo do endpoint como chave, sobre a stringtimestamp + . + corpo bruto da requisição:
timestamp entra na mensagem assinada de propósito: reusar o mesmo corpo com outro horário quebra a assinatura, o que impede replay.
Validar a entrega
Três passos: rejeite entregas antigas, recalcule a assinatura e compare em tempo constante.Proteja-se contra replay e duplicatas
- Janela de tempo. Recuse entregas cujo
X-QSmartHub-Timestampesteja a mais de 300 segundos do seu relógio. A assinatura cobre o timestamp, então ele não pode ser forjado. - Idempotência. Guarde os
X-QSmartHub-Delivery(oidevt_...) já processados e ignore repetições. A entrega é pelo menos uma vez, então o mesmo evento pode chegar de novo.
Requisitos do seu endpoint
O QSmartHub só entrega para endereços que ele consegue alcançar com segurança:- HTTPS obrigatório, em host público (portas 80 ou 443).
- Endereços privados, loopback e de rede local são recusados, tanto no cadastro quanto a cada entrega (proteção contra SSRF).