Configuration des clés de registre dans l'inventaire

1. Objectif

Cette configuration permet de définir les clés de registre Windows à capturer par l'agent machine et à remonter lors de l'inventaire.

Les clés sont configurées depuis le serveur Medulla dans le fichier :

/etc/mmc/plugins/inventoryconf.ini

 

2. Configuration du serveur

Éditer le fichier :

/etc/mmc/plugins/inventoryconf.ini

Ajouter ou modifier la section [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

Format d'une clé

Chaque clé doit respecter le format suivant :

reg_key_X = chemin_de_la_clé|nom_affiché

Exemple :

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

• reg_key_1 : identifiant de la clé à capturer.
• HKEY_LOCAL_MACHINE\... : chemin de la clé de registre Windows.
• LUAEnabled : nom associé à la clé, utilisé pour l'identifier dans l'interface.

---

3. Paramètre max_key_index

Le paramètre :

max_key_index = 2

correspond au nombre de clés de registre configurées.

Par exemple, pour deux clés :

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

Pour trois clés :

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

Important : max_key_index doit correspondre au dernier index utilisé dans la configuration.

---

4. Cas particulier : HKEY_CURRENT_USER

Lorsqu'une clé se trouve dans :

HKEY_CURRENT_USER

l'utilisateur concerné doit être précisé avec le paramètre :

current_user = nom_utilisateur

Exemple :

[parameters]

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

current_user = monUser

Dans cet exemple, la clé sera recherchée dans le profil de l'utilisateur :

monUser

Pourquoi préciser current_user ?

HKEY_CURRENT_USER dépend du profil utilisateur actuellement chargé.

Le paramètre :

current_user = monUser

permet donc d'indiquer à l'agent quel utilisateur doit être utilisé pour récupérer les clés présentes dans HKEY_CURRENT_USER.

Pour les clés situées dans HKEY_LOCAL_MACHINE, le paramètre current_user n'est pas nécessaire.

---

5. Exemple complet

Voici un exemple avec deux clés de registre :

• Une clé située dans HKEY_LOCAL_MACHINE
• Une clé située dans 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. Exemple avec uniquement HKEY_LOCAL_MACHINE

Si toutes les clés à récupérer sont situées dans HKEY_LOCAL_MACHINE, la configuration peut être réalisée sans 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. Exemple avec uniquement HKEY_CURRENT_USER

Si les clés sont situées dans HKEY_CURRENT_USER, il faut préciser l'utilisateur concerné.

[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. Tables GLPI concernées

Les données issues de la collecte des clés de registre sont stockées dans différentes tables GLPI.

Pour GLPI 10.0, les tables concernées sont les suivantes.

8.1. Collect

---

8.2. Registries

---

8.3. RegContent

---

8.4. Correspondance des tables

Selon le plugin utilisé, les tables sont donc différentes.

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

Les tables à utiliser dépendent du plugin d'inventaire utilisé sur l'environnement.

---

9. Vérification en base de données

Pour vérifier la présence des tables :

SHOW TABLES LIKE '%collect%';

Pour vérifier les tables liées aux registres :

SHOW TABLES LIKE '%registr%';

Il est également possible de vérifier directement les tables concernées :

SHOW TABLES LIKE 'glpi_plugin_glpiinventory_collects%';

ou :

SHOW TABLES LIKE 'glpi_plugin_fusioninventory_collects%';

 

10. Exemple de configuration complète

Exemple avec deux clés :

[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

Les valeurs seront ensuite remontées lors de l'inventaire de l'agent machine.

 

11. Résumé

Format général :

reg_key_X = chemin_de_la_clé|nom_affiché