Integration in Service Hooks

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

Mit Dienst-Hooks können Sie Aufgaben für andere Dienste ausführen, wenn Ereignisse in Ihrem Projekt in Azure DevOps auftreten. Erstellen Sie beispielsweise eine Karte in Trello, wenn ein Arbeitselement erstellt wird, oder senden Sie eine Pushbenachrichtigung an die mobilen Geräte Ihres Teams, 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.

Was ist ein Dienst-Hook?

Dienst-Hook-Herausgeber definieren eine Reihe von Ereignissen. Abonnementslauschen auf die Ereignisse und definieren Aktionen , die basierend auf dem Ereignis ausgeführt werden sollen. Abonnements zielen auch auf Verbraucher ab, die externe Dienste sind, die ihre eigenen Aktionen ausführen können, wenn ein Ereignis auftritt.

Dienst-Hooks-Diagramm

Hinweis

Für Azure DevOps Services die Verbindung mit Endpunkten für Service Hooks erfordert, dass IP-Bereiche für eingehende Verbindungen zugelassen werden. Ausführliche Informationen finden Sie unter Zulässige Adresslisten und Netzwerkverbindungen, IP-Adressen und Bereichseinschränkungen.

Verfügbare Dienste

Diese Dienste sind als Ziel von Dienst-Hooks verfügbar. Weitere Informationen zu anderen Apps und Diensten, die in Azure DevOps Services integriert werden, finden Sie im Visual Studio Marketplace

Dienst Unterstützte Ereignisse Unterstützte Aktionen
App Center Arbeitsaufgabe aktualisiert Benachrichtigung senden
AppVeyor Code pushed Auslösen eines AppVeyor-Builds
Azuqua Alle Post-Ereignis auf FLO
Azure App Service Code pushed Bereitstellen von Web-App
Azure Service Bus Alle Senden einer Nachricht an einen Benachrichtigungshub, eine Dienstbuswarteschlange oder ein Dienstbusthema
Azure Storage (in englischer Sprache) Alle Einfügen einer Nachricht in eine Speicherwarteschlange
Bamboo Build abgeschlossen, Code pushed Hinzufügen eines Builds zur Warteschlange
Campfire Alle Posten einer Nachricht in einem Raum
Datadog Alle Posten eines Ereignisses in Datadog
Flowdock Alle Posten einer Nachricht in einem Team-Posteingang oder Chat
Grafana Releasebereitstellung abgeschlossen Hinzufügen von Anmerkungen zur Grafana-Datenbank
HipChat (Nicht mehr unterstützt)
HockeyApp Arbeitsaufgabe aktualisiert Benachrichtigung senden
Jenkins Build abgeschlossen, Code pushed, PR-Zusammenführung versucht, Releasebereitstellung abgeschlossen Auslösen eines generischen oder Git-Builds
Microsoft Teams Alle Posten einer Nachricht an einen Kanal
MyGet Build abgeschlossen, Code pushed Veröffentlichen des NuGet-Pakets in MyGet, Auslösen eines MyGet-Builds
Office 365 Alle Posten einer Nachricht in einer Gruppe
Puffer Alle Posten einer Nachricht an einen Kanal
Trello Alle Erstellen einer Karte oder Liste
UserVoice Arbeitselement erstellt oder aktualisiert Senden des Ereignisses "Verknüpfte Arbeitsaufgabe"
Web-Hooks Alle Posten über HTTP
Workplace Message Apps Alle Senden von Benachrichtigungen
Zapier All Benachrichtigung senden
Zendesk Arbeitsaufgabe kommentiert Erstellen eines privaten Kommentars in einem Ticket

Erstellen eines Abonnements

