Concept

Cette commande permet de gérer la liste des motifs ( substrings ) permettant de déterminer quelles données des éléments de Shinken seront protégées. 

Grâce à cette commande, il est possible de :

  • Visualiser le paramétrage courant et la liste des données chiffrées correspondant aux motifs en se basant sur les éléments actuellement dans la configuration du Synchronizer.
  • Ajouter un ou plusieurs motifs et prévisualisé la nouvelle liste des données chiffrées.
  • Retirer un ou plusieurs motifs et prévisualisé la nouvelle liste des données chiffrées.

La commande affiche deux types d'informations principales :

  • Les modifications apportées à la liste des motifs :
    • en blanc la liste de motifs actuel,
    • en vert les motifs ajoutés,
    • en rouge les motifs supprimés.
    • en jaune la nouvelle liste de motifs.
  • La liste des données chiffrées en fonction de la liste des motifs :
    • en blanc la liste des données actuellement chiffrées,
    • en vert les données qui seront chiffrées,
    • en rouge les données qui ne seront plus chiffrées.
  • Il est possible d'ajouter des motifs pour des données qui ne sont pas encore utilisés dans la base. Dans ce cas, la liste des données ajoutées n’inclura aucune données liée à ce motifs.
  • La nouvelle configuration n'est pas écrite dans le fichier de configuration du Synchronizer par défaut, mais dans le fichier de surcharge se trouvant dans l'arborescence /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg. Cela permet de garder la configuration à travers les mises à jour

Options

Options générales

OptionValeur par défautDescription
-h, --help


--


Affiche le descriptif de la commande.
-c, --config


--


Fichier dans lequel lire la configuration actuelle ( par défaut, le fichier de configuration du Synchronizer qui prend en charge les éventuelles surcharges : /etc/shinken/synchronizer.cfg ).
--quiet


--


Réduit la quantité d'informations à afficher.

Options de gestions des données protégées

OptionValeur par défautDescription
-a, --add

--

Mot-clé à ajouter ; pour ajouter plusieurs mots-clés, répéter cette option autant de fois que nécessaire.
--remove
--


Mot-clé à retirer ; pour retirer plusieurs mots-clés, répéter cette option autant de fois que nécessaire.


Les options --add et –remove peuvent être utilisées simultanément


Options de connexion à la base MongoDB

Cette commande récupère les paramètres de connexion à la base MongoDB depuis la configuration.
Il est nécessaire d'utiliser les options de la ligne de commande que si les fichiers de configuration ne correspond pas à la base MongoDB sur la quel la commande doit être exécutée ( migration de base, test sur une préprod ... ).



Exemple

Dans cet exemple, on ajoute le motif ORACLE_USER et on retire en même temps le motif DOMAINE_NAME. Dans la liste des données, on peut constater :

  • En blanc, toutes les données qui ne seront pas impactées.
  • En vert, les données présentes sur des éléments Shinken qui seront protégées après le redémarrage du Synchronizer.
  • En rouge, les données présentes sur des éléments Shinken qui ne seront plus protégées après le redémarrage du Synchronizer.

Dans cet exemple, 

  • Tant que le Synchronizer n'a pas redémarré, aucune modification n'est effectuée
  • Si un utilisateur ajoute une donnée SUB_DOMAIN_NAME, elle sera protégée