Conector Ivanti UEM

El Conector Ivanti UEM alimenta la CMDB de Portail ZAPP con el inventario de las máquinas gestionadas por un servidor Ivanti UEM. Ese servidor suele estar instalado en tu red y no es accesible desde fuera: la recopilación pasa por los agentes Outpost instalados en tus instalaciones, que consultan el servidor Ivanti y devuelven el resultado. Las pantallas están reservadas a los administradores; la entrada Ivanti UEM está en el menú Administración › Conectores y automatización.

Ivanti UEM designa aquí la consola instalada en tus servidores (Ivanti EPM, Endpoint Manager). Para la plataforma en línea de Ivanti, consulta la página «Conector Ivanti Neurons».

Qué se importa

Para cada máquina de la consulta Ivanti elegida, el conector crea o actualiza, en la CMDB, un Equipo (nombre, dominio, sistema operativo, procesador, memoria) con sus Discos, sus Adaptadores de red y su Software instalado. La información realmente devuelta depende de la definición de columnas preparada en la consola Ivanti (ver más abajo): una columna ausente de esa definición no se importa.

Una máquina ya conocida no se duplica: si otra fuente (por ejemplo el conector Intune) ya la importó, se empareja por su número de serie, sus direcciones MAC o su nombre, y sus campos se completan. Para el número de serie y el modelo, Ivanti UEM prevalece sobre Intune, porque lee el hardware directamente. El conector Ivanti no rellena el Usuario principal.

Las máquinas importadas se consultan en la CMDB, tipo Equipo.

Antes de crear una fuente

• En Portail ZAPP, un grupo de máquinas Outpost (menú Administración › Conectores y automatización › Outpost › Grupos de máquinas) contiene el agente o los agentes que harán la recopilación. Los agentes deben poder llegar al servidor Ivanti.
• En la consola Ivanti, el administrador de Ivanti ha creado una definición de columnas (fija la información devuelta: BIOS, procesador, memoria, almacenamiento, red, software…) y, preferentemente, una consulta que selecciona las máquinas que se inventariarán.
• Una cuenta de servicio de Ivanti autorizada a leer el inventario; su contraseña se guarda en el Almacén de secretos de Portail ZAPP. La fuente designa ese secreto por su nombre, nunca por su valor.

Crear una fuente

La página Fuentes Ivanti UEM 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);
• Grupo de máquinas: la recopilación se activa en cada agente miembro del grupo;
• URL del servicio web MBSDK: la dirección completa del servicio web de Ivanti, con la ruta, por ejemplo https://ivanti.example.local/MBSDKService/MsgSDK.asmx — no solo el nombre del servidor;
• Cuenta de servicio de Ivanti y Secreto (contraseña de la cuenta);
• Nombre de la definición de columnas Ivanti, tal como está escrito en la consola Ivanti;
• Filtro de lista de máquinas de Ivanti: el nombre de la consulta Ivanti que se inventariará. Puedes escribirlo, o hacer clic en Cargar la lista para obtener las consultas del servidor Ivanti (rellena antes el grupo de máquinas, la dirección, la cuenta y el secreto). Si la carga falla («El agente no respondió a tiempo.», «Este grupo de máquinas no contiene ningún agente.»…), el campo conserva su valor y sigue siendo editable; «Ningún agente activo en este grupo de máquinas: sus miembros están revocados, en cuarentena o archivados.» señala un grupo que tiene máquinas, pero ninguna activa: reactiva una de ellas o añade al grupo un agente activo;
• Tiempo de espera de Ivanti (segundos): 30 por defecto;
• 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.

Activar, modificar, eliminar

• El botón de la columna Activada 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. Las máquinas ya importadas permanecen en la CMDB.

Desarrollo de una recopilación

1. A la hora prevista, Portail ZAPP envía la solicitud de recopilación a cada agente del grupo, uno tras otro. Cada agente hace su propia recopilación, sin agrupación entre agentes. Un grupo vacío no produce ninguna recopilación y no es un error.
2. Los agentes trabajan en segundo plano. Cada 2 minutos, la tarea IvantiInventoryPollCollection recoge las recopilaciones terminadas e integra sus máquinas en la CMDB. Una máquina ilegible no impide integrar las demás.

Seguir las recopilaciones

La página Modificar de una fuente muestra su Actividad de la fuente:

• Último inicio planificado: inicio, estado y, en caso de fallo, la explicación;
• Últimas recopilaciones: una línea por agente y por recopilación (inicio, estado, máquinas importadas, errores), con el código del fallo y su explicación en tu idioma.

Cada fuente programada crea también una tarea en el Planificador (Administración › Instancia y operaciones › Planificador), llamada Connector.IvantiUEM: seguido del identificador de la fuente. Su ficha permite Disparar ahora una recopilación y muestra el Historial de ejecución:

• Success: las solicitudes de recopilación se enviaron a los agentes del grupo. El resultado de las recopilaciones aparece en la actividad de la fuente y en la CMDB, después de que pase la tarea IvantiInventoryPollCollection. Atención: si el grupo ya no contiene ningún agente (o se eliminó), la tarea también tiene éxito, sin recopilar nada — comprueba el grupo si no llega ninguna máquina;
• Error: la recopilación no pudo empezar; el historial da la explicación (ver «Resolución de problemas»).

La tarea IvantiInventoryPollCollection termina en PartialSuccess cuando una recopilación recogida ha fallado: su historial da la causa. Si fallaron varias recopilaciones, indica su número y el detalle por fuente: abre la actividad de cada fuente.

Resolución de problemas

Cada fallo lleva un código estable (usado por la API y las exportaciones, seguido de una frase en inglés) y una explicación en el idioma del usuario. El detalle técnico (mensaje del agente, respuesta del servidor Ivanti) nunca se muestra: se escribe en el registro del servidor y en el del agente.

Un agente Outpost actualizado envía él mismo el código de la causa y el estado HTTP: la explicación ya no depende del texto de su mensaje. Con un agente más antiguo, la causa se deduce de ese texto, como antes.

Un código que no figura en esta tabla se muestra como «Fallo de la recopilación: código»; un error imprevisto se muestra como «Error inesperado» con su tipo, y el detalle queda en el registro del servidor.