

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connexion d'un pipeline Amazon OpenSearch Ingestion à Atlassian Jira ou Confluence à l'aide de la version 2.0 OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Utilisez les informations de cette rubrique pour vous aider à configurer et à connecter un pipeline Amazon OpenSearch Ingestion à un compte Jira ou Confluence à l'aide de l'authentification OAuth 2.0. Effectuez cette tâche lorsque vous terminez la [Conditions préalables](configure-client-atlassian.md#atlassian-prerequisites) procédure d'utilisation d'un pipeline d' OpenSearch ingestion avec Atlassian Services, mais que vous choisissez de ne pas utiliser les informations d'identification des clés d'API.

**Topics**
+ [Création d'une application d'intégration OAuth 2.0](#create-OAuth2-integration-app)
+ [Génération et actualisation d'un jeton d'accès Atlassian Developer](#generate-and-refresh-jira-access-token)

## Création d'une application d'intégration OAuth 2.0
<a name="create-OAuth2-integration-app"></a>

Utilisez la procédure suivante pour créer une application d'intégration OAuth 2.0 sur le site Web d'Atlassian Developer.

**Pour créer une application d'intégration OAuth 2.0**

1. [Connectez-vous à votre compte Atlassian Developer sur myapps/. https://developer.atlassian.com/console/](https://developer.atlassian.com/console/myapps/)

1. Choisissez **Créer**, **intégration OAuth 2.0**.

1. Dans **Nom**, entrez un nom pour identifier l'objectif de l'application.

1. **Cochez la case **J'accepte d'être lié par les conditions du développeur d'Atlassian**, puis choisissez Créer.**

1. Dans le volet de navigation de gauche, choisissez **Autorisation**, puis **Ajouter**.

1. Pour **URL de rappel**, entrez n'importe quelle URL, telle que **https://www.amazon.com** ou**https://www.example.com**, puis choisissez **Enregistrer les modifications**.

1. Dans le volet de navigation de gauche, choisissez la page **Permissions**, puis dans la ligne correspondant à l'API Jira, choisissez **Ajouter**, puis choisissez **Configurer**. Sélectionnez toutes les autorisations de lecture de Classic Scopes (liste ci-dessous), puis sélectionnez Enregistrer

1. Choisissez l'onglet **Étendues granulaires**, puis sélectionnez **Modifier les étendues pour ouvrir la boîte** de dialogue **Modifier l'API Jira**.

1. Sélectionnez les autorisations pour le plugin source que vous utilisez :

------
#### [ Jira ]

   ```
   read:audit-log:jira
   read:issue:jira
   read:issue-meta:jira
   read:attachment:jira
   read:comment:jira
   read:comment.property:jira
   read:field:jira
   read:field.default-value:jira
   read:field.option:jira
   read:field-configuration-scheme:jira
   read:field-configuration:jira
   read:issue-link:jira
   read:issue-link-type:jira
   read:issue-link-type:jira
   read:issue.remote-link:jira
   read:issue.property:jira
   read:resolution:jira
   read:issue-details:jira
   read:issue-type:jira
   read:issue-worklog:jira
   read:issue-field-values:jira
   read:issue.changelog:jira
   read:issue.transition:jira
   read:issue.vote:jira
   read:jira-expressions:jira
   ```

------
#### [ Confluence ]

   ```
   read:content:confluence
   read:content-details:confluence
   read:space-details:confluence
   read:audit-log:confluence
   read:page:confluence
   read:blogpost:confluence
   read:custom-content:confluence
   read:comment:confluence
   read:space:confluence
   read:space.property:confluence
   read:space.setting:confluence
   read:content.property:confluence
   read:content.metadata:confluence
   read:task:confluence
   read:whiteboard:confluence
   read:app-data:confluence
   manage:confluence-configuration
   ```

------

1. Choisissez **Enregistrer**.

Pour des informations connexes, consultez [Implémentation de la OAuth version 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) et [Détermination des étendues requises pour une opération](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/) sur le site Web d'Atlassian Developer.

## Génération et actualisation d'un jeton d'accès Atlassian Developer
<a name="generate-and-refresh-jira-access-token"></a>

Utilisez la procédure suivante pour générer et actualiser un jeton d'accès Atlassian Developer sur le site Web d'Atlassian Developer.

**Pour générer et actualiser un jeton d'accès Jira**

1. [Connectez-vous à votre compte Atlassian Developer sur myapps/. https://developer.atlassian.com/console/](https://developer.atlassian.com/console/myapps/)

1. Choisissez l'application que vous avez créée dans[Création d'une application d'intégration OAuth 2.0](#create-OAuth2-integration-app).

1. Dans le volet de navigation de gauche, sélectionnez **Autorisation.**

1. Copiez la valeur granulaire de l'URL d'autorisation de l'API Atlassian en bas de page et collez-la dans l'éditeur de texte de votre choix.

   Le format de l'URL est le suivant :

   ```
   https://auth.atlassian.com/authorize?
   audience=api.atlassian.com 
   &client_id=YOUR_CLIENT_ID
   &scope=REQUESTED_SCOPE%20REQUESTED_SCOPE_TWO
   &redirect_uri=https://YOUR_APP_CALLBACK_URL
   &state=YOUR_USER_BOUND_VALUE 
   &response_type=code
   &prompt=consent
   ```

1. En `state=YOUR_USER_BOUND_VALUE` effet, remplacez la valeur du paramètre par celle de votre choix, par exemple state= » **sample\$1text** ».

   Pour plus d'informations, voir À [quoi sert le paramètre d'état ?](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-) sur le site Web d'Atlassian Developer.

1. Notez que la `scope` section répertorie les étendues granulaires que vous avez sélectionnées lors d'une tâche précédente. Par exemple : `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access`indique que vous souhaitez générer un`refresh_token`.

1. Ouvrez une fenêtre de navigateur Web et entrez l'URL d'autorisation que vous avez copiée dans la barre d'adresse de la fenêtre du navigateur.

1. Lorsque la page cible s'ouvre, vérifiez que les informations sont correctes, puis choisissez **Accepter** pour être redirigé vers votre page d'accueil Jira ou Confluence.

1. Une fois la page d'accueil chargée, copiez l'URL de cette page. Il contient le code d'autorisation de votre application. Vous utilisez ce code pour générer votre jeton d'accès. La section complète qui suit `code=` est le code d'autorisation.

1. Utilisez la commande cURL suivante pour générer le jeton d'accès. Remplacez les *placeholder values* par vos propres informations.
**Astuce**  
Vous pouvez également utiliser un service tiers tel que Postman.

   ```
   curl --request POST --url 'https://auth.atlassian.com/oauth/token' \
   --header 'Content-Type: application/json' \
   --data '{"grant_type": "authorization_code",
   "client_id": "YOUR_CLIENT_ID",
   "client_secret": "YOUR_CLIENT_SECRET",
   "code": "AUTHORIZATION_CODE",
   "redirect_uri": "YOUR_CALLBACK_URL"}'
   ```

   La réponse à cette commande inclut les valeurs pour `access_code` et`refresh_token`.