- 19 Jul 2023
- 5 Minutes à lire
- Impression
- SombreLumière
- PDF
Configuration de la connexion de Jira Server/Data Center à Airtable
- Mis à jour le 19 Jul 2023
- 5 Minutes à lire
- Impression
- SombreLumière
- PDF
Cet article décrit comment les admins peuvent configurer leur Jira Server/Data Center sur réseau ou sur site pour l’associer à Airtable à l’aide de notre intégration de synchronisation Airtable ou de nos fonctionnalités d’automatisation. Nous présentons des recommandations concernant quelques scénarios de configuration courants, ainsi que certains prérequis. Toutefois, gardez à l’esprit que l’architecture de votre instance de Jira Server/Data Center peut différer et ne pas être abordée dans cet article.
Prérequis
Airtable prend actuellement en charge Jira 7.13 ou ses versions ultérieures. Il se peut que les versions antérieures soient compatibles avec l’intégration. Néanmoins, des problèmes inattendus peuvent survenir. En outre, Airtable doit pouvoir accéder à l’instance de Jira Server sur Internet. Une connexion sécurisée (HTTPS) est requise.
Configuration pour les admins informatiques
Cette section du guide est destinée aux personnes chargées de la supervision de l’infrastructure réseau de votre organisation. L’objectif de cette partie du processus de configuration consiste à autoriser les systèmes Airtable à effectuer des appels d’API vers votre instance de Jira Server de façon sécurisée. Pour ce faire, il convient d’effectuer trois étapes fondamentales.
Le nom DNS de votre instance de Jira Server doit renvoyer à une adresse IP accessible en externe. Si le nom DNS de votre instance de Jira Server renvoie à une adresse IP uniquement accessible depuis un intranet d’entreprise ou un VPN, vous devrez modifier le DNS.
Nous vous recommandons les deux options suivantes :
- Ajoutez une entrée DNS publique qui utilise un nom DNS différent pour le trafic externe. Par exemple, si un DNS interne renvoie
jira.company.com
à l’adresse IP privée du serveur Jira dans le réseau client, il est possible de créer une entrée DNS publique qui redirigejira-ext.company.com
vers l’adresse IP publique du pare-feu du réseau client. Un moyen d’y parvenir consiste à configurer un équilibreur de charge réseau qui examine un port particulier et à rediriger la demande vers des adresses IP internes vers lesquelles redirigent des entrées DNS internes. - Configurez votre serveur DNS de sorte qu’il renvoie au même nom DNS pour le trafic interne et externe. Votre serveur DNS doit renvoyer
jira.company.com
à une adresse IP pour le trafic interne et à une autre adresse IP externe pour le trafic externe.
Le protocole HTTPS doit pouvoir accéder à votre instance de Jira Server à l’aide d’un certificat délivré par une autorité habilitée et reconnue, afin d’assurer une connexion sécurisée entre Airtable et votre instance de Jira Server. Pour veiller à ce que ce soit le cas pour votre instance de Jira Server, Jira a déjà rédigé sa propre documentation afin de vous guider tout au long des étapes nécessaires :
Airtable doit pouvoir accéder à l’API REST de votre instance de Jira Server. Si votre instance de Jira Server est protégée par un pare-feu, vous devrez configurer le vôtre de façon à ce qu’il accepte les demandes d’API entrantes de la part d’Airtable. Afin d’autoriser l’accès de la part d’Airtable, tout en empêchant le reste du trafic externe d’accéder à votre instance de Jira Server, ajoutez les adresses IP statiques suivantes à la liste d’autorisation dans votre pare-feu :
- 52.44.24.118
- 3.215.151.50
- 34.204.30.184
- 3.225.92.43
- 3.231.96.120
- 34.236.75.94
L’intégration de synchronisation Airtable est exécutée dans le cloud et doit établir des connexions depuis Internet pour atteindre votre instance de Jira Server à l’aide de l’API REST d’Atlassian. Les points de terminaison de l’API REST de Jira Server se trouvent sur un chemin distinct de l’interface utilisateur de Jira et des pages de connexion pour accéder à celle-ci. Vous pouvez restreindre l’accès d’Airtable aux points de terminaison suivants utilisés par l’API REST de Jira Server :
- https://<url_de_base_de_jira_server>/rest/*
- https://<url_de_base_de_jira_server>/plugins/*
Configuration pour les admins Airtable et Jira
Cette section du guide est destinée aux personnes chargées de la supervision des paramètres d’administration des comptes Airtable et Jira de votre organisation. Avant de passer aux étapes suivantes, assurez-vous de disposer de l’autorisation d’administration Jira et que vous pouvez vous connecter à Airtable en tant qu’admin.
L’objectif de cette section consiste à créer un lien d’application (lien d’app) sur le serveur Jira. Il convient d’abord d’effectuer quelques étapes dans Airtable qui génèreront les informations essentielles à la configuration du lien d’application.
Afin de créer une configuration de Jira Server et de générer la clé consommateur et la clé publique pour le lien d’application Jira :
- Connectez-vous à Airtable avec vos informations d’identification d’admin.
- Sur la page Paramètres, accédez à la section « Configurer les intégrations » et cliquez sur l’onglet « Apps et intégrations ».
- Dans la section « Intégrations », cliquez sur le titre « Configurer les intégrations » pour développer la section correspondante.
- Vous y trouverez la rubrique « Jira Server », ainsi que l’option « Ajouter une configuration » en bas.
- Une fenêtre s’ouvre. Vous pouvez y saisir le nom de la configuration et l’URL de votre instance de Jira Server.
- Une fois la configuration créée, utilisez la clé consommateur et la clé publique associées afin de créer un lien d’application sur Jira Server à la prochaine section.
Dans les étapes décrites ci-dessous, nous vous guiderons à travers la configuration du lien d’application dans Jira. Si vous travaillez avec des liens d’app pour la première fois, nous vous recommandons de consulter également la documentation connexe.
- Connectez-vous à votre instance de Jira Server/Data Center avec l’autorisation d’administration Jira.
- Accédez à « Administration () > Applications » et sélectionnez la rubrique « Application Links » (Liens d’application) dans le menu de gauche.
- Dans le champ « Enter the URL of the application you want to link » (Saisir l’URL de l’application à lier), saisissez
https://app.airtable.com
et cliquez sur « Create new link » (Créer un lien). Vous pouvez recevoir l’une des invites suivantes. Vous pouvez ignorer ces messages et cliquer sur Continue (Continuer) pour laisser l’URL telle quelle.
- L’URL que vous avez saisie n’a généré aucune réponse.
- L’URL d’application fournie a été redirigée une fois. Veuillez vérifier le champ de l’URL redirigée pour vous assurer qu’il s’agit d’une URL de confiance.
- Sur le premier écran de la boîte de dialogue « Link applications » (Lier des applications) :
- Dans le champ Application Name (Nom de l’application), saisissez Airtable.
- Pour Application Type (Type de l’application), acceptez la valeur par défaut Generic Application (Application générique).
- Cochez la case Create incoming link (Créer un lien entrant).
- Laissez les autres champs vides.
- Sur l’écran suivant de la boîte de dialogue Link applications (Lier des applications), utilisez la clé de consommateur et la clé publique fournies par Airtable. Indiquez Airtable comme en tant que nom de consommateur.
- Cliquez sur Continue (Continuer). Votre lien d’application est créé.