Integración con Jira Cloud - Amazon Quick
Qué puede hacerAntes de empezarCrea un token de API de JiraConfigura la integración con JiraConfiguración de la autenticaciónAcciones disponiblesComparte integracionesAdministra las integraciones de Jira

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 Jira Cloud

Connect Amazon Quick a tu instancia de Jira Cloud para gestionar problemas, proyectos y otros objetos de Jira. Puedes crear, actualizar y consultar contenido de Jira sin salir de tu entorno de Amazon Quick. Esta integración requiere el nivel Amazon Quick Pro o superior.

Qué puede hacer

Con la integración con Jira Cloud, puedes realizar acciones en tus instancias de Jira a través de la API REST de Jira.

Conector de acciones

Crea, actualiza y consulta problemas, proyectos y otros objetos de Jira a través de la API REST de Jira.

nota

Esta integración solo admite la ejecución de acciones. No puedes usarla para crear bases de conocimiento ni acceder a los datos de Jira con fines de búsqueda.

Antes de empezar

Necesitas lo siguiente para configurar la integración con Jira:

  • Instancia de Jira Cloud con los permisos adecuados.

  • Credenciales de cuenta de usuario o token de API de Jira.

  • Amazon Quick Author o superior.

  • Acceso administrativo para configurar OAuth aplicaciones (para la autenticación de usuarios).

Crea un token de API de Jira

Para usar la autenticación con clave de API, crea un token de API en tu cuenta de Atlassian.

  1. Ve a la configuración de tu cuenta de Atlassian y selecciona Seguridad.

  2. Cree un nuevo token de API para la integración de Amazon Quick.

  3. Copia el token generado para usarlo en tu configuración de integración de Amazon Quick.

  4. Anota la URL de tu instancia de Jira Cloud y la dirección de correo electrónico del usuario. La URL de tu instancia de Jira Cloud es un valor especial para las llamadas a la API que puedes encontrar navegando hasta. https://your-domain.atlassian.net/_edge/tenant_info

importante

Jira Cloud puede devolver respuestas correctas de HTTP 200 incluso cuando los tokens de API estén revocados o mal configurados. Para obtener más información, consulta JARCLOUD-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 no se haya revocado.

Configura la integración con Jira

Sigue estos pasos para conectar Amazon Quick a tu instancia de Jira Cloud.

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Haz clic en Añadir (más el botón «+»).

  3. Complete los detalles de la integración:

    • Nombre: introduce un nombre descriptivo para tu integración con Jira.

    • Descripción (opcional): describe el propósito de esta integración.

  4. Elija el tipo de conexión (autenticación de usuario o servicio).

  5. Complete la configuración de conexión según el método de autenticación:

    • Para la autenticación de usuarios (OAuth):

      • URL base: la URL de tu instancia de Jira Cloud. Debe proporcionarse en el siguiente formato:https://api.atlassian.com/ex/jira/instanceid. instanceidPuede encontrarlo navegando ahttps://your-domain.atlassian.net/_edge/tenant_info.

      • ID de cliente: el ID de cliente de tu OAuth aplicación de Atlassian.

      • Secreto de cliente: el secreto de cliente de tu aplicación de Atlassian OAuth .

      • URL del token: punto final del token de Atlassian OAuth .

      • URL de autenticación: punto final de autorización de Atlassian OAuth .

      • URL de redireccionamiento: OAuth URI de redireccionamiento.

    • Para la autenticación del servicio (clave de API):

      • URL base: la URL de tu instancia de Jira Cloud.

      • Clave de API: tu token de API de Jira.

      • Correo electrónico: dirección de correo electrónico asociada a tu cuenta de usuario de Jira.

  6. Selecciona Crear y continuar.

  7. Seleccione los usuarios con los que compartir la integración.

  8. Haga clic en Next (Siguiente).

Configuración de la autenticación

La integración con Jira Cloud admite dos métodos de autenticación. Elige el método que mejor se adapte a tu organización.

Autenticación de usuario (OAuth)

OAuth Utilícela cuando desee que las acciones se realicen con identidades de usuario individuales. Configure estos campos:

  • URL base: la URL de tu instancia de Jira Cloud.

  • ID de cliente: el ID de cliente de tu OAuth aplicación de Atlassian.

  • Secreto de cliente: el secreto de cliente de tu aplicación de Atlassian OAuth .

  • URL del token: punto final del token de Atlassian OAuth .

  • URL de autenticación: punto final de autorización de Atlassian OAuth .

  • URL de redireccionamiento: OAuth URI de redireccionamiento.

OAuth Ámbitos necesarios:

  • read:jira-user- Leer la información del usuario.

  • read:jira-work- Lea problemas, proyectos y elementos de trabajo.

  • write:jira-work- Cree y modifique problemas y elementos de trabajo.

  • manage:jira-project- Administra la configuración del proyecto.

  • manage:jira-configuration- Administra la configuración de Jira.

  • manage:jira-webhook- Administra los webhooks.

  • read:sprint:jira-software- Lee la información del sprint.

  • write:sprint:jira-software- Crea y modifica sprints.

  • delete:sprint:jira-software- Eliminar sprints.

  • write:board-scope:jira-software- Administra las configuraciones de la placa.

Autenticación de servicios (clave API)

Utilice la autenticación por clave API para service-to-service las conexiones. Configure estos campos:

  • URL base: la URL de tu instancia de Jira Cloud.

  • Clave de API: tu token de API de Jira.

  • Correo electrónico: dirección de correo electrónico asociada a tu cuenta de usuario de Jira.

nota

Debido a un comportamiento conocido de Jira Cloud, puede parecer que la integración se conecta correctamente incluso con tokens de API revocados o no válidos. Si las acciones fallan inesperadamente tras la configuración, comprueba que tu token de API siga siendo válido en la configuración de tu cuenta de Atlassian.

Acciones disponibles

Tras crear tu integración con Jira, puedes usar estas acciones para interactuar con Jira Cloud:

  • Crea, lee, actualiza y elimina problemas de Jira.

  • Gestiona las transiciones de los problemas y los flujos de trabajo

  • Consulta los problemas con JQL (Jira Query Language).

  • Gestione proyectos, componentes y versiones.

  • Agregue comentarios y archivos adjuntos a los problemas.

  • Gestione las asignaciones de usuarios y los observadores.

  • Acceda a los metadatos del proyecto y de la emisión.

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.

Comparte integraciones

Puedes compartir tu conector de acciones de Jira con otros usuarios de tu organización.

  1. Tras crear la integración, selecciona Compartir la integración.

  2. Seleccione los usuarios o grupos con los que desee compartir la integración.

  3. Establezca los permisos adecuados para el acceso compartido.

  4. Confirma tu configuración de uso compartido.

Administra las integraciones de Jira

Puedes realizar estas tareas de administración para tus integraciones de Jira:

  • Editar la configuración de integración: actualiza la configuración de autenticación o la configuración de la instancia de Jira.

  • Comparte el acceso a la integración: haz que la integración esté disponible para otros usuarios de tu organización.

  • Supervise las métricas de uso: consulte la actividad de integración y las métricas de uso de la API.

  • Revisa las acciones disponibles: consulta la lista completa de acciones de Jira disponibles.

  • Eliminar la integración: elimina la integración y revoca la autenticación asociada.