Freigeben über


Integration in Service Hooks

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Sie können Dienst-Hooks verwenden, um Aufgaben für andere Dienste auszuführen, wenn Ereignisse in Ihrem Azure DevOps-Projekt auftreten.

Sie können beispielsweise einen Diensthaken verwenden, um automatisch eine Karte in Trello zu erstellen, wenn eine Arbeitsaufgabe in Azure DevOps erstellt wird. Sie können auch automatisch eine Pushbenachrichtigung an die mobilen Geräte Ihres Teams senden, 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 Ereignissen 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 mit einem Pfeil, der von einem Herausgeberfeld mit der Bezeichnung

Hinweis

Um Dienst-Hooks zu verwenden, müssen Sie bestimmte IP-Adressbereiche für eingehende Verbindungen mit Dienstendpunkten zulassen. Ein Dienstendpunkt ist eine Reihe von Eigenschaften, die einem Diensthaken bereitgestellt werden. Weitere Informationen finden Sie unter IP-Adressen und Bereichseinschränkungen.

Verfügbare Dienste

Die folgenden Dienste sind als Ziele von Service-Hooks verfügbar. Weitere Informationen zu anderen Apps und Diensten, die in Azure DevOps integriert sind, finden Sie im Visual Studio Marketplace.

Dienst Unterstützte Ereignisse Unterstützte Aktionen Abonnementverwaltung
Visual Studio App Center Arbeitselement aktualisiert Senden einer Benachrichtigung Im App Center
AppVeyor Code gepusht Auslösen eines AppVeyor-Builds In AppVeyor
Azuqua Alle Ein Ereignis in einem Flusssprachenobjekt (FLO) veröffentlichen In Azuqua
Azure App Service Code gepusht Bereitstellen einer Web-App Im App-Dienst
Azure Service Bus Alle Senden einer Nachricht an Azure Notification Hubs, eine ServiceBus-Warteschlange oder ein ServiceBus-Thema In Azure DevOps
Azure Storage (in englischer Sprache) Alle Einfügen einer Nachricht in eine Speicherwarteschlange In Azure DevOps
Bambus Build abgeschlossen, Code pushed Warteschlange für einen Build In Azure DevOps
Datadog Alle Posten eines Ereignisses in Datadog In Azure DevOps
Grafana Die Releasebereitstellung wurde abgeschlossen. Hinzufügen einer Anmerkung zu einer Grafana-Datenbank In Azure DevOps
Jenkins Build abgeschlossen, Code gepusht, PR-Merge wurde versucht Auslösen eines generischen oder Git-Buildprozesses In Azure DevOps
Microsoft Teams Alle Posten einer Nachricht in einem Kanal In Teams
MyGet Build abgeschlossen, Code pushed Veröffentlichen eines NuGet-Pakets in MyGet, Auslösen eines MyGet-Builds In MyGet
Office 365 Alle Posten einer Nachricht in einer Gruppe In Office 365
Schlaff Alle Posten einer Nachricht in einem Kanal In Azure DevOps
Trello Alle Erstellen einer Karte oder Liste In Azure DevOps
UserVoice Erstellte Arbeitsaufgabe, Arbeitsaufgabe aktualisiert Ein verknüpftes Arbeitsvorgangsereignis senden In UserVoice
Webhooks Alle Bereitstellen einer Anforderung über HTTP In Azure DevOps
Workplace Messaging Apps Alle Senden einer Benachrichtigung In beruflichen Messaging-Apps
Zapier Alle Senden einer Benachrichtigung In Zapier
Zendesk Arbeitsaufgabe kommentiert Erstellen eines privaten Kommentars in einem Ticket In Azure DevOps
Dienst Unterstützte Ereignisse Unterstützte Aktionen Abonnementverwaltung
Azure Service Bus Alle Senden einer Nachricht an Azure Notification Hubs, eine ServiceBus-Warteschlange oder ein ServiceBus-Thema In Azure DevOps
Azure Storage (in englischer Sprache) Alle Einfügen einer Nachricht in eine Speicherwarteschlange In Azure DevOps
Bambus Build abgeschlossen, Code pushed Warteschlange für einen Build In Azure DevOps
Datadog Alle Posten eines Ereignisses in Datadog In Azure DevOps
Grafana Die Releasebereitstellung wurde abgeschlossen. Hinzufügen einer Anmerkung zu einer Grafana-Datenbank In Azure DevOps
Jenkins Build abgeschlossen, Code gepusht, PR-Merge wurde versucht Auslösen eines generischen oder Git-Buildprozesses In Azure DevOps
Microsoft Teams Alle Posten einer Nachricht in einem Kanal In Teams
Office 365 Alle Posten einer Nachricht in einer Gruppe In Office 365
Schlaff Alle Posten einer Nachricht in einem Kanal In Azure DevOps
Trello Alle Erstellen einer Karte oder Liste In Azure DevOps
UserVoice Erstellte Arbeitsaufgabe, Arbeitsaufgabe aktualisiert Ein verknüpftes Arbeitsvorgangsereignis senden In UserVoice
Webhooks Alle Bereitstellen einer Anforderung über HTTP In Azure DevOps
Zendesk Arbeitsaufgabe kommentiert Erstellen eines privaten Kommentars in einem Ticket In Azure DevOps

