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.

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.

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.

   

2. Führen Sie den Assistenten aus, um das Abonnement zu erstellen.

   

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

   

4. Wählen Sie das Ereignis aus, das für und alle anwendbaren Filter 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.

   

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

   

   

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.

   

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

   

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.

Verwandte Artikel

• Problembehandlung bei Diensthaken und häufig gestellten Fragen
• Visual Studio Marketplace
• Abrechnungsinformationen