Integration in Service Hooks
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Mit Service Hooks können Sie Aufgaben für andere Dienste ausführen, wenn Ereignisse in Ihrem Projekt in Azure DevOps auftreten.
Sie können beispielsweise eine Karte in Trello erstellen, wenn eine Arbeitsaufgabe erstellt oder eine Pushbenachrichtigung an die mobilen Geräte Ihres Teams gesendet wird, wenn ein Build fehlschlägt. Sie können Auch Dienst-Hooks in benutzerdefinierten Apps und Diensten als effizientere Möglichkeit verwenden, Um Aktivitäten zu fördern, wenn Ereignisse in Ihren Projekten auftreten.
Wie funktionieren Service-Hooks?
Diensthaken-Herausgeber definieren eine Reihe von Ereignissen, die Sie abonnieren können. Abonnements überwachen diese Ereignisse und definieren Aktionen , die basierend auf dem Ereignis ausgeführt werden sollen.
Abonnements zielen auch auf Verbraucher ab, bei denen es sich um externe Dienste handelt, die ihre eigenen Aktionen ausführen können, wenn Ereignisse auftreten.
Hinweis
Dienst-Hooks erfordern das Zulassen von IP-Bereichen für eingehende Verbindungen mit Dienstendpunkten. Der Dienstendpunkt ist der Satz von Eigenschaften, die einem Diensthaken bereitgestellt werden. Weitere Informationen finden Sie unter Zulässige Adresslisten und Netzwerkverbindungen, IP-Adressen und Bereichseinschränkungen.
Verfügbare Dienste
Die folgenden Dienste sind als Ziel von Dienst-Hooks verfügbar. Weitere Informationen zu anderen Apps und Diensten, die in Azure DevOps integriert sind, wechseln Sie zum Visual Studio Marketplace.
| Dienst | Unterstützte Ereignisse | Unterstützte Aktionen |
|---|---|---|
| App Center | Arbeitselement aktualisiert | Benachrichtigung senden. Abonnements werden über Das App Center verwaltet. |
| AppVeyor | Code gepusht | Auslösen eines AppVeyor-Builds. Abonnements werden über AppVeyor verwaltet. |
| Azuqua | Alle | Post event to FLO. Abonnements werden über Azuqua verwaltet. |
| Azure App Service | Code gepusht | Stellen Sie Web-App bereit. Abonnements werden über Azure-App Dienst verwaltet. |
| Azure Service Bus | Alle | Senden Einer Nachricht an einen Benachrichtigungshub, eine Servicebuswarteschlange oder ein Servicebusthema. Das Abonnement wird über Azure-App Dienst verwaltet. |
| Azure Storage (in englischer Sprache) | Alle | Fügen Sie eine Nachricht in eine Speicherwarteschlange ein. |
| Bambus | Build abgeschlossen, Code pushed | Warteschlange für einen Build. |
| Datadog | Alle | Posten Sie ein Ereignis in Datadog. |
| Grafana | Die Releasebereitstellung wurde abgeschlossen. | Fügen Sie der Grafana-Datenbank Anmerkungen hinzu. |
| Jenkins | Build abgeschlossen, Code pushed, PR-Zusammenführung versucht, Releasebereitstellung abgeschlossen | Auslösen eines generischen oder Git-Builds. |
| Microsoft Teams | Alle | Posten Sie eine Nachricht in einem Kanal. Abonnements werden in Microsoft Teams verwaltet. |
| MyGet | Build abgeschlossen, Code pushed | NuGet-Paket in MyGet veröffentlichen. Auslösen eines MyGet-Builds. Abonnements werden von MyGet verwaltet. |
| Office 365 | Alle | Posten Sie eine Nachricht in einer Gruppe. |
| Slack | Alle | Posten Sie eine Nachricht in einem Kanal. |
| Trello | Alle | Erstellen Sie eine Karte oder Liste. |
| UserVoice | Erstellte Arbeitsaufgabe, Arbeitsaufgabe aktualisiert | Verknüpftes Arbeitsaufgabenereignis senden. Abonnements werden über UserVoice verwaltet. |
| Webhooks | Alle | Posten über HTTP. |
| Workplace Message Apps | Alle | Benachrichtigungen senden Abonnements werden über Workplace Message Apps verwaltet. |
| Zapier | Alle | Benachrichtigung senden. Abonnements werden über Zapier verwaltet. |
| Zendesk | Arbeitsaufgabe kommentiert | Erstellen Sie einen privaten Kommentar in einem Ticket. |
| Dienst | Unterstützte Ereignisse | Unterstützte Aktionen |
|---|---|---|
| Azure Service Bus | Alle | Senden Einer Nachricht an einen Benachrichtigungshub, eine Servicebuswarteschlange oder ein Servicebusthema. Das Abonnement wird über Azure-App Dienst verwaltet. |
| Azure Storage (in englischer Sprache) | Alle | Fügen Sie eine Nachricht in eine Speicherwarteschlange ein. |
| Bambus | Build abgeschlossen, Code pushed | Warteschlange für einen Build. |
| Datadog | Alle | Posten Sie ein Ereignis in Datadog. |
| Grafana | Die Releasebereitstellung wurde abgeschlossen. | Fügen Sie der Grafana-Datenbank Anmerkungen hinzu. |
| Jenkins | Build abgeschlossen, Code pushed, PR-Zusammenführung versucht, Releasebereitstellung abgeschlossen | Auslösen eines generischen oder Git-Builds. |
| Microsoft Teams | Alle | Posten Sie eine Nachricht in einem Kanal. Abonnements werden in Microsoft Teams verwaltet. |
| Office 365 | Alle | Posten Sie eine Nachricht in einer Gruppe. |
| Slack | Alle | Posten Sie eine Nachricht in einem Kanal. |
| Trello | Alle | Erstellen Sie eine Karte oder Liste. |
| [UserVoice] ((https://www.uservoice.com) | Erstellte Arbeitsaufgabe, Arbeitsaufgabe aktualisiert | Verknüpftes Arbeitsaufgabenereignis senden. Abonnements werden über UserVoice verwaltet. |
| Webhooks | Alle | Posten über HTTP. |
| Zendesk | Arbeitsaufgabe kommentiert | Erstellen Sie einen privaten Kommentar in einem Ticket. |
Erstellen eines Abonnements
Wenn Sie einen dieser Dienste in Azure DevOps integrieren, müssen Sie ein neues Abonnement erstellen. In vielen Fällen müssen Sie auch eine Konfiguration im anderen Dienst ausführen. Ausführliche Informationen finden Sie in den Informationen für den Dienst, an dem Sie interessiert sind.
Öffnen Sie die Administratorseite für ein Projekt im Webzugriff.
Führen Sie den Assistenten aus, um das Abonnement zu erstellen.
Wählen Sie den Dienst aus, in den Sie integrieren möchten.
Wählen Sie das Ereignis aus, das für und alle anwendbaren Filter ausgelöst werden soll.
Wählen Sie eine Aktion aus, die für den Zieldienst ausgeführt werden soll.
Hinweis
Die Liste der verfügbaren Aktionen kann basierend auf dem ausgewählten Ereignistyp eingeschränkt werden.
Um zu bestätigen, dass die Einstellungen korrekt sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.
Häufig gestellte Fragen
F: Welche Berechtigungen muss ich zum Einrichten eines Abonnements benötigen?
A: Bearbeiten von Abonnements und Anzeigen von Abonnements. Standardmäßig verfügen nur Projektadministratoren über diese Berechtigungen. Wenn Sie sie anderen Benutzern direkt erteilen möchten, können Sie das Befehlszeilentool oder die Sicherheits-REST-API verwenden.
Informationen zum Erteilen der Ansichtsberechtigung für eine Gruppe finden Sie unter "Ansichtsberechtigung für eine Gruppe festlegen" auf der Seite "Service Hooks".
F: Welche Sicherheitsauswirkungen hat die Gewährung von Bearbeitungsabonnements und Anzeigen von Abonnementsberechtigungen ?
A: Der Benutzer mit diesen Berechtigungen kann alle im Projekt erstellten Abonnements und den Benachrichtigungsverlauf für diese Abonnements anzeigen. Dieser Benutzer kann dann einen beliebigen Diensthakenabonnement in diesem Projekt erstellen. Wenn der Benutzer ein Abonnement für eine Ressource einrichtet, auf die er sonst nicht über die Zugriffsberechtigung verfügt, wird das Abonnement nicht ausgelöst.
Beispiel: Abonnements, die Sie für Aktualisierungsereignisse für Arbeitsaufgaben im Bereichspfad XYZ erstellen, senden keine Benachrichtigungen, wenn Sie keinen Zugriff auf diese Arbeitsaufgaben haben. Sie können jedoch den Benachrichtigungsverlauf anderer Benutzer sehen, die Zugriff auf diese Arbeitsaufgaben haben.
F: Kann ich Diensthakenabonnements für ein Projekt programmgesteuert erstellen?
A: Ja. Weitere Informationen finden Sie unter Erstellen eines Diensthakenabonnements.
F: Kann ich den Zugriff einer App auf meine Organisation entfernen, nachdem ich sie autorisiert habe?
A: Ja. Sie können Autorisierungen aus Ihrem Profil widerrufen.
Wechseln Sie zu Ihrer Profilseite von https://visualstudio.microsoft.com/.
Stellen Sie sicher, dass Sie von der Visual Studio-Website () statt von Ihrer Organisation (https://visualstudio.microsoft.com/
https://dev.azure.com/{orgName}) aus beginnen, da Ihr Profil, auf das Sie aus Ihrer Organisation zugegriffen hat, zu der falschen Implementierung der Autorisierungsverwaltungsfunktion führt.Verwalten Sie Ihre Autorisierungen.
Widerrufen Sie alle Autorisierungen, die Sie nicht mehr zulassen möchten.
F: Warum können wir service hooks für HipChat nicht mehr einrichten?
A: Atlassian hat offiziell Unterstützung für HipChat aufgegeben. Weitere Informationen finden Sie in der Ankündigung.