Conector GLPI

El Conector GLPI alimenta la CMDB de Portail ZAPP con los ordenadores, los equipos de red, las impresoras, los monitores, los periféricos y los teléfonos gestionados en GLPI (versiones 10 y 11). Portail ZAPP consulta la API REST de GLPI, directamente desde su servidor o, si GLPI no es accesible desde él, mediante un agente Outpost instalado en la red de GLPI (consulta «GLPI cerrado: modo Outpost»). Las pantallas están reservadas a los administradores; la entrada GLPI está en el menú Administración › Conectores y automatización.

El conector nunca modifica GLPI: solo lee.

Qué se importa

En cada recopilación, el conector lee los ordenadores de GLPI y crea o actualiza en la CMDB un Equipo por máquina, con:

su nombre, dominio, número de serie y UUID;
su sistema operativo y su versión;
su procesador y su memoria (suma de los módulos);
sus discos (nombre, tamaño, espacio libre), sus puertos de red (nombre, dirección MAC, dirección IP) y su software instalado (nombre, versión, editor, fecha de instalación), según los componentes elegidos para la fuente.

Las plantillas de ordenador de GLPI nunca se importan. Los objetos de la papelera de GLPI solo se importan si la fuente lo pide.

Si la fuente lo pide (Objetos de GLPI importados), el conector también lee:

los equipos de red: un Equipo de red por equipo en la CMDB, con su nombre, número de serie, tipo de equipo (Switch, Router, Cortafuegos… cuando el tipo de GLPI coincide con uno de ellos), fabricante, modelo, firmware y ubicación; con los puertos de red, sus puertos (dirección MAC e IP) y su dirección IP;
las impresoras de red: un Equipo de red de tipo Impresora, con la misma información. Una impresora sin dirección de red (USB) pasa a ser una Impresora, asociada por su número de serie;
los monitores, periféricos y teléfonos: un Monitor, un Periférico o un Dispositivo móvil, con nombre, número de serie, marca, modelo, estado e información de compra. Se asocian solo por su número de serie, nunca por su nombre: un elemento sin número de serie tiene su propia ficha;
las conexiones: si importas los ordenadores, los elementos que GLPI les conecta (pestaña «Conexiones») se vinculan al ordenador en la CMDB («conectado a»). Una conexión retirada en GLPI se retira en la siguiente recogida completa; un vínculo que hayas añadido a mano nunca se retira.

Un equipo ya encontrado por el inventario de red no se duplica: se relaciona por su número de serie, sus direcciones MAC o su nombre.

Según los campos GLPI elegidos para la fuente (ver más abajo), el conector también importa el estado, el fabricante, el modelo, las fechas de compra y de fin de garantía, el coste de compra, y cualquier otro campo de GLPI o del plugin Fields vinculado a un campo de la CMDB. Si la fuente lo pide, cada ordenador también se vincula a su ubicación en la CMDB según su ubicación GLPI (consulta «Ubicación de los ordenadores»). Si la fuente también lo pide, el usuario y el técnico GLPI de cada ordenador se emparejan con una cuenta de Portail ZAPP (consulta «Usuarios de los ordenadores»).

Un equipo ya conocido no se duplica: si otra fuente (Ivanti UEM, Intune…) ya lo importó, se relaciona por su UUID, su número de serie, sus direcciones MAC o su nombre, y sus campos se completan. Los números de serie genéricos que GLPI suele contener («To Be Filled By O.E.M.», «Default string», «0», «System Serial Number»…) y los UUID todo a cero se ignoran para la relación: dos máquinas distintas nunca se fusionan por un número de serie ficticio.

Antes de crear una fuente

En GLPI, un administrador prepara el acceso:

Activar la API REST: Configuración › General › API, marcar «Activar la API REST» y «Activar la conexión con un token externo».
Crear un cliente de API en la misma pantalla: activo, sin restricción de dirección o con la dirección del servidor de Portail ZAPP, y luego regenerar su token de aplicación (App-Token).
Crear un perfil de solo lectura: clonar el perfil Read-Only y quitarle la lectura de la Configuración general. El conector no necesita ningún derecho de escritura.
Crear un usuario dedicado con este perfil en la entidad raíz, recursiva. En su pestaña Claves de acceso remoto, marcar Regenerar junto al token de API y luego Guardar: el token solo existe una vez guardado.

En Portail ZAPP, guarda ambos tokens en el Almacén de secretos: la fuente designa cada token por el nombre de su secreto, nunca por su valor.

HTTP o HTTPS

Prefiere una dirección https://. En HTTPS, el certificado de GLPI debe ser reconocido por el servidor de Portail ZAPP: un GLPI cuyo certificado emite una autoridad interna requiere que esa autoridad esté aprobada en ese servidor. No existe ninguna opción para ignorar un error de certificado.

