Integración con Atlassian Jira Cloud - Amazon Quick
Antes de empezarConfigura la consola para desarrolladores de AtlassianConfigurar la integración en Amazon QuickAcciones disponiblesGestiona y soluciona problemas

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.

Integración con Atlassian Jira Cloud

Utilice el conector de acciones de Jira Cloud de Atlassian para crear, actualizar, buscar y gestionar problemas, proyectos, sprints y usuarios de Jira directamente en Amazon Quick mediante lenguaje natural.

La configuración de esta integración consta de dos pasos. En primer lugar, debes crear una aplicación OAuth 2.0 (3LO) en la consola para desarrolladores de Atlassian y configurar sus permisos. A continuación, creas la integración en Amazon Quick y la conectas a tu aplicación de Atlassian. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

Configura la consola para desarrolladores de Atlassian

Si tienes pensado utilizar la autenticación de usuario (3LO), crea una aplicación OAuth 2.0 en Atlassian Developer Console antes de configurar Amazon Quick. Complete todos los pasos siguientes antes de pasar a la consola Amazon Quick.

Si planea usar únicamente la autenticación de servicio (clave de API), puede omitir esta sección y continuar conConfigurar la integración en Amazon Quick.

Para obtener más información sobre las aplicaciones OAuth 2.0 (3LO), consulta las aplicaciones OAuth 2.0 (3LO) en la documentación para desarrolladores de Atlassian.

Crea una aplicación OAuth 2.0 (3LO)

Amazon Quick utiliza una aplicación Atlassian OAuth 2.0 (3LO) para autenticarse con tu producto de Atlassian Cloud en nombre de tus usuarios. Crea esta aplicación en la consola para desarrolladores de Atlassian antes de configurar Amazon Quick.

  1. Abre la consola de desarrolladores de Atlassian e inicia sesión con tu cuenta de Atlassian.

  2. Elige Crear y, a continuación, elige la integración 2.0. OAuth

  3. En Nombre, introduce un nombre descriptivo para la integración, por ejemployour-app-name connector.

  4. Revisa y acepta las condiciones para desarrolladores de Atlassian.

  5. Seleccione Crear.

Configuración de permisos

Tras crear la aplicación OAuth 2.0, añade los permisos de API que Amazon Quick necesita para interactuar con tu producto de Atlassian.

  1. Desde tu aplicación en la consola para desarrolladores de Atlassian, selecciona Permisos en el menú de navegación de la izquierda.

  2. Busca la API de tu producto de Atlassian (por ejemplo, la API de Jira o la API de Confluence) y selecciona Añadir. El botón cambia a Configurar después de añadir la API.

  3. Elija Configurar. La página de ámbitos se abre con las pestañas Ámbitos clásicos y Ámbitos granulares.

  4. En la pestaña Ámbitos clásicos, elija Editar ámbitos. Seleccione los ámbitos clásicos necesarios y pulse Guardar.

  5. Seleccione la pestaña Ámbitos granulares y, a continuación, seleccione Editar ámbitos. Seleccione los ámbitos granulares necesarios y elija Guardar.

Para conocer los ámbitos específicos necesarios para la integración, consulte la sección de ámbitos que aparece a continuación.

Configura los permisos de la API

Añade los siguientes ámbitos a tu aplicación OAuth 2.0 para la integración de las acciones de Jira Cloud.

Alcances clásicos

En la pestaña Ámbitos clásicos, elija Editar ámbitos y seleccione los siguientes ámbitos.

Integración de acciones con Jira: ámbitos clásicos
Alcance Description (Descripción)
read:jira-work Lee los datos de proyectos y emisiones de Jira, busca incidencias y objetos asociados a ellas, como archivos adjuntos y registros de trabajo.
manage:jira-project Crea y edita la configuración del proyecto y crea nuevos objetos a nivel de proyecto (por ejemplo, versiones y componentes).
manage:jira-configuration Realiza acciones de administración de Jira (por ejemplo, crea proyectos y campos personalizados, consulta los flujos de trabajo, gestiona los tipos de enlaces de emisión).
read:jira-user Consulta la información de usuario en Jira a la que el usuario tiene acceso, incluidos los nombres de usuario, las direcciones de correo electrónico y los avatares.
write:jira-work Crea y edita problemas en Jira, publica comentarios como usuario, crea registros de trabajo y elimina problemas.
manage:jira-webhook Busca, registra, actualiza y elimina los webhooks de Jira declarados de forma dinámica.

