Table of Contents
¿Qué es este módulo?
El módulo Jira permite integrar Saturn Studio con la plataforma de gestión de proyectos Atlassian Jira, facilitando la automatización de tareas como creación, actualización, consulta o eliminación de incidencias.
Para poder utilizar los comandos del módulo, primero deberás configurar una credencial de Jira, la cual se compone de tres elementos esenciales:
Dominio, Usuario y API Token.
Cómo obtener las credenciales de Jira
1) Acceder al portal de Atlassian
Dirígete a:
🔗 https://id.atlassian.com/manage-profile/security/api-tokens
Este enlace te llevará directamente al panel de API Tokens de tu cuenta Atlassian, desde donde podrás crear y administrar tus claves personales.
2) Crear un nuevo token de API
En la sección API Tokens, haz clic en el botón:
🔹 Create API token
Aparecerá una ventana emergente solicitando un nombre descriptivo para el token, por ejemplo:
Saturn Studio Integration
Luego, presiona Create para generar el nuevo token.
3) Copiar el token generado
Una vez creado, Atlassian mostrará el nuevo API Token.
Haz clic en Copy to clipboard para copiarlo y guárdalo en un lugar seguro.
⚠️ Importante: Por razones de seguridad, no podrás volver a visualizarlo más adelante.
4) Obtener tu dominio y usuario
Antes de configurar la credencial en Saturn Studio, deberás identificar los siguientes datos:
| Dato | Descripción | Ejemplo |
|---|---|---|
| Dominio | Dirección de tu espacio de Jira Cloud (sin https:// ni www). | tuequipo.atlassian.net |
| Usuario | Correo electrónico asociado a tu cuenta de Atlassian. | usuario@empresa.com |
| API Token | Token generado desde el paso anterior. | ATATT3xFfExampleToken123 |
5) Configurar en Saturn Studio
Abre Saturn Studio → Módulo Jira → New Credential
Completa los campos de la siguiente manera:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Credential name | Nombre para identificar tu credencial. | Mi Jira Credential |
| Domain | Tu dominio de Jira Cloud (sin https:// ni www). | tuequipo.atlassian.net |
| Username | Tu correo de Atlassian. | usuario@empresa.com |
| API Token | El token generado en Atlassian. | ATATT3xFfExampleToken123 |
Luego, presiona Check para verificar la conexión.
Si la validación es exitosa, haz clic en Save credentials.
✅ ¡Listo! Tu credencial de Jira queda registrada y podrás usarla en todos los comandos del módulo.
Requisitos
- Tener una cuenta activa en Atlassian Jira Cloud.
- Permisos para crear y gestionar API Tokens.
- Acceso al dominio de tu organización (por ejemplo:
miempresa.atlassian.net).