Benachrichtigungskanäle

Authentifizierung

Alle Beispiele setzen einen Bearer-Token voraus:

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

Kanaltypen und Config

Jeder Kanaltyp hat eine spezifische config-Struktur:

Geheimnisse (Webhook-secret, Slack-/Discord-URLs, PagerDuty-Routing-Keys, Pushover-Zugangsdaten, Opsgenie-API-Keys) werden verschlüsselt gespeichert und in API-Antworten unkenntlich gemacht (durch null ersetzt, mit hasSecret: true-Flags).

Webhook-Signaturprüfung

Wenn auf einem Webhook-Kanal ein secret konfiguriert ist, signiert Uptimeify ausgehende Payloads, damit Empfänger die Authentizität verifizieren können.

Algorithmus: HMAC-SHA256

Header: X-Webhook-Signature — hex-kodierter HMAC-SHA256-Digest

Begleitende Header, die mit jedem Webhook gesendet werden:

Verifizierungsschritte:

1. Lies den rohen Request-Body als String (nicht zuerst als JSON parsen).
2. Berechne HMAC-SHA256 mit dem im Kanal konfigurierten secret als Schlüssel und dem rohen Body-String als Nachricht.
3. Vergleiche das Ergebnis (hex-kodiert) mit dem Wert des X-Webhook-Signature-Headers per konstanter Laufzeit-Vergleich (constant-time comparison).
4. Optional kannst du X-Webhook-Timestamp für Replay-Schutz prüfen.

// Node.js verification example
const crypto = require('crypto')

function verifySignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex')
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  )
}

# Python verification example
import hmac, hashlib

def verify_signature(raw_body, signature, secret):
    expected = hmac.new(
        secret.encode('utf-8'),
        raw_body.encode('utf-8'),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

Scope-Auflösung

Beim Auflisten von Kanälen bestimmt der Scope, welche Kanäle zurückgegeben werden:

• Organisationsebene (nur organizationId, kein customerId/websiteId): Standardkanäle für alle Kunden
• Kundenebene (customerId gesetzt, kein websiteId): Kundenspezifische Overrides
• Website-Ebene (websiteId gesetzt): Overrides pro Monitor

Endpunkte

• Benachrichtigungskanäle auflisten
• Benachrichtigungskanal erstellen
• Benachrichtigungskanal aktualisieren
• Benachrichtigungskanal löschen
• Benachrichtigungskanal testen