DocumentationCommande d'assignation d'alarme personnalisée
Inclure une commande personnalisée ou un script shell personnalisé qui sera exécuté lorsqu'une alarme est assignée à un utilisateur spécifique.
Les alarmes peuvent être assignées à un utilisateur dans l'interface OPM ou dans SKOOR Engine en sélectionnant Afficher les alarmes :
Attribuer une alarme en cliquant sur le bouton Attribuer sur le côté droit :
Les commandes d'assignation personnalisées doivent être configurées dans le fichier de configuration du serveur :
/etc/opt/eranger/eranger-server.cfg
La configuration se fait par utilisateur et paramètres de commande Le ou les utilisateurs doivent exister dans SKOOR Engine.
custom_assign_user = user custom_assign_command = /path_to/command.sh
ou pour plusieurs utilisateurs, la configuration serait la suivante :
custom_assign_user1 = user1 custom_assign_command1 = /path_to/command1.sh custom_assign_user2 = user2 custom_assign_command2 = /path_to/command2.sh
Il est possible de configurer une commande personnalisée par défaut qui est exécutée pour toutes les affectations, à l'exception de celles qui sont configurées avec des utilisateurs spécifiques :
custom_assign_default = /path_to/default_script.sh
Le script ou la commande obtiendra 10 paramètres de SKOOR Engine :
Paramètre | Utilisé Variable | Variable Description |
|---|---|---|
ALARM_ID | $1 | ID de l'alarme dans le SKOOR Engine |
ALARM_OPEN | $2 | Horodatage UTC de l'ouverture de l'alarme |
STATE | $3 | Gravité de l'alarme |
ASSIGNED_TEXT | $4 | Champ de commentaire de l'action d'assignation |
OBJ_TYPE | $5 | Type d'objet source (alarme de) |
OBJ_NAME | $6 | Nom de l'objet source (Alarme de) |
ORIGIN_TYPE | $7 | Type d'objet d'origine (cause de l'alarme) |
ORIGIN_NAME | $8 | Nom de l'objet d'origine (cause de l'alarme) |
REASON | $9 | Raison de l'alarme |
DEVICE | ${10} | Nom de l'appareil (lorsque l'origine est un travail) |
USER_ID | ${11} | ID de l'utilisateur SKOOR |
USER_NAME | ${12} | Nom de connexion de l'utilisateur SKOOR |
USER_FULLNAME | ${13} | Nom complet de l'utilisateur SKOOR |
ALARM_FILE | ${14} | Chemin d'accès au fichier d'alarme |
Si le script ne génère :
aucune sortie sur stderr, le succès est supposé et un commentaire de succès est ajouté à l'alarme
une sortie sur stderr, un échec est supposé et un commentaire contenant la sortie est ajouté à l'alarme.
Un exemple de script se trouve dans /opt/eranger/server/example_custom_assign_command.sh