Ámbitos granulares

Seleccione la pestaña Ámbitos granulares y, a continuación, seleccione Editar ámbitos. Usa la barra de búsqueda para encontrar los ámbitos que aparecen a continuación. Por ejemplo, busca osciloscopios sprint:jira-software relacionados con los sprints.

Integración de acciones con Jira: alcances granulares
Alcance Description (Descripción)
read:board-scope:jira-software Lea las configuraciones de la placa.
read:sprint:jira-software Lee la información del sprint.
write:sprint:jira-software Crea y modifica sprints.
delete:sprint:jira-software Elimine los sprints.
write:board-scope:jira-software Gestione las configuraciones de la placa.
read:project:jira Lea los detalles del proyecto.

Configuración de la autorización

Configura la URL de devolución de llamada para que Atlassian pueda redirigir a los usuarios a Amazon Quick después de que autoricen la aplicación.

  1. Desde tu aplicación en la consola de desarrolladores de Atlassian, selecciona Autorización en el menú de navegación de la izquierda.

  2. Junto a OAuth 2.0 (3LO), selecciona Añadir.

  3. Para Callback URLs, ingresa. https://region.quicksight.aws.amazon.com/sn/oauthcallback regionSustitúyala por la AWS región en la que está desplegada la instancia de Amazon Quick, por ejemplous-east-1.

  4. Seleccione Save changes (Guardar cambios).

Registre sus credenciales

Antes de salir de la consola de desarrolladores de Atlassian, confirma que tienes los siguientes valores. Los necesitas para la configuración de Amazon Quick.

  1. Desde tu aplicación en la consola para desarrolladores de Atlassian, selecciona Configuración en el menú de navegación de la izquierda.

  2. En Detalles de autenticación, copia el ID de cliente y los valores secretos.

Credenciales requeridas de Atlassian Developer Console
Valor ¿Dónde encontrarlo
ID de cliente Página de configuración, en Detalles de autenticación
Secret Página de configuración, en Detalles de autenticación

Configurar la integración en Amazon Quick

Tras preparar las credenciales de autenticación, cree la integración en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Seleccione la pestaña Acciones.

  3. En Configurar una nueva integración de aplicaciones para Actions, busca Atlassian Jira Cloud y selecciona el botón Añadir (con el signo «+»).

  4. En el asistente de creación de integraciones, rellena los siguientes campos:

    • Nombre: nombre descriptivo de tu integración con Jira.

    • Descripción (opcional): notas sobre cómo se utilizará esta conexión.

    • Tipo de conexión: elija Red pública.

  5. En Configuración de autenticación, elija su método de autenticación y complete los campos obligatorios:

    1. Para la autenticación de usuarios, configure los siguientes campos:

      • URL base: la URL de tu instancia de Jira para las llamadas a la API. No es la misma URL en la que inician sesión los usuarios. Se parece a lo siguiente:https://api.atlassian.com/ex/jira/yourInstanceId. Para encontrar tu ID de instancia, navega hastahttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID de cliente: ID de cliente de la página de configuración de tu aplicación de Atlassian OAuth .

      • Secreto de cliente: secreto de la página de configuración de tu aplicación de OAuth Atlassian.

      • URL del token: https://auth.atlassian.com/oauth/token

      • URL de autorización: https://auth.atlassian.com/authorize

      • URL de redireccionamiento: este campo se rellena previamente con tu URL de devolución de llamada rápida de Amazon.

    2. Para la autenticación del servicio, configure los siguientes campos:

      • Clave de API: token de API de Jira.

      • URL base: la URL de tu instancia de Jira para las llamadas a la API.

      • Correo electrónico: correo electrónico de la cuenta de usuario asociada.

  6. Seleccione Crear y continuar.

  7. (Opcional) En la página de integración de Compartir, selecciona los usuarios con los que compartir la integración.

