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

# Implementar Iru Access

> Distribuye la aplicación Iru Access mediante tu MDM para que las computadoras Mac, los dispositivos iPhone, los dispositivos iPad y las computadoras Windows se reconozcan como administrados.

**Iru Access** contiene la credencial de inicio de sesión vinculada al dispositivo de cada usuario e informa del
[estado del dispositivo](/es/identity/authentication/device-trust). *Cómo* la distribuyas
determina si un dispositivo se reconoce como **administrado**:

* **Implementación administrada:** se instala y configura mediante tu MDM. Iru
  reconoce el dispositivo como administrado, por lo que se cumplen las [políticas de
  autenticación](/es/identity/authentication/authentication-policies) que exigen el
  atributo **administrado**.
* **Implementación no administrada:** un dispositivo personal o BYO que el propio usuario
  configura. Igualmente registra un autenticador funcional e informa de las señales de
  estado, pero **no** se reconoce como administrado, por lo que las políticas que exigen el
  atributo administrado no se superarán en él.

<Note>
  Ambas rutas proporcionan al usuario un autenticador de Iru Access funcional e informan del estado
  del dispositivo. La única diferencia es si el dispositivo cuenta como **administrado** para
  las decisiones de confianza del dispositivo.
</Note>

## Implementación administrada

Instala y configura Iru Access mediante tu MDM para que los dispositivos inscritos cuenten como
**administrados** para la [confianza del dispositivo](/es/identity/authentication/device-trust).

### Crear una conexión MDM

Una [conexión MDM](/es/identity/authentication/mdm-connections) es lo que permite
a Iru reconocer como administrados los dispositivos inscritos en tu MDM. Crea una para cada
instancia de MDM que uses con Iru Identity.

1. En Iru Identity, ve a **Policies → MDM Connections** y elige **+ MDM Connection**.
2. En **Select a connection type**, elige una opción:
   * **Instancia de Iru Endpoint**: completa previamente los campos de la conexión a partir de tu instancia de Iru Endpoint.
   * **Conexión de MDM personalizada**: crea una conexión MDM personalizada mediante entrada manual.
3. Asigna a la conexión un **nombre para mostrar**. Te recomendamos el dominio de tu servidor MDM.
4. Elige una **plataforma**: Apple, Windows o ambas.
5. Ingresa los datos de la plataforma:
   * **Apple:** el **tema de APNs** y la **Check-in URL** de tu servidor MDM.
   * **Windows:** el **Provider ID** y la **Discovery service URL** de tu
     servidor MDM.

