Qui peut le faire : les admins d’entreprise
Quels forfaits : Entreprise
✏️ La connexion de Jira via un serveur d'autorisation est uniquement activée au niveau de l'organisation.
Cet article fournit les étapes pour connecter Miro à Jira avec un serveur d'autorisation tiers sur site utilisant OAuth2.0.
Pour apprendre les détails techniques de cette configuration, consultez l'article de référence pour Jira sur site avec autorisation tierce utilisant OAuth 2.0.
Prérequis
- Assurez-vous de disposer des autorisations suivantes :
- Admin d’entreprise Miro
- (Facultatif) Administrateur système Jira, si vous souhaitez utiliser des webhooks automatiques.
- Sur votre serveur d’autorisation, créez une application OAuth 2.0.
- Configurez l'URL de redirection dans votre application OAuth 2.0 vers l'URL suivante :
https://integrations.miro.com/api/external-auth/oauth2/callback - Assurez-vous d'avoir les détails suivants de votre application OAuth 2.0 prêts à être configurés dans Miro :
- URL d’autorisation
- URL du jeton
- Identifiant client
- Secret client
- Portée
Se connecter à Jira sur site avec des serveurs tiers en utilisant OAuth 2.0
- Sur votre tableau de bord Miro, sélectionnez votre avatar dans le coin supérieur droit et allez dans Console d'administration | Paramètres.
- Aller dans Applications et intégrations
> Applications > Onglet Gérer les applications.
- Assurez-vous que Autoriser uniquement les applications de la liste ci-dessous est activée.
- Dans la colonne App, pour les cartes Jira, sélectionnez Paramètres.
- Cliquez sur Établir une nouvelle connexion.
- Sous configuration de Jira, cliquez sur Jira Data Center.
- Sous Méthode d’authentification, sélectionnez OAuth2.0 via un serveur d'autorisation tiers.
- Sous URL Jira, entrez l'URL de votre instance Jira.
✏️ Vous pouvez ajouter votre URL de base Jira externe ou votre URL Jira interne. Si vous utilisez une URL interne Jira, vous devez alors spécifier votre URL de passerelle API externe à l'étape 10.
✏️ En général, l'utilisation d'une URL interne vous permet d'ajuster la fonctionnalité de navigation vers la source.
- (Facultatif) Pour faire de cette connexion la connexion par défaut pour toutes les équipes de votre organisation, cochez Définir par défaut.
- (Optionnel) Si vous utilisez une passerelle API pour faire des requêtes à Jira, alors pour l'URL de base de la passerelle d’API Jira, saisissez l'URL de votre passerelle API externe.
- Saisissez les détails suivants de votre application OAuth 2.0 :
- URL d’autorisation
- URL du jeton
- Identifiant client
- Clé secrète client
- Portée
- (Facultatif) Pour obtenir des mises à jour en temps réel de Jira dans Miro, cochez Créer un webhook automatiquement.
✏️ Vous pouvez ajouter le webhook manuellement plus tard.
- Cliquez sur Connecter.
- Suivez le flux d'authentification pour votre serveur d'autorisation. Si vous y êtes invité, connectez-vous à votre environnement.
Lorsque votre connexion est terminée, votre instance Jira est répertoriée sous Instances connectées avec l'étiquette suivante : Serveur d’authentification.
Assurez-vous que votre équipe puisse s'authentifier
Maintenant que vous avez connecté votre instance Jira au niveau de l'organisation, vous pouvez commencer à utiliser Jira au niveau de l'équipe.
- Sur votre tableau de bord Miro, sélectionnez votre avatar en haut à droite et allez à Console d’administration.
- Sélectionnez Équipes > Votre équipe.
Le curseur Votre équipe s'ouvre. - Sélectionnez l'onglet Applications.
- Dans la liste des applications, sélectionnez cartes Jira.
- Sous Paramètres d'administration, vérifiez si votre configuration Jira affiche l'étiquette CONNEXION GLOBALE, et affiche l'URL correcte de l'instance Jira, puis faites l'une des actions suivantes :
- Si c'est le cas, vous avez terminé cette procédure. Vous pouvez passer à Et ensuite ?
- Si non, sélectionnez Modifier la configuration > Paramètres généraux de l’organisation > votre instance Jira.
- Sélectionner Enregistrer les paramètres.
Et ensuite ?
Chaque membre de l'équipe doit autoriser son compte utilisateur. Pour s'assurer que chaque utilisateur obtienne des jetons d'accès et de rafraîchissement, lorsqu'un membre de l'équipe tente d'effectuer une action liée à Jira sur un tableau Miro, il sera invité à autoriser son compte.
FAQ
Si toutes les conditions suivantes sont remplies, alors OAuth 2.0 via un serveur d'autorisation tiers est une bonne option :
- Votre instance Jira est hébergée sur vos serveurs.
- L'accès externe à Jira n'est possible qu'avec une passerelle API.
- La passerelle API applique l'autorisation en utilisant un serveur d'autorisation personnalisé.
- Vous devez connecter Miro à Jira sans exposer l'URL de base publique de Jira.