

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conexión de una canalización de Amazon OpenSearch Ingestion a Atlassian, Jira o Confluence mediante la versión 2.0 OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Usa la información de este tema como ayuda para configurar y conectar una canalización de Amazon OpenSearch Ingestion a una cuenta de Jira o Confluence mediante OAuth la autenticación 2.0. Realiza esta tarea cuando estés completando el proceso de uso de una canalización [Requisitos previos](configure-client-atlassian.md#atlassian-prerequisites) de OpenSearch ingestión con Atlassian Services, pero decidas no usar las credenciales de la clave de la API.

**Topics**
+ [

## Crea una aplicación de integración OAuth 2.0
](#create-OAuth2-integration-app)
+ [

## Generación y actualización de un token de acceso para desarrolladores de Atlassian
](#generate-and-refresh-jira-access-token)

## Crea una aplicación de integración OAuth 2.0
<a name="create-OAuth2-integration-app"></a>

Usa el siguiente procedimiento para ayudarte a crear una aplicación de integración OAuth 2.0 en el sitio web para desarrolladores de Atlassian.

**Para crear una aplicación de integración OAuth 2.0**

1. [Inicia sesión en tu cuenta de desarrollador de Atlassian en https://developer.atlassian.com/console/ myapps/.](https://developer.atlassian.com/console/myapps/)

1. ****Elige Create, integración 2.0. OAuth ****

1. En **Nombre**, escriba un nombre para identificar el propósito de la aplicación.

1. Seleccione la casilla **Acepto regirme por las condiciones del desarrollador de Atlassian** y seleccione **Crear**.

1. En el panel de navegación de la izquierda, seleccione **Autorización** y, a continuación, seleccione **Agregar**.

1. En **URL de devolución de llamada**, ingrese cualquier URL, como **https://www.amazon.com** o **https://www.example.com** y seleccione **Guardar cambios**.

1. En el panel de navegación de la izquierda, seleccione la página **Permisos** y, a continuación, en la fila correspondiente a la API de Jira, seleccione **Agregar**. Luego, seleccione **Configurar**. Seleccione todos los permisos de lectura de ámbitos clásicos (la lista aparece abajo) y, a continuación, seleccione “Guardar”.

1. Seleccione la pestaña **Ámbitos granulares** y, a continuación, seleccione **Editar ámbitos** para abrir el cuadro de diálogo **Editar la API de Jira**.

1. Seleccione los permisos del complemento de origen que está utilizando:

------
#### [ 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. Seleccione **Save**.

Para obtener información relacionada, consulta [Implementación de la OAuth versión 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) y [Determinar los alcances necesarios para una operación en el sitio web para](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/) desarrolladores de Atlassian.

## Generación y actualización de un token de acceso para desarrolladores de Atlassian
<a name="generate-and-refresh-jira-access-token"></a>

Utilice el siguiente procedimiento para generar y actualizar un token de acceso para desarrolladores de Atlassian en el sitio web para desarrolladores de Atlassian.

**Para generar y actualizar un token de acceso de Jira**

1. [Inicia sesión en tu cuenta de desarrollador de Atlassian en myapps/. https://developer.atlassian.com/console/](https://developer.atlassian.com/console/myapps/)

1. Seleccione la aplicación que ha creado en [Crea una aplicación de integración OAuth 2.0](#create-OAuth2-integration-app).

1. En el panel de navegación de la izquierda, seleccione **Autorización**.

1. Copie el valor detallado de la URL de autorización de la API de Atlassian de la parte inferior de la página y péguelo en el editor de texto que prefiera.

   El formato de URL es el siguiente:

   ```
   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. Para `state=YOUR_USER_BOUND_VALUE`, cambie el valor del parámetro por el que prefiera, como state="**sample\$1text**".

   Para obtener más información, consulte [¿Para qué se utiliza el parámetro de estado?](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-) en el sitio web para desarrolladores de Atlassian.

1. Tenga en cuenta que en la sección `scope` se enumeran los ámbitos detallados que seleccionó en una tarea anterior. Por ejemplo: `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access` indica que desea generar un `refresh_token`.

1. Abra una ventana del navegador Web e introduzca la URL de autorización que haya copiado en la barra de direcciones de la ventana del navegador.

1. Cuando se abra la página de destino, compruebe que la información es correcta y, a continuación, seleccione **Aceptar** para que lo redirijan a su página de inicio de Jira o Confluence.

1. Una vez que se haya cargado la página de inicio, copia la URL de esta página. Contiene el código de autorización de su aplicación. Utilice este código para generar su token de acceso. La sección completa siguiente a `code=` es el código de autorización.

1. Utilice el siguiente comando cURL para generar el token de acceso. Sustituya *placeholder values* por su propia información.
**sugerencia**  
También puede usar un servicio de terceros, como 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 respuesta a este comando incluye los valores de `access_code` y `refresh_token`.