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, consulte[Métodos de autenticación](quick-action-auth.md).
## Antes de empezar
Asegúrese de disponer de lo siguiente antes de configurar la integración.
+ Atlassian Jira Cloud.
+ Accede a la [consola de desarrolladores de Atlassian](https://developer.atlassian.com/console/myapps/) para crear o gestionar una aplicación. OAuth
+ Para conocer los requisitos de suscripción, consulte. [Configurar las integraciones en la consola](integration-console-setup-process.md)
## 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 con[Configurar la integración en Amazon Quick](#jira-integration-setup).
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](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/) 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](https://developer.atlassian.com/console/myapps/) e inicia sesión con tu cuenta de Atlassian.
1. **Elige **Crear** y, a continuación, elige la integración 2.0. OAuth **
1. En **Nombre**, introduce un nombre descriptivo para la integración, por ejemplo`your-app-name connector`.
1. Revisa y acepta las condiciones para desarrolladores de Atlassian.
1. 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.
1. **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.
1. Elija **Configurar**. La página de ámbitos se abre con las pestañas **Ámbitos clásicos y Ámbitos** **granulares**.
1. **En la pestaña **Ámbitos clásicos, elija Editar ámbitos**.** **Seleccione los ámbitos clásicos necesarios y pulse Guardar.**
1. 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.
1. **Junto a **OAuth 2.0 (3LO), selecciona Añadir**.**
1. Para **Callback URLs, ingresa**. `https://region.quicksight.aws.amazon.com/sn/oauthcallback` *region*Sustitúyala por la AWS región en la que está desplegada la instancia de Amazon Quick, por ejemplo`us-east-1`.
1. 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.
1. 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.**
1. Seleccione la pestaña **Acciones**.
1. En **Configurar una nueva integración de aplicaciones para Actions**, busca **Atlassian Jira Cloud** y selecciona el botón Añadir (con el signo «\$1»).
1. 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**.
1. 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 hasta`https://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.
1. 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.
1. Seleccione **Crear y continuar**.
1. (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.](https://jira.atlassian.com/browse/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, consulta[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).
### 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](https://jira.atlassian.com/browse/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 hasta`https://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.