Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Server-Webhooks
Webhooks senden Meldungen, Registrierungsanträge, Kontoanlagen und Profiländerungen, Moderationsmaßnahmen, Einsprüche, Domain-Maßnahmen, lokale öffentliche Beiträge und Verwaltungsaktionen für eigene Emojis an ein Slack- oder Discord-Relay, ein Ticketsystem oder ein Automatisierungswerkzeug wie n8n. Ein Server ohne konfigurierte Webhooks speichert keine zusätzlichen Zeilen und führt keine zusätzlichen Jobs aus. Was ein Empfänger erhält (Header, Signatur, Ereignisse, Body), beschreibt die Webhook-Referenz.
Einen Webhook einrichten
Abschnitt betitelt „Einen Webhook einrichten“Wer die Berechtigung manage_webhooks hat, kann Webhooks auf dem Admin-Bildschirm „Webhooks“ (/admin/webhooks) einrichten.
Die eingebaute Rolle admin hat sie. „Einen Webhook einrichten“ öffnet das Formular; wenn du in der Liste einen Webhook auswählst, öffnet sich seine Seite, auf der
du ihn testest, aus- und einschaltest, änderst, seine Zustellungen der letzten 14 Tage siehst und eine erneut sendest, ihm ein neues
Secret gibst und ihn löschst, nachdem du den Hostnamen seiner URL eingetippt hast. Die Seite sagt, wenn Zustellungen immer wieder fehlschlagen und wenn der
Server den Webhook ausgeschaltet hat. Der Verlauf zeigt Ereignis, Status, Versuche und letzten Versuch jeder Zustellung sowie den Body,
den sie gesendet hat; er kann personenbezogene Daten enthalten und wird nur jemandem gezeigt, der auch die Berechtigung hat, die sein Ereignis braucht (siehe unten).
- Lege einen Webhook mit einer Ziel-URL, einer Beschreibung und den Ereignissen an, die er abonniert. Jedes Ereignis braucht neben
manage_webhooksauch seine eigene Berechtigung:manage_reportsfür Meldungen,manage_accountsfür Registrierungen, Konten, Moderationsmaßnahmen und Einsprüche,manage_domainsfür Domain-Aktionen,manage_custom_emojisfür eigene Emojis undmanage_errorsfür Fehlergruppen. Öffentliche Beiträge brauchen keine zusätzliche Berechtigung. Ein Ereignis, für dessen Berechtigung dir fehlt, kannst du nicht auswählen. - Das Secret (
whsec_...) wird einmal angezeigt, wenn der Webhook angelegt wird. Setze es beim Empfänger. Es kann nicht erneut angezeigt werden. - Wähle auf der Seite des Webhooks „Test senden“, um
webhook.testzu senden, und prüfe in seinen Zustellungen, dass es angekommen ist.
Anlegen, Ändern, Löschen, Einschalten, Ausschalten und das Erneuern des Secrets eines Webhooks werden im Audit-Log festgehalten. Das Ziel wird als Beschreibung und Hostname der URL angezeigt; die URL selbst wird nicht aufgezeichnet.
Das Secret erneuern
Abschnitt betitelt „Das Secret erneuern“„Neues Secret erzeugen“ erzeugt ein neues Secret und zeigt es einmal an. In den nächsten 24 Stunden werden Nachrichten auch mit dem alten Secret signiert
(webhook-signature trägt zwei Signaturen), sodass du den Empfänger in diesem Zeitfenster auf das neue Secret umstellen kannst.
Secrets werden mit kernel.Sealer versiegelt, bevor sie in der Datenbank gespeichert werden; der Schlüssel ist der
KEK.
Fehler und erneute Zustellung
Abschnitt betitelt „Fehler und erneute Zustellung“- Antwortet das Ziel mit etwas anderem als
2xx, antwortet nicht innerhalb von 15 Sekunden oder ist nicht erreichbar, wird die Nachricht nach 5 Sekunden, 5 Minuten, 30 Minuten, 2 Stunden, 5 Stunden, 10 Stunden und 10 Stunden wiederholt (insgesamt 8 Versuche, etwa 27 Stunden). Eine Zustellung, die sie alle verbraucht hat, wird zu einem toten Job, und „Erneut senden“ in den Zustellungen sendet sie erneut mit demselbenwebhook-id. - Antwortet das Ziel
410 Gone, wird der Webhook sofort deaktiviert. - Der Server deaktiviert ein Ziel, das seit 72 Stunden seit seinem ersten Fehler nicht erfolgreich war und 20 oder mehr Mal
in Folge fehlgeschlagen ist. Das Audit-Log erhält einen
webhook_disabled-Eintrag vonsystem, und jeder mitmanage_webhookserhält eine In-App-Benachrichtigung (und eine E-Mail, wenn er Benachrichtigungen per E-Mail erhalten möchte). - Die Liste im Admin-Screen zeigt die Zahl der Fehler in Folge und den Grund, aus dem der Server einen Webhook deaktiviert hat
(
goneoderfailing). Aktiviere den Webhook erneut, nachdem du das Ziel repariert hast. Nachrichten aus der Zeit, in der er deaktiviert war, werden nicht erneut gesendet. - Nachrichten und Zustellungen werden nach 14 Tagen gelöscht (fest). Bodys enthalten personenbezogene Daten wie den Kommentar einer Meldung.
Ziele in einem internen Netzwerk
Abschnitt betitelt „Ziele in einem internen Netzwerk“Die Zustellung läuft durch den SSRF-Schutz für ausgehendes HTTP. Standardmäßig erreicht sie nur öffentliche Adressen über https (Ports 443
und 80). Um an ein internes Ziel zu senden, etwa ein n8n auf demselben Host oder einen Chat in deinem VPC, liste Hostnamen,
IP-Adressen und CIDRs, durch Kommas getrennt, in der Einstellung webhook_allowed_destinations auf (Umgebungsvariable
MY_WEBHOOK_ALLOWED_DESTINATIONS; siehe die Konfigurationsreferenz).
MY_WEBHOOK_ALLOWED_DESTINATIONS=n8n.internal,10.0.0.0/8- Nur die aufgelisteten Ziele, und nur für die Webhook-Zustellung, sind vom Schutz ausgenommen. Föderation, Medien und Link-
Vorschauen bleiben unverändert. Ein ausgenommenes Ziel darf auch
httpund jeden Port verwenden. - Ein Hostname ist erlaubt, auf welche Adresse er auch auflöst. Ein CIDR ist erlaubt, wenn die URL eine IP-Adresse in diesem Bereich nennt. Wenn du einen Hostnamen verwendest, der in den Bereich auflöst, liste auch den Hostnamen auf.
- Nur ein Betreiber mit Zugang zum Server kann die Einstellung ändern. Die Berechtigungen des Admin-Screens allein können ein internes Netzwerk nicht erreichen.
- Ein Versuch bei einem Ziel, das der Schutz abgelehnt hat, zeigt
forbidden_destinationin den Zustellungen. - Die Entwicklungseinstellung
http_allow_private_networkshebt den Schutz für jeden Zweck auf, Webhooks eingeschlossen.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt