Zum Inhalt springen

Meldungen

Signatur prüfen

Jede Kursmeldung ist mit dem Geheimnis des Endpunkts signiert. Die Gegenstelle rechnet die Signatur nach und nimmt nur an, was stimmt. Ohne diese Prüfung könnte jeder, der die Adresse kennt, Kurse eintragen.

X-Skirent-Signature: t=1794680608,v1=5f2c…
Teil Bedeutung
t Zeitpunkt des Sendens in Unix-Sekunden
v1 HMAC-SHA256 als Hexadezimalzahl

Signiert wird die Zeichenkette aus t, einem Punkt und dem Rumpf der Anfrage, mit dem Geheimnis als Schlüssel:

v1 = HMAC-SHA256(geheimnis, t + "." + rumpf)
  1. Den Rumpf roh lesen, Byte für Byte, bevor ein JSON-Parser ihn anfasst. Ein neu geschriebenes JSON hat andere Leerzeichen oder eine andere Reihenfolge, und die Signatur passt nicht mehr.
  2. t und v1 aus dem Kopf lesen.
  3. Nachrechnen und vergleichen, mit einem Vergleich in konstanter Zeit.
  4. Das Alter prüfen. Lehnen Sie ab, was älter als fünf Minuten ist. Das schützt davor, dass jemand eine mitgeschnittene Meldung später noch einmal einspielt.

Erst danach wird der Rumpf gelesen und verarbeitet.

import { createHmac, timingSafeEqual } from 'node:crypto';
import { createServer } from 'node:http';
const SECRET = process.env.SKI4ME_WEBHOOK_SECRET; // whsec_…
const MAX_ALTER_S = 300;
function gueltig(kopf, rumpf) {
const teile = Object.fromEntries(String(kopf ?? '').split(',').map((t) => t.split('=')));
const zeit = Number(teile.t);
if (!zeit || !teile.v1) return false;
if (Math.abs(Date.now() / 1000 - zeit) > MAX_ALTER_S) return false;
const erwartet = createHmac('sha256', SECRET).update(`${zeit}.${rumpf}`).digest();
const bekommen = Buffer.from(teile.v1, 'hex');
return bekommen.length === erwartet.length && timingSafeEqual(bekommen, erwartet);
}
const gesehen = new Set(); // im Betrieb: eine Tabelle mit eindeutigem Schlüssel
createServer((req, res) => {
const stuecke = [];
req.on('data', (s) => stuecke.push(s));
req.on('end', () => {
const rumpf = Buffer.concat(stuecke).toString('utf8'); // roh, nicht neu geschrieben
if (!gueltig(req.headers['x-skirent-signature'], rumpf)) {
res.writeHead(401).end();
return;
}
const zustellung = req.headers['x-skirent-delivery'];
if (!gesehen.has(zustellung)) {
gesehen.add(zustellung);
const meldung = JSON.parse(rumpf);
if (!meldung.test) verarbeite(meldung.event, meldung.course);
}
res.writeHead(204).end(); // schnell antworten, auch bei einer Doppelten
});
}).listen(8080);
function verarbeite(ereignis, kurs) {
console.log(ereignis, kurs.uid, kurs.status, kurs.courseName, kurs.date);
}

Mit diesen Werten lässt sich eine eigene Prüfung testen, bevor die erste echte Meldung kommt. Sie stammen aus der Testmeldung des Mitschnitts; das Geheimnis gehört zu einer Ablage, die es nicht mehr gibt.

Geheimnis
whsec_gEUdLhouThmd-tXdmMhSddSYr0w2Iqzn4wT3yza_1Jw
X-Skirent-Signature
t=1794680608,v1=947b98a12f0168d047e7b79a57f0a6ffe82681c1b2164c3175d176de0d2a4983

Rumpf, Byte für Byte

{"event":"course.booked","delivery":"01a1db4c-d50a-7497-8d47-2dfe466de15a","sentAt":"2026-11-14T18:23:28.010Z","tenant":"talstation","test":true,"course":{"uid":"00000000-0000-7000-8000-000000000000","bookingRef":"TEST-000000","status":"booked","provider":"eigen","courseId":"0","courseName":"Testkurs","variantId":"0","date":"2026-11-14","days":1,"timeFrom":"10:00","meetingPointId":null,"meetingPointName":"Testtreffpunkt","skillId":null,"skillName":null,"language":"de","persons":1,"participants":[{"firstName":"Erika","lastName":"Muster","age":30}],"contact":{"name":"Erika Muster","email":"erika@example.org","phone":"+43 000 000000"},"amountCents":0,"currency":"EUR","bookedAt":"2026-11-14T18:23:28.010Z","updatedAt":"2026-11-14T18:23:28.010Z","reportedAt":null}}

Signiert wird

1794680608.{"event":"course.booked","delivery":"01a1db4c-d50a-7497-8d47-2df…

Ergebnis

v1=947b98a12f0168d047e7b79a57f0a6ffe82681c1b2164c3175d176de0d2a4983

Auf der Kommandozeile, mit dem Rumpf unverändert in der Datei rumpf.json und ohne Zeilenumbruch am Ende:

Terminal-Fenster
T="<der Wert von t aus dem Kopf>"
SECRET="<das Geheimnis>"
printf '%s.%s' "$T" "$(cat rumpf.json)" | openssl dgst -sha256 -hmac "$SECRET"

Die Prüfung des Alters schlägt bei diesem Prüfwert an, weil er alt ist. Schalten Sie sie für den Test ab oder setzen Sie die Uhr des Tests auf t.

Anzeichen Ursache
Die Signatur stimmt nie Der Rumpf wurde vor dem Nachrechnen geparst und neu geschrieben. Ein Framework, das den Rumpf selbst liest, muss den rohen Text herausgeben.
Die Signatur stimmt nur manchmal Umlaute: gerechnet wird über die Bytes in UTF-8, nicht über eine andere Kodierung.
Die Signatur stimmt seit heute nicht mehr Das Geheimnis wurde im Portal erneuert. Das alte gilt nicht mehr.
Alles kommt doppelt Die Gegenstelle antwortet zu langsam oder nicht mit 2xx. Dann wiederholt Ski4me.