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
| Option | Valeur par défaut | Description |
|---|---|---|
-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
| Option | Valeur par défaut | Description |
|---|---|---|
-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 ... ).
La commande dispose d'options de connexion à la base MongoDB qui peuvent être utilisés dans les cas suivants : La combinaison des options de connexion à MongoDB peut rapidement devenir complexe ; voici des paramètres adaptés aux cas les plus courants. localhost Nom ou IP du serveur MongoDB. 27017 Port de la base MongoDB. shinken ( ou synchronizer si la commande concerne la base du Synchronizer ) Nom de la base de données à utiliser dans MongoDB. À n'utiliser que si la configuration du module ou du démon a changé la base utilisée par défaut. --- Active la connexion SSH au serveur MongoDB. /var/lib/shinken/.ssh/id_rsa Clé privée SSH pour la connexion au serveur MongoDB. À utiliser en complément de l'option --mongo-use-ssh. shinken Utilisateur à utiliser pour la connexion SSH. À utiliser en complément de l'option --mongo-use-ssh. --- Utilisateur pour l'authentification avec mot de passe. --- Mot de passe de l'utilisateur pour l'authentification avec mot de passe. À utiliser en complément de l'option --mongo-username. Si l'option --mongo-password est utilisée, le mot de passe risque d'être visible dans l'historique des commandes ( via la commande history ). Pour éviter d'exposer le mot de passe, il est possible d'utiliser cette commande uniquement avec l'option --mongo-username. Un prompt interactif apparaîtra alors pour demander le mot de passe. Pour automatiser les commandes dans un script, il est possible de rediriger le contenu d'un fichier contenant le mot de passe ( par exemple : --mongo-password $(cat my_file_with_password) ). --- Active SSL/TLS pour les communications avec la base MongoDB. --- Chemin vers le fichier de l’autorité de certification ( CA ) utilisé pour vérifier le certificat SSL de MongoDB. À utiliser en complément de l'option --mongo-ssl. --- Chemin vers le fichier contenant le certificat SSL du client. À utiliser en complément de l'option --mongo-ssl. --- Mot de passe du certificat SSL du client. À utiliser en complément de l'option --mongo-ssl. --- Chemin vers le fichier CRL ( liste de révocation ) des certificats SSL à rejeter. À utiliser en complément de l'option --mongo-ssl. --- Accepter le certificat SSL de MongoDB même si le nom d’hôte du certificat ne correspond pas à celui du serveur. À utiliser en complément de l'option --mongo-ssl. --- Accepter le certificat SSL de MongoDB même s’il est invalide, par exemple expiré. À utiliser en complément de l'option --mongo-ssl.Options génériques
[root@serveur01 ~] shinken-commande --mongo-host 127.0.0.1 --mongo-port 27017 --mongo-database shinken
Option Valeur par défaut Description Options de connexion SSH
[root@serveur01 ~] shinken-command --mongo-host serveur02 --mongo-port 27017 --mongo-use-ssh --mongo-ssh-key /var/lib/shinken/.ssh/id_rsa --mongo-ssh-user shinken
Option Valeur par défaut Description Options d'authentification
[root@serveur01 ~] shinken-command --mongo-host 127.0.0.1 --mongo-port 27017 --mongo-username shinken --mongo-password shinken
Option Valeur par défaut Description Options SSL/TLS
[root@serveur01 ~] shinken-command --mongo-host serveur02 --mongo-port 27017 --mongo-ssl-ca-file /etc/shinken/certs/mongo/ca.pem --mongo-ssl-pem-key-file /etc/shinken/certs/mongo/client.pem
Option Valeur par défaut Description
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