Una dirección http:// solo se acepta marcando Permitir HTTP sin cifrar: los tokens de GLPI viajan entonces en claro por la red. La ficha de la fuente lo muestra de forma permanente.

Por seguridad, una dirección de la propia máquina (localhost, 127.0.0.1) o una dirección de metadatos de un proveedor de nube siempre se rechaza. Las direcciones de red privada se aceptan. GLPI no puede redirigir el conector a otro servidor.

GLPI cerrado: modo Outpost

Si el servidor de Portail ZAPP no puede alcanzar GLPI (por ejemplo, Portail ZAPP alojado en línea y GLPI en tu red interna), elige un grupo de máquinas en Lectura de GLPI: un agente Outpost de ese grupo lee GLPI en lugar del servidor. Hace falta al menos un agente activo, en versión 0.5.7 o posterior, y que alcance GLPI por sí mismo.

Un solo agente del grupo trabaja en cada recopilación: el primer agente activo compatible.
Si ese agente está detenido, la solicitud falla por falta de respuesta (AgentNoReply); la sincronización se hace en la siguiente ejecución planificada, cuando la máquina vuelve.
En HTTPS, es la máquina del agente la que verifica el certificado de GLPI: la autoridad que lo emitió debe ser de confianza en ella, y el nombre de GLPI debe resolverse en ella.
Los tokens se le transmiten durante la lectura; nunca se conservan en la máquina.
El tiempo de espera se aplica a cada solicitud hecha al agente, como máximo 300 segundos.
Probar la conexión, los Campos GLPI y la recopilación funcionan igual en ambos modos; en modo Outpost, la prueba de conexión y el descubrimiento de campos nombran al agente que ha respondido.
La columna Lectura de GLPI de la lista de fuentes indica el modo de cada fuente: «Directo» u «Outpost ·

Sin el módulo Outpost, la lista aparece atenuada y solo es posible el modo directo.

Crear una fuente

La página Fuentes GLPI lista las fuentes con su dirección, su planificación y su estado. Haz clic en + Nueva fuente e indica:

Nombre y Slug (identificador corto, sin espacios; ya no se puede cambiar tras la creación);
URL de la API REST de GLPI: la dirección de apirest.php, o la raíz de GLPI (se añade apirest.php);
Permitir HTTP sin cifrar: solo para una dirección http://;
Lectura de GLPI: Modo directo (por defecto), o un grupo de máquinas Outpost si GLPI no es accesible desde el servidor (consulta «GLPI cerrado: modo Outpost»);
Secreto: token de aplicación (App-Token) y Secreto: token de API del usuario (user_token): elige los secretos en las listas. Si están vacías, el enlace crear uno abre el almacén de secretos;
Tiempo de espera de una llamada: de 5 a 600 segundos (60 por defecto);
Objetos de GLPI importados: ordenadores, equipos de red, impresoras, monitores, periféricos, teléfonos. Por defecto solo están marcados los ordenadores;
Importar también los objetos de la papelera de GLPI: desmarcado por defecto;
Componentes importados: discos, puertos de red, software instalado, todos marcados por defecto. El software es lo que más tarda en leerse: si lo desmarcas, la recopilación de un parque grande es mucho más rápida. Si el perfil de GLPI no puede leer los equipos de red, los puertos de red no se importan (los ordenadores sí);
Vincular los ordenadores a su ubicación: desmarcado por defecto (consulta «Ubicación de los ordenadores»);
Emparejar los usuarios de GLPI con las cuentas de usuario y el orden de las claves: desmarcado por defecto (consulta «Usuarios de los ordenadores»);
Vincular los contactos de la CMDB a los ordenadores: desmarcado por defecto (consulta «Conciliar los usuarios a mano»);
Planificación (cron, opcional): la frecuencia de recopilación, elegida con el asistente. Sin planificación, la fuente solo se sincroniza con «Sincronizar ahora».

Haz clic en Guardar: se abre la ficha de la fuente.

Probar la conexión

En la ficha, Probar la conexión abre una sesión en GLPI con ambos tokens, muestra la versión de GLPI y cierra la sesión. No se importa ni se guarda nada. En caso de fallo, un mensaje indica la causa (véase la tabla siguiente).

Sincronizar ahora

Sincronizar ahora (en la lista o en la ficha) lanza una recopilación en segundo plano: la pantalla responde enseguida. Una sola recopilación a la vez por fuente: un segundo clic durante una recopilación se rechaza. Una fuente desactivada no se sincroniza.

