Personnes : Administrateurs système Jira
Forfaits : Tous les forfaits Miro (pour l’intégration Jira Server/Data Center via OAuth 1.0)
Plateformes : Navigateur, application de bureau (pour les procédures de configuration)
Pour garantir que vos cartes Jira sur un tableau Miro restent à jour, Miro doit recevoir des messages de Jira chaque fois que des modifications de données se produisent. Ces événements Jira sont transmis vers Miro via un webhook.
Ce guide propose deux façons de créer des webhooks pour Jira Server et Jira Data Center en utilisant OAuth 1.0 et OAuth2.0.
Créer un webhook automatiquement
Lors de la configuration de l’intégration des cartes Jira, si vous vous connectez à Jira Server ou Jira Data Center, vous pouvez laisser l’option Créer un webhook automatiquement activée. C’est la méthode recommandée.
✏️ La création automatique de webhooks nécessite que vous soyez connecté(e) à Jira en tant qu’administrateur système.
Paramètres des cartes Jira, étape 2 : "Créer un webhook automatiquement" est activée
Après que le webhook a été créé automatiquement, il est conseillé de se rendre sur la page des webhooks de votre Jira et de modifier le webhook pour lui donner un nom unique. Ceci est particulièrement important si vous prévoyez de connecter plusieurs équipes Miro à votre instance de Jira.
✏️ Pour les connexions OAuth2.0, la connexion côté Miro est configurée au niveau de l’entreprise. Un webhook est créé pour toutes les équipes Miro.
✏️ Pour les connexions OAuth 1.0 au niveau de l’équipe Miro, un webhook est créé par équipe. Au niveau de l’entreprise Miro, un webhook est créé pour toutes les équipes.
Créer un webhook manuellement
Si vous préférez ou devez créer le webhook manuellement, suivez ces étapes.
Obtenir l’URL du webhook de Miro
- Dans les paramètres des cartes Jira sur Miro (étape 2, lors de la connexion à Jira Server/Data Center), décochez l’option pour Créer un webhook automatiquement.
- Copiez et collez l’URL Jira de votre organisation et cliquez sur Connecter et enregistrer les paramètres.
Paramètres des cartes Jira, étape 2 : "Créer un webhook automatiquement" est désactivé - Autorisez l’intégration à se connecter dans Jira lorsque cela vous est demandé.
- Après ces étapes, Miro vous fournira l’URL du Webhook :
URL du Webhook fournie par Miro
✏️ Si vous n’êtes pas administrateur système de Jira, veuillez copier l’URL du Webhook fournie par Miro et l’envoyer à votre administrateur système de Jira afin qu’il puisse créer le webhook côté Jira à l’aide des instructions ci-dessous.
Créer le webhook dans Jira
Voici les étapes pour créer un webhook dans Jira en utilisant l’URL obtenue depuis Miro. Vous pouvez également vous référer à la documentation officielle d’Atlassian pour Jira Server et pour Jira Cloud (bien que cet article se concentre sur Server/Data Center).
- Pour accéder à la page des Webhooks dans Jira, allez dans Administration Jira > Système > Avancé > Webhooks (le chemin exact peut légèrement varier en fonction de votre version de Jira). Alternativement, vous pouvez souvent utiliser un lien direct en ajoutant
/plugins/servlet/webhooksà l’URL de votre instance Jira (par ex.,https://YourJiraInstanceName/plugins/servlet/webhooks). - Cliquez sur Créer un Webhook en haut à droite de la page des Webhooks.
- Entrez un Nom descriptif pour le Webhook (par ex., "Webhook d’intégration Miro").
- Définissez l’état du Webhook à Activé.
- Collez l’URL du Webhook copiée depuis les paramètres de Miro dans le champ URL.
Configuration des webhooks système dans Jira - Dans la section Événements, sous Problème, sélectionnez les événements mis à jour et supprimé.
- Cliquez sur Créer pour sauvegarder le webhook.
Paramètres des événements du webhook Jira - Après avoir créé le webhook dans Jira, retournez à l’Étape 2 dans les paramètres des Cartes Jira dans Miro, assurez-vous que votre URL Jira est correctement renseignée et cliquez sur Connecter.
Le webhook est maintenant créé et configuré. Les cartes Jira sur vos tableaux Miro se mettront automatiquement à jour lorsque des modifications seront apportées dans Jira.
Webhooks au niveau de l’organisation
REMARQUE : Si vos webhooks au niveau des équipes étaient restreints avec des filtres JQL (par exemple, pour des projets spécifiques), le webhook organisationnel doit soit refléter tous ces filtres JQL, soit ne contenir aucun filtre. Vérifiez vos besoins en JQL avant de migrer vers les paramètres organisationnels.
Dans les paramètres d’administration de l’organisation, après avoir établi la connexion, vous trouverez l’URL du webhook sous instances connectées. Copiez le webhook manuel et collez-le dans votre environnement Jira.