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

# Heroku

> Conecta Heroku a Iru Compliance con un token de Platform API para recopilar evidencia de configuración de aplicaciones, pipelines, complementos, acceso de equipos y dynos para auditorías.

### Acerca de Heroku

Iru lee la configuración de **aplicaciones** y **dynos**, los **pipelines**, los **complementos** y los metadatos de acceso de **equipos** mediante la **Heroku Platform API** usando un token **Bearer** (autorización de la CLI o clave de API de la cuenta).

### Cómo funciona

```http theme={null}
Authorization: Bearer YOUR_TOKEN
```

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas para desarrolladores |
| **Autenticación** | Token de Platform API (Bearer) |

Los tokens de Heroku **no** tienen un alcance detallado; heredan todo aquello a lo que puede acceder la cuenta que los genera. Es preferible una cuenta **dedicada** con una pertenencia mínima a equipos.

Referencias oficiales: [Autenticación](https://devcenter.heroku.com/articles/authentication), [Platform API](https://devcenter.heroku.com/articles/platform-api-reference), [CLI](https://devcenter.heroku.com/articles/heroku-cli).

### Requisitos previos

* Acceso a la **Heroku CLI** **o** a la sección **API Key** del panel.
* Ten en cuenta el **SSO**: los tokens pueden ajustarse a ventanas de sesión más cortas. Consulta la documentación de Heroku sobre **`--expires-in`**.

### Conectar Heroku a Iru

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

    <Steps>
      <Step title="Elige la CLI o el panel">
        La mayoría de los equipos usan la **Heroku CLI** para que el token tenga el alcance de una **autorización**. Si no puedes usar la CLI, sigue en su lugar la ruta de **API Key** del panel en los pasos siguientes.
      </Step>

      <Step title="Inicia sesión con la Heroku CLI">
        En una estación de trabajo de confianza, ejecuta **`heroku login`** (o **`heroku login -i`** para flujos de tipo CI) y completa la autenticación con una cuenta que pueda crear autorizaciones.
      </Step>

      <Step title="Crea un token de autorización">
        Ejecuta **`heroku authorizations:create --description "Iru Compliance"`**. La caducidad predeterminada suele ser de **un año**; las organizaciones con SSO pueden tener duraciones más cortas. Añade **`--expires-in`** cuando tu política requiera un TTL más corto.
      </Step>

      <Step title="Copia el valor de Token de la salida de la CLI">
        Copia la cadena **Token** de la salida del comando y guárdala en un almacén de secretos hasta que la pegues en Iru.
      </Step>

      <Step title="Alternativa en el panel: abre Account settings">
        En el [Heroku Dashboard](https://dashboard.heroku.com), selecciona tu **avatar** → **Account settings** (o **Cuenta**).
      </Step>

      <Step title="Alternativa en el panel: muestra o regenera la API Key">
        Abre la sección **API Key**. Usa **Reveal** para copiar la clave existente de toda la cuenta o **Regenerate** para emitir una nueva. **Regenerate** invalida la clave anterior en todas partes, así que actualiza todas las integraciones que usaban la clave anterior, no solo 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 [**Heroku**](#heroku).
    </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 Heroku">
        Busca **Heroku** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Pega el token de Platform API">
        Pega el token en el campo **Bearer**.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar token de Bearer**. 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 **Heroku** 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 Unauthorized">
    Usa el token completo; la sesión de SSO puede requerir una autorización nueva.
  </Accordion>

  <Accordion title="Token obsoleto después de regenerar">
    Regenerar desde el panel invalida los tokens anteriores. Actualiza Iru.
  </Accordion>

  <Accordion title="Faltan aplicaciones">
    La cuenta del token debe pertenecer a los **equipos** correctos.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Iru es de solo lectura: no realiza despliegues, escalados ni reinicios." icon="circle-info">
    Iru es de **solo lectura**; no realiza despliegues, escalados ni reinicios.
  </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>