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

# Jira

> Conecta Jira Cloud a Iru Compliance con OAuth para recopilar evidencia de proyectos, incidencias, flujos de trabajo, tickets de cambios y solicitudes de Jira Service Management para auditorías.

### Acerca de Jira

La fuente de **Jira** extrae la **configuración de proyectos**, los **metadatos de incidencias**, las **definiciones de flujos de trabajo**, la **información de usuarios y responsables** y los datos de solicitudes de **Jira Service Management** de **Jira Cloud** a Iru Compliance, donde se convierten en evidencia que puedes vincular a acciones y controles. Iru se conecta mediante el flujo de código de autorización **OAuth 2.0 de tres vías (3LO) de Atlassian**. La integración es de **solo lectura**: Iru no crea ni modifica incidencias, proyectos ni la configuración del espacio de trabajo.

Este conector es solo para **Jira Cloud**. **Jira Data Center** (autoalojado) usa un modelo de autenticación diferente y **no** es compatible con esta fuente.

### Cómo funciona

Después de proporcionar tu **Cloud ID**, el asistente del conector te envía a Atlassian para iniciar sesión y dar tu consentimiento. Iru recibe un **token de acceso** de corta duración y un **token de actualización rotativo**, y renueva los tokens automáticamente en los ciclos de sincronización.

| Ámbito | Qué permite |
| - | - |
| `read:jira-work` | Leer incidencias, proyectos, flujos de trabajo y archivos adjuntos |
| `read:jira-user` | Leer perfiles de usuario e información de responsables |
| `read:jira-service-desk` | Leer solicitudes y métricas de SLA de Jira Service Management |

| Detalle | Valor |
| - | - |
| **Categoría** | Gestión de proyectos |
| **Autenticación** | OAuth 2.0 (Jira Cloud 3LO) |
| **Plan del proveedor** | Plan **de pago** de Jira Cloud (el nivel **Free** no admite el acceso a la API mediante OAuth que necesita este conector) |

