Integration in Service Hooks

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

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 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
AppVeyor	Code gepusht	Auslösen eines AppVeyor-Builds
Azuqua	Alle	Bereitstellen eines Ereignisses in FLO
Azure App Service	Code gepusht	Bereitstellen von Web-App
Azure Service Bus	Alle	Senden einer Nachricht an einen Benachrichtigungshub, eine Servicebuswarteschlange oder ein Servicebusthema
Azure Storage (in englischer Sprache)	Alle	Einfügen einer Nachricht in eine Speicherwarteschlange
Bambus	Build abgeschlossen, Code pushed	Warteschlange für einen Build
Campfire	Alle	Senden einer Nachricht in einem Raum
Datadog	Alle	Posten eines Ereignisses in Datadog
Grafana	Die Releasebereitstellung wurde abgeschlossen.	Hinzufügen einer Anmerkung 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 in einem 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
Slack	Alle	Posten einer Nachricht in einem Kanal
Trello	Alle	Erstellen einer Karte oder Liste
UserVoice	Arbeitsaufgabe erstellt oder aktualisiert	Senden des Ereignisses "Verknüpfte Arbeitsaufgabe"
Webhooks	Alle	Posten über HTTP
Workplace Message Apps	Alle	Senden von Benachrichtigungen
Zapier	Alle	Benachrichtigung senden
Zendesk	Arbeitsaufgabe 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 einige Aufgaben im anderen Dienst erledigen. 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.

   

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.

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, für die er andernfalls keine Zugriffsberechtigung besitzt, wird das Abonnement nicht ausgelöst.

Beispiel: Wenn Sie keinen Zugriff auf Arbeitsaufgaben im Bereichspfad XYZ haben und ein Abonnement für die Aktualisierungsereignisse für Arbeitsaufgaben einrichten, erhalten Sie keine Benachrichtigungen für Aktualisierungen von Arbeitsaufgaben im Bereichspfad XYZ. Wenn jedoch ein anderer Benutzer, der Zugriff auf die Arbeitsaufgaben im Bereichspfad XYZ hat, diese Ereignisse "Aktualisierung der Arbeitsaufgabe" empfängt, könnten Sie den Benachrichtigungsverlauf der Ereignisse des anderen Benutzers sehen, die Arbeitsaufgabendaten enthalten, 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 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 zu dieser Ankündigung finden Sie hier.

Verwandte Artikel

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