Freigeben über


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.

Diagramm der Diensthaken.

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.

  1. Öffnen Sie die Administratorseite für ein Projekt im Webzugriff.

    Screenshot der hervorgehobenen Schaltfläche
  2. Führen Sie den Assistenten aus, um das Abonnement zu erstellen.

    Screenshot der hervorgehobenen Schaltfläche

  3. Wählen Sie den Dienst aus, in den Sie integrieren möchten.

    Wählen Sie den zu integrierenden Dienst aus.

  4. Wählen Sie das Ereignis aus, das für und alle anwendbaren Filter ausgelöst werden soll.

    Wählen Sie das Ereignis aus, das ausgelöst werden soll, und alle Filter

  5. 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.

    Screenshot der Auswahl einer Aktion für den Zieldienst.

  6. Um zu bestätigen, dass die Einstellungen korrekt sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.

    Screenshot mit Testbenachrichtigung 1.

    Screenshot mit Testbenachrichtigung 2.

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.

  1. 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.

  2. Verwalten Sie Ihre Autorisierungen.

    Screenshot mit hervorgehobener Schaltfläche

  3. Widerrufen Sie alle Autorisierungen, die Sie nicht mehr zulassen möchten.

    Screenshot der Option

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.