Erstellen eines Abonnements

Um einen dieser Dienste in Azure DevOps zu integrieren, erstellen Sie ein Abonnement. In vielen Fällen müssen Sie auch den Zieldienst konfigurieren. Ausführliche Informationen finden Sie in der Dokumentation für den Dienst, den Sie integrieren möchten.

  1. Wechseln Sie zu Ihrem Projekt, wählen Sie "Projekteinstellungen" und dann "Diensthaken" aus.

    Screenshot eines Azure DevOps-Projekts. Auf der Seite werden Project-Einstellungen und Dienst-Hooks hervorgehoben.

  2. Klicken Sie auf Abonnement erstellen.

    Screenshot der Seite

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

    Screenshot des Dialogfelds

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

    Screenshot des Dialogfelds

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

    Hinweis

    Die verfügbaren Aktionen hängen vom Typ des ausgewählten Ereignisses ab.

    Screenshot des Aktions-Dialogfelds.

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

    Screenshot des Fensters

    Screenshot des Fensters

Häufig gestellte Fragen

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

A: Sie benötigen die Berechtigungen " Abonnements bearbeiten" und " Abonnements anzeigen" . Standardmäßig verfügen nur Projektadministratoren über diese Berechtigungen. Um sie anderen Benutzern direkt zu gewähren, können Sie ein Befehlszeilentool oder die Sicherheits-REST-API verwenden.

Informationen zum Erteilen der Ansichtsberechtigung für eine Gruppe finden Sie unter Festlegen der Ansichtsberechtigung für eine Gruppe in Dienst-Hooks.

F: Welche Sicherheitsauswirkungen hat die Gewährung von Bearbeitungsrechten für Abonnements und Anzeigerechten für Abonnements?

A: Ein Benutzer, der über die Berechtigungen " Abonnements bearbeiten" und "Abonnements anzeigen " verfügt, kann:

  • Alle Abonnements im Projekt anzeigen.
  • Sehen Sie sich den Benachrichtigungsverlauf für alle Abonnements im Projekt an.
  • Erstellen Sie ein beliebiges Service-Hook-Abonnement im Projekt.

Wenn der Benutzer ein Abonnement für eine Ressource einrichtet, auf die er sonst nicht über die Berechtigung zum Zugriff verfügt, wird das Abonnement nicht ausgelöst.

Angenommen, Sie erstellen ein Abonnement, um eine Benachrichtigung zu senden, wenn eine Arbeitsaufgabe in einem bestimmten Bereichspfad aktualisiert wird. Wenn Sie keinen Zugriff auf die Arbeitsaufgaben in diesem Bereichspfad haben, werden die Benachrichtigungen nicht gesendet. Wenn andere Benutzer jedoch Zugriff auf die Arbeitsaufgaben haben, können Sie den Benachrichtigungsverlauf für Abonnements sehen, die sie über Updates benachrichtigen.

F: Kann ich Diensthakenabonnements für ein Projekt programmgesteuert erstellen?

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

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. Gehe zu https://visualstudio.microsoft.com. Wählen Sie Ihr Profilfoto und dann Visual Studio-Profil aus.

    Stellen Sie sicher, dass Sie mit der Visual Studio-Website beginnen, https://visualstudio.microsoft.comwenn Sie Autorisierungen verwalten. Von dieser Website aus können Sie auf die richtige Implementierung des Autorisierungsverwaltungsfeatures zugreifen. Beginnen Sie nicht mit Ihrer Organisation (https://dev.azure.com/{organization-name}).

  2. Wählen Sie "Autorisierungen verwalten" aus.

    Screenshot einer Visual Studio-Profilseite mit Kontaktinformationen für einen Benutzer. Im Abschnitt

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

    Screenshot des Dialogfelds

F: Warum kann ich keine Dienst-Hooks für HipChat mehr einrichten?

A: Atlassian unterstützt HipChat nicht mehr. Weitere Informationen finden Sie unter Atlassian Häufig gestellte Fragen.