# Configurer NSClient++ pour le modèle OS-Windows-NRPE-2-Disks

## 1. Objectif

Cette procédure décrit la configuration de l'agent NSClient++ sur un serveur Windows afin de permettre sa supervision par Centreon au moyen du protocole NRPE.

## 2. Emplacement du fichier de configuration

Le fichier de configuration NSClient++ se trouve sur le serveur Windows à superviser :

* `C:\Program Files\NSClient++\nsclient.ini`

Il est recommandé d'ouvrir ce fichier avec Notepad++ pour faciliter la modification et l'enregistrement des paramètres.

## 3. Configuration de base

Les paramètres suivants doivent être présents dans le fichier `nsclient.ini`.

**Section `[/modules]`**

```ini
[/modules]
CheckSystem = 1
CheckDisk = 1
CheckExternalScripts = 1
NRPEServer = 1
```

**Section `[/settings/default]`**

```ini
[/settings/default]
; Adresse IP du collecteur/poller Centreon
allowed hosts = 127.0.0.1,<IP_DU_POLLER>
timeout = 60
```

**Section `[/settings/NRPE/server]`**

```ini
[/settings/NRPE/server]
allow arguments = true
allow nasty characters = true
port = 5666
use ssl = false
insecure = true
timeout = 60
```

## 4. Description des paramètres

### 4.1 Section [/module]

Cette section permet d'activer (`1`) ou de désactiver (`0`) les différents modules de l'agent NSClient++.

#### CheckSystem = 1

Active le module de supervision système. Il permet à Centreon de contrôler :

* L'utilisation du processeur (CPU).
* La consommation de la mémoire vive (RAM).
* L'état des services Windows.

#### CheckDisk = 1

Active le module de supervision du stockage. Il est indispensable pour surveiller :

* L'espace disque disponible.
* L'utilisation des volumes.

#### CheckExternalScripts = 1

Autorise l'exécution de scripts externes présents sur le serveur Windows, tels que :

* Scripts PowerShell.
* Scripts Batch (`.bat`).
* Scripts personnalisés.

#### NRPEServer = 1

Active le serveur NRPE intégré à NSClient++. Ce service permet au poller Centreon d'interroger le serveur Windows au moyen du protocole NRPE (Nagios Remote Plugin Executor).

### 4.2 Section [/settings/default]

Cette section définit les paramètres généraux de communication.

#### allowed hosts

Exemple :

allowed hosts = 127.0.0.1, 192.168.1.10

Dans cet exemple, seul le poller Centreon dont l'adresse IP est `192.168.1.10` pourra envoyer des requêtes NRPE.

#### Délai d'attente par défaut (`timeout = 60`)

Définit le délai maximal d'attente d'une requête avant expiration.

### 4.3 Section [/settings/NRPE/server]

Cette section configure le fonctionnement du serveur NRPE.

#### allow arguments = true

Autorise le poller Centreon à transmettre des arguments dynamiques aux commandes exécutées sur le serveur. N'activer cette option que si elle est nécessaire et limiter l'accès au service NRPE aux pollers autorisés.

Exemple :

* Seuil d'alerte CPU à 80 %.
* Seuil d'espace disque libre à 10 %.

#### allow nasty characters = true

Autorise l'utilisation de caractères spéciaux dans les arguments transmis par Centreon.

Exemples :

* `-`
* `$`
* `|`
* `&`

Ce paramètre est souvent nécessaire pour certains scripts ou commandes avancées.

#### port = 5666

Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes. Le port standard NRPE est :

* `5666/TCP`

#### use ssl = false

Désactive le chiffrement SSL des échanges entre Centreon et NSClient++. Les données transitent donc en clair sur le réseau ; réserver cette configuration à un réseau de confiance.

#### insecure = true

Désactive certaines vérifications de sécurité liées aux certificats et aux protocoles de chiffrement. Cette option ne chiffre pas les échanges et ne remplace pas une configuration réseau sécurisée.

#### Délai d'attente NRPE (`timeout = 60`)

Détermine le délai maximum accordé à l'exécution d'une requête NRPE avant expiration.

## 5. Redémarrage du service

Après avoir enregistré les modifications dans `nsclient.ini`, redémarrer le service NSClient++ pour appliquer la nouvelle configuration. Cette opération peut être effectuée :

* Depuis la console des services Windows (`services.msc`).
* Depuis une invite de commandes ouverte en tant qu'administrateur.

```bat
net stop nscp
net start nscp
```

## 6. Configuration Centreon

Après la configuration de l'agent NSClient++, il est nécessaire de modifier les paramètres de l'hôte supervisé dans Centreon.

### Macro personnalisée

Dans les macros personnalisées de l'hôte, renseigner la valeur suivante :

```text
Macro : NRPEEXTRATIONS
Valeur : -n -2 -t 30
```

#### Description des options

* **`-n`** : désactive le chiffrement SSL côté Centreon.
* **`-2`** : force l'utilisation du protocole NRPE version 2.
* **`-t 30`** : définit un délai d'attente de 30 secondes pour les contrôles NRPE.

## 7. Validation

Une fois la configuration terminée :

* Vérifier que le port **5666/TCP** est accessible depuis le poller Centreon.
* Redémarrer le service NSClient++.
* Effectuer un test de supervision depuis Centreon.
* Vérifier que les services remontent correctement et que leur état est conforme.

### Conclusion

La communication entre Centreon et NSClient++ est désormais configurée pour le modèle de supervision OS-Windows-NRPE-2-Disks.