

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectando um pipeline de OpenSearch ingestão da Amazon ao Atlassian Jira ou ao Confluence usando 2.0 OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Use as informações deste tópico para ajudá-lo a configurar e conectar um pipeline de OpenSearch ingestão da Amazon a uma conta do Jira ou do Confluence usando a autenticação 2.0. OAuth Execute essa tarefa quando estiver concluindo o processo [Pré-requisitos](configure-client-atlassian.md#atlassian-prerequisites) para usar um pipeline de OpenSearch ingestão com os serviços da Atlassian, mas opte por não usar as credenciais da chave de API.

**Topics**
+ [Crie um aplicativo de integração OAuth 2.0](#create-OAuth2-integration-app)
+ [Gerar e atualizar um token de acesso ao Atlassian Developer](#generate-and-refresh-jira-access-token)

## Crie um aplicativo de integração OAuth 2.0
<a name="create-OAuth2-integration-app"></a>

Use o procedimento a seguir para ajudá-lo a criar um aplicativo de integração OAuth 2.0 no site do Atlassian Developer.

**Para criar um aplicativo de integração OAuth 2.0**

1. [Faça login na sua conta de desenvolvedor da Atlassian em https://developer.atlassian.com/console/ myapps/.](https://developer.atlassian.com/console/myapps/)

1. Escolha **Criar**, **integração OAuth 2.0**.

1. Em **Name**, insira um nome para identificar a finalidade da aplicação.

1. Selecione **I agree to be bound by Atlassian's developer terms** e selecione **Create**.

1. No painel de navegação à esquerda, escolha **Authorization** e depois **Add**.

1. Em **Callback URL**, insira qualquer URL, como **https://www.amazon.com** ou **https://www.example.com**, e escolha **Save changes**.

1. No painel de navegação à esquerda, escolha a página **Permissions** e, na linha da API do Jira, escolha **Add**, depois escolha **Configure**, selecione todas as permissões Classic Scopes Read (lista fornecida abaixo) e selecione Save

1. Escolha a guia **Granular scopes** e, em seguida, escolha **Edit Scopes** para abrir a caixa de diálogo **Edit Jira API**.

1. Selecione as permissões para o plug-in de origem que você está usando:

------
#### [ 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. Escolha **Salvar**.

Para obter informações relacionadas, consulte [Implementação OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) e [Determinação dos escopos necessários para uma operação no site de desenvolvedores da Atlassian](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/).

## Gerar e atualizar um token de acesso ao Atlassian Developer
<a name="generate-and-refresh-jira-access-token"></a>

Use o procedimento a seguir para ajudar você a gerar e atualizar um token de acesso ao Atlassian Developer no site do Atlassian Developer.

**Para gerar e atualizar um token de acesso do Jira**

1. [Faça login na sua conta de desenvolvedor da Atlassian em https://developer.atlassian.com/console/ myapps/.](https://developer.atlassian.com/console/myapps/)

1. Selecione a aplicação que você criou em [Crie um aplicativo de integração OAuth 2.0](#create-OAuth2-integration-app).

1. No menu de navegação à esquerda, escolha **Authorization**.

1. Copie o valor granular da URL de autorização da API do Atlassian da parte inferior da página e cole-o no editor de texto de sua preferência.

   O formato do ARN é o seguinte:

   ```
   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. Em `state=YOUR_USER_BOUND_VALUE`, altere o valor do parâmetro à sua escolha, como state=“**sample\$1text**”.

   Para saber mais, consulte [What is the state parameter used for?](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-) no site do Atlassian Developer.

1. Observe que a seção `scope` lista os escopos granulares que você selecionou em uma tarefa anterior. Por exemplo: `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access` indica que você deseja gerar um `refresh_token`.

1. Abra uma janela do navegador e insira a URL de autorização que você copiou na barra de endereço da janela do navegador.

1. Quando a página de destino se abrir, verifique se as informações estão corretas e escolha **Accept** para ser redirecionado para página inicial do Jira ou do Confluence.

1. Depois que a página inicial for carregada, copie a URL dessa página. Ele contém o código de autorização da aplicação. Você precisará desse código para gerar o token de acesso. Toda a seção depois de `code=` é o código de autorização.

1. Use o seguinte comando cURL para gerar o token de acesso. Substitua *placeholder values* por suas próprias informações.
**dica**  
Você também pode usar um serviço de terceiros, como o 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"}'
   ```

   A resposta a esse comando inclui os valores de `access_code` e `refresh_token`.