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

# Solución de problemas de check-in del agente

> Diagnostica y resuelve los errores de check-in del Iru Agent en macOS y Windows. Soluciona problemas de red, errores de certificados y problemas de conectividad.

<Callout icon="list-check" color="#B84A7A" iconType="regular">Esta guía se aplica a las computadoras Mac y Windows</Callout>

### Acerca de los problemas de check-in del agente

Las computadoras macOS y Windows inscritas en Iru Endpoint usan el Iru Agent para diversas tareas de administración. El agente intenta realizar un check-in cada 15 minutos. Si un dispositivo no realiza check-ins como se espera, los siguientes pasos pueden ayudar a restablecer la comunicación.

<Note>
  A partir del **8 de abril de 2026**, las apps se actualizaron de la marca **Kandji** <img className="inline dark:hidden" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-light-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=3ac73eb9098c090ac2838a4902a70e35" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-light-icon.png" /><img className="hidden dark:inline" src="https://mintcdn.com/iru/20OhJ3wZmF4DKbOd/assets/media/images/kandji-bee-dark-icon.png?fit=max&auto=format&n=20OhJ3wZmF4DKbOd&q=85&s=1d4b643c8e1903aabdb072fdf211f2de" alt="" style={{ height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 0.05em' }} width="400" height="284" data-path="assets/media/images/kandji-bee-dark-icon.png" /> a la marca **Iru** <img src="https://mintcdn.com/iru/8j4H0SpqtcKJ5JUM/assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg?fit=max&auto=format&n=8j4H0SpqtcKJ5JUM&q=85&s=befa6ce99e1df18d397deb65aec8edaf" alt="" style={{ display: 'inline', height: '1em', width: 'auto', maxHeight: '1em', verticalAlign: '-0.125em', margin: '0 -0.08em 0 0', padding: 0 }} width="14" height="15" data-path="assets/media/svgs/Iru-Logomark-OnLight-16-Dashboard.svg" />. Los nombres de las apps cambiaron de **Kandji Self Service** a **Iru Self Service** y de **Kandji Agent** a **Iru Agent**. El portal de inscripción manual ahora usa la marca Iru. Actualiza los **scripts, automatizaciones y utilidades** que todavía hagan referencia a los nombres antiguos de las apps.
</Note>

### Cómo funciona

El Iru Agent se comunica con los servidores de Iru Endpoint para recibir actualizaciones de configuración, cambios de políticas e implementaciones de aplicaciones. Cuando los check-ins fallan, es posible que los dispositivos no reciban actualizaciones importantes, lo que provoca problemas de cumplimiento o configuraciones desactualizadas.

### Comprobar la conectividad a Internet

Asegúrate de que el dispositivo tenga una conexión a Internet activa con acceso a los dominios y puertos indicados en [Uso de Iru en redes empresariales](/es/iru/requirements/using-iru-on-enterprise-networks).

Como paso rápido de solución de problemas:

* Prueba a conectar el dispositivo a otra red, como un punto de acceso móvil
* Si los check-ins se reanudan, es posible que el problema esté en la configuración de filtrado o del firewall de la red original

### Solución de problemas por plataforma

<Tabs>
  <Tab title="macOS" icon="apple" iconType="brands">
    ### Forzar un check-in (macOS)

    #### Self Service

    * Los usuarios finales pueden abrir **Iru Self Service**, ir a **Device Info** y seleccionar **Sincronizar**

    #### Línea de comandos

    * Ejecuta el siguiente comando en **Terminal** para forzar un check-in:

    ```bash theme={null}
    sudo iru run -F
    ```

    La salida puede proporcionar detalles adicionales.

    ### Reinstalar el Iru Agent

    En macOS, puedes reinstalar el Iru Agent desde la app web de Iru:

    <Steps>
      <Step title="Accede al registro del dispositivo">
        En la app web de Iru, ve al registro del dispositivo
      </Step>

      <Step title="Reinstala el agente">
        En el Menú de acciones del dispositivo, selecciona **Reinstall Agent**
      </Step>

      <Step title="Supervisa el estado de la instalación">
        Supervisa el estado desde la pestaña **Actividad**. Busca el comando MDM `InstallEnterpriseApplication`
      </Step>
    </Steps>

    <Note>
      Si el comando devuelve **NotNow** (el dispositivo está ocupado):

      * Asegúrate de que el Mac tenga un usuario con la sesión iniciada y esté conectado a la corriente y, a continuación, vuelve a intentarlo. Consulta la [documentación para desarrolladores de Apple](https://developer.apple.com/documentation/devicemanagement/implementing_device_management/handling_notnow_status_responses)
    </Note>

    ### Consideraciones sobre el reinicio

    * Después de un reinicio, Iru puede esperar hasta 30 minutos para realizar un check-in, lo que permite a macOS terminar las actualizaciones y las tareas en segundo plano

    ### Verificación del estado del agente

    Comprueba el estado del agente:

    ```bash theme={null}
    sudo iru library --state
    ```
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    ### Forzar un check-in (Windows)

    #### Reiniciar el servicio Iru Agent

    * Haz clic con el botón derecho en el icono de **Windows** y selecciona **Run**
    * Escribe `services.msc` y pulsa **Enter**
    * Busca **Iru Agent** en la lista de servicios
    * Haz clic con el botón derecho en **Iru Agent** y selecciona **Reiniciar**

    Esto forzará un check-in inmediato.

    #### Línea de comandos

    * Ejecuta el siguiente comando en **PowerShell** como administrador:

    ```powershell theme={null}
    dsregcmd /status
    ```

    ### Reinstalar el Iru Agent

    En Windows, puedes enviar cualquier app o política nueva al dispositivo, o volver a inscribirlo para que el agente se pueda instalar.

    ### Consideraciones sobre el reinicio

    * Los check-ins suelen reanudarse dentro del ciclo de 15 minutos del agente

    ### Consultar los registros del agente

    Los registros del agente se encuentran en:

    ```
    %ProgramData%\kandji\agent\logs
    ```

    ### Verificación del estado del agente

    Comprueba el estado del agente en:

    * **Configuración** > **Cuentas** > **Access work or school**
    * **Event Viewer** > **Applications and Services Logs** > **Microsoft** > **Windows** > **DeviceManagement-Enterprise-Diagnostics-Provider**
  </Tab>
</Tabs>

### Reiniciar

Reiniciar el dispositivo puede resolver un proceso bloqueado y permitir que el Iru Agent reanude el check-in normal.

### Volver a inscribir

Si los pasos anteriores no resuelven el problema, vuelve a inscribir el dispositivo manualmente.

<Steps>
  <Step title="Quita la inscripción existente">
    Quita la inscripción de MDM existente
  </Step>

  <Step title="Vuelve a inscribir el dispositivo">
    Vuelve a inscribirlo con el **Código de inscripción** correcto
  </Step>
</Steps>

<Note>
  Asegúrate de seleccionar el Blueprint correcto al inscribir un dispositivo. Si se selecciona otro Blueprint, el dispositivo aplicará los Library Items y parámetros asignados a ese Blueprint. El registro del dispositivo no se duplicará después de volver a inscribirlo. Iru Endpoint vincula la nueva inscripción con el registro del dispositivo existente.
</Note>

### Solución de problemas avanzada

Revisa los registros en busca de:

* Errores de instalación
* Fallos de políticas
* Problemas de comunicación
* Problemas de conectividad de red

### Diagnóstico de red

<Steps>
  <Step title="Prueba la conectividad">
    Usa herramientas de diagnóstico de red para probar la conectividad con los servicios de Iru
  </Step>

  <Step title="Comprueba el firewall">
    Verifica que las reglas del firewall permitan la comunicación con los dominios de Iru
  </Step>

  <Step title="Prueba el DNS">
    Asegúrate de que la resolución DNS funcione para los dominios de Iru
  </Step>

  <Step title="Comprueba el proxy">
    Verifica la configuración del proxy, si corresponde
  </Step>
</Steps>

### Problemas habituales y soluciones

<AccordionGroup>
  <Accordion title="El agente no responde">
    **Síntomas:**

    * El dispositivo aparece como desconectado en Iru
    * No hay check-ins recientes en el registro del dispositivo
    * Las políticas no se aplican

    **Soluciones:**

    * Comprueba la conectividad a Internet
    * Reinicia el dispositivo
    * Fuerza un check-in manual
    * Reinstala el agente si es necesario
  </Accordion>

  <Accordion title="Los check-ins fallan">
    **Síntomas:**

    * Mensajes de error en los registros del agente
    * Problemas de conectividad de red
    * El firewall bloquea la comunicación

    **Soluciones:**

    * Verifica la conectividad de red
    * Comprueba las reglas del firewall
    * Prueba con otra red
    * Revisa los registros del agente en busca de errores específicos
  </Accordion>

  <Accordion title="Problemas de instalación del agente">
    **Síntomas:**

    * El agente no se instala después de la inscripción
    * Errores de instalación en los registros
    * El dispositivo no aparece en Iru

    **Soluciones:**

    * Verifica que el dispositivo cumpla los requisitos
    * Comprueba la conectividad de red durante la inscripción
    * Revisa los registros de instalación
  </Accordion>
</AccordionGroup>

### Prácticas recomendadas

<CardGroup cols={2}>
  <Card title="Supervisa regularmente" icon="eye">
    Supervisa regularmente el estado del check-in de los dispositivos para identificar problemas a tiempo
  </Card>

  <Card title="Prueba la conectividad" icon="wifi">
    Prueba la conectividad de red con los servicios de Iru desde los dispositivos administrados
  </Card>

  <Card title="Revisa los registros" icon="file-text">
    Revisa regularmente los registros del agente en busca de posibles problemas
  </Card>

  <Card title="Documenta los problemas" icon="book">
    Documenta los problemas recurrentes y sus soluciones para consultarlos en el futuro
  </Card>
</CardGroup>