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

# Configurar Passport Inicio de sesión de Mac con Microsoft Entra ID

> Configura Passport con Microsoft Entra ID para Inicio de sesión de Mac en Iru Endpoint. Habilita la autenticación en la pantalla de inicio de sesión de macOS con credenciales de Entra ID.

<Callout icon="apple" color="#B84A7A" iconType="regular">Esta guía se aplica a computadoras Mac</Callout>

### Acerca de Passport con Microsoft Entra ID Inicio de sesión de Mac

Passport con Microsoft Entra ID Inicio de sesión de Mac permite a los usuarios iniciar sesión en la ventana de inicio de sesión de la Mac con su nombre de usuario y contraseña de Microsoft Entra ID. Para Inicio de sesión web (inicio de sesión de Microsoft Entra ID en la vista web de Passport, incluido cuando necesitas MFA), usa [Configurar Passport con Microsoft Entra ID - Inicio de sesión web](/es/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-web-login).

<Card title="Actualización importante de Passport con Entra ID" type="danger" icon="calendar-exclamation" iconType="solid">
  A partir del **15 de junio de 2026**, Microsoft Entra ID gestiona el acceso condicional para el inicio de sesión de Passport de forma diferente cuando el cambio de aplicación afecta a tu inquilino. Consulta [Cambios necesarios antes del 15 de junio de 2026](#june-2026-conditional-access-change) para confirmar si te afecta. Microsoft explica el cambio en [esta documentación](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions).

  Si vas a configurar Passport por primera vez, continúa desde el principio de este artículo. Las instrucciones de configuración ya incluyen estas actualizaciones.
</Card>

### Cómo funciona

Passport se integra con tu inquilino de Microsoft Entra ID para autenticar a los usuarios en la pantalla de inicio de sesión de macOS mediante los campos estándar de nombre de usuario y contraseña. Cuando los usuarios introducen sus credenciales de Entra ID, Passport las verifica con tu inquilino y crea o actualiza la cuenta de usuario local de la Mac.

### Requisitos previos

* Acceso a una cuenta de administrador de Microsoft Entra ID que pueda conceder a la app de Passport los permisos correctos.

<Tabs>
  <Tab title="Microsoft Entra ID" id="microsoft-entra-id" icon="microsoft" iconType="brands">
    ### Crear el registro de la aplicación

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

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

      <Step title="Acceder a App registrations">
        En el menú **Identity**, en **Aplicaciones**, selecciona **App registrations**.
      </Step>

      <Step title="Iniciar un nuevo registro">
        En la página **App registrations**, en el menú, selecciona **+ New registration**.
      </Step>

      <Step title="Configurar los detalles de la aplicación">
        En el cuadro de diálogo **Register an application**, introduce un nombre para la nueva aplicación (como *Iru Passport Inicio de sesión de Mac*).
      </Step>

      <Step title="Establecer los tipos de cuenta admitidos">
        En **Tipos de cuenta compatibles**, abre el menú desplegable y selecciona **Single tenant only** (la opción también muestra el nombre de tu inquilino, por ejemplo **Single tenant only - *Accuhive***). Passport debe ser de un solo inquilino, solo en tu organización. Consulta [Registrar una aplicación en Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app).
      </Step>

      <Step title="Configurar el URI de redirección">
        En la sección **Redirect URI**, en el menú desplegable **Select a platform**, elige **Web**.
      </Step>

      <Step title="Introducir el URI de redirección">
        En el campo URI, introduce lo siguiente: `https://localhost.redirect`
      </Step>

      <Note>
        Para obtener más información sobre las restricciones, los tipos de plataforma y las prácticas recomendadas de los URI de redirección, consulta la [documentación de Microsoft sobre URI de redirección](https://learn.microsoft.com/en-us/entra/identity-platform/reply-url).
      </Note>

      <Step title="Completar el registro">
        Selecciona **Registrar**.
      </Step>
    </Steps>

    ### Configurar los detalles de la aplicación

    <Steps>
      <Step title="Preparar un documento seguro">
        Abre un documento de texto seguro donde puedas almacenar temporalmente los valores de esta app OIDC. Necesitarás estos datos cuando [configures el Library Item de Passport](/es/endpoint/library/passport/configure-the-passport-library-item).
      </Step>

      <Step title="Copiar el Application ID">
        En la página **Información general**, copia el **Application (client) ID** en un documento de texto seguro temporal.
      </Step>

      <Step title="Acceder a Endpoints">
        Sin salir de la página Overview, selecciona **Endpoints**.
      </Step>

      <Step title="Copiar el documento de metadatos">
        Copia el **OpenID Connect metadata document** (URL del proveedor de identidad) en tu documento de texto seguro temporal.
      </Step>

      <Step title="Acceder a la configuración de Authentication">
        A la izquierda, selecciona **Autenticación** y luego **Configuración**.
      </Step>

      <Step title="Permitir los flujos de cliente público">
        Establece **Allow public client flows** en **Enabled**.
      </Step>

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

      <Step title="Acceder a Token configuration">
        A la izquierda, selecciona **Token configuration**.
      </Step>

      <Step title="Agregar una notificación opcional">
        Selecciona **Add optional claim**.
      </Step>

      <Step title="Configurar el tipo de token">
        En Token type, selecciona **ID**.
      </Step>

      <Step title="Seleccionar la notificación">
        En Claim, selecciona **preferred\_username**.
      </Step>

      <Step title="Agregar la notificación">
        Selecciona **Añadir**.
      </Step>

      <Step title="Agregar la notificación de grupos">
        Sin salir de la página Token configuration, selecciona **Add groups claim**.
      </Step>

      <Step title="Seleccionar los grupos">
        Selecciona **Todos los grupos**.

        <Note>
          SAML de Entra ID solo admite hasta 150 grupos de seguridad. Si tienes más de 150 grupos de seguridad, no debes usar **Todos los grupos**, sino seleccionar grupos específicos. Puedes obtener más información en el artículo de Microsoft [Configurar notificaciones de grupo para aplicaciones con Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/how-to-connect-fed-group-claims).
        </Note>
      </Step>

      <Step title="Agregar la notificación de grupos">
        Selecciona **Añadir**.
      </Step>
    </Steps>

    Una vez completada la configuración de tokens, verás ambas notificaciones opcionales.

    ### Configurar los permisos de API

    <Steps>
      <Step title="Acceder a API Permissions">
        Selecciona **API Permissions**.
      </Step>

      <Step title="Agregar un permiso">
        Selecciona **Add a permission**.
      </Step>

      <Step title="Seleccionar Microsoft Graph">
        Selecciona **Microsoft Graph**.
      </Step>

      <Step title="Seleccionar permisos delegados">
        Selecciona **Delegated permissions**.
      </Step>

      <Step title="Expandir los permisos de OpenID">
        Confirma que la sección **OpenID permissions** está expandida. Si no lo está, selecciona el icono de expansión junto a **OpenID permissions**.
      </Step>

      <Step title="Seleccionar el permiso email">
        Selecciona **email**.
      </Step>

      <Step title="Seleccionar el permiso profile">
        Selecciona **profile**.
      </Step>

      <Step title="Buscar el permiso User.Read">
        En el campo **Select permissions**, introduce **User.Read**.
      </Step>

      <Step title="Confirmar la selección de User.Read">
        En la sección User, confirma que **User.Read** ya está seleccionado. Si **User.Read** no está seleccionado, selecciónalo.
      </Step>

      <Step title="Agregar los permisos">
        Selecciona **Add permissions**.
      </Step>

      <Step title="Conceder el consentimiento del administrador">
        Sin salir de la página API permissions, selecciona **Grant admin consent for \[your tenant]**.
      </Step>

      <Step title="Confirmar el consentimiento del administrador">
        Selecciona **Sí**.
      </Step>
    </Steps>

    Deberías ver una notificación similar a la siguiente y un mensaje "Granted for \[your tenant] ..." en la columna Status junto a cada permiso.

    <Frame>
      <img src="https://mintcdn.com/iru/4wJJk-urrjfBXzBY/assets/media/images/iru-entra-passport-configured-perms.png?fit=max&auto=format&n=4wJJk-urrjfBXzBY&q=85&s=370e73da3d658ffcacf8f4656fce0e35" alt="Permisos de API de Microsoft Entra ID con el estado Granted for tenant" width="2048" height="598" data-path="assets/media/images/iru-entra-passport-configured-perms.png" />
    </Frame>

    ### Asignar usuarios y grupos

    <Note>
      De forma predeterminada, cuando creas un nuevo registro de aplicación, el atributo "Assignment required?" se establece en "No". Sin embargo, si tu app empresarial de Passport está configurada para requerir asignación, sigue estos pasos para asignar usuarios y que puedan usar tu app de Passport.
    </Note>

    <Steps>
      <Step title="Acceder a Enterprise Applications">
        En el menú de navegación de Entra ID a la izquierda, selecciona **Enterprise Apps**.
      </Step>

      <Step title="Seleccionar tu app de Passport">
        En la lista All applications, selecciona **Iru Passport Inicio de sesión de Mac** o el nombre que le diste al registro de la aplicación en la sección anterior.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-enterprise-applications.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=1e5359c8d0f650e1dc1804275841d8fb" alt="Lista de aplicaciones empresariales de Entra ID con Iru Passport Inicio de sesión de Mac" width="3082" height="1438" data-path="assets/media/images/iru-entra-id-passport-enterprise-applications.png" />
        </Frame>
      </Step>

      <Step title="Acceder a Properties">
        En **Gestionar**, selecciona **Properties**.
      </Step>

      <Step title="Agregar un logotipo (opcional)">
        Opcionalmente, agrega un logotipo a tu app empresarial.
      </Step>

      <Step title="Comprobar el requisito de asignación">
        Revisa la opción **Assignment required?**. Si está establecida en "No", puedes omitir el resto de esta sección. Todos los usuarios de Entra ID podrán usar la app de Passport.
      </Step>

      <Step title="Configurar la visibilidad">
        Confirma que **Visible to users?** está establecido en **No**; de lo contrario, los usuarios verán la app en su portal. La app de Passport solo es útil como reemplazo de la ventana de inicio de sesión de macOS.
      </Step>

      <Step title="Guardar las propiedades">
        Selecciona **Guardar**.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-properties.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8d06d2174e478f9f6347c971893cddd1" alt="Properties de Passport en Entra ID con Visible to users establecido en No" width="2558" height="1196" data-path="assets/media/images/iru-entra-id-passport-properties.png" />
        </Frame>
      </Step>

      <Step title="Acceder a Users and Groups">
        <Note>
          Si la opción **Assignment required?** está establecida en "No", puedes omitir los pasos restantes de esta sección y continuar con la siguiente. Si está establecida en "Yes", continúa con los pasos siguientes para asignar usuarios y grupos.
        </Note>

        En **Gestionar**, selecciona **Users and Groups**.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-assignment-required.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=e60e0b210eccf98e0f1fe453500e6e48" alt="Properties de Passport en Entra ID con Assignment required en Yes y Users and groups" width="3172" height="1492" data-path="assets/media/images/iru-entra-id-passport-assignment-required.png" />
        </Frame>
      </Step>

      <Step title="Agregar un usuario o grupo">
        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 que aparece en **Users and groups**.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-users-groups-empty.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=df0424332d9bc5ac8264aab9b4c06025" alt="Users and groups de Passport en Entra ID sin asignaciones" width="3182" height="1484" data-path="assets/media/images/iru-entra-id-passport-users-groups-empty.png" />
        </Frame>
      </Step>

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

      <Step title="Confirmar la selección">
        Después de seleccionar tus usuarios y grupos, selecciona **Seleccionar**.

        Si ves el mensaje siguiente, significa que se está usando un nivel gratuito. Solo puedes agregar usuarios (no grupos) a la app empresarial de Passport.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-groups-not-available-plan-level.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=969cd9458b7d340c056d89b1187c5b2b" alt="Los grupos no están disponibles para asignación debido al nivel del plan de Active Directory" width="1420" height="166" data-path="assets/media/images/iru-entra-groups-not-available-plan-level.png" />
        </Frame>
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-select-users-groups.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=b90dccbe36260010fd1e5d9c420a5396" alt="Selector de usuarios y grupos de Add Assignment en Entra ID con Select" width="3178" height="1434" data-path="assets/media/images/iru-entra-id-passport-select-users-groups.png" />
        </Frame>
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-add-assignment.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=74b4e200c3e7b97e6823a584691e3e35" alt="Add Assignment de Entra ID con usuarios seleccionados y el botón Assign" width="3174" height="1434" data-path="assets/media/images/iru-entra-id-passport-add-assignment.png" />
        </Frame>
      </Step>

      <Step title="Revisar la configuración">
        Con esta parte de la configuración de Entra ID completada, revisa las secciones restantes de este artículo para tu entorno de Microsoft Entra ID.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-users-and-groups.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=86df36369402d68491dad8cf43413840" alt="Users and groups de Passport en Entra ID con usuarios asignados" width="3184" height="1432" data-path="assets/media/images/iru-entra-id-passport-users-and-groups.png" />
        </Frame>
      </Step>
    </Steps>

    ### Consideraciones sobre el acceso condicional de Microsoft Entra ID

    <Warning>
      El [acceso condicional de Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity/conditional-access/) se incluye con Microsoft Entra ID Premium o superior. Asegúrate de desactivar tanto la MFA por usuario como los valores predeterminados de seguridad antes de activar las directivas de acceso condicional de Microsoft Entra ID.
    </Warning>

    Completa los pasos siguientes para registrar **Passport - CA Policy API**, agregar su ámbito a tu app de Passport y excluir esa app de las directivas aplicables. Omite esta sección si no usas el acceso condicional. Cuando termines, agrega el ámbito en **Additional scopes (optional)** en [Modo de autenticación](#authentication-mode) en la pestaña [Iru Endpoint](#iru-endpoint).

    <span id="passport-ca-policy-api" />

    #### Crear la aplicación Passport - CA Policy API

    Crea este registro de aplicación para que Passport pueda solicitar un ámbito más allá de los ámbitos de referencia.

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

      <Step title="Registrar la aplicación">
        Selecciona **+ New registration**. Introduce **Passport - CA Policy API** como nombre, en **Tipos de cuenta compatibles** selecciona **Single tenant only** y deja **Redirect URI** vacío. Selecciona **Registrar**.
      </Step>

      <Step title="Conceder el consentimiento del administrador para Microsoft Graph">
        Abre **API permissions**. Si el consentimiento del administrador aún no se ha concedido, selecciona **Grant admin consent for \[your tenant]**.
      </Step>

      <Step title="Exponer una API">
        Abre **Expose an API** en la navegación de la izquierda.
      </Step>

      <Step title="Agregar un ámbito">
        Selecciona **+ Add a scope**.
      </Step>

      <Step title="Establecer el Application ID URI">
        Revisa el **Application ID URI**. Entra ID sugiere un valor predeterminado (por ejemplo, `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a`). El valor predeterminado es válido. Selecciona **Guardar y continuar**. No necesitas copiar este URI; copia el URI del ámbito en **Copiar el URI del ámbito** más abajo.
      </Step>

      <Step title="Configurar el ámbito de Passport">
        En **Scope name**, introduce `Passport` sin espacios ni caracteres especiales. Deja **Who can consent** con el valor predeterminado. Introduce un nombre visible y una descripción en los campos **Admin consent** y luego selecciona **Add scope**.

        <Frame>
          <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-scope.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=7696a053228d59eac997a0a97c23ca2d" alt="Lista de ámbitos de Expose an API de Microsoft Entra ID con el URI del ámbito Passport y el estado Enabled" width="1822" height="188" data-path="assets/media/images/iru-entra-passport-ca-policy-api-scope.png" />
        </Frame>
      </Step>

      <Step title="Copiar el URI del ámbito">
        Junto al URI del ámbito en la lista **Scopes** (por ejemplo, `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a/Passport`), selecciona **Copiar**. Guárdalo para **Agregar ámbitos adicionales** en [Modo de autenticación](#authentication-mode) en la pestaña [Iru Endpoint](#iru-endpoint).
      </Step>
    </Steps>

    <span id="passport-ca-policy-api-permission" />

    #### Agregar el ámbito personalizado al registro de tu app de Passport

    <Steps>
      <Step title="Abrir el registro de tu app de Passport">
        Si aún no has iniciado sesión, inicia sesión en el [centro de administración de Microsoft Entra](https://entra.microsoft.com) y abre **Entra ID** > **App registrations**. Abre la aplicación que usas para Passport **Inicio de sesión de Mac**.
      </Step>

      <Step title="Agregar un permiso de API">
        Abre **API permissions** y selecciona **+ Add a permission**.
      </Step>

      <Step title="Seleccionar Passport - CA Policy API">
        Abre la pestaña **APIs my organization uses** y selecciona **Passport - CA Policy API**.
      </Step>

      <Step title="Agregar el permiso delegado Passport">
        Selecciona **Delegated permissions**, selecciona el permiso **Passport** y luego **Add permissions**.
      </Step>

      <Step title="Conceder el consentimiento del administrador">
        Selecciona **Grant admin consent for \[your tenant]**.

        <Frame>
          <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-permissions.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=624831db5dcf4ae73afe9a33a284cf6a" alt="Permisos de API de Microsoft Entra ID para Passport con los permisos delegados de Microsoft Graph y Passport - CA Policy API" width="964" height="472" data-path="assets/media/images/iru-entra-passport-ca-policy-api-permissions.png" />
        </Frame>
      </Step>
    </Steps>

    <span id="passport-ca-policy-api-ca-exclude" />

    #### Excluir Passport - CA Policy API de las directivas de All resources

    Si usas el acceso condicional, excluye **Passport - CA Policy API** de cada directiva con ámbito **All resources**. Las directivas con ámbito **All resources** incluyen los inicios de sesión que usan el ámbito `openid`. Excluir **Passport - CA Policy API** elimina el requisito de MFA para ROPG, que Passport usa para la verificación y la sincronización de contraseñas en **Inicio de sesión de Mac**.

    <Steps>
      <Step title="Abrir Conditional Access">
        En el [centro de administración de Microsoft Entra](https://entra.microsoft.com), abre **Protection** > **Conditional Access** > **Policies**.
      </Step>

      <Step title="Abrir una directiva con ámbito All resources">
        Selecciona cada directiva con ámbito **All resources** y luego abre **Target resources**.
      </Step>

      <Step title="Excluir Passport - CA Policy API">
        Abre la pestaña **Exclude**, selecciona **Select resources** y luego **Passport - CA Policy API**. Selecciona **Seleccionar** y luego **Guardar**.

        <Frame>
          <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-ca-exclude.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=1c5ff72b9d4671691b3cbbfd376c2503" alt="Pestaña Exclude de una directiva de acceso condicional de Microsoft Entra ID con Passport - CA Policy API seleccionado en Select specific resources" width="604" height="826" data-path="assets/media/images/iru-entra-passport-ca-policy-api-ca-exclude.png" />
        </Frame>
      </Step>

      <Step title="Repetir para cada directiva de All resources">
        Repite estos pasos para cada directiva de acceso condicional con ámbito **All resources**.
      </Step>
    </Steps>

    <Note>
      Si **Guardar** falla, confirma que **Passport - CA Policy API** no permite flujos de cliente público. Si la app tiene un URI de redirección configurado, elimínalo e inténtalo de nuevo.
    </Note>

    ### Aprovisionamiento de cuentas de usuario con Passport

    Si quieres que Passport establezca el tipo de cuenta de la Mac de cada usuario según su pertenencia a grupos de seguridad de Entra ID, recopila el **Object ID** de cada grupo en el centro de administración de Microsoft Entra siguiendo los pasos de esta sección. Usarás esos valores en **Aprovisionamiento de usuarios** en la [pestaña **Iru Endpoint**](#iru-endpoint) del Library Item de Passport. Para obtener más detalles sobre este modo, consulta [Aprovisionamiento de usuarios](/es/endpoint/library/passport/configure-the-passport-library-item#user-provisioning) en **Configurar el Library Item de Passport**.

    Microsoft Entra ID admite 150 grupos de seguridad en las aserciones SAML. En organizaciones más grandes, el número de grupos de los que un usuario es miembro puede superar el límite que aplica Microsoft Entra ID antes de emitir notificaciones de grupo en un token. Si se supera este límite, Microsoft Entra ID omitirá las notificaciones de grupo del token.

    <Steps>
      <Step title="Acceder a Groups">
        Inicia sesión en el [centro de administración de Microsoft Entra](https://entra.microsoft.com). En el menú de navegación Identity a la izquierda, abre **Grupos** y selecciona **Todos los grupos**.
      </Step>

      <Step title="Seleccionar el grupo">
        Selecciona el grupo que quieres usar.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-groups-all-groups.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=34b8389946a40766e3d14022d1f35791" alt="Lista Todos los grupos de Entra ID con Mac Computer Admin Users" width="3178" height="1504" data-path="assets/media/images/iru-entra-id-groups-all-groups.png" />
        </Frame>
      </Step>

      <Step title="Copiar el Object ID">
        Copia el **Object ID** de ese grupo.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-group-object-id.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=032b1059e37294d2bee6e77afbb864d3" alt="Overview de un grupo de Entra ID con el Object ID" width="2204" height="1416" data-path="assets/media/images/iru-entra-id-group-object-id.png" />
        </Frame>
      </Step>

      <Step title="Repetir para otros grupos de Entra ID">
        Para cada grupo adicional de Entra ID que quieras usar, repite **Seleccionar el grupo** y **Copiar el Object ID**. Guarda los valores de **Object ID** en un documento seguro hasta que los introduzcas en la [pestaña **Iru Endpoint**](#iru-endpoint).
      </Step>
    </Steps>

    <Note>
      Configura **Modo de autenticación** y **Aprovisionamiento de usuarios** en el Library Item de Passport en la [pestaña **Iru Endpoint**](#iru-endpoint).
    </Note>
  </Tab>

  <Tab title="Iru Endpoint" id="iru-endpoint" icon="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg">
    Si aún no lo has hecho, usa [Configurar el Library Item de Passport](/es/endpoint/library/passport/configure-the-passport-library-item) para agregar el Library Item de Passport y su configuración básica. Los pasos siguientes corresponden a los campos de Microsoft Entra ID **Inicio de sesión de Mac** del Library Item de Passport; usa el **Application (client) ID** y la URL de metadatos de OpenID Connect de la pestaña [Microsoft Entra ID](#microsoft-entra-id).

    ### Modo de autenticación

    Establece **Modo de autenticación** en **Inicio de sesión de Mac** para que los usuarios inicien sesión con su nombre de usuario y contraseña de Microsoft Entra ID en la ventana de inicio de sesión de la Mac.

    <Steps>
      <Step title="Seleccionar Microsoft Entra ID como proveedor de identidad">
        En el Library Item de Passport, establece **Proveedor de identidad** en **Microsoft Entra ID**.
      </Step>

      <Step title="Introducir la URL del proveedor de identidad">
        En el campo **URL del proveedor de identidad**, pega la URL del **OpenID Connect metadata document** del registro de la aplicación en la pestaña [Microsoft Entra ID](#microsoft-entra-id).
      </Step>

      <Step title="Introducir el Client ID (Sincronización de contraseñas)">
        En el campo **Client ID (Password Sync)**, pega el **Application (client) ID** del registro de la aplicación en la pestaña [Microsoft Entra ID](#microsoft-entra-id).
      </Step>

      <Step title="Agregar ámbitos adicionales (solo acceso condicional)">
        <Note>
          Completa este paso solo si completaste [Consideraciones sobre el acceso condicional de Microsoft Entra ID](#microsoft-entra-id-conditional-access-considerations). Si omitiste esa sección, continúa con **Seleccionar Inicio de sesión de Mac**.
        </Note>

        Pega el URI del ámbito que copiaste en **Crear la aplicación Passport - CA Policy API** en **Additional scopes (optional)**. Este campo aparece debajo de **Client ID (Password Sync)**.

        <Frame>
          <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-additional-scopes.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=184577a527e20b9066f038cfadb7e6ce" alt="Campo Additional scopes del Library Item de Passport con el URI del ámbito de Passport - CA Policy API" width="744" height="214" data-path="assets/media/images/iru-entra-passport-additional-scopes.png" />
        </Frame>
      </Step>

      <Step title="Seleccionar Inicio de sesión de Mac">
        En **Modo de autenticación**, selecciona **Inicio de sesión de Mac**.
      </Step>

      <Step title="Guardar la configuración">
        Selecciona **Guardar** en el Library Item de Passport.
      </Step>
    </Steps>

    ### Aprovisionamiento de usuarios

    Si quieres que Passport establezca el tipo de cuenta de la Mac de cada usuario según su pertenencia a grupos de seguridad de Entra ID, usa los pasos siguientes en **Aprovisionamiento de usuarios** en la [pestaña **Iru Endpoint**](#iru-endpoint) del Library Item de Passport. Primero, recopila el **Object ID** de cada grupo en Entra ID. Consulta [Aprovisionamiento de cuentas de usuario con Passport](#user-account-provisioning-via-passport) en la pestaña [Microsoft Entra ID](#microsoft-entra-id).

    <Steps>
      <Step title="Configurar el tipo de cuenta de usuario">
        En la sección **Aprovisionamiento de usuarios**, abre **Tipo de cuenta de usuario** y selecciona **Especificar por grupo del proveedor de identidad**.
      </Step>

      <Step title="Elegir el tipo de cuenta alternativo">
        Con **Tipo de cuenta de usuario** establecido en **Especificar por grupo del proveedor de identidad**, abre el menú desplegable de tipo de cuenta que aparece debajo y selecciona Administrator o Standard user. Si la pertenencia a grupos del IdP de un usuario devuelve tanto el tipo de cuenta Administrator como Standard, el usuario se designa como Administrator.
      </Step>

      <Step title="Introducir los Object ID">
        En cada campo **Grupo del proveedor de identidad**, introduce el **Object ID** del grupo de Entra ID como GUID, no el nombre visible del grupo.
      </Step>

      <Step title="Establecer los tipos de cuenta">
        Para cada fila de **Grupo del proveedor de identidad**, establece el **Account type** que corresponda.

        <Frame>
          <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-entra-id-passport-user-account-type.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=91c1ca4439ea3c71cc1fbc651bb1d4fe" alt="Tipo de cuenta de usuario del Library Item de Passport por grupo de proveedor de identidad de Entra ID" width="2436" height="892" data-path="assets/media/images/iru-entra-id-passport-user-account-type.png" />
        </Frame>
      </Step>

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

    <Note>
      Cuando se haya guardado el Library Item de Passport, vuelve a la pestaña [Microsoft Entra ID](#microsoft-entra-id) si necesitas cambiar el registro de la aplicación, las exclusiones de **Passport - CA Policy API** o los **Object ID** de los grupos.
    </Note>
  </Tab>
</Tabs>

<span id="june-2026-conditional-access-change" />

## Cambios necesarios antes del 15 de junio de 2026

El **15 de junio de 2026**, Microsoft Entra ID empieza a aplicar el acceso condicional de forma más amplia a las directivas que se dirigen a **All resources** (antes **All cloud apps**) e incluyen **exclusiones de recursos**. Los inicios de sesión que solo solicitan **ámbitos de referencia**, como `openid`, `profile`, `email` y `User.Read`, estarán sujetos a esas directivas.

<Note>
  Si no tienes licencia para el acceso condicional, este cambio no se aplica a tu organización. Solo se aplica cuando las directivas se dirigen a **All resources** con una o más **exclusiones de recursos** y los usuarios inician sesión mediante aplicaciones que solo solicitan ámbitos de referencia. Si no usas esa configuración de directivas, no te afecta. Las directivas que se dirigen a **All resources** sin exclusiones de recursos también quedan fuera de este cambio.
</Note>

Passport **Inicio de sesión de Mac** solicita esos ámbitos como cliente público. Si este cambio se aplica a tu inquilino y ya usas **Inicio de sesión de Mac**, completa las actualizaciones correspondientes que se indican a continuación antes del **15 de junio de 2026**. Si las omites, el inicio de sesión y la sincronización de contraseñas pueden dejar de funcionar cuando empiece la aplicación.

Si vas a configurar Passport **Inicio de sesión de Mac** por primera vez con este artículo, las pestañas **Microsoft Entra ID** e **Iru Endpoint** anteriores ya incluyen estas actualizaciones.

Lee [Aplicación para ámbitos de referencia en el acceso condicional](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions) para obtener más detalles.

### Si omites estas actualizaciones

Si no te preparas antes del **15 de junio de 2026**:

* Es posible que los nuevos usuarios no puedan iniciar sesión con Passport.
* La sincronización de contraseñas y la gestión del estado pueden dejar de funcionar.
* Microsoft Entra ID podría registrar eventos adicionales de inicio de sesión fallido.

### Si no usas directivas de acceso condicional

Si no usas el acceso condicional, o quieres mantener el comportamiento anterior en todo tu inquilino mientras haces pruebas:

<Steps>
  <Step title="Registrar una aplicación de marcador de posición">
    Registra una aplicación de un solo inquilino en Microsoft Entra ID para que sirva como recurso de destino personalizado para los ámbitos de referencia. No se requiere ninguna configuración adicional durante el registro. Consulta **Create an application** en [Personalizar el comportamiento](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior).
  </Step>

  <Step title="Excluir la aplicación de la directiva correspondiente">
    En cada directiva de acceso condicional en la que necesites conservar el comportamiento heredado, excluye la aplicación de marcador de posición de **Target resources**. Consulta **Exclude the application from the relevant policy** en la [documentación de Microsoft](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior).
  </Step>

  <Step title="Seleccionar la aplicación en la configuración de Baseline scopes">
    Abre la [configuración de Baseline scopes](https://aka.ms/BaselineScopesSettingsUX), selecciona **Customize behavior**, selecciona la aplicación de marcador de posición y luego **Guardar**. Consulta **Select the application in the Baseline scopes settings UX** en la [documentación de Microsoft](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions#customize-behavior).
  </Step>

  <Step title="No se requieren cambios en el Library Item de Passport">
    No necesitas cambiar tu Library Item de Passport en Iru Endpoint.
  </Step>
</Steps>

Esta configuración de Entra ID afecta a todas las aplicaciones que solicitan ámbitos de referencia, no solo a Passport.

### Si usas directivas de acceso condicional

Si usas el acceso condicional con Passport **Inicio de sesión de Mac**, completa los pasos siguientes antes del **15 de junio de 2026**.

<span id="create-passport-ca-policy-api-app" />

#### Crear la aplicación Passport - CA Policy API

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

  <Step title="Registrar la aplicación">
    Selecciona **+ New registration**. Introduce **Passport - CA Policy API** como nombre, en **Tipos de cuenta compatibles** selecciona **Single tenant only** y deja **Redirect URI** vacío. Selecciona **Registrar**.
  </Step>

  <Step title="Conceder el consentimiento del administrador para Microsoft Graph">
    Abre **API permissions**. Si el consentimiento del administrador aún no se ha concedido, selecciona **Grant admin consent for \[your tenant]**.
  </Step>

  <Step title="Exponer una API">
    Abre **Expose an API** en la navegación de la izquierda.
  </Step>

  <Step title="Agregar un ámbito">
    Selecciona **+ Add a scope**.
  </Step>

  <Step title="Establecer el Application ID URI">
    Revisa el **Application ID URI**. Entra ID sugiere un valor predeterminado (por ejemplo, `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a`). El valor predeterminado es válido. Selecciona **Guardar y continuar**. No necesitas copiar este URI; copia el URI del ámbito en **Copiar el URI del ámbito** más abajo.
  </Step>

  <Step title="Configurar el ámbito de Passport">
    En **Scope name**, introduce `Passport` sin espacios ni caracteres especiales. Deja **Who can consent** con el valor predeterminado. Introduce un nombre visible y una descripción en los campos **Admin consent** y luego selecciona **Add scope**.

    <Frame>
      <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-scope.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=7696a053228d59eac997a0a97c23ca2d" alt="Lista de ámbitos de Expose an API de Microsoft Entra ID con el URI del ámbito Passport y el estado Enabled" width="1822" height="188" data-path="assets/media/images/iru-entra-passport-ca-policy-api-scope.png" />
    </Frame>
  </Step>

  <Step title="Copiar el URI del ámbito">
    Junto al URI del ámbito en la lista **Scopes** (por ejemplo, `api://cca588ed-dfe6-4fb4-b695-abfa23b6475a/Passport`), selecciona **Copiar**. Guárdalo para [Actualizar tu Library Item de Passport](#update-passport-library-item).
  </Step>
</Steps>

#### Agregar el ámbito personalizado al registro de tu app de Passport

<Steps>
  <Step title="Abrir el registro de tu app de Passport">
    Si aún no has iniciado sesión, inicia sesión en el [centro de administración de Microsoft Entra](https://entra.microsoft.com) y abre **Entra ID** > **App registrations**. Abre la aplicación que usas para Passport **Inicio de sesión de Mac**.
  </Step>

  <Step title="Agregar un permiso de API">
    Abre **API permissions** y selecciona **+ Add a permission**.
  </Step>

  <Step title="Seleccionar Passport - CA Policy API">
    Abre la pestaña **APIs my organization uses** y selecciona **Passport - CA Policy API**.
  </Step>

  <Step title="Agregar el permiso delegado Passport">
    Selecciona **Delegated permissions**, selecciona el permiso **Passport** y luego **Add permissions**.
  </Step>

  <Step title="Conceder el consentimiento del administrador">
    Selecciona **Grant admin consent for \[your tenant]**.

    <Frame>
      <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-permissions.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=624831db5dcf4ae73afe9a33a284cf6a" alt="Permisos de API de Microsoft Entra ID para Passport con los permisos delegados de Microsoft Graph y Passport - CA Policy API" width="964" height="472" data-path="assets/media/images/iru-entra-passport-ca-policy-api-permissions.png" />
    </Frame>
  </Step>
</Steps>

#### Excluir Passport - CA Policy API de las directivas de All resources

Las directivas con ámbito **All resources** incluyen los inicios de sesión que usan el ámbito `openid`. Excluir **Passport - CA Policy API** elimina el requisito de MFA para ROPG, que Passport usa para la verificación y la sincronización de contraseñas en **Inicio de sesión de Mac**.

<Steps>
  <Step title="Abrir Conditional Access">
    En el [centro de administración de Microsoft Entra](https://entra.microsoft.com), abre **Protection** > **Conditional Access** > **Policies**.
  </Step>

  <Step title="Abrir una directiva con ámbito All resources">
    Selecciona cada directiva con ámbito **All resources** y luego abre **Target resources**.
  </Step>

  <Step title="Excluir Passport - CA Policy API">
    Abre la pestaña **Exclude**, selecciona **Select resources** y luego **Passport - CA Policy API**. Selecciona **Seleccionar** y luego **Guardar**.

    <Frame>
      <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-ca-policy-api-ca-exclude.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=1c5ff72b9d4671691b3cbbfd376c2503" alt="Pestaña Exclude de una directiva de acceso condicional de Microsoft Entra ID con Passport - CA Policy API seleccionado en Select specific resources" width="604" height="826" data-path="assets/media/images/iru-entra-passport-ca-policy-api-ca-exclude.png" />
    </Frame>
  </Step>

  <Step title="Repetir para cada directiva de All resources">
    Repite estos pasos para cada directiva de acceso condicional con ámbito **All resources**.
  </Step>
</Steps>

<Note>
  Si **Guardar** falla, confirma que **Passport - CA Policy API** no permite flujos de cliente público. Si la app tiene un URI de redirección configurado, elimínalo e inténtalo de nuevo.
</Note>

<span id="update-passport-library-item" />

#### Actualizar tu Library Item de Passport

<Steps>
  <Step title="Abrir el Library Item de Passport">
    En Iru Endpoint, abre **Library** y edita tu Library Item de Passport configurado para Microsoft Entra ID **Inicio de sesión de Mac**.
  </Step>

  <Step title="Agregar el URI del ámbito">
    En la [pestaña **Iru Endpoint**](#iru-endpoint), pega el URI del ámbito de [Crear la aplicación Passport - CA Policy API](#create-passport-ca-policy-api-app) en **Additional scopes (optional)** y luego selecciona **Guardar**.

    <Frame>
      <img src="https://mintcdn.com/iru/XxnIQlFwhHx3K8Yp/assets/media/images/iru-entra-passport-additional-scopes.png?fit=max&auto=format&n=XxnIQlFwhHx3K8Yp&q=85&s=184577a527e20b9066f038cfadb7e6ce" alt="Campo Additional scopes del Library Item de Passport con el URI del ámbito de Passport - CA Policy API" width="744" height="214" data-path="assets/media/images/iru-entra-passport-additional-scopes.png" />
    </Frame>
  </Step>

  <Step title="Repetir para otros Library Items de Passport">
    Repite **Agregar el URI del ámbito** para cada Library Item de Passport configurado para Microsoft Entra ID **Inicio de sesión de Mac**.
  </Step>
</Steps>

Cuando termines estas actualizaciones, prueba el inicio de sesión de Passport en una Mac inscrita. Si el inicio de sesión falla, consulta [Solución de problemas de Passport con Microsoft Entra ID (antes Azure AD)](/es/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad).

## Solución de problemas de Microsoft Entra ID

Si el inicio de sesión de Passport falla con Entra ID, consulta [Solución de problemas de Passport con Microsoft Entra ID (antes Azure AD)](/es/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad).