importante

Es posible que Jira Cloud devuelva respuestas correctas con el protocolo HTTP 200 incluso cuando los tokens de la API estén revocados o mal configurados. Para obtener más información, consulta JRACLOUD-82932. Si parece que la integración se ha conectado correctamente, pero las acciones fallan inesperadamente, compruebe que el token de API sea válido y que no se haya revocado.

Acciones disponibles

Tras configurar la integración, estarán disponibles las siguientes acciones.

Acciones disponibles de Jira Cloud
Action Description (Descripción)
Añadir adjunto Añadir un archivo adjunto a un número.
Añadir comentario Añadir un comentario nuevo.
Cambiar el estado del problema Cambiar el estado de la tarea de un problema.
Crear incidencia Crear una nueva incidencia o subtarea.
Crear proyecto Crea un nuevo proyecto.
Crea Sprint Crea un sprint en un proyecto.
Eliminar comentario Eliminar comentario.
Eliminar problema Eliminar un problema de un proyecto.
Eliminar proyecto Eliminar proyecto.
Eliminar Sprint Eliminar un sprint de un proyecto.
Editar problema Modificar el problema.
Encuentra usuarios Busca un usuario de Jira.
Obtenga todas las etiquetas Ver todas las etiquetas.
Obtenga todos los usuarios Haz una lista de todos los usuarios de Jira.
Obtenga el contenido de los archivos adjuntos Ver el contenido de un archivo adjunto.
Obtenga comentarios Ver los comentarios del problema.
Obtenga un problema Ver los detalles de un problema en un proyecto.
Obtenga los tipos de problemas para el proyecto Ver los tipos de problemas del proyecto.
Obtenga prioridades Vea las prioridades de los problemas.
Obtenga el proyecto Ver los detalles del proyecto.
Obtén Sprint Consulta los detalles de un sprint en un proyecto.
Mueva los problemas a Backlog Mueva los problemas a los pendientes.
Mueva los problemas a Sprint and Ranking Asigna una incidencia a un sprint.
Problemas de búsqueda Busca problemas.
Buscar proyectos Encuentra proyectos visibles.
Estados de búsqueda Buscar estados de problemas.
Actualizar comentario Editar comentario.
Actualizar proyecto Modificar el proyecto.
Actualiza Sprint Actualiza los detalles del sprint.
nota

Las acciones que puedes usar dependen de los permisos configurados en tu instancia de Jira Cloud y de tu método de autenticación.

Gestiona y soluciona problemas

Para editar, compartir o eliminar tu integración, consultaAdministrar las integraciones existentes.

Problemas de autenticación

  • Configuración de la aplicación incorrecta: verifica que la OAuth aplicación en la consola para desarrolladores de Atlassian incluya los ámbitos necesarios y que el URI de redireccionamiento coincida con tu configuración de Amazon Quick.

  • Token de API caducado o revocado: si utilizas la autenticación de servicio, comprueba que el token de API no haya caducado ni se haya revocado. Debido a un comportamiento conocido de Jira Cloud (JRACLOUD-82932), puede parecer que la integración se conecta correctamente incluso con tokens no válidos.

  • URL base incorrecta: la URL base para las llamadas a la API no es la misma que la URL de inicio de sesión de Jira Cloud. Compruebe que está utilizando el formato de URL de la API:https://api.atlassian.com/ex/jira/yourInstanceId. Para encontrar tu ID de instancia, navega hastahttps://your-domain.atlassian.net/_edge/tenant_info.

Mensajes de error comunes

  • Access denied. You do not have permission to perform this action— El usuario autenticado no tiene los permisos necesarios en Jira Cloud. Ponte en contacto con tu administrador de Jira Cloud para verificar y conceder los permisos adecuados.

  • OAuth 2.0 authorization failed— Comprueba que el ID de cliente, el secreto del cliente y los OAuth ámbitos estén configurados correctamente tanto en Atlassian Developer Console como en Amazon Quick.