Plugin ssh inventario
Plugin con el que ejecutar comandos en terminales y mostrar la devolución de estos en PandoraFMS

Introducción
Este plugin tiene como finalidad ejecutar comandos ssh en switches para devolver información que puede ser consultada en PandoraFMS , como puede ser la configuración de este o su version de firmware. 

 El plugin se conecta al switch, ejecuta el comando configurado por el usuario y muestra la salida de este en el inventario del agente configurado.

Matriz de compatibilidad
Sistemas donde se ha probado 

 Rocky linux, Fedora 34 

 

 

 Sistemas donde funciona 

 Cualquier sistema linux

Pre requisitos
  

 

 Conectividad desde PandoraFMS hacía el switch objetivo

Parámetros
"address" 

 Host o ip del switch al que se quiere conectar. 

 

 

 "username" 

 Usuario 

 

 

 "password" 

 Contraseña. En caso de necesitar enable password, especificar separando el password y enable con "/" : password/enable. Ejemplo : P4nd0r4/S3uK! 

 

 

 "command" 

 Comando que se pretende ejecutar en la máquina objetivo 

 

 

 "extra_command" 

 En caso de necesitar paginación (la salida se muestra cortada), usar este parámetro para lanzar comando que habilite el modo paginación. 

 

 

 "--debug" 

 Para mostrar información extra de la ejecución

Ejecución manual
El formato de ejecución del plugin es el siguiente : 

 ./ssh_inventory < host > < user > < password > < comando > < comando paginación > < aplicar filtro : 1 o 0 > 

 En caso de necesitar enable password : 

 ./ssh_inventory < host > < user > < password / enable password > < comando > < comando paginación > < aplicar filtro : 1 o 0 > 

 Ejemplo de ejecución en switch cisco (con enable password): 

 ./ssh-plugin 192.168.23.212 admin pandora/en4Bl3 "show running-config\n" "terminal length 0" 1 

 Ejemplo de ejecución en switch mikrotik (sin enable password): 

 ./ssh_inventory 192.168.87.21 admin pandora "system resource print\n\r" "" 1 

 Ejemplo de ejecución en switch A10 (con enable password): 

 ./ssh-plugin 192.168.1.27 admin pandora/pandora "show running-config\n" "" 1

Configuración en PandoraFMS
Para configurar el plugin en PandoraFMS, se deben seguir los siguientes pasos : 

 1. subir el plugin a PandoraFMS, por ejemplo en la siguiente ruta: 

 /etc/pandora/plugin 

 2. Ir al menú de módulos de inventario y crear uno nuevo. 

 

 3. Crear un nuevo módulo de inventario  

 

 

 El interpreter se debe dejar vacío , en script mode, debe ir la ruta del plugin. 

 4. Ir a un agente y configurar el plugin 

 

 

 Se deberá marcar la opción custom fields, añadir el target y un intervalo, se deben añadir los siguientes custom fields: 

 

  user: usuario 

 password: La contraseña (si hay enable se debe especificar en este campo separado del password con "/" como en el ejemplo),  

 comando: El comando a lanzar 

 extra command: si se requiere, si no se debe dejar en blanco 

 

 Una vez hechos estos pasos se debe añadir el plugin y el resultado de la ejecución del comando utilizado se verá en la vista de inventario del agente: