Integration in Service Hooks

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019 | TFS 2018

Mithilfe von Service Hooks können Sie Aufgaben in anderen Diensten ausführen, wenn Ereignisse in Ihrem Projekt in Azure DevOps auftreten.

Sie können beispielsweise eine Karte in Trello erstellen, wenn ein Arbeitselement erstellt wird, oder eine Pushbenachrichtigung an die mobilen Geräte Ihres Teams senden, wenn ein Build fehlschlägt. Sie können Diensthaken auch in benutzerdefinierten Apps und Diensten verwenden, um Aktivitäten effizienter zu steuern, wenn Ereignisse in Ihren Projekten auftreten.

Wie funktionieren Diensthaken?

Service Hook-Herausgeber definieren eine Reihe von Ereignissen , die Sie abonnieren können. Abonnements lauschen auf diese Ereignisse und definieren Aktionen , die basierend auf dem Ereignis ausgeführt werden sollen.

Abonnements richten sich auch an Consumer, bei denen es sich um externe Dienste handelt, die ihre eigenen Aktionen ausführen können, wenn Ereignisse auftreten.

Diagramm der Diensthaken.

Hinweis

Diensthaken erfordern das Zulassen von IP-Bereichen für eingehende Verbindungen mit Dienstendpunkten. Der Dienstendpunkt ist der Satz von Eigenschaften, die für einen 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 Diensthaken verfügbar. Weitere Informationen zu anderen Apps und Diensten, die in Azure DevOps integriert werden, findest du im Visual Studio Marketplace.

Dienst Unterstützte Ereignisse Unterstützte Aktionen
App Center Arbeitselement aktualisiert Benachrichtigung senden
AppVeyor Code gepusht Auslösen eines AppVeyor-Builds
Azuqua Alle Ereignis in FLO posten
Azure App Service Code gepusht Bereitstellen einer Web-App
Azure Service Bus All Senden einer Nachricht an ein Notification Hub-, Service Bus-Warteschlangen- oder Service Bus-Thema
Azure Storage (in englischer Sprache) Alle Einfügen einer Nachricht in eine Speicherwarteschlange
Bamboo Build abgeschlossen, Code gepusht Hinzufügen eines Builds zur Warteschlange
Campfire Alle Senden einer Nachricht in einem Raum
Datadog Alle Veröffentlichen eines Ereignisses in Datadog
Grafana Releasebereitstellung abgeschlossen Hinzufügen einer Anmerkung zur Grafana-Datenbank
HipChat (Nicht mehr unterstützt)
HockeyApp Arbeitselement aktualisiert Benachrichtigung senden
Jenkins Build abgeschlossen, Code gepusht, PR-Zusammenführung versucht, Releasebereitstellung abgeschlossen Auslösen eines generischen oder Git-Builds
Microsoft Teams Alle Senden einer Nachricht an einen Kanal
MyGet Build abgeschlossen, Code gepusht Veröffentlichen eines NuGet-Pakets in MyGet, Auslösen eines MyGet-Builds
Office 365 Alle Senden einer Nachricht an eine Gruppe
Puffer Alle Senden einer Nachricht an einen Kanal
Trello Alle Erstellen eines Karte oder einer Liste
UserVoice Erstellte oder aktualisierte Arbeitselemente Senden eines Ereignisses für verknüpfte Arbeitselemente
Web-Hooks Alle Posten über HTTP
Workplace Message Apps Alle Senden von Benachrichtigungen
Zapier Alle Benachrichtigung senden
Zendesk Arbeitselement kommentiert Erstellen eines privaten Kommentars 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 im anderen Dienst arbeiten. Ausführliche Informationen finden Sie in den Informationen zu dem 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.

    Auswählen des zu integrierenden Diensts

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

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

  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: Auswahl einer Aktion für den Zieldienst

  6. Um sicherzustellen, dass die Einstellungen richtig sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.

    Screenshot: Testbenachrichtigung 1

    Screenshot: Testbenachrichtigung 2

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

    Screenshot der Administratorseite

  2. Erstellen Sie ein Abonnement, indem Sie den Assistenten ausführen.

    Screenshot des hervorgehobenen Kontrollkästchens

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

    Screenshot: Auswahl der zu integrierenden Dienste

  4. Wählen Sie das Ereignis, für das sie ausgelöst werden soll, und alle Filter (falls zutreffend) aus.

    Screenshot: Auswahl des Ereignisses, für das ausgelöst werden soll

  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: Ausgewählte Aktion, die für den Zieldienst ausgeführt werden soll

  6. Um sicherzustellen, dass die Einstellungen richtig sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.

    Screenshot: Testbenachrichtigung 1

    Screenshot: Testbenachrichtigung 2

Häufig gestellte Fragen

F: Welche Berechtigungen benötige ich zum Einrichten eines Abonnements?

A: Abonnements bearbeiten und Abonnements anzeigen. 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.

F: Welche Auswirkungen hat die Gewährung von Berechtigungen "Abonnements bearbeiten" und "Abonnements anzeigen" auf die Sicherheit?

A: Der Benutzer mit diesen Berechtigungen kann alle im Projekt erstellten Abonnements und den Benachrichtigungsverlauf für diese Abonnements anzeigen. Dieser Benutzer kann dann eine beliebige Art von Diensthakenabonnement in diesem Projekt erstellen. Wenn der Benutzer ein Abonnement für eine Ressource einrichtet, für die er andernfalls keine Zugriffsberechtigung hat, wird das Abonnement nicht ausgelöst.

Zum Beispiel: Wenn Sie keinen Zugriff auf Arbeitselemente im Bereichspfad XYZ haben und ein Abonnement für die Arbeitselementupdateereignisse eingerichtet haben, erhalten Sie keine Benachrichtigungen für Updates von Arbeitselementen im Bereichspfad XYZ. Wenn jedoch ein anderer Benutzer, der Zugriff auf die Arbeitselemente im Bereich XYZ hat, diese "Arbeitselementupdate"-Ereignisse empfängt, können Sie den Benachrichtigungsverlauf der Ereignisse des anderen Benutzers sehen, der Arbeitselementdaten enthält, auf die Sie sonst keinen Zugriff 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 organization entfernen, nachdem ich sie autorisiert habe?

A: Ja. Sie können Autorisierungen aus Ihrem Profil widerrufen.

  1. Wechseln Sie von zu Ihrer Profilseite.https://visualstudio.microsoft.com/

    Stellen Sie sicher, dass Sie von der Visual Studio-Website (https://visualstudio.microsoft.com/) statt von Ihrem organization (https://dev.azure.com/{orgName}) aus beginnen, da Ihr Profil von Ihrem organization sie zur falschen Implementierung des Autorisierungsverwaltungsfeatures führt.

  2. Verwalten Sie Ihre Autorisierungen.

    Screenshot: hervorgehobene Schaltfläche

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

    Screenshot: Option

F: Warum können wir keine Diensthaken mehr für HipChat einrichten?

A: Atlassian hat die Unterstützung für HipChat offiziell eingestellt. Weitere Informationen zu dieser Ankündigung finden Sie hier.