Skip to main content

Configuración de las claves del Registro en el inventario


1. Objetivo

Esta configuración permite definir las claves del Registro de Windows que el agente de máquina debe capturar y enviar durante el inventario.


2. Configuración del servidor

En este caso son necesarias dos modificaciones: una para los agentes ya instalados y otra para las futuras máquinas.

Configuración que debe realizarse para los agentes ya instalados:

Edite el archivo:

/etc/mmc/plugins/inventoryconf.ini

Edite el siguiente archivo para actualizar los puestos de trabajo ya existentes:

/var/lib/pulse2/xmpp_baseplugin/plugin_updatesettings.py

Ejemplo (línea 20):

param_1 = "del@__@startupdate.ini@__@plugins@__@liststartplugin"
param_2 = "add@__@inventoryconf.ini@__@parameters@__@reg_key_1@__@HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled"
param_3 = "add@__@inventoryconf.ini@__@parameters@__@reg_key_2@__@HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion"
nb_params = 3

Configuración que debe realizarse para los futuros puestos de trabajo:

Edite el archivo:

/var/lib/pulse2/client/inventory.ini

Regenere el agente:

/var/lib/pulse2/client/generate-pulse-agent.sh

Añada o modifique la sección [parameters]:

[parameters]

# Registry keys that need to be pushed in an inventory

# Format:
# reg_key_x = path_to_key|key_label_shown_in_mmc

# Exemple :
# reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled
# reg_key_2 = HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion

# Nombre total de clés configurées
# max_key_index = 2

reg_key_1 = \chemin\vers\la\cle|nom à associer


Formato de una clave

Cada clave debe respetar el siguiente formato:

reg_key_X = ruta_de_la_clave|nombre_mostrado

Ejemplo:

reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled

  • reg_key_1: identificador de la clave que se va a capturar.
  • HKEY_LOCAL_MACHINE\...: ruta de la clave del Registro de Windows.
  • LUAEnabled: nombre asociado a la clave, que se utiliza para identificarla en la interfaz.

3. Parámetro max_key_index

El parámetro:

max_key_index = 2

corresponde al número de claves del Registro configuradas.

Por ejemplo, para dos claves:

reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled
reg_key_2 = HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion
max_key_index = 2

Para tres claves:

reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled
reg_key_2 = HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion
reg_key_3 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\...|MaCle
max_key_index = 3


Importante: max_key_index debe coincidir con el último índice utilizado en la configuración.


4. Caso particular: HKEY_CURRENT_USER

Cuando una clave se encuentra en:

HKEY_CURRENT_USER

se debe especificar el usuario en cuestión mediante el parámetro:

current_user = nombre_de_usuario

Ejemplo:

[parameters]

reg_key_1 = HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\...|MaCle
max_key_index = 1

current_user = monUser

En este ejemplo, la clave se buscará en el perfil del usuario:

monUser


¿Por qué especificar current_user?

HKEY_CURRENT_USER depende del perfil de usuario cargado actualmente.

El parámetro:

current_user = monUser


permite, por tanto, indicar al agente qué usuario debe utilizarse para recuperar las claves presentes en HKEY_CURRENT_USER.

En el caso de las claves ubicadas en HKEY_LOCAL_MACHINE, el parámetro current_user no es necesario.


5. Ejemplo completo

A continuación se muestra un ejemplo con dos claves del Registro:

  • Una clave ubicada en HKEY_LOCAL_MACHINE
  • Una clave ubicada en HKEY_CURRENT_USER
[parameters]

# Registry keys that need to be pushed in an inventory

reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled
reg_key_2 = HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced|Exemple

max_key_index = 2

current_user = siveo


6. Ejemplo solo con HKEY_LOCAL_MACHINE

Si todas las claves que se deben recuperar se encuentran en HKEY_LOCAL_MACHINE, la configuración puede realizarse sin current_user.

[parameters]

reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled
reg_key_2 = HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion

max_key_index = 2

7. Ejemplo solo con HKEY_CURRENT_USER

Si las claves se encuentran en HKEY_CURRENT_USER, es necesario especificar el usuario en cuestión.

[parameters]

reg_key_1 = HKEY_CURRENT_USER\Software\MonApplication\Configuration\Version|ApplicationVersion
reg_key_2 = HKEY_CURRENT_USER\Software\MonApplication\Configuration\Mode|ApplicationMode

max_key_index = 2

current_user = siveo


8. Tablas de GLPI afectadas

Los datos obtenidos de la recopilación de claves del Registro se almacenan en diferentes tablas de GLPI.

En GLPI 10.0, las tablas afectadas son las siguientes.

8.1. Collect

Complemento Tabla
FusionInventory glpi_plugin_fusioninventory_collects
GLPI Inventory glpi_plugin_glpiinventory_collects

8.2. Registries

Complemento Tabla
FusionInventory glpi_plugin_fusioninventory_collects_registries
GLPI Inventory glpi_plugin_glpiinventory_collects_registries

8.3. RegContent

Complemento Tabla
FusionInventory glpi_plugin_fusioninventory_collects_registries_contents
GLPI Inventory glpi_plugin_glpiinventory_collects_registries_contents

8.4. Correspondencia de tablas

Por lo tanto, las tablas varían en función del complemento utilizado.

FusionInventory
glpi_plugin_fusioninventory_collects
glpi_plugin_fusioninventory_collects_registries
glpi_plugin_fusioninventory_collects_registries_contents


GLPI Inventory
glpi_plugin_glpiinventory_collects
glpi_plugin_glpiinventory_collects_registries
glpi_plugin_glpiinventory_collects_registries_contents


Las tablas que deben utilizarse dependen del complemento de inventario que se utilice en el entorno.



9. Comprobación en la base de datos

Para comprobar si existen las tablas:

SHOW TABLES LIKE '%collect%';

Para comprobar las tablas relacionadas con el Registro:

SHOW TABLES LIKE '%registr%';


También es posible comprobar directamente las tablas en cuestión:

SHOW TABLES LIKE 'glpi_plugin_glpiinventory_collects%';

o:

SHOW TABLES LIKE 'glpi_plugin_fusioninventory_collects%';


10. Ejemplo de configuración completa

Ejemplo con dos claves:

[parameters]

# Registry keys that need to be pushed in an inventory

# Key permettant de récupérer l'état de l'UAC
reg_key_1 = HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA|LUAEnabled

# Key permettant de récupérer le nom du produit Windows
reg_key_2 = HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\ProductName|WindowsVersion

# Nombre de clés configurées
max_key_index = 2

A continuación, los valores se transmitirán durante el inventario del agente de máquina.

11. Resumen

Parámetro Función
reg_key_1 Primera clave de registro que se debe capturar
reg_key_2 Segunda clave de registro que se debe capturar
reg_key_X Clave de registro adicional
max_key_index Número total de claves configuradas
current_user Usuario asociado a las claves HKEY_CURRENT_USER

Formato general:

reg_key_X = ruta_de_la_clave|nombre_mostrado