> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Jira est l'outil de suivi pour les équipes qui planifient et construisent d'excellents produits.

<Note>
  🗓 Cette documentation a été mise à jour en novembre 2022 pour refléter les changements d'interface utilisateur de Jira. Si, au moment de la lecture, vous constatez que nos instructions ne sont plus à jour, merci de [nous le faire savoir !](mailto:support@appsignal.com)
</Note>

[Jira](https://www.atlassian.com/software/jira) est un outil utilisé pour la gestion de projet. Il s'organise autour d'un système de tickets permettant de créer, suivre et assigner des fonctionnalités, des tâches et des bugs.

AppSignal peut être intégré à Jira pour la création automatique de tickets à partir d'incidents.

Cette documentation vous guidera à travers les étapes nécessaires pour intégrer AppSignal à votre projet Jira.

## Configurer Jira

Avant de pouvoir lier AppSignal à Jira, nous devons configurer Jira pour qu'il accepte notre requête OAuth.

Pour ce faire, cliquez sur la roue dentée des paramètres (⚙️) en haut à droite de la barre de navigation et sélectionnez **Products** dans le menu des paramètres.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-products.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=8478ff4290f030ca45c631e613086f9f" alt="Produits Jira" width="1166" height="777" data-path="assets/images/screenshots/jira/jira-products.png" />

Sélectionnez **« Application links »** dans la navigation latérale Products, puis cliquez sur **« Create link »**.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-add-link.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=992aed7d59071b7cec79c797e71d5344" alt="Ajouter un lien Jira" width="1166" height="720" data-path="assets/images/screenshots/jira/jira-add-link.png" />

Une fenêtre contextuelle apparaît. Dans le champ Application URL, ajoutez l'adresse : `https://www.appsignal.com`

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-add-link-pop-up.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=4c7742b4c6d070a5450407af8a45a1ed" alt="Pop-up d'ajout de lien Jira" width="1166" height="777" data-path="assets/images/screenshots/jira/jira-add-link-pop-up.png" />

Jira peut afficher l'erreur : « No response was received from the URL you entered ». Vous pouvez ignorer cette erreur et continuer en cliquant sur **« Continue »**.

Vous accédez ensuite à un écran Review Link. Vous devez seulement renseigner un Application name avant de continuer. Nommez l'application : `AppSignal`, puis cliquez sur Continue.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-review-link-pop-up.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=7729fc73fe6574ef41cce8218bb41598" alt="Pop-up Review Link Jira" width="1920" height="1001" data-path="assets/images/screenshots/jira/jira-review-link-pop-up.png" />

### Configuration OAuth

Il est maintenant temps de configurer **« Incoming Authentication »** d'AppSignal. Pour cela, accédez à **« Edit »** sur l'écran **« Application links »** :

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-link-edit-hover.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=71b8fc382a3f0fbb23bdaa0c807c4f42" alt="Survol d'édition d'un lien Jira" width="1445" height="818" data-path="assets/images/screenshots/jira/jira-link-edit-hover.png" />

Une fenêtre **« Configure AppSignal »** s'ouvre. Accédez à « Incoming Authentication » dans le menu de gauche.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-edit-link-auth.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=0cc196a83b227ef79a7b04e417a2948b" alt="Authentification du lien Jira" width="1445" height="818" data-path="assets/images/screenshots/jira/jira-edit-link-auth.png" />

Dans l'onglet « Incoming OAuth », configurez OAuth avec les valeurs suivantes :

* Consumer Key : `ce2jejafmni3qmnzrfergg9fLpzxmppl`
* Consumer Name : `AppSignal`
* Public Key :

```text Text theme={null}
-----BEGIN CERTIFICATE-----
MIIDaDCCAlACCQCmEw1Ty8uuRTANBgkqhkiG9w0BAQsFADB2MQswCQYDVQQGEwJO
TDEWMBQGA1UECAwNTm9vcmQtQnJhYmFudDESMBAGA1UEBwwJRGVuIEJvc2NoMRUw
EwYDVQQKDAxBcHBTaWduYWwgQlYxJDAiBgkqhkiG9w0BCQEWFWNvbnRhY3RAYXBw
c2lnbmFsLmNvbTAeFw0yMjA0MjExMDQ1MjBaFw0yMjA1MjExMDQ1MjBaMHYxCzAJ
BgNVBAYTAk5MMRYwFAYDVQQIDA1Ob29yZC1CcmFiYW50MRIwEAYDVQQHDAlEZW4g
Qm9zY2gxFTATBgNVBAoMDEFwcFNpZ25hbCBCVjEkMCIGCSqGSIb3DQEJARYVY29u
dGFjdEBhcHBzaWduYWwuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEAtts1uBJnpIP89PDrlz7EjmEOBBE9RRjpfEEcPctwyYwgLwlP1rK75Qsi/f/T
4T8jD1Q5uVoaAx03m+OBnAJu016qZI2yaCBDVw4+eZwhD9O4kj9ZvwsOFv+ewme8
Bi4MSh+PpXcZuf+FAtAWEPS0aZlA3tq1DokxiJsu1UjfDGBjpVGRf4vwPhQg9Qaq
SPOpFODHX6m2fQvglRUxU6y9pJgXhBUxhkiyAosJOnvVLVVdOJ/cnEM6XRfXMb1I
aa7on+2dMjryZktYCZRwWMKBfTP3v4qyWB/keyob9K/BvHi8uDTSbJV62vQ+WJza
b3STEtFvLl6o2l8GzSkHVlX8/QIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQAXnutJ
HHFo3s+b1pnbRs0uKQ/D8bMUlGQocOh2+7189puEdy161Z6qXbv7QL2Z5uAhd67j
I/8h3Fchtiy+PbXAn5L+cTQ8ixPllBq4+WFCnL+lWhV4Pnv+qc6KohBHOfgYL9U0
aKGYe5/eFBdewXE1VT+qfncXOxRSjGr4L5UqqS3672ncl1mEWwX6VN/SiGQ8eQ2h
FnBIhGCok9w2GLRmx7bfdQVo0b5ROq1FgWyWJWT+eFRmAJ4ei2YrjmfgAfgVEco3
LfAzOw42KKEkcFLiPLZarCGh15fh7QSdBIVI1aF15vceLONC4EEvxMpFLYljmqIF
aXqiZ0iKf9gfCvtP
-----END CERTIFICATE-----
```

Cliquez sur **« Save »**.

## Configurer AppSignal

Pour terminer la liaison de votre projet Jira à AppSignal, AppSignal doit être configuré pour communiquer avec votre projet Jira.

Pour ce faire, ouvrez votre application dans AppSignal. Cliquez sur « App settings » en bas du volet de navigation de gauche puis cliquez sur « Integrations » :

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/appsignal-settings.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=512d30516537b8f48515fb6473933c37" alt="Paramètres AppSignal" width="1219" height="804" data-path="assets/images/screenshots/jira/appsignal-settings.png" />

Allez dans « Personal issue tracker integrations » et cliquez sur « Manage » pour Jira. Vous pouvez aussi suivre [ce lien](https://appsignal.com/redirect-to/app?to=integrations/jira/edit).

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/appsignal-integrations.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=ac741bdc2fb397f501f8a01e3c1b67ea" alt="Intégrations AppSignal" width="1219" height="804" data-path="assets/images/screenshots/jira/appsignal-integrations.png" />

Descendez jusqu'à « Jira installation location » et saisissez l'URL de votre projet Jira, par exemple : `project-name.appsignal.net`, puis cliquez sur « link AppSignal to Jira ».

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/appsignal-connect-jira.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=296bcad0bcaf8f66885c289e9923db00" alt="Connecter AppSignal à Jira" width="943" height="303" data-path="assets/images/screenshots/jira/appsignal-connect-jira.png" />

L'écran d'authentification suivant vous sera présenté. Cliquez sur « Allow ».

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-connect.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=f3828a10901c82b2c3951af287aa5734" alt="Connexion Jira" width="597" height="364" data-path="assets/images/screenshots/jira/jira-connect.png" />

Vous serez redirigé vers AppSignal. Ici, vous devez sélectionner le projet et le type de ticket à utiliser pour les tickets AppSignal. Pour continuer, cliquez sur **« create integration »**.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/appsignal-jira-linked-config.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=b5cf019ecde252f7e79d41611ca7f55d" alt="Configuration Jira liée à AppSignal" width="1219" height="804" data-path="assets/images/screenshots/jira/appsignal-jira-linked-config.png" />

Si cette étape produit un message d'erreur, lisez la section [erreurs](#errors) pour plus d'aide.

## Erreurs

AppSignal exige que quatre champs soient présents dans Jira :

* Labels
* Environment
* Summary
* Description

AppSignal affichera un message d'erreur à la fin de la configuration si des champs manquent et précisera lesquels doivent être ajoutés dans Jira.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/appsignal-jira-integration-error.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=0713ffe1d834177672a1939762abf760" alt="Erreur d'intégration AppSignal Jira" width="917" height="212" data-path="assets/images/screenshots/jira/appsignal-jira-integration-error.png" />

Vous devrez ajouter les champs aux écrans Jira en allant dans l'onglet « Issues » du menu « Settings » :

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-setting-issues.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=a085f72a05398c4a016292c73feec20f" alt="Paramètres Issues Jira" width="1114" height="825" data-path="assets/images/screenshots/jira/jira-setting-issues.png" />

Allez ensuite dans « Screens » dans le volet de navigation de gauche et cliquez sur « Configure » pour l'écran concerné :

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-screen-options.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=1893bee4775a4507000663cc3ae69857" alt="Options d'écran Jira" width="1114" height="825" data-path="assets/images/screenshots/jira/jira-screen-options.png" />

Sur cette page « Configure », Jira vous présentera une liste des champs déjà configurés. Faites défiler jusqu'en bas et ajoutez les champs requis manquants.

<img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/jira/jira-screen-config.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=6b1504061a71bd6c96bddc7a689b77af" alt="Configuration d'écran Jira" width="1219" height="804" data-path="assets/images/screenshots/jira/jira-screen-config.png" />

Une fois tous les champs créés, vous devriez pouvoir reprendre et terminer la [configuration de votre intégration Jira depuis l'application AppSignal](#configuring-appsignal).

## Besoin d'aide ?

Si vous avez suivi les étapes de cette page et que vous êtes toujours bloqué, n'hésitez pas à nous contacter à [support@appsignal.com](mailto:support@appsignal.com).

<hr />

### Liste des intégrations

* [Asana](/application/integrations/asana)
* [Discord](/application/integrations/discord)
* [Geckoboard](/application/integrations/geckoboard)
* [GitLab](/application/integrations/gitlab)
* [Google Hangouts Chat](/application/integrations/hangouts)
* [Jira](/application/integrations/jira)
* [Linear](/application/integrations/linear)
* [Microsoft Teams](/application/integrations/teams)
* [OpsGenie](/application/integrations/opsgenie)
* [PagerDuty](/application/integrations/pagerduty)
* [Shortcut](/application/integrations/shortcut)
* [Slack](/application/integrations/slack)
* [Squadcast](/application/integrations/squadcast)
* [Trello](/application/integrations/trello)
* [Webhooks](/application/integrations/webhooks)