Webhooks

Un webhook envoie une requête POST en JSON à l’adresse de votre choix quand un événement se produit, par exemple quand un service tombe. Ils se gèrent dans Développeurs, à partir de l’offre Pro.

Ce que reçoit votre serveur

• X-NorminUp-Event : le nom de l’événement.
• X-NorminUp-Attempt : le numéro de la tentative, en cas de nouvel essai.
• X-NorminUp-Signature : si vous avez défini un secret, la signature sha256=… du corps.

Vérifier la signature

const crypto = require("crypto");

function isFromNorminUp(rawBody, header, secret) {
	const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
	return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(header || ""));
}

Réglages

• En-têtes personnalisés, et un modèle de corps avec {{event}}, {{timestamp}} et {{payload.champ}}.
• Bouton de test, journal des envois, pause et reprise.

L’adresse doit être publique : les adresses de réseau privé sont refusées et les redirections ne sont pas suivies.