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

# Segment

> Conecta Segment a Iru Compliance con un token de acceso de la Public API para recopilar evidencia de espacios de trabajo, fuentes, destinos y planes de seguimiento.

### Acerca de Segment

La **Segment Public API** respalda este conector. Iru lee metadatos de **configuración del espacio de trabajo**, **fuentes y destinos**, **planes de seguimiento** y **membresía**, lo suficiente para evidenciar cómo fluyen los datos de clientes a través de Segment. La integración es de **solo lectura** del lado de Iru; no envía eventos ni cambia la configuración del espacio de trabajo.

Solo los **Workspace Owners** pueden crear tokens de la Public API en Segment.

### Cómo funciona

Iru se autentica con un token **Bearer** (el **token de acceso de la Public API** de Segment):

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

| Detalle | Valor |
| - | - |
| **Categoría** | Analítica |
| **Autenticación** | Token Bearer (token de acceso de la Public API) |
| **Rol para crear el token** | Workspace Owner |

Referencias oficiales: [Segment Public API](https://segment.com/docs/api/public-api/), [API reference](https://docs.segmentapis.com/) y [Access Management](https://segment.com/docs/segment-app/iam/).

### Requisitos previos

* Rol **Workspace Owner** en el espacio de trabajo de Segment que necesitas para el cumplimiento.
* Unos minutos para crear el token y pegarlo en Iru.

### Conectar Segment a Iru

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

    <Steps>
      <Step title="Inicia sesión en Segment">
        Abre [Segment](https://segment.com) e inicia sesión con un usuario que pueda administrar los tokens del **espacio de trabajo**.
      </Step>

      <Step title="Abre Settings">
        Selecciona **Configuración** (engranaje) en el marco de la aplicación de Segment.
      </Step>

      <Step title="Abre Workspace Settings">
        Elige **Workspace Settings** para el espacio de trabajo que debe leer Iru.
      </Step>

      <Step title="Abre Access Management">
        Selecciona **Access Management** (o **Members & access**) y luego abre **Tokens**.
      </Step>

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

      <Step title="Elige un rol para el token">
        Elige un rol acorde con el principio de menor privilegio:

        * **Workspace Owner**: acceso amplio a la API; úsalo cuando necesites visibilidad completa del espacio de trabajo para auditorías.
        * **Workspace Member**: más restringido; puede omitir recursos que le interesan a tu programa.
      </Step>

      <Step title="Copia el token y guárdalo de forma segura">
        Crea el token y **cópialo de inmediato**. Segment lo muestra **una sola vez**. Trátalo como una contraseña hasta que lo pegues en **Iru Compliance**.

        Segment puede **revocar automáticamente** los tokens detectados en repositorios públicos; los propietarios reciben una notificación.
      </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 [**Segment**](#segment).
    </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 Segment">
        Busca **Segment** (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 la Public API">
        Cuando el asistente solicite el token, pega el **token de acceso de la Public API** y envíalo.
      </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 **Segment** 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">
    Copia el token exactamente; confirma que no se haya eliminado ni revocado automáticamente.
  </Accordion>

  <Accordion title="Faltan fuentes o destinos">
    Es preferible un token de **Workspace Owner** en lugar de un token limitado de Member.
  </Accordion>

  <Accordion title="Espacio de trabajo incorrecto">
    Los tokens tienen **alcance de espacio de trabajo**: crea el token en el espacio de trabajo que conectaste en Iru.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Los tokens no caducan de forma predeterminada: rótalos…" icon="circle-info">
    Los tokens no caducan de forma predeterminada: rótalos periódicamente y actualiza Iru después de la rotación.
  </Card>

  <Card title="Varios espacios de trabajo requieren conexiones de Iru independientes…" icon="shield">
    Varios espacios de trabajo requieren conexiones y tokens de Iru **independientes**.
  </Card>
</CardGroup>

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