Autenticación de Jira

Antes de utilizar actividades o desencadenadores de Jira, debes crear una conexión a tu instancia de Jira Cloud en UiPath Integration Service.

Importante:

El conector de Jira solo admite instancias de Jira Cloud. Las instancias de Jira Server y Data Center no son compatibles.

Métodos de autenticación compatibles (solo Jira Cloud)

Tipo de Autenticación	Descripción	Mejor para
Token de API (básico sobre HTTPS)	Utiliza el correo electrónico de Atlassian Cloud y el token de API	Cuentas de servicio, automatizaciones unattended.
OAuth 2.0	Utiliza el inicio de sesión y el consentimiento del usuario con ámbitos de Jira Cloud	Flujos delegados por el usuario, atendidos o personales.
Traiga su propia aplicación OAuth 2.0	Utiliza tu propia aplicación OAuth con la URL de devolución de llamada de UiPath.	Clientes que gestionan su propia aplicación y claves de Jira.

Token de API (básico sobre HTTPS)

Autentícate con Jira Cloud utilizando un correo electrónico de cuenta de Atlassian y un token de API, pasado como autenticación básica HTTPS. Más información .

La conexión se ejecuta con los mismos permisos de proyecto y emisión que el usuario de Jira configurado.

Campos obligatorios

Campo	Descripción
URL del sitio	La URL del sitio de Jira, por ejemplo https://your-domain.atlassian.net. Nota: Asegúrate de incluir 'https://' y no '/' al final de la URL.
Nombre de usuario	Correo electrónico de la cuenta de Atlassian utilizado para iniciar sesión en Jira Cloud
Token de API	Token de la API de Jira Cloud asociado a la cuenta

Cómo generar el token de API

1. Crea un token de API (sin ámbito) en la seguridad de la cuenta de Atlassian.​ Más información
2. Copia el token generado y guárdalo para su uso posterior.
3. En UiPath Integration Service, añade una conexión Jira y rellena:

• URL del sitio
• Nombre de usuario
• Token de API​​

Ciclo de vida del token

Por tu seguridad, los tokens no pueden durar más de un año y pueden revocarse y eliminarse desde la página de seguridad de la cuenta de Atlassian. Una vez eliminadas, todas las llamadas de Integration Service que utilicen ese token fallarán con 401 No autorizado hasta que se configure un nuevo token.​

Solución de problemas

• 401 No autorizado: compruebe el correo electrónico y el token, confirme que el token existe y se copió correctamente.​
• 403 Prohibido en algunas operaciones: confirma que el usuario de Jira tiene los permisos de proyecto necesarios para el proyecto de destino y el tipo de incidencia.​

Preguntas frecuentes

¿Puedo limitar un token de API a proyectos específicos?
No. Los tokens heredan todos los permisos del usuario; limita el acceso configurando los permisos de usuario/proyecto en Jira.​

¿Afecta CAPTCHA o SSO a las llamadas basadas en token?
Las reglas de CAPTCHA e inicio de sesión interactivo se aplican al nombre de usuario/contraseña, no a los tokens de API; SSO sigue rigiendo la cuenta, pero no bloquea el uso del token. Más información​.

¿Cómo debo rotar los tokens utilizados por UiPath?
Crea un nuevo token, actualiza la conexión de Jira en UiPath con el nuevo token, valida las automatizaciones y luego revoca el token antiguo.​

Traiga su propia aplicación OAuth 2.0

Este tipo de autenticación es similar al código de autorización OAuth 2.0, pero requiere que traigas tu propio ID de cliente y credenciales secretas de cliente.

Sigue las directrices de Jira para crear tu propia aplicación: OAuth 2.0 (3LO) apps. Puedes crear tu aplicación desde la consola de desarrollador de Jira. Al configurar tu propio OAuth2.0 Asegúrese de proporcionar la URL de redirección/devolución de llamada como: https://cloud.uipath.com/provisioning_/callback
Esto se recomienda cuando las automatizaciones deben ejecutarse en el contexto de un usuario final y obedecer tanto a los ámbitos de OAuth como a los permisos de proyecto de ese usuario.​

Campos obligatorios

Campo	Descripción
URL del sitio	URL del sitio de Jira, por ejemplo https://your-domain.atlassian.net. Cuando se te pida que concedas permisos a la aplicación UiPath para acceder a Jira, asegúrate de seleccionar la misma URL del sitio de Jira.
ID de cliente	Identificador de cliente para la aplicación Atlassian OAuth 2.0 (3LO).
Secreto de cliente	Secreto de la aplicación Atlassian OAuth 2.0 (3LO). Esto se almacenará en la base de datos de UiPath Integration Service.
URL de redireccionamiento	URL de devolución de llamada de UiPath, configurada exactamente en la aplicación Atlassian.
Nombre de usuario	Se utiliza en la página de inicio de sesión de Jira.
Contraseña	Se utiliza en la página de inicio de sesión de Jira.

Comprender los ámbitos de Jira

Los ámbitos definen el nivel de acceso que una aplicación puede solicitar para interactuar con un producto de Atlassian. Cuando se establece una conexión y el usuario autoriza la aplicación a través de la actividad de Jira (a través de la API), la aplicación OAuth recibe permiso para realizar las operaciones especificadas en nombre del usuario, sujeto a la configuración de permisos del usuario. Para obtener una lista completa de los ámbitos disponibles, consulta la documentación de los ámbitos de Jira .

