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

# Arnica

> Conecta Arnica a Iru Compliance con una clave de API de solo lectura con alcance limitado para recopilar hallazgos de detección de secretos, el inventario de repositorios, el riesgo de los desarrolladores y el estado de las políticas de seguridad.

### Acerca de Arnica

Iru lee datos de **hallazgos**, **inventario de repositorios**, **políticas de seguridad** y **riesgo de los desarrolladores** desde la API REST de Arnica mediante una clave de API **Bearer** creada en la plataforma web de Arnica en **Administrador** → **API**. Las claves están **vinculadas a alcances** desde su creación. Concede solo los alcances de **lectura** que requieran tus controles y evita por completo los alcances de escritura.

### Cómo funciona

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

La API de Arnica se sirve desde `https://api.app.arnica.io` en la versión **v1**. Las claves se crean por alcance en el panel de Arnica, por lo que una clave a la que le falta un alcance devuelve un error en lugar de un resultado parcial. Arnica devuelve **`403`**, no `401`, para todos los fallos de autenticación y autorización. Una clave no válida, una clave revocada y una clave a la que le falta un alcance obligatorio se ven igual. Iru solo almacena la clave de API; no hay ningún host ni subdominio que configurar.

| Detalle | Valor |
| - | - |
| **Categoría** | Seguridad |
| **Autenticación** | Bearer (clave de API con alcance) |

Referencias oficiales: [Documentación de Arnica](https://docs.arnica.io/), [Referencia de la API (Swagger)](https://api.app.arnica.io/swagger).

### Requisitos previos

* Acceso de **administrador de Arnica**. Solo los administradores pueden abrir **Administrador** → **API** para crear una clave.
* Decide qué repositorios están dentro del alcance. Arnica te permite excluir repositorios, y los repositorios excluidos no generan evidencia. Iru no puede distinguir si un repositorio no tiene hallazgos o si nunca se ha analizado.

### Conectar Arnica a Iru

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

    <Steps>
      <Step title="Iniciar sesión en Arnica">
        Inicia sesión en Arnica en [https://app.arnica.io](https://app.arnica.io) con una cuenta que tenga el rol de **admin**.
      </Step>

      <Step title="Abrir Admin API">
        Ve a **Administrador** → **API**.
      </Step>

      <Step title="Crear una nueva clave de API">
        Selecciona **Create a New API Key**.
      </Step>

      <Step title="Asignar un nombre a la clave">
        Introduce un nombre como **Iru Compliance** para poder identificar esta clave más adelante.
      </Step>

      <Step title="Seleccionar alcances de solo lectura">
        Selecciona los alcances de **solo lectura** que cubran tu programa de cumplimiento: `risks:read`, `products:read`, `inventory:read`, `policies:read` y `status-checks:read`. Añade `groups:read` si tus controles cubren la pertenencia a grupos de desarrolladores. **No** concedas `risks:write` ni ningún otro alcance de escritura.
      </Step>

      <Step title="Crear y copiar el token">
        Selecciona **Crear** y, a continuación, copia el valor del token **una sola vez** mientras Arnica lo muestra. Guárdalo de forma segura hasta que lo pegues en Iru como token **Bearer**.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Termina primero la pestaña [**Arnica**](#arnica).
    </Note>

    <Steps>
      <Step title="Abrir 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="Activar Arnica">
        Busca **Arnica** (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="Pegar el token Bearer">
        Pega el token en el campo **Bearer**.
      </Step>

      <Step title="Finalizar la conexión">
        Selecciona **Enviar token de Bearer**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirmar que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos** y, a continuación, vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Arnica** 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="La conexión falla con un error 403">
    Arnica devuelve `403` en lugar de `401` para los fallos de autenticación, por lo que esto abarca una clave no válida, caducada o revocada, así como un alcance que falta. Vuelve a generar la clave, confirma que pegaste la cadena completa y vuelve a comprobar la lista de alcances.
  </Accordion>

  <Accordion title="Faltan hallazgos de algunos repositorios">
    O bien a la clave le falta `risks:read` o `inventory:read`, o bien esos repositorios están **excluidos** en Arnica. Los repositorios excluidos no son visibles para Iru.
  </Accordion>

  <Accordion title="La tarjeta está activa, pero no ha aparecido ningún artefacto">
    Arnica se consulta según una programación y no bajo demanda. Espera a que se complete un ciclo de recopilación completo antes de investigar.
  </Accordion>
</AccordionGroup>

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