Wychodzące webhooki i podpisy HMAC
Otrzymuj bezpiecznie zdarzenia w czasie rzeczywistym ze swojego projektu Aurabase na własnych serwerach, korzystając z podpisów kryptograficznych HMAC-SHA256.
Architektura webhooków#
Aurabase wychodzące webhooki transmitują zdarzenia systemowe do adresów URL wywołania zwrotnego (np. rejestracja nowego użytkownika, pomyślna płatność, aktualizacja wiersza tabeli).
Każdy wysłany webhook zawiera unikalny identyfikator zdarzenia event_id, który umożliwia wdrożenie idempotentnego przetwarzania na Twoich serwerach.
Struktura nagłówka podpisu X-Aurabase#
Każde żądanie HTTP POST wydane przez Aurabase zawiera następujący nagłówek zabezpieczeń:
POST /webhook HTTP/1.1
Host: api.votre-domaine.com
Content-Type: application/json
X-Aurabase-Event-Id: evt_01J8Y6Q9K3M7Z...
X-Aurabase-Signature: t=1724060000,v1=9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
Zweryfikuj podpis HMAC-SHA256#
import crypto from 'node:crypto'
export function verifyAurabaseWebhook(
rawBody: string, signatureHeader: string, secret: string
): boolean {
const parts = Object.fromEntries(
signatureHeader.split(',').map(p => p.split('=')),
)
const { t: timestamp, v1: signature } = parts
// 1. Ochrona przed atakami polegającymi na powtórzeniu (maks. 5 min)
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) {
return false
}
// 2. Obliczenie HMAC-SHA256 na timestamp.rawBody
const expected = crypto
.createHmac('sha256', secret)
.update(timestamp + '.' + rawBody)
.digest('hex')
// 3. Bezpieczne porównanie w stałym czasie
return crypto.timingSafeEqual(
Buffer.from(signature), Buffer.from(expected)
)
}
Zarządzanie błędami i kolejka niedostarczonych wiadomości#
Jeśli Twój serwer odpowie kodem błędu HTTP (4xx, 5xx) lub doświadczy przekroczenia limitu czasu (limit czasu 10 sekund), Aurabase automatycznie ponawia próbę wysyłania zgodnie z wykładniczym opóźnieniem :
- Próba 1: natychmiastowa
- Próba 2: Po 15 sekundach
- Próba 3: Po 1 minucie
- Próba 4: Po 5 minutach
- Próba 5: Po 30 minutach
Po 5 kolejnych niepowodzeniach zdarzenie jest umieszczane w Kolejce utraconych wiadomości (DLQ) w Studio w celu sprawdzenia i ręcznego odtworzenia.