La siguiente tabla enumera los ámbitos necesarios para crear conexiones:

Ámbito	Tipo	Descripción
Leer:jira-user	Obligatorio	Ver la información del usuario en Jira a la que el usuario tiene acceso, incluidos los nombres de usuario, las direcciones de correo electrónico y los avatares.
Leer:jira-work	Obligatorio	Leer datos de proyectos y incidencias de Jira, buscar incidencias y objetos asociados a incidencias como archivos adjuntos y registros de trabajo.
Escribir:jira-work	Obligatorio	Crea y edita incidencias en Jira, publica comentarios como usuario, crea registros de trabajo y elimina incidencias.
manage:jira-project	Obligatorio	Crear y editar la configuración del proyecto y crear nuevos objetos a nivel de proyecto (por ejemplo, versiones y componentes).
acceso_ sin conexión	Obligatorio	Actualizar el token de OAuth automáticamente
manage:jira-configuration	Opcional	Realizar acciones de administración de Jira (por ejemplo, crear proyectos y campos personalizados, ver flujos de trabajo y gestionar tipos de enlaces de incidencias).
manage:jira-data-provider	Opcional	Gestionar información de desarrollo y lanzamiento para terceros en Jira

Importante:

La aplicación debe tener todos los ámbitos que solicita tu conexión.

Cómo generar credenciales

1. Sigue la guía de la aplicación 3LO de Atlassian.
2. Configura la URL de devolución de llamada de UiPath Jira desde la página de autenticación de Integration Service Jira como URI de redirección.
3. Seleccione los ámbitos de Jira Cloud que necesita (por ejemplo, read:jira-work, write:jira-work, read:jira-user).
4. Copia el ID de cliente y el Secreto de cliente de la aplicación Atlassian en la configuración de conexión de UiPath Jira.

Ciclo de vida del token

Los tokens de acceso son de corta duración; UiPath utiliza tokens de actualización para obtener nuevos tokens de acceso hasta que el token de actualización caduque o se revoque.​

Revocar el consentimiento o eliminar la aplicación Atlassian OAuth invalida los tokens y requiere una nueva autorización de UiPath.​

Solución de problemas (OAuth)

• Desajuste de URI de redirección: asegúrate de que la URL de redirección configurada en Atlassian coincida exactamente con la URL de devolución de llamada de UiPath.​

• insufficient_scope o 403: añade cualquier ámbito de Jira que falte a la aplicación y asegúrate de que el usuario tenga los permisos de Jira necesarios.​

Preguntas frecuentes

¿Cuáles son los ámbitos mínimos para emitir CRUD?
Varía de un objeto a otro, pero normalmente read:jira-work y write:jira-work para incidencias/comentarios; agregue read:jira-user si se utiliza la búsqueda/asignación de usuarios.

¿Pueden los ámbitos restringir el acceso a proyectos específicos?
No. Los ámbitos son funcionales; el acceso a nivel de proyecto aún se rige por los permisos del usuario que autoriza en Jira.​

¿Por qué sigo recibiendo 403 después de un inicio de sesión OAuth exitoso?
Asegúrese de que read:jira-user se esté infiriendo en su aplicación privada.

Código de autorización OAuth 2.0

El método de código de autorización OAuth 2.0 en UiPath Integration Service es funcionalmente idéntico a Trae tu propia aplicación OAuth 2.0 (BYOA) en cómo se obtienen los tokens y cómo se realizan las actividades en Jira Cloud. La diferencia clave está en quién es el propietario de las credenciales de la aplicación OAuth:

• El código de autorización OAuth 2.0 utiliza la propia aplicación OAuth 2.0 pública registrada de UiPath para Jira Cloud con ámbitos preconfigurados limitados.
  • Esto significa que el ID de cliente y el Secreto de cliente son gestionados por UiPath y no son necesarios para el usuario.
  • Solo tiene que proporcionar la URL de su sitio de Jira y seleccionar los ámbitos deseados durante la configuración de la conexión.
  • El resto de la experiencia de autenticación, incluido el inicio de sesión del usuario, el consentimiento y la gestión de tokens, es la misma que para una aplicación personalizada.
• BYOA (Bring Your Own OAuth) permite a las organizaciones registrar y gestionar su propia aplicación OAuth 2.0 con Atlassian.
  • El usuario o administrador debe proporcionar el ID de cliente de la aplicación personalizada, el Secreto de cliente y configurar la URL de devolución de llamada en consecuencia.​
  • Utiliza BYOA si necesitas una aplicación privada para tu organización, quieres gestionar tus propias claves o necesitas aplicar el control en la configuración del cliente OAuth.​

No hay diferencia en los ámbitos necesarios, el flujo de consentimiento o las capacidades disponibles; ambos utilizan el OAuth de 3 vías de Atlassian para adquirir tokens de acceso otorgados por el usuario para Jira Cloud. La única diferencia es si utilizas la integración pública de UiPath (no se necesitan credenciales de cliente) o tu propia aplicación Atlassian OAuth (se requieren credenciales en la configuración).