Dela via


Integrera med tjänstkrokar

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

Med Service Hooks kan du köra uppgifter på andra tjänster när händelser inträffar i ditt projekt i Azure DevOps.

Du kan till exempel skapa ett kort i Trello när ett arbetsobjekt skapas eller skicka ett push-meddelande till teamets mobila enheter när ett bygge misslyckas. Du kan också använda tjänstkrokar i anpassade appar och tjänster som ett effektivare sätt att driva aktiviteter när händelser inträffar i dina projekt.

Hur fungerar tjänstkrokar?

Service Hook-utgivare definierar en uppsättning händelser som du kan prenumerera på. Prenumerationer lyssnar efter dessa händelser och definierar åtgärder som ska utföras baserat på händelsen.

Prenumerationer riktar sig också till konsumenter, som är externa tjänster som kan köra sina egna åtgärder när händelser inträffar.

Diagram över tjänstkrokar.

Kommentar

Tjänstkrokar kräver att IP-intervall tillåts för inkommande anslutning till tjänstslutpunkter. Tjänstslutpunkten är den uppsättning egenskaper som tillhandahålls till en tjänstkrok. Mer information finns i Tillåtna adresslistor och nätverksanslutningar, IP-adresser och intervallbegränsningar.

Tillgängliga tjänster

Följande tjänster är tillgängliga som mål för tjänstkrokar. Mer information om andra appar och tjänster som integreras med Azure DevOps finns på Visual Studio Marketplace.

