Page History

Les mécanismes de règles permet d'enrichir les équipements détectés.

• Par défaut, une installation fournit une liste de règles prédéfinies.
• Vous pouvez définir vos propres règles ou surcharger les règles prédéfinies.
  Vous devez pour cela éditer le fichier JSON
  • /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/discovery_rules.json

Il y a Une règle de découverte est séparée en 4 parties dans une règle:

• name: le nom et l'id de votre règle ( doit doit être unique unique)
• condition[1-9]: représente une condition qui applique la règle si elle est remplie
  ( il suffit qu'une seule condition soit bonne pour que la règle soit appliquée appliquée)
• prefix_name: ce préfixe est ajouté au nom des éléments pour lesquels la règle s'applique ( optionnel optionnel)
• use: Les modèles d'hôtes ajoutés en cas d'application de la règle. Vous pouvez en mettre autant que vous voulez en les séparant d'une virgule.
  • Les modèles d'hôtes sont ajoutés à la suite de ceux déjà présents sur l'hôte (ajoutés par d'autres règles) 

Voici un exemple qui est disponible par défaut dans Shinken:

{
	"rules":[
			{
			"name": "myRuleExample",
			"condition1": "os=myOS AND osversion=^2",
			"condition2": "osversion=^2.6.0$",
			"condition3": "macvendor=^myMacVendor",
			"condition4": "ostype=myType$",
			"condition5": "openports=1|2",
			"prefix_name": "myRulePrefix",
			"use": "myTemplate,myTemplate2"
			}
	]
}

Les règles sont affichées sous forme de la liste:

• Triée par ordre de priorité: Lorsque les règles 1 et 2 s'appliquent, la règle 1 s'applique avant la règle 2 (ajout du préfixe et des modèles d'hôtes)
• La couleur de fond de chaque ligne indique le type de règle:
  • Blanc : règle par défaut 
  • Bleu: règle définie par l'utilisateur
  • Gris: règle affichée dans la liste mais sans effet (désactivée volontairement, syntaxe incorrecte, ...).

Lors du scan d'une plage réseau, le collecteur discovery peut remonter le constructeur du matériel à l'aide de nmap.

Cette détection du constructeur se fait par identification de l'adresse MAC de l'équipement détecté sur le réseau. Pour la correspondance entre adresse MAC et constructeur, nmap utilise un fichier nommé nmap-mac-prefixes qui comporte des adresses MAC associées à des constructeurs (macvendor).

Par exemple, si votre machine récupérée par la discovery a pour adresse MAC "0050BAXXXXX", le constructeur détecté (macvendor) est "D-Link".
Shinken fournit par défaut un fichier nmap-mac-prefixes qui sert de réference à nmap. Ce fichier est mis à jour à chaque mise à jour de Shinken.

Pour créer des associations entre adresses MAC et constructeur personnalisées, il est possible créer un fichier nmap-mac-prefixes dans /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/nmap/, qui surchargera celui que Shinken met à  disposition lors de l'installation.

Ce fichier doit être au format de l'exemple donné et peut contenir des commentaires en commençant la ligne par un #.

Votre fichier surcharger la liste présente par défaut dans l'installation de Shinken Entreprise.

Le fichier par défaut à utiliser comme modèle est le suivant: nmap-mac-prefixes.

L'exemple suivant fournit une illustration sur la découverte d'un NAS Synology et la détection automatique du constructeur.

Il peut y avoir plusieurs problèmes à l'ouverture de votre fichier de règles:

Dans le cas où le fichier de règles n'est pas correctement chargé (

voir les problèmes liés aux règles dans les règles de découvertes

), seules les règles par défaut sont prises en compte et un message d'erreur apparaît en haut du tableau.