> ## 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.

# Trello

> Conecta Trello a Iru Compliance con una API key de Power-Up y un token de usuario para obtener acceso de solo lectura a evidencia de tableros, listas, tarjetas y membresía de espacios de trabajo.

### Acerca de Trello

La REST API de Trello espera **`key`** (el ID de la aplicación desde **Power-Ups admin**) y **`token`** (autorizado por el usuario) en las solicitudes (por ejemplo, **`GET /1/members/me/boards?key=…&token=…`**). La **key** se puede compartir; el **token** es secreto y limita el acceso a lo que puede ver el usuario que lo autoriza.

### Cómo funciona

Iru se autentica en la REST API de Trello con tu **API key de Power-Up** y un **token de usuario**, que se pasan como parámetros de consulta **`key`** y **`token`** en cada solicitud (por ejemplo, **`GET https://api.trello.com/1/members/me/boards?key=…&token=…`**).

| Detalle | Valor |
| - | - |
| **Categoría** | Gestión de proyectos |
| **Autenticación** | API key + token (parámetros de consulta) |

Crea o abre un **Power-Up** en **`https://trello.com/power-ups/admin`**, abre la pestaña **API key**, **genera** una clave y luego visita la URL de **autorización** de Trello con **`scope=read`** y tu clave para emitir un **token**.

Referencias oficiales: [Authorization](https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/), [API introduction](https://developer.atlassian.com/cloud/trello/guides/rest-api/api-introduction/), [Power-Up admin](https://trello.com/power-ups/admin).

### Requisitos previos

* Usuario de Trello que pueda acceder a los **tableros** y **espacios de trabajo** que necesitas para las auditorías.

### Conectar Trello a Iru

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

    <Steps>
      <Step title="Inicia sesión en Trello">
        Abre [Trello](https://trello.com) e inicia sesión con un usuario que pueda acceder a los **tableros** y **espacios de trabajo** que debe leer Iru.
      </Step>

      <Step title="Abre la administración de Power-Ups">
        Ve a **`https://trello.com/power-ups/admin`** (administración de Power-Ups de Trello) para tu cuenta.
      </Step>

      <Step title="Crea o selecciona un Power-Up">
        Crea un nuevo Power-Up (o abre uno existente) que usarás solo para emitir credenciales de API para Iru. Asígnale un nombre claro (por ejemplo, **Iru Compliance**).
      </Step>

      <Step title="Genera una API key">
        Abre la pestaña **API key** de ese Power-Up y **genera** una **clave** de API (`key`). Copia el valor de la clave; la introducirás en Iru como el parámetro **`key`**.
      </Step>

      <Step title="Autoriza un token de solo lectura">
        Abre la URL de **autorización** de Trello documentada para Power-Ups, incluidos **`expiration`**, **`scope=read`**, **`response_type=token`** y **`key=YOUR_API_KEY`**. Aprueba el acceso cuando Trello te lo solicite.
      </Step>

      <Step title="Copia el token de usuario">
        Después de seleccionar **Permitir**, Trello devuelve una cadena de **token**. Cópiala de inmediato; la combinarás con **`key`** en Iru.
      </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 [**Trello**](#trello).
    </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 Trello">
        Busca **Trello** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introduce la API key y el token">
        Proporciona **`key`** y **`token`** como lo indique el asistente (en una sola pantalla o en campos separados).
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar clave de API**. 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 **Trello** 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 e inténtalo de nuevo.
  </Accordion>

  <Accordion title="401">
    Vuelve a generar el token; confirma que la clave siga siendo válida.
  </Accordion>

  <Accordion title="429">
    Límites de frecuencia: los reintentos pueden distribuir la sincronización en el tiempo.
  </Accordion>

  <Accordion title="Faltan tableros">
    El usuario del token debe **unirse** a esos tableros o espacios de trabajo.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

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

  <Card title="Primeros pasos con 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="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>