Tjänst Händelser som stöds Åtgärder som stöds
App Center Arbetsobjektet har uppdaterats Skicka meddelande. Prenumerationer hanteras via App Center.
AppVeyor Kod push-överförd Utlösa en AppVeyor-version. Prenumerationer hanteras via AppVeyor.
Azuqua Alla Publicera händelsen till FLO. Prenumerationer hanteras via Azuqua.
Azure App Service Kod push-överförd Distribuera webbapp. Prenumerationer hanteras via Azure App Service.
Azure Service Bus Alla Skicka ett meddelande till en meddelandehubb, Service Bus-kö eller Service Bus-ämne. Prenumerationen hanteras via Azure App Service.
Azure Storage Alla Infoga ett meddelande i en lagringskö.
Bambu Bygget har slutförts, koden har push-överförts Köa ett bygge.
Datadog Alla Publicera en händelse i Datadog.
Grafana Versionsdistributionen har slutförts Lägg till anteckningar i Grafana-databasen.
Jenkins Build completed, code pushed, PR merge attempted, release deployment completed Utlösa allmän version eller Git-version.
Microsoft Teams Alla Publicera ett meddelande till en kanal. Prenumerationer hanteras i Microsoft Teams.
MyGet Bygget har slutförts, koden har push-överförts Publicera NuGet-paketet till MyGet. Utlös en MyGet-version. Prenumerationer hanteras av MyGet.
Office 365 Alla Publicera ett meddelande till en grupp.
Slack Alla Publicera ett meddelande till en kanal.
Trello Alla Skapa ett kort eller en lista.
UserVoice Arbetsobjektet har skapats, arbetsobjektet har uppdaterats Skicka en länkad händelse för arbetsobjekt. Prenumerationer hanteras via UserVoice.
Webbkrokar Alla Publicera via HTTP.
Meddelandeappar för arbetsplats Alla Skicka meddelanden. Prenumerationer hanteras via Workplace Message Apps.
Zapier Alla Skicka meddelande. Prenumerationer hanteras via Zapier.
Zendesk Arbetsobjekt som kommenterats Skapa en privat kommentar i ett ärende.
Tjänst Händelser som stöds Åtgärder som stöds
Azure Service Bus Alla Skicka ett meddelande till en meddelandehubb, Service Bus-kö eller Service Bus-ämne. Prenumerationen hanteras via Azure App Service.
Azure Storage Alla Infoga ett meddelande i en lagringskö.
Bambu Bygget har slutförts, koden har push-överförts Köa ett bygge.
Datadog Alla Publicera en händelse i Datadog.
Grafana Versionsdistributionen har slutförts Lägg till anteckningar i Grafana-databasen.
Jenkins Build completed, code pushed, PR merge attempted, release deployment completed Utlösa allmän version eller Git-version.
Microsoft Teams Alla Publicera ett meddelande till en kanal. Prenumerationer hanteras i Microsoft Teams.
Office 365 Alla Publicera ett meddelande till en grupp.
Slack Alla Publicera ett meddelande till en kanal.
Trello Alla Skapa ett kort eller en lista.
[UserVoice] ((https://www.uservoice.com) Arbetsobjektet har skapats, arbetsobjektet har uppdaterats Skicka en länkad händelse för arbetsobjekt. Prenumerationer hanteras via UserVoice.
Webbkrokar Alla Publicera via HTTP.
Zendesk Arbetsobjekt som kommenterats Skapa en privat kommentar i ett ärende.

Skapa en prenumeration

När du integrerar en av dessa tjänster med Azure DevOps måste du skapa en ny prenumeration. I många fall måste du också göra vissa konfigurationer i den andra tjänsten. Mer information finns i informationen för tjänsten som du är intresserad av.

  1. Öppna administratörssidan för ett projekt i webbåtkomst.

    Skärmbild av den markerade knappen Projektinställningar.
  2. Kör guiden för att skapa prenumerationen.

    Skärmbild av den markerade knappen Skapa prenumeration.

  3. Välj den tjänst som du vill integrera med.

    Välj den tjänst som ska integreras

  4. Välj den händelse som ska utlösas och eventuella tillämpliga filter.

    Välj den händelse som ska utlösas och eventuella filter

  5. Välj en åtgärd som ska köras på måltjänsten.

    Kommentar

    Listan över tillgängliga åtgärder kan begränsas baserat på den händelsetyp som du har valt.

    Skärmbild som visar val av en åtgärd för måltjänsten.

  6. Kontrollera att inställningarna är korrekta genom att testa prenumerationen och sedan slutföra guiden.

    Skärmbild som visar testmeddelande 1.

    Skärmbild som visar testmeddelande 2.

Vanliga frågor och svar

F: Vilka behörigheter behöver jag för att konfigurera en prenumeration?

S: Redigera prenumerationer och Visa prenumerationer. Som standard har endast projektadministratörer dessa behörigheter. Om du vill bevilja dem till andra användare direkt kan du använda kommandoradsverktyget eller säkerhets-REST-API:et.

Information om hur du beviljar visningsbehörighet för en grupp finns i Ange vybehörighet för en grupp på sidan Service Hooks .

F: Vilka är säkerhetskonsekvenserna av att bevilja behörigheter för Redigera prenumerationer och Visa prenumerationer ?

S: Användaren med dessa behörigheter kan se alla prenumerationer som skapats i projektet och meddelandehistoriken för dessa prenumerationer. Användaren kan sedan skapa valfri typ av tjänsthookprenumeration i projektet. Om användaren konfigurerar en prenumeration för en resurs som de annars inte har behörighet att komma åt utlöses inte prenumerationen.

Till exempel: Prenumerationer som du skapar för uppdateringshändelser för arbetsobjekt i områdessökvägen XYZ skickar inte meddelanden om du saknar åtkomst till dessa arbetsobjekt. Du kan dock se meddelandehistoriken för andra användare som har åtkomst till dessa arbetsobjekt.

F: Kan jag skapa tjänstkrokprenumerationer för ett projekt programmatiskt?

S: Ja. Mer information finns i Skapa en prenumeration för tjänstkrokar.

F: Kan jag ta bort en apps åtkomst till min organisation när jag har godkänt den?

S: Ja. Du kan återkalla auktoriseringar från din profil.

  1. Gå till din profilsida från https://visualstudio.microsoft.com/.

    Se till att du börjar från Visual Studio-webbplatsen (https://visualstudio.microsoft.com/) i stället för din organisation (https://dev.azure.com/{orgName}) eftersom din profil som nås från din organisation tar dig till fel implementering av funktionen för auktoriseringshantering.

  2. Hantera dina auktoriseringar.

    Skärmbild som visar den markerade knappen Hantera program.

  3. Återkalla alla auktoriseringar som du inte längre vill tillåta.

    Skärmbild som visar alternativet Återkalla för auktoriseringar.

F: Varför kan vi inte konfigurera tjänstkrokar för HipChat längre?

S: Atlassian tappade officiellt stödet för HipChat. Mer information finns i meddelandet.