Page History

Pour définir le module source Discovery:

1. Configurer la source dans le fichier  /etc/shinken/sources/discovery.cfg
   
2. La source discovery est déclarée dans le fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

source_name

order

import_interval

modules

enabled

1 - Active la source

0 - Désactive la source. Elle est visible dans l'interface, mais ne collecte pas de données.

Exemple de définition:

define source {
    source_name             discovery
    order                   10
    import_interval         5
    module_type             discovery-import
    data_backend            mongodb
    mongodb_uri             mongodb://localhost/?safe=false
    mongodb_database        synchronizer
    rules_path              /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/discovery_rules.json
    nmap_mac_prefixes_path  /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/nmap/nmap-mac-prefixes
}

Puis vous verrez la page de configuration d'une nouvelle plage réseau dans une popup.

Vous devez définir les paramètres suivants:

• Plage de ports: Plage de ports scanné pour chaque adresse. Les 1000 ports les plus répandus sont utilisés par défaut
  • Vous pouvez restreindre les ports scannés, avec une liste.
  • Plusieurs plages peuvent être définies séparés par des virgules.
  • Ex: 1-1024,2000-8000
    
• Notes: Texte descriptif au sujet de cette plage réseau
• Activé: Activer ou désactiver les scans sur cette plage réseau

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

• name: le nom et l'id de votre règle (doit être 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)
• prefix_name: ce préfixe est ajouté au nom des éléments pour lesquels la règle s'applique (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"
			}
	]
}

{
	"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"
			}
	]
}

macvendor=^myMacVendor

ostype=myType$

osversion=^2.6.0$

os=myOS

os=myOS AND osversion=^2

openports=1|2

os=aix

os=cisco

openports=53

openports=21

macvendor=hewlett packard AND openports=2301

os=embedded AND ostype=remote management AND osvendor=hp

openports=631 AND openports=9100

os=hp-ux

openports=80

openports=443

openports=143

openports=993

openports=389

openports=636

os=linux

openports=27017

openports=1433

openports=3306

openports=1521|1526

openports=110

openports=995

openports=25

openports=465

openports=22

ostype=switch

isesxhost=1

isesxvm=1

os=windows

os=windows AND osversion=2000

os=windows AND osversion=2003

os=windows AND osversion=vista

os=windows AND osversion=7

os=windows AND osversion=2012

os=windows AND osversion=2016

define source {
    source_name             discovery
    order                   10
    import_interval         5
    module_type             discovery-import
    data_backend            mongodb
    mongodb_uri             mongodb://localhost/?safe=false
    mongodb_database        synchronizer
    rules_path              /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/discovery_rules.json
    nmap_mac_prefixes_path  /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/nmap/nmap-mac-prefixes
}

Il existe 6 statuts pour les règles de découvertes :

Vous pouvez rafraîchir la liste des règles directement en appuyant sur le bouton de rafraîchissement en haut à droite Image Removed, ou en appuyant sur F5.

macvendor=^myMacVendor

ostype=myType$

Est égal (=^...$)

osversion=^2.6.0$

os=myOS

os=myOS AND osversion=^2

L'écriture d'une condition pour la propriété openports est un cas spécifique.

openports=1|2

Lors de l'installation, Shinken livre un certain nombre de règles par défaut pour la détection des objets via le collecteur discovery. 

Ces règles par défaut sont les suivantes:

os=aix

os=cisco

openports=53

openports=21

macvendor=hewlett packard AND openports=2301

os=embedded AND ostype=remote management AND osvendor=hp

openports=631 AND openports=9100

os=hp-ux

openports=80

openports=443

openports=143

openports=993

openports=389

openports=636

os=linux

openports=27017

openports=1433

openports=3306

openports=1521|1526

openports=110

openports=995

openports=25

openports=465

openports=22

ostype=switch

isesxhost=1

isesxvm=1

os=windows

os=windows AND osversion=2000

os=windows AND osversion=2003

os=windows AND osversion=vista

os=windows AND osversion=7

os=windows AND osversion=2012

os=windows AND osversion=2016

Le fichier des règles par défaut est le suivant:  discovery_rules.json

Dans l'onglet "Détail de dernier lancement" est listé chaque équipement détecté par le collecteur discovery en fonction des plages réseau actives lors de l'import.

Pour chaque équipement, l’œil à droite vous permet de voir le détail de l'opération. Deux tableaux fournissent respectivement:

fqdn

DiskStation

mac

00:11:32:9F:09:44

macvendor

Synology Incorporated

openports

22,80,137,139,161,161,443,445,548,3261,5000,5001,5353

os

Famille du système d'exploitation détectée, comme par exemple Windows, Linux, IOS (routeurs Cisco), Solaris ou OpenBSD. Ils y a des centaines d'autres familles de systèmes comme des routeurs, imprimantes ou autres systèmes propriétaires.

Lorsque la famille du système d'exploitation ne peut pas être déterminée avec une confiance suffisante, la valeur embedded est utilisée.

Linux

ostype

Le type de système d'exploitation est une classification large selon l'usage prévu de ce système comme "router", "printer", ou "game console". Les systèmes d'exploitation universels tels que Linux et Windows, qui ont de nombreux cas d'utilisations sont classés en tant que "general purpose".

general purpose

osvendor

Entreprise ou entité qui produit le système d'exploitation ou équipement (par exemple Apple, Cisco, Microsoft, Linksys). Pour les projets communautaires comme Linux ou les différents BSD, la valeur de l'information "os" est répétée ici.

Linux

osversion

3.X

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

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.

Image Removed