Conexión de una canalización de Amazon OpenSearch Ingestion a Atlassian Jira o Confluence mediante OAuth 2.0 - Amazon OpenSearch Service

Conexión de una canalización de Amazon OpenSearch Ingestion a Atlassian Jira o Confluence mediante OAuth 2.0

Utilice 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 la autenticación de OAuth 2.0. Realice esta tarea cuando esté completando los Requisitos previos para el uso de una canalización de OpenSearch Ingestion con Atlassian Services, pero opte por no usar las credenciales de la clave de la API.

Crear una aplicación de integración de OAuth 2.0

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

Cómo crear una aplicación de integración de OAuth 2.0
  1. Inicie sesión en su cuenta de desarrollador de Atlassian en https://developer.atlassian.com/console/myapps/.

  2. Elija Crear, Integración de OAuth 2.0.

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

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

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

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

  7. 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”.

  8. 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.

  9. 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
  10. Seleccione Save.

Para obtener información relacionada, consulte Implementing OAuth 2.0 (3LO) y Determining the scopes required for an operation en el sitio web para desarrolladores de Atlassian.

Generación y actualización de un token de acceso para desarrolladores de Atlassian

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. Inicie sesión en su cuenta de desarrollador de Atlassian en https://developer.atlassian.com/console/myapps/.

  2. Seleccione la aplicación que ha creado en Crear una aplicación de integración de OAuth 2.0.

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

  4. 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
  5. Para state=YOUR_USER_BOUND_VALUE, cambie el valor del parámetro por el que prefiera, como state="sample_text".

    Para obtener más información, consulte ¿Para qué se utiliza el parámetro de estado? en el sitio web para desarrolladores de Atlassian.

  6. 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.

  7. 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.

  8. 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.

  9. 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.

  10. Utilice el siguiente comando cURL para generar el token de acceso. Reemplace los valores de marcador de posición con su 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.