Integration in Service Hooks

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

Dienst-Hooks ermöglichen Es Ihnen, Aufgaben auf anderen Diensten auszufü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, Aktivitäten zu fördern, wenn Ereignisse in Ihren Projekten auftreten.

Was ist ein Dienst-Hook?

Dienst-Hook-Herausgeber definieren eine Reihe von Ereignissen. Abonnements hören 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 eigene Aktionen ausführen können, wenn ein Ereignis auftritt.

Service Hooks Diagram

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 sind, finden Sie im Visual Studio Marketplace

Dienst Unterstützte Ereignisse Unterstützte Aktionen
App Center Arbeitselement aktualisiert Benachrichtigung senden
AppVeyor Code pushed Auslösen eines AppVeyor-Builds
Azuqua All Post event to FLO
Azure App Service Code pushed Bereitstellen von Web-App
Azure Service Bus Alle Senden einer Nachricht an einen Benachrichtigungshub, Service Bus Warteschlange oder Service Bus Thema
Azure Storage All Einfügen einer Nachricht in eine Storage Warteschlange
Bamboo Build abgeschlossen, Code pushed Hinzufügen eines Builds zur Warteschlange
Campfire Alle Posten einer Nachricht an einen Raum
Datadog Alle Posten eines Ereignisses in Datadog
Flowdock Alle Posten einer Nachricht an einen Team-Posteingang oder Chat
Grafana Die Bereitstellung wurde abgeschlossen Hinzufügen von Anmerkungen zur Grafana-Datenbank
HipChat (Nicht mehr unterstützt)
HockeyApp Arbeitselement 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 NuGet Pakets in MyGet, Auslösen eines MyGet-Builds
Office 365 All Posten einer Nachricht an eine Gruppe
Puffer Alle Posten einer Nachricht an einen Kanal
Trello Alle Erstellen einer Karte oder Liste
UserVoice Arbeitselement erstellt oder aktualisiert Senden eines verknüpften Arbeitselementereigniss
Web-Hooks Alle Posten über HTTP
Workplace Message Apps All 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 Services integrieren, müssen Sie ein neues Abonnement erstellen. In vielen Fällen müssen Sie auch einige Arbeiten im anderen Dienst ausführen. Weitere Informationen finden Sie in den Informationen zum Dienst, an dem Sie interessiert sind.

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

    Screenshot of highlighted Project settings button.
  2. Erstellen Sie ein Abonnement, indem Sie den Assistenten ausführen.

    Screenshot of highlighted button, Create subscription.

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

    Select the service to integrate

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

    Select the event to trigger on and any filters

  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.

    Select an action for the target service

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

    Test notification 1 for Azure DevOps Server 2019, 2020, and Azure DevOps Services

    Test notification 2 for Azure DevOps Server 2019, 2020, and Azure DevOps Services

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

    Screenshot of the admin page.

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

    Screenshot of highlighted box, Create subscription, to select to run the subscription wizard.

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

    Select the service to integrate

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

    Select the event to trigger on and select any desired filters

  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.

    Select an action to perform on the target service

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

    Test notification 1

    Test notification 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.com.

    Stellen Sie sicher, dass Sie von der Visual Studio Website () anstelle Ihrer Organisation (https://visualstudio.comhttps://dev.azure.com/{orgName}) beginnen, da Ihr Profil, auf das Sie in Ihrer Organisation zugegriffen haben, zu der falschen Implementierung der Verwaltungsfunktion für Autorisierungen führt.

  2. Verwalten Sie Ihre Autorisierungen.

    Click Manage applications to manage authorizations
  3. Widerrufen Sie alle Autorisierungen, die Sie nicht mehr zulassen möchten.

    Click Revoke to revoke authorizations

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.