Page History

Introduction

Certaines situations nécessitent l’existence de plusieurs Shinken Entreprise que l'on voudrait connecter ensemble:

• Exemple 1: Découvrir les machines d'un sous-réseau sécurisé
  • Pour utiliser le collecteur discovery ( réalisant des scans réseau via nmap ) vers ce sous-réseau sécurisé, il faudrait ouvrir les flux vers tous les équipements ce qui créerait une faille de sécurité.
  • Pour contourner cela, il est possible d'installer un Shinken dans le sous-réseau, ce dernier réalisant les scans nmap, et le connecter à un Shinken centrale via le synchronizer-collector-linker pour récupérer les hôtes découverts dans le sous-réseau.
    
    
• Exemple 2: Donner une autonomie a un admin shinken qui pourrait créer ses hôtes via un Synchronizer distant et les collecter en centrale via le synchronizer-collector-linker. 

Fonctionnement

Le collecteur synchronizer-collector-linker va se connecter à chaque shinken distant listé:

• Il interroge le listener « shinken-listener » de chaque shinken distant.
• Il récupère tous les hôtes présents, y compris 
  • les hôtes en nouveau
  • les hôtes avec leurs différences ( comme si elles avaient été acceptées )

Il interrogera à tour de rôle chacun des Shinkens distants pour collecter les hôtes et les présenter au mécanisme de calcul de nouveauté et différence du Synchronizer qui l'héberge.

Configuration ( affichage de la source dans la page d’accueil )

La définition du collecteur

Il faut créer dans le répertoire /etc/shinken/sources le fichier  synchronizer-collector-linker.cfg

Voici les paramètres à renseigner :

mongodb://localhost/?safe=false

Un exemple ce trouve dans le répertoire /etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-linker/synchronizer-collector-linker-example.cfg.

Copier et éditer l'exemple dans le dossier /etc/shinken/sources/

Exemple de définition:

#===============================================================================
# synchronizer-collector-linker
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# This source is about loading remote synchronizers configurations
#===============================================================================

define source {
    source_name              synchronizer-collector-linker
    order                    2
    import_interval          5
    module_type              synchronizer-collector-linker
    data_backend             mongodb
    mongodb_uri              mongodb://localhost/?safe=false
    mongodb_database         synchronizer
    description              This source is about loading remote synchronizers configurations
    enabled                  1
	not_stored_properties    _SE_UUID
}

Une fois le fichier copié, il faut ajouter les droits shinken au fichier :

cd /etc/shinken/sources/
chown -R shinken:shinken synchronizer-collector-linker.cfg

Configuration du démon Synchronizer pour déclarer le collecteur

Exemple :

    sources               syncui,cfg-file-shinken,active-dir-example,sync-vmware,cfg-file-nagios,discovery,openldap-example,synchronizer-collector-linker

Redémarrez le Synchronizer pour qu'il prenne acte de la nouvelle source :

service shinken-synchronizer restart

Vous verrez dans l'interface le nouveau collecteur apparaître

Utilisation du collecteur

Définir la connexion aux Shinken distants

Il faut définir les sites distants qui vont être contactés pour récupération de leurs hôtes : 

• Cliquer sur le nom de la source dans la page principale pour ouvrir la page de détail du dernier lancement de la source. Ensuite il faut cliquer sur l'onglet "Liste des Synchronizers distant".
  
  

• Cliquer sur le bouton  à droite pour ouvrir la page d'édition d'un site distant 
  
  

• Les champs à remplir sont les suivants:
  
  

Une sauvegarde réussie redirigera vers la liste des Synchronizers distants.

Vous pouvez tester manuellement la connexion avec le Synchronizer distant à l'aide de la commande affichée sous le formulaire d'édition.

Liste des synchronizers distants 

Précisions techniques

Clés de synchronisation

Les clés de synchronisation sont des valeurs utilisées lors de l'étape du mélange des sources ( Voir Modules d'import ( Sources ) et de qualification ( Taggers ) ) qui permet de choisir quel élément de cette source se mélange avec quel élément d'une autre source ( Voir Le mélange des sources & les clés de synchronisation (sync-key) ).

Propriétés par défaut utilisé pour la construction des clés de synchronisation :

Les propriétés suivantes sont ajoutées comme clés de synchronisation de l'objet Shinken:

• UUIDShinkenDistant-UUID : il est donc composé de 2 valeurs séparées par un tiret.
  • UUIDShinkenDistant : unique dans une Installation Shinken 
  • UUID de l'hôte sur le synchronizer distant

• hostname (pour rappel, le hostname est égal à PREFIX-HOSTNAME ( du site distant ), au moment de l'import). Cette clé de synchronization est dynamique. En effet, si le préfixe de renommage du Synchronizer distant change, les noms des hôtes seront renommés ainsi que leur sync-key pour être en adéquation.

Propriétés par défaut utilisé pour la construction des clés de synchronisation