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

# Notion

> Conecta Notion a Iru Compliance con un token de integración interna para recopilar evidencia del espacio de trabajo, las páginas, las bases de datos y el acceso de los miembros para las evaluaciones de controles.

### Acerca de Notion

El conector de **Notion** lee los **metadatos de páginas**, los **esquemas de bases de datos**, la **pertenencia al espacio de trabajo** y la configuración de las integraciones para que puedas asignar la evidencia de la base de conocimientos a los controles en Iru Compliance. La autenticación usa un **token de integración interna de Notion** (a veces llamado secreto de conexión) generado desde **[My integrations](https://www.notion.com/my-integrations)**.

### Cómo funciona

Notion espera el token en el encabezado **`Authorization`**:

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

Las integraciones internas solo acceden al contenido que **compartes** explícitamente con la integración. Planifica el uso compartido con cuidado; normalmente, asociando la integración a una **página principal** para que las páginas secundarias hereden el acceso.

| Detalle | Valor |
| - | - |
| **Categoría** | Productividad |
| **Autenticación** | Token Bearer (integración interna) |
| **Rol en el espacio de trabajo** | Solo los **propietarios del espacio de trabajo** pueden crear integraciones |

Documentación: [Crear integraciones](https://www.notion.com/help/create-integrations-with-the-notion-api), [Descripción general de la autorización](https://developers.notion.com/docs/authorization), [Referencia de la API](https://developers.notion.com/reference).

### Requisitos previos

* Derechos de **propietario del espacio de trabajo** (necesarios para crear integraciones).
* Una lista clara de las **páginas o bases de datos** que debe incluir la evidencia de cumplimiento.

### Conectar Notion a Iru

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

    <Steps>
      <Step title="Inicia sesión en Notion">
        Inicia sesión en [notion.so](https://www.notion.so) con un usuario que pueda crear **integraciones internas** para el espacio de trabajo que quieres que Iru lea.
      </Step>

      <Step title="Abre My integrations">
        Visita **[notion.com/my-integrations](https://www.notion.com/my-integrations)** o, en la aplicación de Notion, abre **Configuración** → **Connections** y sigue la ruta para crear (**Crear**) o administrar integraciones.
      </Step>

      <Step title="Configura la integración">
        Crea una integración nueva. Asígnale un nombre (por ejemplo, **Iru Compliance**), asígnala al **espacio de trabajo correcto** y habilita las capacidades que necesitan tus controles: como mínimo **Read content**, y **Read user information including email addresses** cuando importe la evidencia de pertenencia.
      </Step>

      <Step title="Guarda y copia el secreto de integración interna">
        **Guarda** la integración y, a continuación, copia el **internal integration secret**. Trátalo como una contraseña; no caduca a menos que rotes o elimines la integración.
      </Step>

      <Step title="Comparte contenido con la integración">
        Abre cada página o base de datos de nivel superior → **`⋯`** → **Connections** → elige **Iru Compliance**. Compartir una página principal reduce el trabajo duplicado para los documentos anidados.

        Sin elementos compartidos explícitamente, la integración no ve **nada**, aunque las personas puedan leer las páginas.
      </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 [**Notion**](#notion).
    </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 Notion">
        Busca **Notion** (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 secreto de integración">
        Pega el **secreto** de integración interna en el paso del token 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 **Notion** 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">
    Vuelve a copiar el secreto y asegúrate de que la integración no se haya eliminado ni rotado.
  </Accordion>

  <Accordion title="Faltan bases de datos">
    Vuelve a abrir cada página principal y confirma que **Connections** muestre tu integración.
  </Accordion>

  <Accordion title="La integración no aparece en el menú">
    Solo los propietarios del espacio de trabajo administran las integraciones: confirma que la creaste en el espacio de trabajo previsto.
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Rota los secretos según tu calendario y actualiza Iru…" icon="circle-info">
    Rota los secretos según tu calendario y actualiza Iru inmediatamente después.
  </Card>

  <Card title="Iru lee los metadatos expuestos al token: no…" icon="shield">
    Iru lee los metadatos expuestos al token; no edita páginas ni invitaciones de forma silenciosa.
  </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>