Centro de documentación: [Atlassian Support - Jira](https://support.atlassian.com/jira/). OAuth: [Jira Cloud OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/), [Ámbitos de OAuth 2.0](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/). Cloud ID: [Recuperar tu Atlassian Cloud ID](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/).

### Requisitos previos

* Un sitio de Jira Cloud **de pago** (**Free** no admite el acceso a la API mediante OAuth que se requiere aquí).
* Tu **Jira Cloud ID** (UUID). Consulta **Buscar tu Jira Cloud ID** más abajo.
* **Ventanas emergentes** del navegador permitidas para tu dominio de **Iru** para que se pueda abrir el paso de OAuth.
* El usuario que inicia sesión **no** tiene que ser administrador de Jira, pero Iru solo puede leer los datos a los que ese usuario tiene acceso. Para una recopilación amplia de evidencia, usa una cuenta con al menos:
  * **Browse projects** en cada proyecto que quieras que Iru lea.
  * **Browse users and groups** (permiso global) si necesitas metadatos de usuarios y responsables.

Una **cuenta de servicio dedicada** con acceso de lectura a los proyectos adecuados suele ser la forma más sencilla de mantener estable el alcance.

### Conectar Jira a Iru

<Tabs>
  <Tab title="Jira">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    #### Buscar tu Jira Cloud ID

    Tu **Cloud ID** es el UUID que Iru usa con `https://api.atlassian.com/ex/jira/{cloudId}`.

    <Steps>
      <Step title="Confirma Jira Cloud y el acceso de pago">
        Este conector admite **Jira Cloud** con un plan **de pago** que permita el acceso a la API mediante OAuth que necesita Iru. Confirma que no estás en un sitio **Free** que bloquee la integración.
      </Step>

      <Step title="Abre tu sitio de Jira">
        En un navegador, abre la URL de Jira Cloud (por ejemplo, `https://yoursite.atlassian.net`) para conocer el **subdominio** que sustituirás en los pasos siguientes.
      </Step>

      <Step title="Elige cómo buscarás el Cloud ID">
        Usa la **opción A** para una búsqueda rápida en JSON, o la **opción B** si ya trabajas en **Atlassian Admin**.
      </Step>

      <Step title="Opción A: información del tenant (la más rápida)">
        En una pestaña nueva del navegador, abre (sustituye `yoursite` por tu subdominio de Jira):

        `https://yoursite.atlassian.net/_edge/tenant_info`

        En la respuesta JSON, copia el valor de **`cloudId`**.
      </Step>

      <Step title="Opción B: Atlassian Admin">
        Inicia sesión en [admin.atlassian.com](https://admin.atlassian.com), selecciona tu organización y busca el Cloud ID en la URL del navegador (aparece después de `/s/`).
      </Step>

      <Step title="Guarda el Cloud ID para Iru">
        Guarda el UUID en un lugar seguro hasta que lo pegues en el campo **cloudId** del asistente del conector de Iru en la pestaña [**Iru Compliance**](#iru-compliance).
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**Jira**](#jira) para tener tu **Cloud ID** para el asistente del conector.
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa Jira">
        Busca **Jira** (establece **Categoría** en **Project management** o usa **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Se abre una pestaña del navegador con el asistente del conector.
      </Step>

      <Step title="Paso 1 de 2: configura las variables del servidor">
        Introduce tu **Cloud ID** en el campo **cloudId** y, a continuación, selecciona **Configure Server Variables**. Espera la confirmación de que las variables del servidor se actualizaron correctamente antes de continuar.
      </Step>

      <Step title="Paso 2 de 2: OAuth">
        Selecciona **Launch OAuth Authentication**. Cuando se abra la ventana emergente de Atlassian, inicia sesión y selecciona **Accept** para conceder los permisos solicitados.
      </Step>

      <Step title="Finaliza la conexión">
        Cuando se cierra la ventana emergente, Iru completa el intercambio de OAuth. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Jira** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru y vuelve a intentar **Launch OAuth Authentication**.
  </Accordion>

  <Accordion title="Failed to update server variables">
    Es posible que el enlace del asistente haya caducado. Desactiva y vuelve a activar **Jira** en **Fuentes** y, a continuación, introduce de nuevo tu **Cloud ID**.
  </Accordion>

  <Accordion title="Faltan proyectos o incidencias">
    Es posible que la cuenta que completó OAuth no tenga **Browse projects** en algunos espacios. Ajusta los permisos de Jira o conecta con una **cuenta de servicio** que tenga la cobertura de lectura que necesitas.
  </Accordion>

  <Accordion title="Token caducado o solicitudes de reconexión">
    Jira Cloud usa un **token de actualización rotativo** con un período de validez de **90 días**. Si la conexión permanece inactiva más tiempo, vuelve a completar el flujo de OAuth desde la tarjeta de la fuente **Jira**.
  </Accordion>

  <Accordion title="Plan Free de Jira">
    El nivel **Free** no admite el acceso a la API mediante OAuth que requiere este conector. Usa un plan **de pago** de Jira Cloud para conectar.
  </Accordion>

  <Accordion title="Sitio o Cloud ID incorrectos">
    Confirma que el **Cloud ID** coincida con el sitio que quieres usar (consulta **Buscar tu Jira Cloud ID**). Si no coinciden, Iru apunta al tenant incorrecto.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Tokens de actualización y conexiones inactivas" icon="circle-info">
    Iru actualiza los tokens de acceso en los ciclos de sincronización. Si la sincronización no se ejecuta durante **90 días**, prepárate para **volver a autenticarte** desde la tarjeta de la fuente.
  </Card>

  <Card title="Proyectos grandes y retención" icon="shield">
    Los proyectos grandes generan historiales extensos. Limita el alcance de los proyectos cuando puedas y alinea las políticas de **retención** y **privacidad** antes de basarte en la evidencia de flujos de trabajo en las auditorías.
  </Card>
</CardGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>