Disponible pour : OAuth 1.0 Serveur Jira et centre de données ((sur site) (protégé par LDAP))
Mise en place par : Jira System Admin.
Pour mettre à jour les cartes Jira sur le tableau, Miro doit recevoir les message de Jira contenant les événements de modification des données. Ces événements Jira sont transmis vers Miro via un webhook. Il est possible de créer un webhook dans Miro de deux manières différentes.
Option 1 (recommandée) : Créer un webhook automatiquement
Lors de la configuration de votre plugin de cartes Jira, sélectionnez Jira Server ou Jira Data Center et laissez l'option Créer un webhook automatiquement activée.
✏️ La création automatique de webhook nécessite que vous soyez connecté à Jira en tant qu'administrateur.
Paramètres des cartes Jira, étape 2 : L'option "Créer un webhook automatiquement" est activée.
Après avoir créé le WebHook, n’oubliez pas d’aller sur votre page Jira WebHooks et de le modifier pour lui donner un nom unique, au cas où vous prévoyez de connecter plusieurs équipes Miro à votre instance Jira.
⚠️ Un autre webhook sera créé pour la connexion de chaque équipe, il est donc important de s'assurer que le nom est unique. Lorsque vous déconnectez des équipes, les webhooks associés ne sont pas supprimés.
Option + 2 Créer un webhook manuellement
Comment obtenir le webhook
- Décochez l'option 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 : L'option "Créer un webhook automatiquement" est désactivée. - Autorisez l'intégration à se connecter dans Jira.
- Vous avez maintenant l'URL du webhook dans Miro :
URL du webhook
✏️ Si vous n’êtes pas un admin Jira System, veuillez envoyer l’URL du webhook à votre admin Jira pour que ce dernier crée un webhook du côté de Jira.
Comment appliquer le webhook
Voici ci-dessous les étapes à suivre pour créer un webhook. Vous pouvez également vous référer à la documentation Atlassian : pour Jira Server et pour Jira Cloud.
- Pour vous rendre sur la page des webhooks dans Jira, rendez-vous dans la section Administration > System (Système) > Advanced (Avancé) > WebHooks. Vous pouvez également suivre le lien suivant après avoir ajouté le nom unique de votre instance Jira (ce lien fonctionne pour les versions Server et Cloud de Jira, même si nous ne pouvons pas garantir un fonctionnement efficace pour chaque version de Jira) : https://NomInstanceJira/plugins/servlet/webhooks.
- Cliquez sur Créer un webhook dans le coin supérieur droit :
- Saisissez le nom du webhook, définissez l'état du webhook comme activé, collez l'URL du webhook copiée depuis Miro :
system_webhooks.jpg
Les webhooks du système dans Jira - Sélectionnez les événements mis à jour et supprimés dans la section Issue et cliquez sur Create :
Jira_Webhook_settings.jpg
Paramètres de Jira Webhook - Revenez à l'étape 2 dans les paramètres Miro, renseignez votre URL Jira et cliquez sur Connecter.
Le webhook est désormais créé, les cartes Jira sont activées et peuvent être mises à jour automatiquement. Toute modification apportée dans Jira est répercutée dans les cartes Jira sur le tableau.