Plugin ssh inventario
Plugin con el que ejecutar comandos en terminales y mostrar la devolución de estos en PandoraFMS
- Introducción
- Matriz de compatibilidad
- Pre requisitos
- Parámetros
- Ejecución manual
- Configuración 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: