Integreren met servicehook
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Met Service Hooks kunt u taken uitvoeren op andere services wanneer er gebeurtenissen plaatsvinden in uw project in Azure DevOps.
U kunt bijvoorbeeld een kaart maken in Trello wanneer een werkitem wordt gemaakt of een pushmelding verzendt naar de mobiele apparaten van uw team wanneer een build mislukt. U kunt ook servicehook gebruiken in aangepaste apps en services als een efficiëntere manier om activiteiten te stimuleren wanneer er gebeurtenissen in uw projecten plaatsvinden.
Hoe werken servicehookpunten?
Uitgevers van servicehook definiëren een set gebeurtenissen waarop u zich kunt abonneren. Abonnementen luisteren naar deze gebeurtenissen en definiëren acties die moeten worden uitgevoerd op basis van de gebeurtenis.
Abonnementen richten zich ook op consumenten, die externe services zijn die hun eigen acties kunnen uitvoeren wanneer er gebeurtenissen plaatsvinden.
Notitie
Servicehook vereist het toestaan van IP-bereiken voor binnenkomende verbinding met service-eindpunten. Het service-eindpunt is de set eigenschappen die aan een servicehook worden geleverd. Zie Toegestane adreslijsten en netwerkverbindingen, IP-adressen en bereikbeperkingen voor meer informatie.
Beschikbare services
De volgende services zijn beschikbaar als doel van servicehook. Ga naar Visual Studio Marketplace voor meer informatie over andere apps en services die kunnen worden geïntegreerd met Azure DevOps.
| Service | Ondersteunde gebeurtenissen | Ondersteunde acties |
|---|---|---|
| App Center | Werkitem bijgewerkt | Melding verzenden. Abonnementen worden beheerd via App Center. |
| AppVeyor | Code gepusht | Een AppVeyor-build activeren. Abonnementen worden beheerd via AppVeyor. |
| Azuqua | Alle | Post de gebeurtenis naar FLO. Abonnementen worden beheerd via Azuqua. |
| Azure App Service | Code gepusht | Web-app implementeren. Abonnementen worden beheerd via Azure-app Service. |
| Azure Service Bus | Alle | Een bericht verzenden naar een Notification Hub, Service Bus-wachtrij of Service Bus-onderwerp. Het abonnement wordt beheerd via Azure-app Service. |
| Azure Storage | Alle | Een bericht invoegen in een opslagwachtrij. |
| Bamboe | Build voltooid, code gepusht | Een build in de wachtrij plaatsen. |
| Datadog | Alle | Plaats een gebeurtenis in Datadog. |
| Grafana | Release-implementatie voltooid | Annotatie toevoegen aan Grafana-database. |
| Jenkins | Build completed, code pushed, PR mergeed, release deployment completed | Generiek of Git-build activeren. |
| Microsoft Teams | Alle | Een bericht posten in een kanaal. Abonnementen worden beheerd in Microsoft Teams. |
| MyGet | Build voltooid, code gepusht | NuGet-pakket publiceren naar MyGet. Een MyGet-build activeren. Abonnementen worden beheerd door MyGet. |
| Office 365 | Alle | Een bericht posten in een groep. |
| Slack | Alle | Een bericht posten in een kanaal. |
| Trello | Alle | Een kaart of lijst maken. |
| UserVoice | Werkitem gemaakt, werkitem bijgewerkt | Gebeurtenis gekoppeld werkitem verzenden. Abonnementen worden beheerd via UserVoice. |
| Webhook | Alle | Post via HTTP. |
| Workplace Message Apps | Alle | Meldingen verzenden. Abonnementen worden beheerd via Workplace Message Apps. |
| Zapier | Alle | Melding verzenden. Abonnementen worden beheerd via Zapier. |
| Zendesk | Werkitem waarop een opmerking is geplaatst | Maak een persoonlijke opmerking in een ticket. |
| Service | Ondersteunde gebeurtenissen | Ondersteunde acties |
|---|---|---|
| Azure Service Bus | Alle | Een bericht verzenden naar een Notification Hub, Service Bus-wachtrij of Service Bus-onderwerp. Het abonnement wordt beheerd via Azure-app Service. |
| Azure Storage | Alle | Een bericht invoegen in een opslagwachtrij. |
| Bamboe | Build voltooid, code gepusht | Een build in de wachtrij plaatsen. |
| Datadog | Alle | Plaats een gebeurtenis in Datadog. |
| Grafana | Release-implementatie voltooid | Annotatie toevoegen aan Grafana-database. |
| Jenkins | Build completed, code pushed, PR mergeed, release deployment completed | Generiek of Git-build activeren. |
| Microsoft Teams | Alle | Een bericht posten in een kanaal. Abonnementen worden beheerd in Microsoft Teams. |
| Office 365 | Alle | Een bericht posten in een groep. |
| Slack | Alle | Een bericht posten in een kanaal. |
| Trello | Alle | Een kaart of lijst maken. |
| [UserVoice] ((https://www.uservoice.com) | Werkitem gemaakt, werkitem bijgewerkt | Gebeurtenis gekoppeld werkitem verzenden. Abonnementen worden beheerd via UserVoice. |
| Webhook | Alle | Post via HTTP. |
| Zendesk | Werkitem waarop een opmerking is geplaatst | Maak een persoonlijke opmerking in een ticket. |
Een abonnement maken
Wanneer u een van deze services integreert met Azure DevOps, moet u een nieuw abonnement maken. In veel gevallen moet u ook een configuratie uitvoeren in de andere service. Bekijk de informatie voor de service waarin u geïnteresseerd bent voor specifieke informatie.
Open de beheerpagina voor een project in webtoegang.
Voer de wizard uit om het abonnement te maken.
Selecteer de service waarmee u wilt integreren.
Selecteer de gebeurtenis waarop u wilt activeren en eventuele toepasselijke filters.
Selecteer een actie die moet worden uitgevoerd op de doelservice.
Notitie
De lijst met beschikbare acties kan worden beperkt op basis van het gebeurtenistype dat u hebt geselecteerd.
Als u wilt controleren of de instellingen juist zijn, test u het abonnement en voltooit u de wizard.
Veelgestelde vragen
V: Welke machtigingen heb ik nodig om een abonnement in te stellen?
A: Abonnementen bewerken en abonnementen weergeven. Standaard beschikken alleen projectbeheerders over deze machtigingen. Als u deze rechtstreeks aan andere gebruikers wilt toekennen, kunt u het opdrachtregelprogramma of de REST API beveiliging gebruiken.
Als u weergavemachtigingen voor een groep wilt verlenen, raadpleegt u De machtiging Weergave instellen voor een groep op de pagina Servicehook.
V: Wat zijn de gevolgen voor de beveiliging van het verlenen van abonnementen bewerken en abonnementen weergeven?
A: De gebruiker met deze machtigingen kan alle abonnementen zien die in het project zijn gemaakt en de meldingsgeschiedenis voor deze abonnementen. Die gebruiker kan vervolgens elk type servicehookabonnement in dat project maken. Als de gebruiker een abonnement instelt voor een resource die anders geen toegangsmachtiging heeft, wordt het abonnement niet geactiveerd.
Bijvoorbeeld: Abonnementen die u maakt voor updategebeurtenissen voor werkitems in gebiedspad XYZ verzenden geen meldingen als u geen toegang hebt tot deze werkitems. U kunt echter de meldingsgeschiedenis zien van andere gebruikers die wel toegang hebben tot deze werkitems.
V: Kan ik programmatisch servicehookabonnementen voor een project maken?
A: Ja. Zie Een abonnement voor servicehook maken voor meer informatie.
V: Kan ik de toegang van een app tot mijn organisatie verwijderen nadat ik deze heb geautoriseerd?
A: Ja. U kunt autorisaties intrekken vanuit uw profiel.
Ga naar uw profielpagina van https://visualstudio.microsoft.com/.
Zorg ervoor dat u begint vanaf de Visual Studio-site () in plaats van uw organisatie (https://visualstudio.microsoft.com/
https://dev.azure.com/{orgName}) omdat u met uw profiel dat vanuit uw organisatie wordt geopend, naar de verkeerde implementatie van de functie autorisatiebeheer gaat.Beheer uw autorisaties.
Eventuele autorisaties intrekken die u niet meer wilt toestaan.
V: Waarom kunnen we geen servicehook meer instellen voor HipChat?
A: Atlassian heeft officieel ondersteuning voor HipChat verwijderd. Zie de aankondiging voor meer informatie.