> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA

> Configuración de la integración JIRA en Corgea

La integración JIRA de Corgea te permite crear automáticamente tickets JIRA para problemas de seguridad encontrados en tu base de código y dependencias. Esta integración agiliza el proceso de seguimiento y gestión de vulnerabilidades de seguridad dentro de tu flujo de trabajo JIRA existente.

## Requisitos previos

Antes de configurar la integración con JIRA, asegúrate de tener lo siguiente:

* Una cuenta JIRA con privilegios administrativos
* Tu URL de instancia de JIRA (por ejemplo, `https://mycompany.atlassian.net`)
* Un token de API de JIRA ([Cómo crear un token de API JIRA](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/))

## Configuración de la integración

<Steps>
  <Step title="Accede a la página de integraciones">
    Inicia sesión en tu cuenta de Corgea y navega a la página de "Integraciones".
  </Step>

  <Step title="Abre la integración de JIRA">
    Localiza la integración "JIRA" y haz clic en el botón "Añadir" o "Editar" para abrir la página de integraciones de JIRA.
  </Step>

  <Step title="Configurar integración">
    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-jira-integration.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9b9ee22cc1005576c9723ff40294e23d" alt="Crear integración con JIRA" width="1009" height="616" data-path="images/create-jira-integration.png" />

    Haz clic en "Añadir integración" e introduce los siguientes datos:

    * **Name**: Un nombre descriptivo para la integración (por ejemplo, "Mi instancia de JIRA")
    * **URL base**: Tu URL de instancia JIRA (por ejemplo, `https://mycompany.atlassian.net`)
    * **Nombre de usuario**: Tu nombre de usuario JIRA
    * **API Token**: Tu token de API JIRA
    * **Clave de Proyecto** (opcional): La clave predeterminada de JIRA para usar al crear incidencias
    * **Tipo de issue** (opcional): El tipo de issue predeterminado de JIRA para crear issues
  </Step>

  <Step title="Guardar configuración">
    Haz clic en "Guardar" para completar la configuración de la integración.
  </Step>
</Steps>

## Crear issues en JIRA

<Steps>
  <Step title="Navegar a Problemas">
    Navega a un problema de código o de dependencia en Corgea y abre la página de detalles del problema.
  </Step>

  <Step title="Accede a los detalles del issue">
    En la página de detalles del issue, selecciona el botón con el icono de ticket (tooltip: "Crear ticket").

    <img src="https://mintcdn.com/corgea/iadAV76rx_-M1qX0/images/pull_request.png?fit=max&auto=format&n=iadAV76rx_-M1qX0&q=85&s=c8286da5954cff2b319a709b40c635ca" alt="Botón de crear ticket" width="492" height="436" data-path="images/pull_request.png" />
  </Step>

  <Step title="Configurar el ticket">
    Si no has especificado valores por defecto para la clave del proyecto y el tipo de problema durante la configuración de la integración, tendrás que proporcionarlos aquí. Corgea recuperará automáticamente tus proyectos y los tipos de issues para que los selecciones.

    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-ticket.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9225ca9d574a1fbf4abe654aa545669d" alt="Crear Ticket" width="611" height="499" data-path="images/create-ticket.png" />
  </Step>

  <Step title="Crear Ticket">
    Haz clic en el botón "Crear ticket de JIRA". Corgea creará un nuevo issue de JIRA con los detalles pertinentes.
  </Step>

  <Step title="Confirmar creación">
    Recibirás un mensaje de confirmación con un enlace al ticket JIRA recién creado.
  </Step>
</Steps>

## Personalización de los detalles de los tickets de JIRA

De forma predeterminada, Corgea rellena el ticket de JIRA con la siguiente información:

* **Resumen**:
  * Hallazgos de código: clasificación y ubicación de los archivos
  * Problemas de dependencia: CVE, paquete afectado y versión afectada
  * Los resúmenes que superan el límite de longitud de Jira se acortan automáticamente
* **Descripción**:
  * Detalles de vulnerabilidades (ubicación/paquete, categoría, gravedad)
  * Explicación del problema
  * Solución propuesta (si está disponible)
  * Enlace a la página de detalles del hallazgo en Corgea

Si necesitas incluir campos adicionales o personalizar los detalles del ticket, puedes modificar el ticket de JIRA una vez creado en tu instancia de JIRA.

## Gestión de múltiples integraciones JIRA

Si tienes varias instancias o proyectos de JIRA, puedes configurar varias integraciones JIRA en Corgea. Al crear un ticket de JIRA, se te pedirá que selecciones la integración adecuada para usar.

Desde la página de integraciones de JIRA puedes editar una integración existente o eliminar una que ya no necesitas. Al editar una integración, deja el token de la API en blanco para conservar el token existente, o introduce un token nuevo para reemplazarlo.

Al integrar Corgea con JIRA, puedes agilizar tu proceso de gestión de vulnerabilidades de seguridad y asegurarte de que los problemas críticos se rastreen y aborden dentro de tu flujo de trabajo actual.