Para ir rápido, una recopilación solo vuelve a leer los objetos modificados en GLPI desde la última recopilación correcta. Lee todos los objetos:

si marcas Recopilación completa junto a «Sincronizar ahora» en la ficha;
si ninguna recopilación ha terminado bien en 7 días;
después de un cambio que lo requiere (campos GLPI, componente marcado de nuevo, tipo de objeto añadido, papelera, dirección de GLPI): la ficha indica entonces «La próxima recopilación será completa» y la casilla ya está marcada.

GLPI no siempre indica que un ordenador ha cambiado cuando solo ha cambiado su software: ese cambio se recoge como muy tarde en la recopilación completa semanal, o enseguida con Recopilación completa.

El recuadro Última recopilación de la ficha indica su estado, sus horas de inicio y fin, el número de objetos importados y de errores. Recarga la página para seguir una recopilación en curso. También indica el Modo de esa recopilación («Directo» u «Outpost ·

Ubicación de los ordenadores

Con la opción Vincular los ordenadores a su ubicación, la ubicación GLPI de cada ordenador (su ruta completa, por ejemplo «Sede > Edificio A > Sala 101») se empareja con una ubicación de la CMDB con la misma ruta, sin tener en cuenta mayúsculas ni acentos. El ordenador queda asociado a esa ubicación; si tenía otra, se sustituye.

Una ubicación que aún no existe se crea, con sus padres que faltan; los padres ya presentes se reutilizan.
Un ordenador sin ubicación en GLPI conserva la suya.
Si varias ubicaciones de la CMDB tienen la misma ruta, la ubicación es ambigua: el ordenador no se vincula y la ubicación aparece en el recuadro Última recopilación. Cambia el nombre de una de las ubicaciones para eliminar la ambigüedad.
Un cambio de ubicación en GLPI se recoge en la siguiente recopilación.
Solo se vinculan los ordenadores; los equipos de red conservan su ubicación como texto.

Usuarios de los ordenadores

Con la opción Emparejar los usuarios de GLPI con las cuentas de usuario, el usuario GLPI de un ordenador pasa a ser su usuario principal en la CMDB, y el técnico responsable su propietario. Cada usuario GLPI se empareja con una cuenta de Portail ZAPP mediante claves probadas en el orden elegido (Clave 1 a Clave 3); gana la primera que designa una sola cuenta:

Identificador de directorio AD: cuando GLPI sincroniza Active Directory mediante el identificador objectGUID, ese identificador se busca entre las cuentas sincronizadas por AdSync;
Inicio de sesión: el inicio de sesión GLPI se busca entre los de Portail ZAPP, sin tener en cuenta mayúsculas;
Dirección de correo: se busca cada dirección del usuario GLPI, sin tener en cuenta mayúsculas ni acentos.

Una clave que designa varias cuentas (dos cuentas con la misma dirección, por ejemplo) pasa a la siguiente. Una cuenta eliminada nunca se usa; una desactivada, sí.

No se crea ninguna cuenta de usuario.
Un usuario sin correspondencia deja el campo como está: nunca se vacía.
El recuadro Última recopilación cuenta los usuarios emparejados y lista los que no lo están, con el motivo («Ninguna cuenta» o «Varias cuentas») y el número de ordenadores afectados.
Cuando Intune también proporciona el usuario principal de una máquina, prevalece Intune.

Conciliar los usuarios a mano

El botón Conciliar los usuarios de la ficha abre la lista de los usuarios GLPI designados por los ordenadores: la pestaña Por tratar muestra los que las claves no han emparejado, la pestaña Todos, el conjunto. Para cada uno: inicio de sesión, nombre, direcciones, número de ordenadores, resultado del emparejamiento automático y decisión tomada.

Vincular a una cuenta: busca la cuenta por su nombre, su inicio de sesión o su dirección (sin tener en cuenta mayúsculas ni acentos) y pulsa Vincular.
Crear los contactos: para una persona sin cuenta, márcala, elige su tercero y crea el contacto; se rellena con su nombre y su dirección.
Ignorar: el usuario deja de proponerse y de contarse como sin emparejar.
Retirar la decisión: el usuario vuelve a pasar por las claves.

Las casillas permiten tratar varios usuarios a la vez. Una decisión prevalece sobre las claves y se aplica en la próxima recopilación, que será completa: lanza Sincronizar ahora para aplicarla de inmediato. Un usuario vinculado a un contacto no rellena ni el usuario principal ni el propietario; con la opción Vincular los contactos de la CMDB a los ordenadores, sus ordenadores se vinculan al contacto («usado por» para el usuario, «gestionado por» para el técnico).

Resultado de una recopilación

El recuadro Última recopilación muestra uno de estos estados:

Éxito: se importaron todos los objetos;
Éxito parcial: algunos objetos no se pudieron tratar; los demás se importan normalmente;
Error: la recopilación no importó nada; la causa se indica con un código:

Código	Significado
`AuthenticationFailed`	GLPI rechaza el token de aplicación o el token de API del usuario
`Forbidden`	El perfil GLPI del usuario no puede leer los ordenadores
`ApiDisabled`	La API REST está desactivada en GLPI
`GlpiUnavailable`	GLPI inaccesible, tiempo agotado, redirección rechazada o respuesta ilegible
`Throttled`	GLPI limita el número de llamadas; la próxima recopilación lo reintentará
`InsecureHttpRefused`	Dirección http:// sin la opción «Permitir HTTP sin cifrar»
`SecretResolutionFailed`	Uno de los secretos designados no existe o es ilegible
`SecretResolutionUnavailable`	El almacén de secretos no está instalado
`InvalidConfig`	La fuente está incompleta: edítala
`AllItemsFailed`	No se pudo tratar ningún objeto
`AlreadyRunning`	Ya hay una recopilación de esta fuente en curso
`InvalidMappings`	Dos mapeos activos apuntan al mismo campo CMDB
`CmdbFieldAdminRequired`	Crear un campo CMDB requiere el permiso de añadir campos a los tipos de la CMDB
`OutpostUnavailable`	Modo Outpost: el módulo Outpost no está instalado
`NoCompatibleAgent`	Modo Outpost: ningún agente activo y compatible con GLPI en el grupo de máquinas
`AgentNoReply`	Modo Outpost: el agente no respondió a tiempo
`UnsupportedAgentVersion`	Modo Outpost: el agente es demasiado antiguo; actualízalo
`ResultTooLarge`	Modo Outpost: un objeto GLPI es demasiado grande para que el agente lo transmita
`AgentError`	Modo Outpost: el agente rechazó la solicitud o falló

Cada fuente tiene también una tarea en el Planificador (Administración › Instancia y operaciones › Planificador), llamada Connector.Glpi: seguido del identificador de la fuente, con su Historial de ejecución.

Campos GLPI

En la ficha de la fuente, Gestionar los campos abre la página Campos GLPI. Un distintivo en la ficha señala los campos aparecidos en GLPI desde tu último descubrimiento.

Mapeos. La tabla vincula cada campo GLPI a un campo de la CMDB; sus filas se agrupan por tipo de objeto de GLPI (un tipo que la fuente no importa se señala como «Tipo no recopilado»). En cada fila puedes:

desactivarla (casilla Activo) o quitarla (casilla Quitar);
elegir el campo CMDB de destino;
elegir una transformación: ninguna, quitar espacios, número, fecha, o correspondencias (una línea valor GLPI = valor CMDB por valor);
en una lista de opciones, decidir qué hacer con un valor que no es una opción conocida: ignorarlo o añadir la opción.

Haz clic en Guardar. El estado de cada fila indica si se aplicará: solo se aplican las filas válidas, y una recopilación nunca crea un campo. El nombre, el número de serie y el UUID siguen siempre activos: sirven para reconocer las máquinas. Restablecer los mapeos predeterminados vuelve a la configuración original.

Descubrir los campos. Este botón lee la lista de campos de GLPI y una muestra de 50 objetos de cada tipo importado, sin modificar nada. Para cada campo, la página muestra ejemplos de valores, su estado (mapeado, descartado, nuevo), y propone un slug y un tipo de campo CMDB. Marca los campos que quieres recuperar y luego:

Crear o mapear la selección: para cada campo marcado, deja «crear un campo nuevo» para añadir el campo propuesto al tipo Equipo de la CMDB (o Equipo de red para un campo de equipo de red o de impresora, Monitor, Periférico o Dispositivo móvil para un campo de monitor, periférico o teléfono), o elige un campo existente. Tras confirmar, un informe indica los campos creados, ya existentes o rechazados. Crear un campo requiere el permiso de añadir campos a los tipos de la CMDB; sin él, solo se te propone elegir un campo existente;
Descartar la selección: esos campos ya no se proponen ni se señalan como nuevos. Volver a proponer la selección, al pie de la página, lo deshace.

Los campos nuevos se importan en la siguiente recopilación.

Activar, modificar, eliminar

El botón de la columna Activada (Sí / No) activa o suspende la fuente y su recopilación planificada.
Editar abre la ficha; vaciar la planificación elimina la recopilación planificada, la sincronización manual sigue siendo posible.
La papelera elimina la fuente y su tarea planificada, tras confirmación. Los objetos ya importados permanecen en la CMDB.