Einen benutzerdefinierten Webhook verbinden

Verbinde jedes Tool, das Web-Requests senden oder empfangen kann, mit InfraNest — auch wenn wir keine fertige Integration dafür haben. Das ist für alle, die Events an ihr eigenes System senden lassen möchten, oder ein anderes Tool InfraNest steuern lassen möchten.

Übersicht

• Events können an eine URL gehen, die dir gehört, und eine von uns generierte URL lässt jedes Tool hier eine Automatisierung auslösen.
• Du kannst eine Richtung einrichten oder beide — Senden und Empfangen sind unabhängig voneinander.
• Für keine der beiden Richtungen wird ein Zugangsdatensatz oder API-Schlüssel benötigt.

Welche Richtung brauchst du?

• Wenn in InfraNest etwas passiert und dein System davon erfahren soll, musst du Events nach außen senden.
• Wenn in deinem System etwas passiert und InfraNest darauf reagieren soll, musst du etwas InfraNest auslösen lassen.

Eingehende URLs sind an kein bestimmtes Tool gebunden — alles, was einen Request senden kann, kann sie nutzen — deshalb befinden sie sich hier auf der Seite Custom webhook, und die Seiten für Zapier, Make und n8n verweisen darauf zurück.

Events nach außen senden

1. Gehe zu Integrationen → Custom webhook.
2. Wähle unter Where events go die Option Add endpoint und füge die URL ein, auf der dein eigenes System lauscht.
3. Kopiere das Signaturgeheimnis, das nach dem Speichern einmalig angezeigt wird, und gib es deinem Empfänger, damit dieser überprüfen kann, dass der Request tatsächlich von InfraNest stammt.
4. Wähle Send test event und suche ein Event zum Nachahmen aus, um zu bestätigen, dass dein Empfänger es akzeptiert, bevor du dich darauf verlässt.
5. Lege fest, was gesendet wird: Wähle unter Start an automation that posts to Custom webhook einen Startpunkt oder schreibe eine eigene Regel.

NoteDas Hinzufügen des Endpoints sendet allein noch nichts — es gibt nur an, wohin gesendet werden soll. Eine Automatisierung entscheidet, was gesendet wird, deshalb ist Schritt 5 wichtig. Eine Regel kann alle Events abdecken, oder du kannst sie auf die für dich relevanten Events eingrenzen.

Etwas InfraNest auslösen lassen

1. Gehe zu Integrationen → Custom webhook → URLs we give you und wähle Add incoming URL.
2. Gib ihr einen Name, den du später wiedererkennst — du wählst sie beim Schreiben der Regel anhand des Namens aus.
3. Lege optional ein Shared secret (Optional) fest. Ist eines gesetzt, akzeptiert InfraNest nur Aufrufe, die es im Request-Header mitsenden, sodass eine geleakte URL allein nicht ausreicht.
4. Kopiere Your URL und füge sie in das andere Tool ein, konfiguriert zum Senden von Requests.
5. Nutze in InfraNest Start an automation Custom webhook can trigger und lege fest, was passieren soll — ein Wartungsfenster öffnen, einen Monitor pausieren, einen Vorfall auflösen.

Gut zu wissen

• Es wird kein Zugangsdatensatz benötigt. Du gibst eine URL an, an die InfraNest posten soll, und InfraNest generiert eine URL für dich. Es gibt kein API-Token zu erstellen.
• Das Signaturgeheimnis wird einmalig angezeigt und danach nie wieder. Du kannst es später rotieren; das alte funktioniert dann sofort nicht mehr.
• Deine eingehende URL funktioniert wie ein Passwort. Jeder, der sie besitzt, kann die Automatisierungen deiner Organisation auslösen — lege ein Shared secret fest und nutze Regenerate URL, falls sie geleakt wird.
• Accept calls to this URL schaltet eine eingehende URL aus, ohne sie zu löschen oder die anderen zu berühren.
• Beide Richtungen führen ein Zustellprotokoll unter Recent deliveries, damit du sehen kannst, was gesendet wurde, was ankam und was dein Endpoint geantwortet hat.
• Du kannst mehrere Endpoints hinzufügen — zum Beispiel einen für Vorfälle und einen weiteren für Domains.
• Diese Integration bewegt nur Events. Sie liest oder verwaltet keine Server, DNS oder Domains — das bleibt bei den Anbieter-Integrationen.

WarningDeine eingehende URL wirkt wie ein Passwort — jeder, der sie besitzt, kann Automatisierungen in deinem Konto auslösen. Sollte sie geleakt werden, nutze sofort Regenerate URL.

Fehlerbehebung

Bei meinem Endpoint kommt nichts an. Der Endpoint allein ist nur ein Ziel. Prüfe, ob eine Automatisierung tatsächlich dorthin postet, und sieh dann unter Recent deliveries nach, ob InfraNest überhaupt etwas gesendet hat.

Mein Empfänger lehnt die Zustellung ab. Er verifiziert die Signatur mit dem falschen Geheimnis. Das Signaturgeheimnis wird einmalig beim Speichern des Endpoints angezeigt — rotiere es und kopiere das neue in deinen Empfänger.

Mein Tool löst InfraNest nicht aus. Stelle sicher, dass es Requests an genau die richtige eingehende URL sendet und dass das Shared secret — falls gesetzt — korrekt mitgesendet wird. Wurde die URL neu generiert, funktioniert die alte sofort nicht mehr.