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

# Inicio de sesión único con Microsoft Entra ID (nativo)

> Configura el SSO nativo de Microsoft Entra ID para Iru Endpoint mediante OAuth2 y OpenID Connect. Habilita el inicio de sesión con un clic para administradores con credenciales de Microsoft Entra ID.

### Acerca de la integración nativa de Microsoft Entra ID

La integración nativa de Microsoft Entra ID en Iru Endpoint te permite configurar una integración nativa de Microsoft Entra ID para SSO. Los usuarios se autentican con sus credenciales de Microsoft Entra ID mediante OAuth2/OpenID Connect.

#### Cómo funciona

Cuando los usuarios intentan acceder a Iru Endpoint, se les redirige a Microsoft Entra ID para autenticarse mediante los protocolos OAuth2/OpenID Connect. Tras una autenticación correcta, Microsoft Entra ID envía un token de acceso de vuelta a Iru Endpoint, que valida la identidad del usuario y le concede acceso. El SSO se puede usar para iniciar sesión en la [aplicación web de Iru Endpoint](/es/endpoint/getting-started/foundation/admins-and-access) y para [requerir autenticación con Automated Device Enrollment](/es/endpoint/enrollment/configure-require-authentication-for-enrollment).

<Note>
  Microsoft Entra ID [es el nuevo nombre](https://learn.microsoft.com/en-us/entra/fundamentals/new-name) de Azure AD (Azure Active Directory)
</Note>

> Como los client secrets tienen una vida útil máxima de 24 meses, te recomendamos configurar el [inicio de sesión único basado en SAML](/es/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-microsoft-entra-id-saml) en lugar de usar el método descrito en este documento.

### Requisitos previos

Antes de comenzar, asegúrate de tener:

* [Acceso a la aplicación web de Iru Endpoint](/es/endpoint/getting-started/foundation/admins-and-access) como Admin o Account Owner
* Una cuenta de administrador en Microsoft Entra ID con permisos para crear registros de aplicaciones (como Global Administrator, Application Administrator o Cloud Application Administrator)

<Tabs>
  <Tab title="Configuración de la aplicación web de Iru">
    ### Configurar la conexión de Iru Endpoint

    Sigue estos pasos para configurar la conexión en Iru:

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

      <Step title="Acceder a la configuración de autenticación">
        Selecciona la opción **Acceso** en el menú.

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

      <Step title="Seleccionar Administración y autenticación">
        Selecciona la pestaña **Administración y autenticación** (seleccionada de forma predeterminada) y desplázate hacia abajo hasta **Métodos de autenticación**.
      </Step>

      <Step title="Agregar un método de autenticación">
        Selecciona **+ Método de autenticación**.
      </Step>

      <Step title="Ingresar el nombre visible">
        Ingresa un nombre visible para la conexión SSO.
      </Step>

      <Step title="Seleccionar el método de autenticación">
        Selecciona **Microsoft Entra ID** como método de autenticación.
      </Step>

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

      <Step title="Copiar la Redirect URL">
        Copia la **Redirect URL** en un documento de texto para usarla más adelante. La necesitarás para la configuración de Microsoft Entra ID.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_10-54-56.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=944f34794f4d9a91d0b2c90e23c3889d" alt="Copia de la Redirect URL de Iru Endpoint para Entra ID" width="1924" height="1638" data-path="assets/media/images/entra_native_10-54-56.png" />
        </Frame>
      </Step>

      <Step title="Mantener la pestaña abierta">
        Mantén abierto el modal de configuración de la aplicación web de Iru y luego cambia a la pestaña **Configuración de Microsoft Entra ID** para continuar.
      </Step>
    </Steps>

    Sigue estos pasos para completar la configuración:

    <Info>
      Después de completar la configuración de Microsoft Entra ID, vuelve aquí para terminar de configurar la conexión SSO en Iru Endpoint. Necesitarás el Client ID y el Client secret que copiaste de Microsoft Entra ID.
    </Info>

    <Steps>
      <Step title="Ingresar el dominio del directorio">
        Ingresa el **Tenant ID** en el que se registró la aplicación en el campo **Microsoft Entra ID Domain**. Consulta la [documentación de Microsoft para encontrar tu Tenant ID](https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/find-tenant-id-domain).
      </Step>

      <Step title="Ingresar el Client ID">
        Ingresa el **Client ID** que copiaste anteriormente del Microsoft Entra admin center.
      </Step>

      <Step title="Ingresar el Client Secret">
        Ingresa el **Client Secret** que copiaste anteriormente del Microsoft Entra admin center.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_12-00-35.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=652ba4ba977cabe185b104cfd2913bbc" alt="Tenant ID, Client ID, Client Secret y Save en Iru Endpoint" width="1646" height="1640" data-path="assets/media/images/entra_native_12-00-35.png" />
        </Frame>
      </Step>

      <Step title="Autorizar la conexión">
        Después de guardar, aparecerá un nuevo cuadro de diálogo con un enlace para **autorizar tu conexión.** Un administrador de Microsoft Entra ID de tu dominio debe seleccionar el enlace y completar este proceso para autorizar la aplicación. Este cuadro no desaparecerá una vez completada la autorización.
      </Step>

      <Step title="Completar la autorización">
        En la nueva ventana que se abre, inicia sesión y selecciona **Accept**.
      </Step>

      <Step title="Verificar la autorización">
        Después de seleccionar **Accept,** se te llevará a una página de autorización correcta.
      </Step>

      <Step title="Confirmar la configuración">
        Tu conexión ya está configurada correctamente y puede habilitarse y probarse.
      </Step>
    </Steps>

    <Warning>
      Si aparece el error "Failed to obtain access token", es posible que se haya usado el ID del secreto en lugar del valor correcto.
    </Warning>

    ### Permitir la autenticación en el tenant

    Una vez que hayas configurado la conexión SAML en Iru Endpoint y en tu proveedor de identidad, puedes permitir su uso para la autenticación en el tenant. Para obtener instrucciones paso a paso, consulta la sección **Permitir la autenticación en el tenant y administrar conexiones** de nuestro [artículo de soporte sobre inicio de sesión único](/es/endpoint/integrations/single-sign-on-integrations/single-sign-on).

    ### Limitar la autenticación a un dominio

    Al configurar la conexión SAML, puedes limitar opcionalmente la autenticación a uno o más dominios. Esto puede ser útil cuando la conexión SSO podría autenticar en varios dominios. Puedes limitar la autenticación en tu tenant de Iru a un subconjunto de los dominios disponibles.

    ### Exigir el inicio de sesión único

    Una vez que hayas configurado al menos una conexión de inicio de sesión único, puedes deshabilitar las conexiones Passkey, Google Social y Microsoft Social. Deshabilitar estas conexiones impedirá que los administradores de Iru Endpoint de tu tenant se autentiquen mediante esos métodos. Consulta nuestro [artículo de soporte sobre inicio de sesión único](/es/endpoint/integrations/single-sign-on-integrations/single-sign-on) para obtener instrucciones paso a paso.

    ### Renovar el client secret

    <Steps>
      <Step title="Crear un nuevo client secret">
        Sigue los pasos de la pestaña **Configuración de Microsoft Entra ID** anterior para crear un nuevo client secret. Completa los pasos desde "Acceder a Certificates and Secrets" hasta "Copiar el valor del secreto" para crear un nuevo client secret y copiar el valor.
      </Step>

      <Step title="Ir a Administración y autenticación">
        Después de copiar el valor, vuelve a la pestaña **Configuración de la aplicación web de Iru** y sigue los pasos 1 a 3 de la sección **Configurar la conexión de Iru Endpoint**.
      </Step>

      <Step title="Seleccionar la integración SSO">
        Selecciona los puntos suspensivos junto a la integración SSO que creaste anteriormente en este artículo.
      </Step>

      <Step title="Editar la integración SSO">
        Elige **Editar**.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-37-39.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=4ee6a9ed63ead1405c742d939bc4260d" alt="Puntos suspensivos junto a la integración SSO y Edit en Iru Endpoint" width="2198" height="1648" data-path="assets/media/images/entra_native_08-37-39.png" />
        </Frame>
      </Step>

      <Step title="Editar el client secret">
        Selecciona el botón **Edit client secret**.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-43-21.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=a7c8aa2f5d98d61121a1878564b851cc" alt="Botón Edit client secret en Iru Endpoint" width="1730" height="1642" data-path="assets/media/images/entra_native_08-43-21.png" />
        </Frame>
      </Step>

      <Step title="Actualizar el client secret">
        Pega el nuevo valor de **Client secret** que copiaste antes.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-46-11.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=7059a9ab71febe26517d39f8b0eee2ce" alt="Save en Iru Endpoint después de actualizar el client secret" width="1702" height="1640" data-path="assets/media/images/entra_native_08-46-11.png" />
        </Frame>
      </Step>

      <Step title="Probar la configuración">
        Asegúrate de probar la configuración iniciando sesión en la aplicación web de Iru Endpoint y eligiendo la opción de inicio de sesión con SSO nativo que creaste. Conviene probarlo en una ventana privada o de incógnito del navegador y verificar que puedes iniciar sesión en la aplicación web de Iru Endpoint.
      </Step>

      <Step title="Eliminar el secreto anterior">
        Luego, opcionalmente, puedes eliminar el client secret anterior del registro de la aplicación en Entra ID.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Configuración de Microsoft Entra ID">
    ### Configurar la aplicación de Microsoft Entra ID

    <Note>
      Antes de iniciar la configuración de Microsoft Entra ID, completa la configuración inicial en la pestaña **Configuración de la aplicación web de Iru** para obtener la Redirect URL. Necesitarás este valor para configurar la aplicación de Microsoft Entra ID.
    </Note>

    Sigue estos pasos para configurar tu aplicación de Microsoft Entra ID:

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

      <Step title="Expandir la sección Entra ID">
        En la barra de navegación izquierda, asegúrate de que la sección **Entra ID** esté expandida.
      </Step>

      <Step title="Ir a las aplicaciones">
        En la barra de navegación izquierda, selecciona **App registrations**.
      </Step>

      <Step title="Crear un nuevo registro">
        Selecciona **+ New registration** para registrar una nueva aplicación.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-10-59.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=fda999ea57500f53e90ef2df74b9fc7a" alt="App registrations, New registration en Entra ID" width="2750" height="1454" data-path="assets/media/images/entra_native_11-10-59.png" />
        </Frame>
      </Step>

      <Step title="Asignar un nombre a la aplicación">
        En el campo **Nombre**, especifica un nombre para la aplicación (por ejemplo, "Iru Native SSO").
      </Step>

      <Step title="Seleccionar los tipos de cuenta">
        En "**Tipos de cuenta compatibles**", selecciona **Accounts in this organizational directory only**.
      </Step>

      <Step title="Configurar los Redirect URIs">
        En el campo **Redirect URI**, selecciona **Web** en el menú desplegable.
      </Step>

      <Step title="Ingresar el Redirect URI">
        Ingresa la Redirect URL completa que copiaste de la configuración de la aplicación web de Iru (por ejemplo, `https://vpriix.id.iru.com/federated-auth/oidc/callback`).
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-30-17.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=05f8f539e3144b5d1c2b069f3ee31d87" alt="Name, Tipos de cuenta compatibles, Redirect URI y Register en Entra ID" width="2358" height="1634" data-path="assets/media/images/entra_native_11-30-17.png" />
        </Frame>
      </Step>

      <Step title="Copiar el Client ID">
        En la nueva página, copia el **Application (client) ID** y guárdalo para más adelante. Se usará como **Client ID** en Iru.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-40-58.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=790029fe79b3f9dea7429be5d92d2c6b" alt="Copia del Application client ID en Entra ID" width="2716" height="1622" data-path="assets/media/images/entra_native_11-40-58.png" />
        </Frame>
      </Step>

      <Step title="Acceder a Certificates and Secrets">
        Selecciona **Certificates and Secrets**.
      </Step>

      <Step title="Crear un nuevo client secret">
        Selecciona **New client secret**.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-44-51.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=884d74d10d01813ce5fece20d2dbd1b0" alt="Certificates and Secrets, New client secret en Entra ID" width="2716" height="1528" data-path="assets/media/images/entra_native_11-44-51.png" />
        </Frame>
      </Step>

      <Step title="Configurar los detalles del secreto">
        Asigna al client secret una **Descripción**, como "Iru Native SSO".
      </Step>

      <Step title="Establecer el vencimiento">
        Establece el vencimiento en **24 months**.
      </Step>

      <Step title="Agregar el secreto">
        Selecciona **Añadir**.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-47-12.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=532c64c0100928deb9ed852b02cfa0bf" alt="Description, vencimiento y Add del client secret en Entra ID" width="1152" height="446" data-path="assets/media/images/entra_native_11-47-12.png" />
        </Frame>
      </Step>

      <Step title="Copiar el valor del secreto">
        Copia el **Valor** del client secret y guárdalo para más adelante. **Ten en cuenta que el Value del client secret es distinto del ID del client secret.**

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-48-27.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=3d3cc4b5e7e7ddacaab50425208efc32" alt="Copia del Value del client secret en Entra ID" width="3020" height="1628" data-path="assets/media/images/entra_native_11-48-27.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Después de completar la configuración de Microsoft Entra ID, vuelve a la pestaña **Configuración de la aplicación web de Iru** para terminar de configurar la conexión SSO con el Client ID y el Client secret que copiaste de Microsoft Entra ID.
    </Note>
  </Tab>
</Tabs>

## Consideraciones

**Seguridad**: asegúrate de que tu tenant de Microsoft Entra ID tenga configuradas las políticas de seguridad adecuadas para la autenticación OAuth2/OpenID Connect.

**Administración del client secret**: los client secrets vencen a los 24 meses y deben renovarse periódicamente. Considera usar SSO basado en SAML como solución a más largo plazo.

**Pruebas**: prueba siempre la integración SSO con un grupo pequeño de usuarios antes de implementarla en toda tu organización.

**Administración de usuarios**: los usuarios deben existir tanto en Microsoft Entra ID como en Iru Endpoint para autenticarse correctamente mediante SSO.