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

# Integración de directorio SCIM

> Configura la sincronización del directorio de usuarios basada en SCIM en Iru Endpoint. Aprovisiona y desaprovisiona automáticamente usuarios y grupos desde tu proveedor de identidad.

### Acerca de la integración de directorio SCIM

SCIM, o [System for Cross-domain Identity Management](https://scim.cloud/), es un protocolo diseñado para que la gestión de identidades de usuario en distintos sistemas sea más sencilla y eficiente. Es especialmente útil cuando usas varias aplicaciones basadas en la nube, ya que ayuda a automatizar el proceso de añadir y eliminar usuarios.

### Cómo funciona

SCIM implica dos roles principales:

* **Cliente**: suele ser un proveedor de identidad o un sistema de gestión de identidades y accesos, como Microsoft Entra ID u Okta, que gestiona los datos de identidad principales.
* **Proveedor de servicios**: una aplicación de software como servicio (SaaS), como Iru Endpoint, que usa los datos de identidad para gestionar el acceso y los permisos de los usuarios.

SCIM admite varias operaciones, como el aprovisionamiento, la sincronización y el desaprovisionamiento. Esta sincronización unidireccional te permite crear automáticamente cuentas de usuario en Iru Endpoint, mantener actualizados los atributos de los usuarios entre tu MDM y tu IdP, y eliminar o deshabilitar automáticamente las cuentas de usuario cuando ya no sean necesarias.

### Configurar SCIM en Iru Endpoint

Para configurar una integración SCIM entre tu proveedor de identidad (IdP) e Iru Endpoint, deberás:

* Crear una nueva integración de directorio SCIM en Iru Endpoint
* Obtener la URL de la API de SCIM y el token de API de Iru Endpoint para usarlos con tu IdP.
* Acceder a tu IdP para crear una integración de app, asignar atributos SCIM y enviar los grupos de usuarios deseados.

#### Crear una nueva integración de directorio SCIM

<Steps>
  <Step title="Abrir Integrations">
    En Iru Endpoint, en la barra lateral, selecciona el [**Botón del menú de la cuenta**](/es/iru/platform-overview/account-menu) y, a continuación, selecciona **Integraciones**.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Captura de pantalla del menú de la cuenta con la opción Integrations resaltada" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
    </Frame>
  </Step>

  <Step title="Explorar todas las integraciones">
    Selecciona **Explorar todas las integraciones** en la esquina superior derecha de la página Integrations.
  </Step>

  <Step title="Filtrar por integraciones de directorio">
    Marca el filtro **Directory integrations**.
  </Step>

  <Step title="Seleccionar SCIM protocol">
    Selecciona el mosaico **SCIM protocol**.

    <Frame>
      <img src="https://mintcdn.com/iru/mFx4MUIljla7jvxs/assets/media/images/iru-integrations-add-scim.png?fit=max&auto=format&n=mFx4MUIljla7jvxs&q=85&s=336ae459ab0810c8d899d6abecb96ad9" alt="Página de añadir nueva integración con el mosaico SCIM protocol" width="2126" height="1354" data-path="assets/media/images/iru-integrations-add-scim.png" />
    </Frame>
  </Step>

  <Step title="Iniciar la configuración">
    Selecciona **Comenzar**.
  </Step>

  <Step title="Asignar un nombre a la integración">
    Introduce un nombre único para la integración SCIM.
  </Step>

  <Step title="Generar el token de autenticación">
    Selecciona **Generar token**. La integración de directorio de usuarios SCIM usa un encabezado de autorización HTTP con un Bearer Token como método de autenticación.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-name.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cf4df5d3d63147de7739024f71f94bf8" alt="Pantalla de configuración de una integración de usuarios SCIM con el campo de nombre y el botón Generar token" width="1898" height="1258" data-path="assets/media/images/iru-scim-name.png" />
    </Frame>
  </Step>

  <Step title="Copiar el token">
    Selecciona **Copy token**.
  </Step>

  <Step title="Confirmar la copia del token">
    El token no volverá a ser visible después de seleccionar Done. Guárdalo de forma segura antes de continuar.
  </Step>

  <Step title="Completar la configuración">
    Confirma que has copiado el token marcando la casilla y, a continuación, selecciona **Listo**. Volverás a la página **Integraciones**.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c31e71ca70b13bd8db22047685ff47ae" alt="Cuadro de diálogo para copiar el token y configurarlo con tu proveedor de identidad con el botón Copy token" width="1912" height="1262" data-path="assets/media/images/iru-scim-copy-token.png" />
    </Frame>
  </Step>
</Steps>

#### Obtener la URL de la API de SCIM

La URL de la API de SCIM está disponible en los detalles de la integración en Iru Endpoint. Deberás proporcionar esta URL a tu proveedor de identidad al configurar la conexión SCIM.

<Steps>
  <Step title="Acceder a los detalles de la integración">
    Selecciona los **puntos suspensivos** de la integración de directorio SCIM que acabas de crear.
  </Step>

  <Step title="Ver detalles">
    Selecciona **View Details**.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-view-details.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=72a2ce0cf83d041f18caa066996ffd4f" alt="Lista de integraciones de directorio con la integración SCIM y el menú de puntos suspensivos con View details, Rename, Rotate token y Delete" width="876" height="492" data-path="assets/media/images/iru-scim-view-details.png" />
    </Frame>
  </Step>

  <Step title="Copiar la URL de la API">
    **Copia** la URL de la API de SCIM (p. ej., `https://subdomain.api.iru.com/api/v1/scim`). Tu proveedor de identidad la necesitará.

    <Note>Es posible que la URL que se muestra en tu tenant siga mostrando el dominio `api.kandji.io`. La versión `api.kandji.io` de la URL de la API de SCIM también funcionará para este fin.</Note>
  </Step>

  <Step title="Cerrar los detalles">
    Selecciona **Cerrar**.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-api-url.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f826bc146ef440fff34093ffeb0202d6" alt="Cuadro de diálogo de detalles de la integración de usuarios con la URL de la API de SCIM y el botón de copiar" width="1258" height="804" data-path="assets/media/images/iru-scim-copy-api-url.png" />
    </Frame>
  </Step>
</Steps>

### Cambiar el nombre de una integración SCIM

Para cambiar el nombre de una integración de directorio SCIM existente:

<Steps>
  <Step title="Abrir el menú de la integración">
    Selecciona los **puntos suspensivos** de la integración de directorio SCIM cuyo nombre quieres cambiar.
  </Step>

  <Step title="Elegir Rename">
    Selecciona **Rename**.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-rename.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=23ec71b5a32fe4f4c79dbc3b0fb3d573" alt="Menú de puntos suspensivos de la integración SCIM con la opción Rename" width="876" height="502" data-path="assets/media/images/iru-scim-rename.png" />
    </Frame>
  </Step>

  <Step title="Introducir el nuevo nombre">
    Introduce el nuevo nombre de la integración y guarda.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rename-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8bce3f3a702cc1044918b75de8937961" alt="Solicitud o cuadro de diálogo para cambiar el nombre de la integración SCIM con el campo de nombre" width="1270" height="674" data-path="assets/media/images/iru-scim-rename-prompt.png" />
    </Frame>
  </Step>
</Steps>

### Rotar el token SCIM

Rota el token de API de SCIM cuando necesites invalidar el token actual (por ejemplo, tras un problema de seguridad o al reconfigurarlo en tu IdP). Después de rotarlo, actualiza el nuevo token en tu proveedor de identidad.

<Steps>
  <Step title="Abrir el menú de la integración">
    Selecciona los **puntos suspensivos** de la integración de directorio SCIM.
  </Step>

  <Step title="Elegir Rotate token">
    Selecciona **Rotate token**.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f8f63aedfd798b4a2c0d08f6d96f5cbc" alt="Menú de puntos suspensivos de la integración SCIM con la opción Rotate token" width="1160" height="534" data-path="assets/media/images/iru-scim-rotate-token.png" />
    </Frame>
  </Step>

  <Step title="Confirmar la rotación">
    Confirma la rotación en la solicitud. El token anterior dejará de funcionar.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8a4ba4bc590415c8380c2a21848455ac" alt="Solicitud de confirmación de rotación del token de la integración SCIM" width="1106" height="674" data-path="assets/media/images/iru-scim-rotate-prompt.png" />
    </Frame>
  </Step>

  <Step title="Copiar el nuevo token">
    Copia el nuevo token y actualízalo en tu IdP.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-new-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=12bfb79182832a84389e2f1d57f67013" alt="Copiar el nuevo token SCIM después de la rotación" width="1098" height="1282" data-path="assets/media/images/iru-scim-copy-new-token.png" />
    </Frame>
  </Step>
</Steps>

### Eliminar una integración SCIM

Al eliminar una integración de directorio SCIM, se detiene la sincronización desde tu IdP y se elimina la integración de Iru Endpoint. Actualiza o elimina la app SCIM en tu IdP para evitar errores.

<Steps>
  <Step title="Abrir el menú de la integración">
    Selecciona los **puntos suspensivos** de la integración de directorio SCIM que quieres eliminar.
  </Step>

  <Step title="Elegir Delete integration">
    Selecciona **Delete integration**.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-delete-integration.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=f540e04a54a5ab4db9060b2aa9b6d599" alt="Menú de puntos suspensivos de la integración SCIM con la opción Delete integration" width="868" height="496" data-path="assets/media/images/iru-scim-delete-integration.png" />
    </Frame>
  </Step>

  <Step title="Confirmar la eliminación">
    Confirma en la solicitud que quieres eliminar la integración.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-delete-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=fd94a0d15d035bb5c9b6468ef97b0662" alt="Solicitud de confirmación de eliminación de la integración SCIM" width="1108" height="728" data-path="assets/media/images/iru-scim-delete-prompt.png" />
    </Frame>
  </Step>
</Steps>

### Esquema SCIM y atributos admitidos

Iru Endpoint admite los siguientes atributos SCIM. Consulta estos atributos al asignar tu aplicación SCIM en tu IdP.

<Note>
  Iru Endpoint no usa ningún atributo que no figure en la lista siguiente. Para limitar los atributos enviados, modifica los atributos configurados en la app SCIM de tu IdP.
</Note>

**Atributos de usuario**

| **Atributo** | **Descripción** | **Obligatorio** |
| - | - | - |
| userName | Identificador único del usuario, que se usa para autenticarse en el proveedor de servicios | Sí |
| name.formatted | El nombre completo del usuario (por ejemplo, "John Doe"). Se requiere este atributo o el atributo displayName | No |
| displayName | El nombre completo del usuario (por ejemplo, "John Doe"). Se requiere este atributo o el atributo name.formatted | Sí |
| title | El cargo del usuario, como "Vice President". | No |
| active | El estado del usuario en el proveedor de identidad. El proveedor de identidad añade este atributo automáticamente. | Sí |
| emails.value | La dirección de correo electrónico del usuario como subatributo de emails. Iru Endpoint solo almacena el primer correo electrónico de la lista. | Sí |
| department | Identifica el nombre de un departamento. | No |

Cuando el primer envío de un usuario establece `active` en `false`, Iru Endpoint crea ese usuario como suspendido.

**Atributos de grupo**

| **Atributo** | **Descripción** | **Obligatorio** |
| - | - | - |
| displayName | Un nombre legible para el grupo. | Sí |
| members | Una lista de los miembros del grupo. | Sí |

Al usar SCIM para sincronizar usuarios desde un directorio, la app SCIM envía automáticamente la información nueva a Iru Endpoint, por lo que no se necesita el botón Sync Now que verías al usar las integraciones de directorio nativas de Entra ID o Google Workspace. Cada IdP en la nube tiene su propio estándar para sincronizar los datos de SCIM.

Consulta la documentación de tu proveedor de identidad para saber cómo se configura la sincronización SCIM.

### Artículos relacionados

Configura SCIM en tu proveedor de identidad con el artículo correspondiente a tu IdP. La implementación de SCIM de Iru Endpoint sigue la especificación SCIMv2.

<CardGroup cols={3}>
  <Card title="Integración de directorio SCIM con Okta" icon="key" href="/es/endpoint/integrations/scim/scim-directory-integration-with-okta">
    Conecta Okta a Iru Endpoint para el aprovisionamiento automático de usuarios y grupos mediante SCIM
  </Card>

  <Card title="Integración de directorio SCIM con Microsoft Entra ID" icon="microsoft" iconType="brands" href="/es/endpoint/integrations/scim/scim-directory-integration-with-microsoft-entra-id">
    Conecta Microsoft Entra ID (antes Azure AD) a Iru Endpoint para el aprovisionamiento de usuarios y grupos basado en SCIM
  </Card>

  <Card title="Integración de directorio SCIM con OneLogin" icon="key" href="/es/endpoint/integrations/scim/scim-directory-integration-with-onelogin">
    Conecta OneLogin a Iru Endpoint para el aprovisionamiento automático de usuarios y grupos mediante SCIM
  </Card>
</CardGroup>