<Tip>
  ¿No conoces esos valores? Consulta [Recursos](#resources) para ver scripts auxiliares que
  puedes ejecutar en un dispositivo ya inscrito para obtenerlos.
</Tip>

Después de crear la conexión, implementa Iru Access en cada plataforma, como se indica a continuación.

### macOS

<Steps>
  <Step title="Implementar el perfil de configuración de Iru Access">
    En Iru Identity, en **Policies → MDM Connections**, selecciona el botón de
    descarga a la izquierda de **+ MDM Connection** y luego elige **macOS Profile**.
    Implementa el perfil en tus computadoras Mac. Ya contiene la configuración de Associated Domains
    y de la extensión de inicio de sesión único (con los dominios de tu organización
    completados), por lo que no tienes que armarla manualmente.

    <Expandable title="Crear el perfil manualmente">
      Si tu MDM configura estos elementos como payloads nativos en lugar de un perfil
      subido, replica lo siguiente. Sustituye `<your-iru-domain>` por
      cada dominio que use tu conexión (una conexión puede incluir más
      de uno).

      * **Associated Domains:** identificador de aplicación
        `N5M3B34269.com.iru.Access`, con un dominio asociado
        `authsrv:<your-iru-domain>` para cada dominio.
      * **Extensión de inicio de sesión único** (Extensible SSO, tipo **Redirect**):
        identificador de extensión `com.iru.Access.SSOExtension`, identificador de equipo
        `N5M3B34269` y estos valores de URL de redirección para cada dominio:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        https://<your-iru-domain>/api/v1/saml/login
        ```
      * **Elementos de inicio de sesión administrados:** permite el identificador de equipo `N5M3B34269` para
        `com.iru.Access`, `com.iru.Access.IruDaemon` y `com.iru.Access.Menu`
        para que el asistente, el servicio en segundo plano y el actualizador de Iru Access puedan ejecutarse.
    </Expandable>
  </Step>

  <Step title="Implementar la aplicación Iru Access">
    **Con Iru Endpoint:** agrega la Auto App **Iru Access** para Mac desde
    **Auto Apps** en la Library, asígnala mediante un Blueprint y aplícala a
    tus computadoras Mac. Consulta
    [Descripción general de Auto Apps](/es/endpoint/library/auto-apps/auto-apps-overview).

    **Con otro MDM:** descarga
    [Iru Access para macOS](https://updater.iru.com/iru-access-macOS/download),
    sube el paquete a tu MDM y aplícalo a tus computadoras Mac.
  </Step>

  <Step title="Descargar el script de registro">
    Copia el
    [script de registro administrado de Iru Access](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_macos.zsh)
    del
    [repositorio de GitHub de Iru Support](https://github.com/kandji-inc/support/tree/main/Identity).
  </Step>

  <Step title="Configurar el script">
    En la sección **USER INPUT** cerca del principio del archivo, establece `regToken` en el
    **client secret** de tu conexión MDM y `regTokenDomain` en el dominio **base** de tu
    tenant:

    ```zsh theme={null}
    # USER INPUT
    regToken="mdm-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    regTokenDomain="yourcompany.iru.com"
    ```
  </Step>

  <Step title="Implementar el script con Iru Endpoint">
    Agrega un Library Item **Mac Custom Script** desde la Library, pega el script
    modificado en **Script de auditoría** y asígnalo mediante el mismo Blueprint que la
    aplicación Iru Access. Establece **Frecuencia de ejecución** en **Run every 15 minutes** para que el
    script vuelva a intentarlo en cada registro hasta que Iru Access esté instalado y el secreto esté
    almacenado. Como el script es idempotente, **Run daily** también funciona si
    prefieres ejecuciones menos frecuentes. Consulta
    [Descripción general de Custom Scripts](/es/endpoint/library/library-items-profiles/custom-scripts-overview)
    (pestaña Mac).
  </Step>

  <Step title="Implementar el script con otro MDM">
    Sube el script modificado mediante las herramientas de scripts personalizados o de políticas de tu plataforma.
    Ejecútalo de forma periódica después de instalar Iru Access para que los nuevos
    dispositivos obtengan el secreto una vez que la aplicación esté presente.
  </Step>
</Steps>

### iOS, iPadOS y visionOS

**Requisitos**

* **iOS y iPadOS:** los dispositivos deben ejecutar **18.4 o posterior**.
* **Apple Vision Pro:** Iru Access se instala como la aplicación de iPad.

<Steps>
  <Step title="Implementar el perfil de configuración de Iru Access">
    En Iru Identity, en **Policies → MDM Connections**, selecciona el botón de
    descarga a la izquierda de **+ MDM Connection** y luego elige **iOS Profile**.
    Implementa el perfil en tus dispositivos.

    <Expandable title="Crear el perfil manualmente">
      * **Extensión de inicio de sesión único** (Extensible SSO, tipo **Redirect**):
        identificador de extensión `com.iru.AccessMobile.SSOExtension`, identificador de
        equipo `N5M3B34269` y estos valores de URL de redirección para cada dominio:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        ```
    </Expandable>
  </Step>

  <Step title="Implementar la aplicación Iru Access">
    Distribuye
    [Iru Access en el App Store](https://apps.apple.com/us/app/iru-access/id6752437810)
    mediante tu MDM como aplicación administrada y aplícala a tus dispositivos.
  </Step>

  <Step title="Configurar el registro administrado">
    En tu MDM, establece la **configuración de aplicación administrada** en Iru Access (bundle ID
    `com.iru.AccessMobile`). Establece dos claves:

    * **`mdmSecret`** (String, obligatoria): el **client
      secret** de tu conexión MDM.
    * **`mdmSecretDomain`** (String, obligatoria): el dominio **base** de tu tenant
      (por ejemplo, `yourcompany.iru.com`).

    <Warning>
      Establece `mdmSecretDomain` en tu dominio **base** (`yourcompany.iru.com`), no en
      el subdominio `id.` que usan los enlaces de invitación
      (`yourcompany.id.iru.com`). Si se incluye el subdominio `id.`, el secreto
      no se aplica y el usuario tiene que ingresarlo manualmente.
    </Warning>

    ```xml Managed app configuration (plist) theme={null}
    <dict>
        <key>mdmSecret</key>
        <string>mdm-REPLACE-WITH-MDM-CONNECTION-CLIENT-SECRET</string>
        <key>mdmSecretDomain</key>
        <string>yourcompany.iru.com</string>
    </dict>
    ```

    <Note>
      Con esta configuración, el registro es **sin credenciales**: el usuario
      nunca ingresa un secreto, escanea un código QR ni espera una aprobación manual.
      Aun así, abre su **invitación** (enviada por correo electrónico o un enlace que envías a los
      dispositivos administrados) o la pantalla de incorporación de la aplicación, toca **Continuar** y
      confirma con Face ID o Touch ID.
    </Note>

    Con Iru Endpoint, aplica este diccionario mediante **Set app configuration**
    en la aplicación del App Store Iru Access. Consulta
    [Usar AppConfig](/es/endpoint/library/library-items-profiles/using-appconfig)
    para conocer los pasos de implementación.
  </Step>
</Steps>

### Windows

**Requisitos**

* **Windows 11 24H2, 25H2 o 26H2**

La implementación en Windows tiene dos partes: implementar **Iru Access** mediante tu MDM y luego
almacenar el **client secret** de tu conexión MDM en cada computadora Windows con el script de
registro. El registro sigue requiriendo que el usuario abra su invitación y confirme
con **Windows Hello**.

<Steps>
  <Step title="Implementar la aplicación Iru Access">
    **Con Iru Endpoint:** agrega la Auto App **Iru Access** para Windows desde
    **Auto Apps** en la Library, asígnala mediante un Blueprint y aplícala a
    tus computadoras Windows. Consulta
    [Descripción general de Auto Apps](/es/endpoint/library/auto-apps/auto-apps-overview).

    **Con otro MDM:** descarga
    [Iru Access para Windows](https://updater.iru.com/iru-access-windows/download),
    sube el paquete a tu MDM y aplícalo a tus computadoras Windows.
  </Step>

  <Step title="Descargar el script de registro">
    Copia el
    [script de registro administrado de Iru Access](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_windows.ps1)
    del
    [repositorio de GitHub de Iru Support](https://github.com/kandji-inc/support/tree/main/Identity).
  </Step>

  <Step title="Implementar el script con Iru Endpoint">
    Agrega un Library Item **Windows Custom Script** desde la Library, sube el
    script y asígnalo mediante el mismo Blueprint que la aplicación Iru Access. En
    [**Command line parameters**](/es/endpoint/library/library-items-profiles/custom-scripts-overview#command-line-parameters-optional),
    pasa tu client secret y el dominio base del tenant:

    ```
    manage --secret <client-secret> --domain yourcompany.iru.com
    ```

    <Warning>
      Usa el **client secret** de tu conexión y el dominio **base** del tenant
      (`yourcompany.iru.com`), los mismos valores que en macOS e iOS. Almacena el
      client secret con este script en lugar de escribir directamente en el registro.
      Se cifra para el dispositivo, por lo que un valor enviado directamente al registro o mediante OMA-URI
      no se podrá usar.
    </Warning>

    Establece **Execute in** en **64 bit**. Los Windows Custom Scripts se ejecutan una vez por dispositivo
    cuando se asignan. Consulta
    [Descripción general de Custom Scripts](/es/endpoint/library/library-items-profiles/custom-scripts-overview)
    (pestaña Windows).
  </Step>

  <Step title="Implementar el script con otro MDM">
    Implementa el script con las herramientas de políticas de scripts o de PowerShell que admita tu
    plataforma. Pasa los argumentos `manage --secret` y `--domain` que permita tu
    MDM y ejecútalo con privilegios elevados para que el script pueda escribir en `HKLM`:

    ```powershell theme={null}
    .\iru_access_managed_registration_windows.ps1 manage --secret <client-secret> --domain yourcompany.iru.com
    ```
  </Step>

  <Step title="Verificar o rotar (opcional)">
    Para confirmar que el secreto está almacenado o para borrarlo, ejecuta el script desde una
    sesión de PowerShell con privilegios elevados y con argumentos. Consulta
    [Getting Started with PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/01-getting-started?view=powershell-7.5#starting-powershell-elevated-as-an-administrator) de Microsoft
    para saber cómo abrir PowerShell como administrador.

    ```powershell theme={null}
    # Verify: prints "<domain>:<hash>", never the secret itself
    .\iru_access_managed_registration_windows.ps1 manage --list

    # Rotate or remove
    .\iru_access_managed_registration_windows.ps1 manage --clear "yourcompany.iru.com"
    ```
  </Step>

  <Step title="Completar el registro">
    Con la aplicación implementada y el client secret almacenado, el usuario abre su
    **invitación**, que inicia Iru Access, y confirma con **Windows
    Hello**. Como el dispositivo está inscrito en tu MDM y tiene el
    client secret almacenado, Iru lo reconoce como **administrado**.
  </Step>
</Steps>

<Note>
  Iru Access registra su **complemento de passkeys** en Windows automáticamente la
  primera vez que se ejecuta, tras lo cual aparece en **Settings ▸ Accounts ▸
  Passkeys ▸ Advanced options**. Activar ese interruptor depende de Windows
  y del usuario. Actualmente no se puede forzar de forma centralizada mediante MDM. La
  [guía del usuario final](/es/identity/end-user/installing-iru-access) explica ese
  paso.
</Note>

## Implementación no administrada

Para los dispositivos personales o propios del usuario (BYOD), no hay nada que configurar en un MDM.
El usuario instala Iru Access y se registra a partir de su invitación.

### macOS

Comparte
[Iru Access para macOS](https://updater.iru.com/iru-access-macOS/download)
con el usuario. Lo descarga e instala y luego se registra a partir de su
invitación. Para obtener instrucciones paso a paso, consulta
[Instalar Iru Access](/es/identity/end-user/installing-iru-access).

### iOS, iPadOS y visionOS

Comparte
[Iru Access en el App Store](https://apps.apple.com/us/app/iru-access/id6752437810)
o su enlace de invitación con el usuario. Instala la aplicación y luego se registra.

**Requisitos**

* **iOS y iPadOS:** el dispositivo debe ejecutar **18.4 o posterior**.
* **Apple Vision Pro:** instala desde el App Store como la aplicación de iPad.

Para obtener instrucciones paso a paso, consulta
[Instalar Iru Access](/es/identity/end-user/installing-iru-access).

### Windows

Comparte
[Iru Access para Windows](https://updater.iru.com/iru-access-windows/download)
con el usuario. Lo descarga e instala y luego se registra a partir de su
invitación.

**Requisitos**

* **Windows 11 24H2, 25H2 o 26H2**

Para obtener instrucciones paso a paso, consulta
[Instalar Iru Access](/es/identity/end-user/installing-iru-access).

<Note>
  Los dispositivos no administrados igualmente registran un autenticador funcional e informan de las señales
  de estado, pero **no** se reconocen como administrados. Las políticas que exigen
  el atributo administrado no se superarán en ellos. Usa una **implementación administrada** para
  los dispositivos que deban cumplir esas políticas.
</Note>

## Recursos

Ejecuta estos scripts auxiliares en un dispositivo ya inscrito en tu MDM para recopilar
los datos del servidor MDM que necesitas al crear una conexión. Ambos se mantienen
en el
[repositorio de GitHub de Iru Support](https://github.com/kandji-inc/support/tree/main/Identity).

<AccordionGroup>
  <Accordion title="macOS: recopilar el tema de APNs y la Check-in URL" icon="apple">
    El
    [script Collect MDM details de macOS](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_macos.zsh)
    lee el **tema de APNs** y la **MDM Check-in URL** de una Mac inscrita.
  </Accordion>

  <Accordion title="Windows: recopilar el Provider ID y la Discovery service URL" icon="windows">
    El
    [script Collect MDM details de Windows](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_windows.ps1)
    lee el **Provider ID** y la **Discovery service URL** del servidor MDM de una
    computadora Windows inscrita. Ejecútalo en PowerShell.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Solucionar problemas de la extensión SSO de macOS" icon="bug" href="/es/identity/authentication/troubleshoot-macos-sso">
    Diagnostica la aprobación de dominios asociados y la carga de la extensión en una Mac.
  </Card>

  <Card title="Conexiones MDM" icon="tower-broadcast" href="/es/identity/authentication/mdm-connections">
    Configura y administra la conexión que hace que un dispositivo cuente como administrado.
  </Card>

  <Card title="Confianza del dispositivo" icon="laptop" href="/es/identity/authentication/device-trust">
    Exige dispositivos administrados y en buen estado como condición de acceso.
  </Card>

  <Card title="Instalar Iru Access" icon="download" href="/es/identity/end-user/installing-iru-access">
    La guía del usuario final para configurar Iru Access en un dispositivo personal.
  </Card>

  <Card title="Autenticadores" icon="key" href="/es/identity/authentication/authenticators">
    Cómo encaja Iru Access junto a las passkeys como autenticador.
  </Card>
</CardGroup>