Webhooks
Lassen Sie sich auf Ihrem eigenen Server, in Slack oder in Discord informieren, wenn neue Versionen veröffentlicht werden, ein Sicherheitshinweis herausgeht oder ein Paket zurückgezogen wird.
Ein Webhook sendet einen POST an eine Adresse von Ihnen, wenn mit Paketen, die Sie auswählen, etwas passiert: um ein Deployment zu starten, einen Pull Request zu öffnen oder in einem Chat-Kanal zu posten.
Bevor Sie beginnen
Sie brauchen eine https://-Adresse, die POST-Anfragen annimmt, oder die Incoming-Webhook-URL eines Slack- oder Discord-Kanals. Webhooks eines Teams liegen in der Organisation: Ihre Organisation → Webhooks, mit denselben Seiten.
Einen Webhook hinzufügen
- Öffnen Sie Einstellungen → Webhooks und dann Webhook hinzufügen.
- Geben Sie die Payload-URL (1) ein.
- Wählen Sie das Format (2): JSON (signiert) für Ihren eigenen Server, Slack oder Discord für einen Kanal.
- Setzen Sie unter Ereignisse (3) die Häkchen: Neue Versionen, Sicherheitshinweise, Zurückgezogene Pakete.
- Wählen Sie die Pakete (4): die Pakete, die Sie beobachten, die Pakete, die Sie mit ihrem Composer-Namen aufführen, oder alle Pakete (eine Zustellung pro Build des Repositorys).
- Klicken Sie auf Webhook hinzufügen (5).
Bei JSON-Webhooks zeigt die Seite danach einmalig das Signatur-Secret: Kopieren Sie es auf Ihren Server.
Eine JSON-Zustellung prüfen
Jede JSON-Zustellung trägt den Header X-MeteorGPL-Signature: sha256=<HMAC-SHA256 of the body with your secret>. Berechnen Sie denselben HMAC über den unveränderten Body und vergleichen Sie, bevor Sie der Payload vertrauen. Der Body nennt das Ereignis und pro Paket seinen Composer-Namen, Titel, Typ, die neuen Versionen, einen Link und den Installationsbefehl.
Ihre Webhooks
Jeder Webhook zeigt seine Adresse und sein Format mit seinem Status: Aktiv, Pausiert oder Nach Fehlern abgeschaltet (1); dann seine Ereignisse und Pakete (2).
- Test senden (3) sendet sofort eine
ping-Zustellung. - Pausieren und Einschalten stoppen die Zustellungen und nehmen sie wieder auf; Entfernen löscht den Webhook.
- Letzte Zustellungen (4) zeigt jede Zustellung mit ihrem Ergebnis, dem HTTP-Status, mit dem Ihr Server geantwortet hat, und der Zahl der Versuche; Erneut zustellen wiederholt eine.
Eine fehlgeschlagene Zustellung wird später erneut versucht: insgesamt sechs Versuche, verteilt über etwa 15 Stunden. Nach 20 Fehlern in Folge wird der Webhook abgeschaltet, und Sie werden informiert; beheben Sie den Fehler am Endpunkt und klicken Sie auf Einschalten.
Hat das Ihre Frage nicht beantwortet? Support kontaktieren.