Wenn Sie einen dieser Dienste in Azure DevOps Services integrieren, müssen Sie ein neues Abonnement erstellen. In vielen Fällen müssen Sie auch einige Aufgaben im anderen Dienst ausführen. Weitere 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 Schaltfläche
  2. Erstellen Sie ein Abonnement, indem Sie den Assistenten ausführen.

    Screenshot der hervorgehobenen Schaltfläche, Abonnement erstellen.

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

    Wählen Sie den Dienst aus, der integriert werden soll

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

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

  5. Wählen Sie eine Aktion aus, die im Zieldienst ausgeführt werden soll.

    Hinweis

    Die Liste der verfügbaren Aktionen kann basierend auf dem ausgewählten Ereignistyp eingeschränkt werden.

    Auswählen einer Aktion für den Zieldienst

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

    Testbenachrichtigung 1 für Azure DevOps Server 2019, 2020 und Azure DevOps Services

    Testbenachrichtigung 2 für Azure DevOps Server 2019, 2020 und Azure DevOps Services

  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 Felds, Abonnement erstellen, um den Abonnement-Assistenten auszuführen.

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

    Wählen Sie den Dienst aus, der integriert werden soll

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

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

  5. Wählen Sie eine Aktion aus, die im Zieldienst ausgeführt werden soll.

    Hinweis

    Die Liste der verfügbaren Aktionen kann basierend auf dem ausgewählten Ereignistyp eingeschränkt werden.

    Wählen Sie eine Aktion aus, die im Zieldienst ausgeführt werden soll

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

    Testbenachrichtigung 1

    Testbenachrichtigung 2

Häufig gestellte Fragen

F: Welche Berechtigungen muss ich ein Abonnement einrichten?

A: Bearbeiten von Abonnements und Ansichtsabonnements. Standardmäßig verfügen nur Projektadministratoren über diese Berechtigungen. Um sie anderen Benutzern direkt zu gewähren, können Sie das Befehlszeilentool oder die Security REST-API verwenden.

F: Was sind die Sicherheitsauswirkungen beim Erteilen von Bearbeitungsabonnements und Anzeigen von Abonnementsberechtigungen ?

A: Der Benutzer mit diesen Berechtigungen kann alle Abonnements anzeigen, die im Projekt erstellt wurden und den Benachrichtigungsverlauf für diese Abonnements. Dieser Benutzer kann dann ein beliebiges Dienst-Hook-Abonnement in diesem Projekt erstellen. Wenn der Benutzer ein Abonnement für eine Ressource eingerichtet hat, auf die sie nicht andernfalls über die Berechtigung zum Zugriff verfügen, wird das Abonnement nicht ausgelöst.

Wenn Sie beispielsweise keinen Zugriff auf Arbeitselemente im Bereichspfad XYZ haben und ein Abonnement für die Arbeitselementupdateereignisse eingerichtet haben, erhalten Sie keine Benachrichtigungen für Updates für Arbeitselemente im Bereichspfad XYZ. Wenn jedoch ein anderer Benutzer, der Zugriff auf die Arbeitselemente im Bereichspfad XYZ hat, diese Ereignisse des "Arbeitselementupdates" empfängt, kann der Benachrichtigungsverlauf der Ereignisse des anderen Benutzers angezeigt werden, die Arbeitselementdaten enthalten, auf die Sie sonst keinen Zugriff haben.

F: Kann ich Dienst-Hook-Abonnements für ein Projekt programmgesteuert erstellen?

Antwort: Ja. Weitere Informationen finden Sie unter Erstellen eines Dienst-Hooks-Abonnements.

F: Kann ich den Zugriff einer App auf meine Organisation entfernen, nachdem ich es autorisiert habe?

Antwort: 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 () anstelle Ihrer Organisation (https://visualstudio.microsoft.com/https://dev.azure.com/{orgName}) beginnen, da Ihr Profil, auf das Sie von Ihrer Organisation zugegriffen haben, zur falschen Implementierung der Autorisierungsverwaltungsfunktion führt.

  2. Verwalten Sie Ihre Autorisierungen.

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

    Klicken Sie auf

F: Warum können wir Service Hooks für HipChat nicht mehr einrichten?

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