Se connecter à Jira en utilisant OAuth 1.0 (Mis à jour)

Qui peut le faire : Admins d'entreprise, admins d'équipe
Quels forfaits : Starter, Business, Enterprise
Quelles plateformes : Navigateur, Bureau

Les organisations qui ne sont pas prêtes à migrer vers OAuth 2.0 peuvent utiliser la procédure suivante pour connecter Miro à Jira en utilisant OAuth 1.0.

Atlassian a déprécié OAuth 1.0, et la méthode fournie dans cet article est une solution provisoire. Pour éviter les problèmes et s'aligner sur les meilleures pratiques en matière de sécurité et de compatibilité, Miro recommande fortement de migrer vers OAuth 2.0 dès que possible.

La méthode d'authentification OAuth 1.0 précédente est obsolète et sera supprimée le 31 juillet 2025.

Cet article explique également comment utiliser une instance Jira pour plusieurs équipes Miro, et comment désactiver les cartes Jira au niveau de l'organisation et des équipes.

Prérequis

• Assurez-vous de disposer des autorisations suivantes :
  • Admin d’entreprise Business, Enterprise Miro
    (Starter) Admin d’équipe Miro
  • Admin du système Jira

    ✏️ Pour compléter la procédure, vous devez être capable de créer un lien d'application dans Jira.

• Dans Jira, supprimez tous les liens d'application existants vers Miro.

Procédure

Pour vous connecter à Jira en utilisant OAuth1.0, procédez comme suit :

1. Depuis votre tableau de bord Miro, sélectionnez votre avatar en haut à droite et cliquez sur Console d'admin.
2. Dans la barre latérale gauche, allez dans Applications et intégrations > Applications > onglet Gérer les applications.
3. Assurez-vous que Autoriser uniquement les applications de la liste ci-dessous est activé.
4. Dans la colonne Application, pour les Cartes Jira, sélectionnez Paramètres.
5. Dans l'onglet Paramètres par défaut, sélectionnez Établir une nouvelle connexion.
6. Sous configuration Jira, sélectionnez soit Jira Cloud, soit Jira Data Center.
7. Sous Méthode d'authentification, sélectionnez OAuth 1.0x (Mise à jour).
8. Sous URL Jira, saisissez l'URL de votre instance Jira.
9. (Facultatif) Pour définir cette connexion comme la connexion par défaut pour toutes les équipes de votre organisation, cochez Définir par défaut.
10. Sous Instructions de configuration, vérifiez que vous disposez des propriétés suivantes:
    • URL
    • Clé consommateur
    • Nom du consommateur
    • Clé publique
11. Dans Jira, créez un lien d'application.
    1. (Cloud) Allez dans Paramètres > Produits > Liens d'application.
       Dans les paramètres d'admin de Jira, allez à Produits > Liens d’application.
    2. Cliquez sur Créer un lien.
    3. (Cloud) Pour Type d'application, sélectionnez Application directe.
       Pour Type d'application, sélectionnez produit Atlassian.
    4. Pour URL de l'application, collez l'URL des instructions de configuration de Miro. Voir l'étape 10.
    5. Cliquez sur Continuer.
    6. Pour nom de l'application, donnez un nom à votre application.

       ⚠️ Ne saisissez pas de données dans un autre champ. Vous fournirez les données Miro dans une étape suivante.

    7. Cochez Créer un lien entrant.
    8. Cliquez sur Continuer.
    9. Copiez et collez votre clé du consommateur, nom du consommateur et clé publique depuis les instructions de configuration de Miro. Voir l'étape 10.
    10. Cliquez sur Continuer.
        Vous avez créé votre lien d'application.
12. Dans Miro, cliquez sur Connecter.
    Vous avez connecté Miro à Jira en utilisant OAuth 1.0.

Quelles sont les prochaines étapes ?

Vous avez configuré et connecté votre intégration Jira avec Miro en utilisant Jira OAuth1.0. Lorsqu'un utilisateur tente une action liée à Jira dans Miro pour la première fois, une invite lui demande de s'authentifier. Ils n'ont pas besoin de se réauthentifier.

Pour en savoir plus : Consultez Comment utiliser les cartes Jira.

Une instance Jira pour plusieurs équipes Miro

Vous pouvez installer des cartes Jira au niveau de l'organisation ou au niveau de l'équipe. Si vous avez plusieurs équipes, vous pouvez spécifier des paramètres au niveau de l'organisation pour éviter une configuration répétitive pour chaque équipe. Le lien d'application existant est ensuite utilisé pour toutes les équipes.

La connexion de plusieurs instances Jira à une seule équipe Miro n’est pas prise en charge.

Pour les demandes de mise à jour, après avoir connecté votre organisation ou votre équipe à une instance Jira, un webhook est ajouté à vos webhooks Jira pour cette organisation ou équipe Miro.

💡 Donnez un nom unique à chaque webhook par équipe. Allez sur votre page Jira WebHooks et modifiez chaque webhook nouvellement créé.

Si vous spécifiez des paramètres au niveau de l'organisation, les équipes qui ont déjà leurs propres paramètres les conservent. Toute équipe disposant de sa propre configuration peut passer aux paramètres au niveau de l'organisation à tout moment.

À l'inverse, toute équipe peut outrepasser les paramètres de l'organisation pour se connecter à une instance Jira distincte.

Si vous êtes sur un forfait Enterprise, contactez votre équipe de compte pour migrer plusieurs connexions au niveau de l'équipe vers les paramètres au niveau de votre organisation.

Désactiver les cartes Jira

Niveau de l’organisation

Pour désactiver les cartes Jira au niveau de l'organisation, suivez ces étapes :

1. Depuis votre tableau de bord Miro, cliquez sur votre avatar dans le coin supérieur droit et cliquez sur Console Admin.
2. Accédez à Applications et Intégrations > Gérer les applications.
3. Localiser les cartes Jira.
4. Pour les cartes Jira, basculez Autorisé sur la position off.

⚠️ Si vous désactivez les cartes Jira pour l'organisation, alors les membres de toutes les équipes Enterprise ne pourront pas utiliser les cartes Jira. Pour en savoir plus sur la gestion des applications, consultez la page Gestion des applications.

Niveau équipe

Pour désactiver les cartes Jira au niveau de l'équipe, suivez ces étapes :

1. Depuis votre tableau de bord Miro, cliquez sur votre avatar dans le coin supérieur droit et cliquez sur Console Admin.
2. Aller à Équipes.
3. Cliquez sur la ligne de l'équipe que vous souhaitez gérer.
   Le panneau des paramètres de l’équipe s'ouvre.
4. Cliquez sur l’onglet Apps.
5. Localisez et cliquez sur Jira Cards.
6. Cliquez sur Supprimer pour l’équipe.