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

 

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.

image.png

3. Crear un nuevo módulo de inventario 

imagen.png

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

imagen.png

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

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:

imagen.png