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

# Contentful

> Conecta Contentful a Iru Compliance con un token de acceso personal de la Content Management API para recopilar espacios, modelos de contenido, entornos y la pertenencia a equipos.

### Acerca de Contentful

Iru lee **espacios**, **modelos de contenido**, **entornos** y **pertenencias** mediante la **Content Management API (CMA)** con un **Personal Access Token** (**PAT**) enviado como **`Authorization: Bearer`**. **No** uses tokens de vista previa de la **Content Delivery API (CDA)**: carecen de alcance de administración.

### Cómo funciona

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

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas para desarrolladores |
| **Autenticación** | Token de acceso personal de CMA |

Referencias oficiales: [Autenticación](https://www.contentful.com/developers/docs/references/authentication/), [Tokens de acceso personal](https://www.contentful.com/help/token-management/personal-access-tokens/), [Referencia de CMA](https://www.contentful.com/developers/docs/references/content-management-api/).

### Requisitos previos

* Un usuario de Contentful con acceso a los **espacios** que necesitas como evidencia.

### Conectar Contentful a Iru

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

    <Steps>
      <Step title="Iniciar sesión en Contentful">
        Abre la [aplicación web de Contentful](https://app.contentful.com) e inicia sesión con un usuario que pueda acceder a los **espacios** que Iru debe leer.
      </Step>

      <Step title="Abrir Settings">
        Selecciona **Configuración** (engranaje o configuración del espacio de trabajo, según tu interfaz) para la organización o el espacio al que pertenece el token.
      </Step>

      <Step title="Abrir los tokens de CMA">
        Elige **CMA tokens** (tokens de la Content Management API) o la pantalla equivalente **Personal access tokens**.
      </Step>

      <Step title="Crear un token de acceso personal">
        Selecciona **Create personal access token** (o **Generar token**). Introduce un nombre como **Iru Compliance**.
      </Step>

      <Step title="Establecer la caducidad opcional">
        Si Contentful ofrece **caducidad**, establece una fecha acorde con tu política de rotación de claves, o déjala sin establecer solo si tu equipo de seguridad permite tokens que no caducan.
      </Step>

      <Step title="Generar y copiar el token">
        Genera el token y copia el valor **una sola vez**. Guárdalo de forma segura; lo pegarás 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 [**Contentful**](#contentful).
    </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 Contentful">
        Busca **Contentful** (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 de acceso personal">
        Pega el PAT 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 **Contentful** 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 un PAT, no un token de CDA; pega la cadena exacta.
  </Accordion>

  <Accordion title="PAT caducado">
    Rótalo en **Configuración** → **CMA tokens** y actualiza Iru.
  </Accordion>

  <Accordion title="Faltan espacios">
    El PAT hereda la pertenencia del usuario: primero concede acceso al espacio.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Revoca de inmediato los tokens filtrados y vuelve a crearlos: PUT…" icon="circle-info">
    Revoca de inmediato los tokens filtrados y vuelve a crearlos; Contentful documenta el endpoint de revocación **PUT** para la automatización.
  </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>