Webhooks

Mit Webhooks kann InfraNest Echtzeit-Updates zu deiner Infrastruktur direkt an deine eigenen Systeme senden, sodass deine Tools automatisch reagieren können, statt dass du manuell nachschaust.

#Überblick

• Webhooks benachrichtigen einen Endpunkt, den du selbst kontrollierst, sobald in InfraNest etwas passiert – etwa wenn eine Domain abläuft oder ein Monitor-Alarm ausgelöst wird.
• Jede Zustellung wird signiert, damit du bestätigen kannst, dass sie wirklich von InfraNest stammt.
• Fehlgeschlagene Zustellungen werden protokolliert und automatisch wiederholt.

#Einen Webhook hinzufügen

1. Gehe zu Webhooks und füge einen Endpunkt hinzu.
2. Gib die URL ein, an die Ereignisse gesendet werden sollen, eine description, und wähle aus, welche events empfangen werden sollen.

3. Speichere. InfraNest generiert ein secret, mit dem du die Anfragen verifizierst.

#Auswählen, welche Ereignisse empfangen werden

Du kannst einen Webhook für Ereignisse wie die folgenden abonnieren:

• Eine ablaufende Domain
• Eine Status-Änderung einer Domain oder eines Servers
• Einen Monitor-Alarm
• Änderungen an DNS-Einträgen
• Den Drop-Catch-Lebenszyklus (bald verfügbar, verfügbar, registriert, fehlgeschlagen)

#Zustellungen verifizieren

1. Jeder Webhook wird als POST-Request gesendet, mit deinem Secret über einen HMAC im Header X-InfraNest-Signature-V2 signiert und mit X-InfraNest-Timestamp zeitgestempelt.
2. Verwende diese Header auf deiner Seite, um zu bestätigen, dass die Anfrage tatsächlich von InfraNest stammt.
3. Test-Zustellungen und echte Ereignisse werden auf dieselbe Weise signiert, sodass du deine Einrichtung gefahrlos testen kannst, bevor du dich darauf verlässt.

WarningDer ältere Header X-InfraNest-Signature wird ab dem 30. April 2027 nicht mehr gesendet. Stelle deinen Empfänger vorher auf X-InfraNest-Signature-V2 um.

NoteSchlägt eine Zustellung fehl, protokolliert InfraNest dies und wiederholt sie automatisch – du musst sie nicht selbst erneut senden.

#Weitere eingehende Verbindungen

InfraNest akzeptiert außerdem einige eingehende Verbindungen, die von deinen eigenen Tools aufgerufen werden und jeweils mit einem eigenen Token gesichert sind. Beispiele sind:

• Deploy Hooks – lösen ein Deployment aus deinem CI-System aus.
• Dynamic-IP-Updates – werden von deinem Router gesendet (siehe Set up Dynamic IP).