Saltar a contenido

Conectar Jira REST con Zeta Test Management

La conexión actual con Jira utiliza la API REST de Jira. Configure y pruebe la conexión primero con una instancia no productiva o un proyecto de prueba previsto para ello. Coordine el alcance concreto de soporte para su versión de Jira y las operaciones necesarias antes del despliegue.

Requisitos y modelo de seguridad

  • Una dirección base accesible por HTTPS de la instancia Jira
  • Un proyecto Jira así como su clave de proyecto o ID de proyecto
  • Una cuenta técnica propia o un token de acceso personal con los derechos mínimos necesarios
  • Permisos para leer los metadatos necesarios y ejecutar las operaciones previstas
  • Un proyecto de prueba representativo para la aceptación de campos, estados, comentarios y archivos adjuntos

No guarde tokens reales en capturas de pantalla o documentación. Use marcadores de posición, limite la validez y los derechos, y establezca un proceso para el intercambio y la revocación.

Configurar Jira REST

  1. Abra en la configuración del proyecto la configuración de la base de datos de errores y seleccione Jira.
  2. Active la conexión e introduzca la dirección base HTTPS de su instancia de Jira, por ejemplo https://jira.example.org. El conector añade automáticamente la ruta REST /rest/api/2/.
  3. Introduzca la clave del proyecto Jira o la ID del proyecto requerida.
  4. En la configuración avanzada, seleccione el modo de autenticación adecuado y pruebe la conexión.

Jira Cloud: Básico con token API

Seleccione Basic, utilice como nombre de usuario la dirección de correo electrónico de la cuenta Atlassian y como contraseña un token API de Atlassian. Establezca Jira-IsCloudJira en true. Una contraseña normal de Atlassian no debe usarse en esta configuración.

Jira Data Center: Bearer con token de acceso personal

Seleccione Bearer e introduzca el token de acceso personal en el campo para el token de seguridad. El conector lo envía como token Bearer. Verifique si los tokens de acceso personal están autorizados en su versión de centro de datos y política de seguridad.

Encabezado HTTP personalizado

Seleccione CustomHeader si un gateway de seguridad previo o su entorno de destino requiere un encabezado propio. Introduzca el token en el campo de token de seguridad y configure, si es necesario, Jira-AuthHeaderName y Jira-AuthHeaderPrefix. Copie exactamente el nombre del encabezado y el prefijo de la configuración de destino autorizada.

Los nombres técnicos de configuración para modo y detección en la nube son Jira-AuthMode y Jira-IsCloudJira. Documente la variante elegida, pero nunca el valor secreto.

Autenticación y diagnóstico de errores

En caso de conexión fallida, verifique en este orden:

  1. ¿La dirección base es correcta, accesible por HTTPS y libre de una ruta REST adicional registrada?
  2. ¿Se ajusta Jira-AuthMode a los campos completados y a Jira Cloud o Data Center?
  3. ¿El token API o de acceso es válido, no ha expirado y no ha sido revocado?
  4. ¿Puede la cuenta leer el proyecto objetivo y sus metadatos, así como ejecutar las operaciones previstas?
  5. ¿Coinciden la clave del proyecto o la ID del proyecto, los tipos de incidencias, los campos obligatorios y los valores de estado?
  6. ¿Permiten el proxy, firewall, DNS y la confianza TLS la conexión?
  7. ¿Contienen los registros de Zeta Test Management y Jira un mensaje de estado o error útil?

No modifique varios parámetros simultáneamente. Documente el momento, la dirección de destino sin secretos, el modo de autenticación, el estado HTTP y la operación afectada. Reemplace inmediatamente los tokens comprometidos.

Asignar campos para nuevos issues de Jira

Asigne los datos registrados en Zeta Test Management a los campos del tipo de incidencia previsto en Jira. Verifique al menos resumen, descripción, tipo de incidencia, prioridad y todos los campos personalizados obligatorios en Jira. La configuración en la nube también puede influir en cómo se resuelven los valores de usuario.

Cargue listas de selección y metadatos de campos con la cuenta técnica prevista y, a continuación, cree un proceso de prueba. Verifique el resultado directamente en Jira. Utilice únicamente asignaciones de campos que el conector y la configuración de destino concreta admitan de forma comprobada; en particular, los comentarios, los archivos adjuntos y los campos personalizados deben ser aprobados por separado.