> ## 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 con Microsoft Entra ID

> Configura la integración de directorio SCIM entre Microsoft Entra ID e Iru Endpoint. Aprovisiona y desaprovisiona automáticamente usuarios y grupos mediante SCIM.

### Acerca de la integración de directorio SCIM con Microsoft Entra ID

La integración de directorio SCIM con Microsoft Entra ID en Iru Endpoint te permite configurar la sincronización del directorio de usuarios basada en SCIM entre Microsoft Entra ID e Iru Endpoint, lo que habilita el aprovisionamiento y desaprovisionamiento automáticos de usuarios y grupos.

### Cómo funciona

La integración SCIM crea una conexión segura entre Microsoft Entra ID e Iru Endpoint, lo que permite la sincronización automática de los datos de usuarios y grupos. Cuando se añaden, modifican o eliminan usuarios o grupos en Microsoft Entra ID, estos cambios se reflejan automáticamente en Iru Endpoint mediante el protocolo SCIM.

### Requisitos previos

* Asegúrate de revisar los atributos de usuario y grupo admitidos que se indican en el artículo [Integración de directorio SCIM](/es/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes).
* Asegúrate de que no se incluyan grupos anidados con SCIM, ya que Microsoft no admite esta funcionalidad.

<Tabs>
  <Tab title="Iru Endpoint">
    ### Obtener el token SCIM y la URL de la API

    Completa primero estos pasos en Iru Endpoint. Necesitarás el token de acceso SCIM y la URL de la API al configurar Microsoft Entra ID. Para obtener todos los detalles, consulta el artículo [Integración de directorio SCIM](/es/endpoint/integrations/scim/scim-directory-integration).

    <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 SCIM usa un encabezado de autorización HTTP con un Bearer Token.

        <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**. El token no volverá a ser visible después de seleccionar Done. Guárdalo de forma segura, ya que lo necesitarás en la pestaña **Microsoft Entra ID**.
      </Step>

      <Step title="Confirmar y 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>

      <Step title="Acceder a los detalles de la integración">
        Selecciona los **puntos suspensivos** de la integración de directorio SCIM que creaste.
      </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á. 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.
      </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>

      <Step title="Cambiar a la pestaña Microsoft Entra ID">
        Ten a mano el token y la URL de la API y, a continuación, cambia a la pestaña **Microsoft Entra ID** para crear y configurar la integración de la app SCIM.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Microsoft Entra ID">
    <Note>
      Completa primero la pestaña **Iru Endpoint** para obtener el token SCIM y la URL de la API. Los introducirás en los pasos siguientes.
    </Note>

    ### Crear la integración SCIM en Microsoft Entra ID

    <Steps>
      <Step title="Abrir el centro de administración de Microsoft Entra">
        Inicia sesión en el [centro de administración de Microsoft Entra](https://entra.microsoft.com).
      </Step>

      <Step title="Ir a Entra ID">
        Abre el menú del portal y selecciona **Entra ID**.
      </Step>

      <Step title="Acceder a Enterprise apps">
        En el menú **Entra ID**, selecciona **Enterprise apps**.
      </Step>

      <Step title="Crear una nueva aplicación">
        Selecciona **New application**.

        <Note>
          Si ya has creado una aplicación de inicio de sesión único SAML, puedes seleccionar esa aplicación y añadir SCIM.
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-id-new-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c2cf9fdd7e1bb1642bde470e6b2cb9e1" alt="Enterprise applications de Microsoft Entra ID, All applications, con el botón New application" width="3584" height="2006" data-path="assets/media/images/iru-scim-entra-id-new-app.png" />
        </Frame>
      </Step>

      <Step title="Elegir el tipo de aplicación">
        Selecciona **Create your own application**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=e8ee8a2bc2755af20b6e3899cb060fbc" alt="Browse gallery de Microsoft Entra ID con Create your own application" width="3584" height="1538" data-path="assets/media/images/iru-scim-entra-create-own-app.png" />
        </Frame>
      </Step>

      <Step title="Asignar un nombre a la aplicación">
        Asigna un nombre a la aplicación.
      </Step>

      <Step title="Seleccionar el tipo de integración">
        Selecciona **Integrate any other application you don't find in the gallery (Non-gallery)**.
      </Step>

      <Step title="Crear la aplicación">
        Selecciona **Crear**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app-name-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cba41a5ec1b20278e90e2a50596f575e" alt="Cuadro de diálogo Create your own application de Microsoft Entra ID con el nombre de la app y la opción Non-gallery" width="1150" height="1202" data-path="assets/media/images/iru-scim-entra-create-own-app-name-settings.png" />
        </Frame>
      </Step>

      <Step title="Acceder a Provisioning">
        Se te llevará a la página Overview de la app recién creada.
        En **Gestionar**, selecciona **Provisioning**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=254b497e5495f90c98dd2aa3f8043f96" alt="Overview de Iru SCIM en Microsoft Entra ID con Provisioning en Manage" width="3274" height="1976" data-path="assets/media/images/iru-scim-entra-provisioning.png" />
        </Frame>
      </Step>

      <Step title="Crear una nueva configuración">
        Selecciona **New Configuration**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-new-config.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f467f0725c3ed827be07becb33457fba" alt="Provisioning Comenzar de Microsoft Entra ID con el botón New configuration" width="1884" height="1318" data-path="assets/media/images/iru-scim-entra-new-config.png" />
        </Frame>
      </Step>

      <Step title="Seleccionar el método de autenticación">
        En el menú desplegable **Select authentication method**, elige **Bearer authentication**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-configuration.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8e4dd75bab8d15c0867bda9f6737d821" alt="Nueva configuración de aprovisionamiento de Microsoft Entra ID con Bearer authentication, Tenant URL y Secret token" width="1886" height="1470" data-path="assets/media/images/iru-scim-entra-provisioning-configuration.png" />
        </Frame>
      </Step>

      <Step title="Configurar la conexión SCIM">
        Pega la URL de la API de SCIM que copiaste en la pestaña **Iru Endpoint** en el campo **Tenant URL**.
      </Step>

      <Step title="Añadir el token secreto">
        Pega el token que obtuviste en la pestaña **Iru Endpoint** en el campo **Secret token**.
      </Step>

      <Step title="Probar la conexión">
        Selecciona **Test connection**. Deberías ver una notificación de prueba correcta.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-test-success.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=20452fe2fa50403d81da1e52d8188c51" alt="Mensaje de prueba de conexión correcta en Provisioning de Microsoft Entra ID" width="684" height="128" data-path="assets/media/images/iru-scim-entra-provisioning-test-success.png" />
        </Frame>
      </Step>

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

      <Step title="Acceder a los ajustes de Provisioning">
        En la sección Manage, selecciona **Provisioning**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-mapping.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=7c8a14a6cc74dbcfc10cf82ce6af826e" alt="Overview de la configuración de Provisioning de Microsoft Entra ID" width="1864" height="1532" data-path="assets/media/images/iru-scim-entra-provisioning-mapping.png" />
        </Frame>
      </Step>

      <Step title="Configurar las asignaciones">
        Expande el triángulo desplegable **Mappings** y asegúrate de que tanto Groups como Users estén habilitados.
      </Step>

      <Step title="Configurar los ajustes">
        Expande el triángulo desplegable **Configuración**.
      </Step>

      <Step title="Establecer el ámbito">
        En **Scope**, elige **Sync only assigned users and groups**.
      </Step>

      <Step title="Habilitar el aprovisionamiento">
        Establece **Provisioning Status** en On.
      </Step>

      <Step title="Guardar la configuración">
        Selecciona **Guardar**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-mapping-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=0970d7108a416da6b5087fbf537785a2" alt="Mappings y Settings de Provisioning de Microsoft Entra ID con Scope y Provisioning Status" width="2034" height="1962" data-path="assets/media/images/iru-scim-mapping-settings.png" />
        </Frame>
      </Step>

      <Step title="Cerrar los ajustes">
        Selecciona la **X** de la esquina superior derecha para cerrar los ajustes.
      </Step>
    </Steps>

    ### Asignar usuarios y grupos

    <Steps>
      <Step title="Acceder a Users and groups">
        En **Gestionar**, selecciona **Users and groups**.
      </Step>

      <Step title="Añadir usuarios y grupos">
        En el menú, selecciona **Add user/group**.
      </Step>

      <Step title="Seleccionar usuarios y grupos">
        En el cuadro de diálogo **Add Assignment**, selecciona el enlace situado debajo de **Users and groups**.
      </Step>

      <Step title="Elegir de la lista">
        Se muestra una lista de usuarios y grupos de seguridad. Puedes buscar un usuario o grupo específico, o seleccionar varios usuarios y grupos que aparezcan en la lista.
      </Step>

      <Step title="Seleccionar las asignaciones">
        Selecciona los usuarios y grupos que quieres asignar.
      </Step>

      <Step title="Confirmar la selección">
        Selecciona **Seleccionar**.
      </Step>

      <Step title="Completar la asignación">
        Selecciona **Asignar** para terminar de asignar usuarios y grupos a la app.
      </Step>

      <Step title="Verificar la asignación">
        Confirma que los usuarios y grupos que añadiste aparecen en la lista **Users and groups**.
      </Step>
    </Steps>

    <Note>
      Si ves un mensaje que indica que se está usando un nivel gratuito, significa que solo puedes añadir usuarios (no grupos) a la Enterprise App de SCIM.
    </Note>

    ### Consideraciones

    <CardGroup cols={2}>
      <Card title="Sincronización" icon="arrows-rotate">
        La sincronización de usuarios es unidireccional. La app SCIM de Microsoft Entra ID envía información de usuarios a Iru Endpoint solo cuando se necesita información nueva. Si se añade un usuario o grupo a la app SCIM en Microsoft Entra ID después de crear la app, se produce una sincronización cada 40 minutos (establecido por Microsoft Entra ID). Para sincronizar antes, detén e inicia el aprovisionamiento en la app SCIM en Microsoft Entra ID. Esto no afecta a los usuarios ni grupos existentes en Iru Endpoint.
      </Card>

      <Card title="Eliminar usuarios" icon="user-minus">
        Si Entra ID establece un usuario como inactivo, el usuario se establece como inactivo en tu tenant de Iru Endpoint. Si Entra ID elimina un usuario, el usuario se elimina de tu tenant de Iru Endpoint.
      </Card>

      <Card title="Lógica condicional de Blueprints" icon="code-branch">
        Si usas lógica condicional del [Assignment Map](/es/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints) con grupos, debes añadir explícitamente a la app SCIM cada grupo que quieras aprovisionar en Iru Endpoint. Los grupos no se sincronizarán automáticamente al añadir usuarios que resulten ser miembros del grupo.
      </Card>

      <Card title="Asignación de certificados seguros de AD CS" icon="certificate">
        Si usas Microsoft Active Directory Certificate Services para la autenticación basada en certificados, asegúrate de que tus asignaciones de atributos SCIM admitan los requisitos de asignación de certificados seguros (strong certificate mapping). Para conocer las asignaciones y actualizaciones de certificados necesarias, consulta [Configuración de la asignación de certificados seguros de Active Directory](/es/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-strong-mapping-configuration).
      </Card>
    </CardGroup>

    #### Microsoft Device Compliance

    Si usas una integración de directorio de usuarios SCIM de Entra ID y la integración de Microsoft Device Compliance, asegúrate de que las asignaciones de atributos de usuario y grupo para el atributo **externalId** de tu aplicación SCIM se asignen a objectId, como se indica a continuación. Iru Endpoint usa el **objectId** para asignar los recursos de usuarios y grupos en Intune.

    <table>
      <thead>
        <tr>
          <th><strong>Atributo de usuario</strong></th>
          <th><strong>Valor de usuario</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    <table>
      <thead>
        <tr>
          <th><strong>Atributo de grupo</strong></th>
          <th><strong>Valor de grupo</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    **Actualizar las asignaciones de usuarios y grupos**

    <Steps>
      <Step title="Acceder a la aplicación SCIM">
        Ve a la aplicación empresarial SCIM en el [centro de administración de Microsoft Entra](https://entra.microsoft.com).
      </Step>

      <Step title="Abrir Provisioning">
        Selecciona **Provisioning**.
      </Step>

      <Step title="Acceder a la asignación de atributos">
        Selecciona la sección **Attribute mapping (Preview)**.
      </Step>

      <Step title="Elegir la asignación de usuarios o grupos">
        Si vas a actualizar atributos de usuario, selecciona **Provision Microsoft Entra ID Users.**
        Si vas a actualizar atributos de grupo, selecciona **Provision Microsoft Entra ID Groups**.
      </Step>

      <Step title="Verificar la asignación de External ID">
        Verifica que externalId esté asignado a objectId.
      </Step>

      <Step title="Actualizar la asignación si es necesario">
        Si no lo está, selecciona el botón **Editar** a la derecha del atributo y selecciona objectId en la lista.
      </Step>

      <Step title="Guardar los cambios">
        Selecciona **Guardar**.
      </Step>

      <Step title="Volver a Overview">
        Selecciona la **X** para volver.
      </Step>

      <Step title="Reiniciar el aprovisionamiento">
        Una vez de vuelta en la página de descripción general de Provisioning, si se cambió algún valor, debes enviar inmediatamente los valores actualizados a Iru Endpoint deteniendo y volviendo a iniciar el servicio de aprovisionamiento.
      </Step>

      <Step title="Pausar el aprovisionamiento">
        Selecciona el botón **Pause provisioning**.
      </Step>

      <Step title="Iniciar el aprovisionamiento">
        Selecciona el botón **Start provisioning**.
      </Step>
    </Steps>
  </Tab>
</Tabs>