Ein Webhook-Kanal sendet per POST JSON an eine URL Ihrer Wahl, wenn ein Monitor ausfällt oder wieder erreichbar ist, und auch bei anderen Alarmen wie langsamen Antworten, ablaufenden Zertifikaten und geänderten DNS-Einträgen. Jede Anfrage ist signiert, sodass Ihr Endpunkt prüfen kann, ob sie wirklich von Uptimecheck stammt.
Webhook hinzufügen
Öffnen Sie in der Seitenleiste Alert channels und wählen Sie Add channel.Wählen Sie Webhook und geben Sie die Endpoint URL ein.Wählen Sie Add channel und kopieren Sie das angezeigte Signing Secret. Es wird nur einmal angezeigt.Wählen Sie Send test, um einen Testaufruf zu senden.
Signatur verifizieren
Jede Anfrage enthält zwei Header:
x-uptimecheck-timestamp: Unix-Zeit in Sekunden, zu der die Anfrage signiert wurde.x-uptimecheck-signature: sha256=, gefolgt vom hexadezimalen HMAC-SHA256 aus Zeitstempel, einem Punkt und dem unveränderten Body, mit dem Signing Secret des Kanals als Schlüssel.
Berechnen Sie denselben Wert aus dem unveränderten Body, bevor Sie ihn parsen, vergleichen Sie in konstanter Zeit und lehnen Sie alte Zeitstempel ab. In Node.js:
import { createHmac, timingSafeEqual } from „node:crypto“;
export function isFromUptimecheck(rawBody, headers, secret) {
const timestamp = headers[„x-uptimecheck-timestamp“] ?? „“;
const signature = headers[„x-uptimecheck-signature“] ?? „“;
const expected = „sha256=“ + createHmac(„sha256“, secret).update(`${timestamp}.${rawBody}`).digest(„hex“);
const fresh = Math.abs(Date.now() / 1000 – Number(timestamp)) < 300;
return fresh && signature.length === expected.length && timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}
Eine Python-Version und alle Felder des Payloads finden Sie in der API-Dokumentation.
Gut zu wissen
Antworten Sie innerhalb von 10 Sekunden mit einem beliebigen 2xx-Status. Alles andere wird noch viermal wiederholt, nach 30 s, 2 min, 10 min und 30 min.Das Feld event gibt an, was passiert ist, etwa monitor.down, monitor.up, monitor.slow, certificate.expiring oder dns.changed. Die API-Referenz listet alle Events auf und zeigt, wie Sie die Signatur verifizieren.Nutzen Sie HTTPS und erledigen Sie aufwendige Verarbeitung erst, nachdem Sie geantwortet haben.
Sehen Sie sich alle Alarmkanäle an, oder automatisieren Sie die Einrichtung mit der REST API.