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

# Semgrep

> Conecta Semgrep AppSec Platform a Iru Compliance con un token de API Bearer que incluya el alcance Web API para recopilar evidencia de hallazgos, implementaciones y políticas.

### Acerca de Semgrep

Iru llama a la **Web API** de Semgrep para obtener **hallazgos**, **proyectos** y **políticas**. Los tokens deben incluir el alcance **Web API**: los tokens solo de **Agent/CI** devuelven errores **404** en los endpoints web. Normalmente se requiere el nivel **Team** o **Enterprise** para el acceso a la API.

### Cómo funciona

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

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

Referencias oficiales: [Tokens](https://semgrep.dev/docs/deployment/tokens), [Web API scope](https://semgrep.dev/docs/kb/semgrep-appsec-platform/api-404-token-scope), [API reference](https://semgrep.dev/api/v1/docs/).

### Requisitos previos

* Rol **Administrador** u **Propietario** en la organización de Semgrep.

### Conectar Semgrep a Iru

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

    <Steps>
      <Step title="Inicia sesión en Semgrep">
        Abre **Semgrep AppSec Platform** e inicia sesión con un **Administrador** u **Propietario** de la organización que debe leer Iru.
      </Step>

      <Step title="Abre Settings">
        Selecciona **Configuración** (engranaje o menú de perfil, según la interfaz de Semgrep).
      </Step>

      <Step title="Abre Tokens">
        Navega a **Tokens** y luego a **Tokens de API** (el texto puede ser **API Tokens** o **Personal access tokens**).
      </Step>

      <Step title="Crea un token">
        Selecciona **Crear** (o **New token**). Introduce un nombre como **Iru Compliance**.
      </Step>

      <Step title="Habilita el alcance Web API">
        Habilita el alcance **Web API** (obligatorio para este conector). Elimina cualquier alcance de escritura que tu equipo de seguridad no quiera para un uso exclusivo de evidencia.
      </Step>

      <Step title="Guarda y copia el secreto">
        **Guarda** el token y luego copia el **secreto** una sola vez. Semgrep solo lo muestra al crearlo.
      </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 [**Semgrep**](#semgrep).
    </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 Semgrep">
        Busca **Semgrep** (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="Pega el token de API">
        Pega el token **Bearer** cuando se te solicite.
      </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 **Semgrep** 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="Error 404 en la API">
    Vuelve a crear el token con el alcance **Web API**.
  </Accordion>

  <Accordion title="No hay funciones de API">
    Actualiza a un nivel que incluya acceso a la API.
  </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>