

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connessione di una pipeline Amazon OpenSearch Ingestion ad Atlassian Jira o Confluence tramite 2.0 OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Usa le informazioni in questo argomento per aiutarti a configurare e connettere una pipeline Amazon OpenSearch Ingestion a un account Jira o Confluence utilizzando l'autenticazione 2.0. OAuth Esegui questa attività quando stai completando l'[Prerequisiti](configure-client-atlassian.md#atlassian-prerequisites)utilizzo di una pipeline di OpenSearch ingestion con Atlassian Services, ma scegli di non utilizzare le credenziali della chiave API.

**Topics**
+ [Crea un'app di integrazione 2.0 OAuth](#create-OAuth2-integration-app)
+ [Generazione e aggiornamento di un token di accesso Atlassian Developer](#generate-and-refresh-jira-access-token)

## Crea un'app di integrazione 2.0 OAuth
<a name="create-OAuth2-integration-app"></a>

Utilizza la seguente procedura per aiutarti a creare un'app di integrazione OAuth 2.0 sul sito Web di Atlassian Developer.

**Per creare un'app di integrazione OAuth 2.0**

1. [Accedi al tuo account Atlassian Developer su https://developer.atlassian.com/console/ myapps/.](https://developer.atlassian.com/console/myapps/)

1. ****Scegli Create, integrazione 2.0. OAuth ****

1. In **Nome**, inserisci un nome per identificare lo scopo dell'app.

1. **Seleziona la casella di controllo **Accetto di essere vincolato dai termini per sviluppatori di Atlassian**, quindi scegli Crea.**

1. **Nella barra di navigazione a sinistra, scegli **Autorizzazione**, quindi scegli Aggiungi.**

1. Per **URL di richiamata**, inserisci un URL qualsiasi, ad esempio **https://www.amazon.com** o**https://www.example.com**, quindi scegli **Salva modifiche**.

1. Nella barra di navigazione a sinistra, scegli la pagina **Autorizzazioni**, quindi nella riga per Jira API, scegli **Aggiungi**, quindi scegli **Configura**. Quindi seleziona tutte le autorizzazioni di lettura di Classic Scopes (elenco riportato di seguito), quindi seleziona Salva

1. **Scegli la scheda Ambiti **granulari, quindi scegli Modifica ambiti** **per aprire la finestra di dialogo Modifica** API Jira.**

1. Seleziona le autorizzazioni per il plug-in sorgente che stai utilizzando:

------
#### [ 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. Scegli **Save** (Salva).

Per informazioni correlate, consulta [Implementazione OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) e [Determinazione degli ambiti richiesti per un'operazione](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/) sul sito Web di Atlassian Developer.

## Generazione e aggiornamento di un token di accesso Atlassian Developer
<a name="generate-and-refresh-jira-access-token"></a>

Utilizza la seguente procedura per aiutarti a generare e aggiornare un token di accesso Atlassian Developer sul sito web di Atlassian Developer.

**Per generare e aggiornare un token di accesso Jira**

1. [Accedi al tuo account Atlassian Developer su myapps/. https://developer.atlassian.com/console/](https://developer.atlassian.com/console/myapps/)

1. Scegli l'app in cui hai creato. [Crea un'app di integrazione 2.0 OAuth](#create-OAuth2-integration-app)

1. Nella barra di navigazione a sinistra, scegli **Autorizzazione.**

1. Copia il valore granulare dell'URL di autorizzazione dell'API Atlassian dalla parte inferiore della pagina e incollalo nell'editor di testo che preferisci.

   Il formato dell'URL è il seguente:

   ```
   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. Per`state=YOUR_USER_BOUND_VALUE`, modifica il valore del parametro con qualsiasi cosa tu scelga, ad esempio state=»». **sample\$1text**

   Per ulteriori informazioni, consulta A [cosa serve il parametro state](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-)? sul sito Web di Atlassian Developer.

1. Nota che la `scope` sezione elenca gli ambiti granulari selezionati in un'attività precedente. Ad esempio: `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access`indica che si desidera generare un. `refresh_token`

1. Apri una finestra del browser Web e inserisci l'URL di autorizzazione che hai copiato nella barra degli indirizzi della finestra del browser.

1. Quando si apre la pagina di destinazione, verifica che le informazioni siano corrette, quindi scegli **Accetta** per essere reindirizzato alla home page di Jira o Confluence.

1. Dopo aver caricato la home page, copia l'URL di questa pagina. Contiene il codice di autorizzazione per la tua applicazione. Questo codice viene utilizzato per generare il token di accesso. L'intera sezione successiva `code=` è il codice di autorizzazione.

1. Usa il seguente comando cURL per generare il token di accesso. Sostituisci *placeholder values* con le informazioni appropriate.
**Suggerimento**  
Puoi anche utilizzare un servizio di terze parti come 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 risposta a questo comando include i valori per `access_code` e`refresh_token`.