Intégrer à des crochets de service
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Les hooks de service vous permettent d’exécuter des tâches sur d’autres services lorsque des événements se produisent dans votre projet dans Azure DevOps.
Par exemple, vous pouvez créer une carte dans Trello lorsqu’un élément de travail est créé ou envoyer une notification Push aux appareils mobiles de votre équipe en cas d’échec d’une génération. Vous pouvez également utiliser des hooks de service dans des applications et des services personnalisés comme moyen plus efficace de générer des activités lorsque des événements se produisent dans vos projets.
Comment fonctionnent les hooks de service ?
Les éditeurs de hook de service définissent un ensemble d’événements auxquels vous pouvez vous abonner. Les abonnements écoutent ces événements et définissent des actions à entreprendre en fonction de l’événement.
Les abonnements ciblent également les consommateurs, qui sont des services externes qui peuvent exécuter leurs propres actions lorsque des événements se produisent.
Remarque
Les hooks de service nécessitent l’autorisation des plages d’adresses IP pour la connexion entrante aux points de terminaison de service. Le point de terminaison de service est l’ensemble des propriétés fournies à un hook de service. Pour plus d’informations, consultez Listes d’adresses autorisées et connexions réseau, adresses IP et restrictions de plage.
Services disponibles
Les services suivants sont disponibles en tant que cible de hooks de service. Pour plus d’informations sur d’autres applications et services qui s’intègrent à Azure DevOps, accédez à Visual Studio Marketplace.
Service | Événements pris en charge | Actions prises en charge |
---|---|---|
App Center | Élément de travail mis à jour | Envoyer la notification |
AppVeyor | Code envoyé (push) | Déclencher une build AppVeyor |
Azuqua | Tous | Publier l’événement sur FLO |
Azure App Service | Code envoyé (push) | Déployer une application web |
Azure Service Bus | Tous | Envoyer un message à une rubrique Notification Hub, File d’attente Service Bus ou Service Bus |
Stockage Azure | Tous | Insérer un message dans une file d’attente de stockage |
Bambou | Build completed, Code pushed | Mettre en file d’attente une build |
Campfire | Tous | Publier un message dans une salle |
Datadog | Tous | Publier un événement dans Datadog |
Grafana | Déploiement de mise en production effectué | Ajouter une annotation à la base de données Grafana |
HipChat | (Non pris en charge) | |
HockeyApp | Élément de travail mis à jour | Envoyer la notification |
Jenkins | Build completed, code pushed, pr merge tentative, release deployment completed | Déclencher une build générique ou Git |
Microsoft Teams | Tous | Publier un message sur un canal |
MyGet | Génération terminée, code envoyé (push) | Publier le package NuGet sur MyGet, déclencher une build MyGet |
Office 365 | Tous | Publier un message dans un groupe |
Slack | Tous | Publier un message sur un canal |
Trello | Tous | Créer une carte ou une liste |
UserVoice | Élément de travail créé ou mis à jour | Envoyer un événement d’élément de travail lié |
Web Hooks | Tous | Publier via HTTP |
Applications de messages d’espace de travail | Tous | Envoi de notifications |
Zapier | Tous | Envoyer la notification |
Zendesk | Élément de travail commenté sur | Créer un commentaire privé dans un ticket |
Création d’un abonnement
Lorsque vous intégrez l’un de ces services à Azure DevOps, vous devez créer un abonnement. Dans de nombreux cas, vous devez également effectuer un travail dans l’autre service. Pour plus d’informations, consultez les informations sur le service qui vous intéresse.
Ouvrez la page d’administration d’un projet dans l’accès web.
Exécutez l’Assistant pour créer l’abonnement.
Sélectionnez le service auquel vous souhaitez effectuer l’intégration.
Sélectionnez l’événement à déclencher et tous les filtres applicables.
Sélectionnez une action à exécuter sur le service cible.
Remarque
La liste des actions disponibles peut être limitée en fonction du type d’événement que vous avez sélectionné.
Pour confirmer que les paramètres sont corrects, testez l’abonnement, puis terminez l’Assistant.
FAQ
Q : Quelles autorisations dois-je configurer un abonnement ?
R : Modifier les abonnements et afficher les abonnements. Par défaut, seuls les administrateurs de projet disposent de ces autorisations. Pour les accorder directement à d’autres utilisateurs, vous pouvez utiliser l’outil en ligne de commande ou l’API REST Sécurité.
Pour accorder l’autorisation d’affichage pour un groupe, consultez Définir l’autorisation Afficher pour un groupe dans la page Hooks de service.
Q : Quelles sont les implications de sécurité de l’octroi des autorisations Modifier les abonnements et afficher les abonnements ?
R : L’utilisateur disposant de ces autorisations peut voir tous les abonnements créés dans le projet et l’historique des notifications pour ces abonnements. Cet utilisateur peut ensuite créer n’importe quel type d’abonnement de hook de service dans ce projet. Si l’utilisateur configure un abonnement pour une ressource qu’il n’est pas autorisé à accéder, l’abonnement n’est pas déclenché.
Par exemple : si vous n’avez pas accès aux éléments de travail dans le chemin d’accès de zone XYZ et que vous configurez un abonnement aux événements de mise à jour des éléments de travail, vous n’obtenez pas de notifications pour les mises à jour des éléments de travail dans le chemin d’accès de zone XYZ. Toutefois, si un autre utilisateur, qui a accès aux éléments de travail dans le chemin d’accès de zone XYZ, reçoit ces événements de « mise à jour des éléments de travail », vous pouvez voir l’historique des notifications des événements de l’autre utilisateur, qui inclut les données d’élément de travail auxquelles vous n’avez pas accès.
Q : Puis-je créer des abonnements de hook de service pour un projet par programmation ?
A : Oui. Pour plus d’informations, consultez Créer un abonnement de hooks de service.
Q : Puis-je supprimer l’accès d’une application à mon organisation une fois que je l’ai autorisé ?
A : Oui. Vous pouvez révoquer des autorisations de votre profil.
Accédez à votre page de profil à partir de https://visualstudio.microsoft.com/.
Veillez à commencer à partir du site Visual Studio (https://visualstudio.microsoft.com/) au lieu de votre organisation (
https://dev.azure.com/{orgName}
) car votre profil accessible à partir de votre organisation vous amène à une implémentation incorrecte de la fonctionnalité de gestion des autorisations.Gérez vos autorisations.
Révoquez les autorisations que vous ne souhaitez plus autoriser.
Q : Pourquoi ne pouvons-nous plus configurer des hooks de service pour HipChat ?
R : Atlassian a officiellement abandonné le support pour HipChat. Pour plus d'informations, consultez Annonce.
Articles connexes
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour