Conector Microsoft Intune

El Conector Intune alimenta la CMDB de Portail ZAPP con los equipos Windows gestionados por Microsoft Intune. Portail ZAPP consulta directamente el servicio de Microsoft (Microsoft Graph): no hay ningún agente que instalar. Las pantallas están reservadas a los administradores; la entrada Microsoft Intune está en el menú Administración › Conectores y automatización.

Qué se importa

En cada recopilación, el conector lee los dispositivos Windows inscritos en Intune (los dispositivos iOS, Android o macOS no se importan) y crea o actualiza, en la CMDB:

• un Equipo por dispositivo: nombre, número de serie, sistema operativo y su versión, Usuario principal;
• un Disco, llamado «Intune», con la capacidad y el espacio libre del dispositivo (Intune no da el detalle por volumen);
• un Adaptador de red «Wi-Fi» y otro «Ethernet» cuando el dispositivo comunica su dirección MAC.

No se importan el software instalado, el fabricante, el modelo ni el estado de cumplimiento.

Un equipo ya conocido no se duplica: si otra fuente (por ejemplo el conector Ivanti UEM) ya lo importó, se empareja por su número de serie, sus direcciones MAC o su nombre, y sus campos se completan. Cuando dos fuentes dan valores distintos, Intune prevalece para el usuario principal; para el número de serie, una fuente que lee el hardware directamente (Ivanti UEM) va antes que Intune. El modelo nunca procede de Intune: lo rellena otra fuente.

Usuario principal: la dirección de correo que da Intune se busca entre las cuentas de Portail ZAPP, sin distinguir mayúsculas ni acentos. Si ninguna cuenta coincide, o si varias cuentas comparten la dirección, el campo no se modifica; el equipo se importa de todos modos.

Los equipos importados se consultan en la CMDB, tipo Equipo.

Antes de crear una fuente

En el lado de Microsoft, un administrador de tu directorio prepara el acceso:

1. En el portal de Microsoft Entra, registra una aplicación (inquilino único).
2. Le concede el permiso de aplicación de Microsoft Graph DeviceManagementManagedDevices.Read.All, con el consentimiento del administrador.
3. Crea un secreto de cliente para esa aplicación y anota el ID de directorio (inquilino) y el ID de aplicación (cliente), que aparecen en la página Información general del registro.

En Portail ZAPP, guarda el valor del secreto de cliente en el Almacén de secretos: la fuente designa ese secreto por su nombre, nunca por su valor.

Crear una fuente

La página Fuentes de Microsoft Intune lista las fuentes con su nombre, su slug, su planificación y su estado. Haz clic en + Nueva fuente e indica:

• Nombre y Slug (identificador corto; ya no se puede modificar después de la creación);
• ID de directorio (inquilino) e ID de aplicación (cliente): dos GUID, por ejemplo 00000000-0000-0000-0000-000000000000; cualquier otro valor se rechaza al guardar;
• Secreto (secreto de cliente de la aplicación): elige el secreto en la lista. Si la lista está vacía, el enlace crear uno lleva al almacén de secretos;
• Planificación (cron, opcional): la frecuencia de recopilación, elegida con el asistente. Sin planificación, la fuente nunca se activa automáticamente.

Haz clic en Guardar. Una planificación no válida se rechaza y no se crea nada.

Activar, modificar, eliminar

• El botón de la columna Activada (Sí / No) activa o suspende la fuente y su recopilación programada.
• Editar abre el mismo formulario; vaciar la planificación elimina la recopilación programada.
• La papelera elimina la fuente y su recopilación programada, tras confirmación. Los equipos ya importados permanecen en la CMDB.

Seguir las recopilaciones

Cada fuente programada crea una tarea en el Planificador (Administración › Instancia y operaciones › Planificador), llamada Connector.Intune: seguido del identificador de la fuente. Su ficha permite Disparar ahora una recopilación y muestra el Historial de ejecución, donde cada recopilación indica el número de dispositivos tratados y de errores (N dispositivo(s), M error(es)):

• Success (verde): se importaron todos los dispositivos;
• PartialSuccess (naranja): algunos dispositivos no se pudieron tratar; los demás se importan con normalidad;
• Error (rojo): la recopilación no importó nada — o ningún dispositivo se pudo tratar, o la recopilación no pudo empezar; en este segundo caso, el mensaje es un código:

Una recopilación que no encuentra ningún equipo Windows es correcta, con 0 dispositivos.