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.
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.
Öffnen Sie die Administratorseite für ein Projekt im Webzugriff.
Erstellen Sie ein Abonnement, indem Sie den Assistenten ausführen.
Wählen Sie den Dienst aus, mit dem Sie integrieren möchten.
Wählen Sie das Ereignis aus, das auf und alle Filter ausgelöst werden soll (falls zutreffend).
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.
Um zu bestätigen, dass die Einstellungen richtig sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.
Öffnen Sie die Administratorseite für ein Projekt im Webzugriff.
Erstellen Sie ein Abonnement, indem Sie den Assistenten ausführen.
Wählen Sie den Dienst aus, mit dem Sie integrieren möchten.
Wählen Sie das Ereignis aus, das auf und alle Filter ausgelöst werden soll (falls zutreffend).
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.
Um zu bestätigen, dass die Einstellungen richtig sind, testen Sie das Abonnement, und beenden Sie dann den Assistenten.
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.
Wechseln Sie zu Ihrer Profilseite von https://visualstudio.com.
Stellen Sie sicher, dass Sie von der Visual Studio Website () anstelle Ihrer Organisation (https://visualstudio.com
https://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.Verwalten Sie Ihre Autorisierungen.
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 die Unterstützung für HipChat offiziell abgebrochen. Weitere Informationen zu dieser Ankündigung finden Sie hier.