# Dynamic snmp

# Introducción

**Ver**. 15-02-2024

Este plugin tiene como finalidad hacer escaneos dinámicos SNMP.

**Tipo**: Plug-in server

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha-1" style="width: 74.8148%;"><tbody><tr><td style="width: 56.7204%;">**Sistemas donde se ha probado**</td><td style="width: 43.2796%;">Rocky linux, Fedora 34</td></tr><tr><td style="width: 56.7204%;">**Sistemas donde funciona**</td><td style="width: 43.2796%;">Cualquier sistema linux</td></tr></tbody></table>

# Pre requisitos

- Conectividad hacia el host y la comunidad que se pretende escanear.

# Parámetros

<table border="1" id="bkmrk--c-comunidad--v-vers" style="border-collapse: collapse; width: 100%; height: 867.907px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-c</div></div></td><td style="height: 29.7969px;">Comunidad</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-v</div></div></td><td style="height: 29.7969px;">Versión de snmp</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-h</div></div></td><td style="height: 29.7969px;">IP hacía la que apuntará el plugin</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-p</td><td style="height: 29.7969px;">Port</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-o</td><td style="height: 29.7969px;">OID base</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-d</td><td style="height: 29.7969px;">Tipo de datos</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-u</td><td style="height: 29.7969px;"><div><div>Se utiliza para especificar el nombre de usuario o entidad de seguridad que está realizando la operación SNMP</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-n</td><td style="height: 29.7969px;"><div><div>Se utiliza para especificar el contexto en el que se realizará la operación SNMP</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-l</td><td style="height: 29.7969px;"><div><div>Este parámetro especifica el nivel de seguridad que se aplicará a las operaciones SNMPv3. Los posibles valores incluyen "noAuthNoPriv" (sin autenticación ni privacidad), "authNoPriv" (autenticación sin privacidad) y "authPriv" (autenticación con privacidad).</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-a</td><td style="height: 29.7969px;"><div><div>Este parámetro se utiliza para especificar el protocolo de autenticación que se utilizará. Puede ser MD5 (Message Digest 5) o SHA (Secure Hash Algorithm).</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-A</td><td style="height: 29.7969px;"><div><div>Es la clave de autenticación utilizada en combinación con el protocolo de autenticación especificado. Esta clave se utiliza para verificar la autenticidad de los mensajes SNMPv3.</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-x</td><td style="height: 29.7969px;"><div><div>Especifica el protocolo de privacidad que se utilizará para cifrar los datos transmitidos. Los posibles valores incluyen DES (Data Encryption Standard) y AES (Advanced Encryption Standard).</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">-X</td><td style="height: 29.7969px;"><div><div>Es la clave de privacidad que se utiliza junto con el protocolo de privacidad para cifrar y descifrar los datos transmitidos. Esta clave es esencial para garantizar la confidencialidad de los mensajes SNMPv3.</div></div></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-agent</div></div></td><td style="height: 29.7969px;">Nombre del agente</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-names</div></div></td><td style="height: 29.7969px;">Instancias específicas de un objeto</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"><div><div>-branches</div></div></td><td style="height: 46.5938px;">Esta opción especifica las ramas (branches) que se deben recuperar bajo los OIDs proporcionados.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-t_ip</div></div></td><td style="height: 29.7969px;">IP de tentacle</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-t_port</div></div></td><td style="height: 29.7969px;"> Puerto de tentacle</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-t_opts</div></div></td><td style="height: 29.7969px;">Opciones extras de tentacle</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-t_file_path</div></div></td><td style="height: 29.7969px;">Ruta de tentacle</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"><div><div>-m</div></div></td><td style="height: 46.5938px;">Modo de transferencia, local o localcopy. Por defecto: 'localcopy'</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-wmin</div></div></td><td style="height: 29.7969px;">Umbral mínimo de warning</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-wmax</div></div></td><td style="height: 29.7969px;">Umbral máximo de warning</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-cmin</div></div></td><td style="height: 29.7969px;">Umbral mínimo de crítico</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-cmax</div></div></td><td style="height: 29.7969px;">Umbral máximo de crítico</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-alrt</div></div></td><td style="height: 29.7969px;">Alertas globales</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-group</div></div></td><td style="height: 29.7969px;">Grupo para los módulos</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><div><div>-debug</div></div></td><td style="height: 29.7969px;">Activa el modo debug</td></tr></tbody></table>

# Ejecución manual

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

```
./dynamic_snmp.pl -agent <agent name> -h <host> -v <version> -c <comunidad> [-u username] [-a MD5] [-A auth_password] [-x DES] [-X priv_password] [-l authPriv] -o < base oid> -names <instance> -branches < branches > -nodefaults 1 [-t_ip 127.0.0.1] [-t_port 41121] [-t_opts "additional_tentacle_options"] [-t_file_path "/path/to/data_in"] [-m tentacle] [-wmin 0] [-wmax 100] [-cmin 0] [-cmax 200] [-alrt alert_name] [-group GroupName] [-debug 1]
```

Ejemplo :

```
./dynamic_snmp -agent test -h 192.168.51.1 -v 2c -c artica06  -o .1.3.6.1.2.1 -names .2.2.1.2 -branches OperStatus:.2.2.1.8,AdminStatus:.2.2.1.7 -nodefaults 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:**

```
/usr/share/pandora_server/util/plugin
```

**2. Dirigirse al apartado plugins y crear uno nuevo:**

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/scaled-1680-/VNOimagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/VNOimagen.png)

 **3. Se le añade nombre, descripción y timeout:**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/698image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/698image.png)

**4. Se añade la ruta del plugin en el comando y los parámetros necesarios para la ejecución de este.**

<p class="callout info">Para cada parámetro se debe configurar una macro, siendo la sintaxis de esta macro la siguiente : \_fieldx\_, siendo x el numero posicional del parámetro.</p>

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/bbrimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/bbrimage.png)

**5. Se configuran las macros anteriores, añadiendo en cada una el valor del parámetro:**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/KTkimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/KTkimage.png)

**6.** **Una vez configurado se debe crear un módulo en un agente que ejecute el plugin. En el menu de módulos de un agente creamos un módulo de tipo plugin nuevo:**

[![imagen.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/scaled-1680-/503imagen.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-01/503imagen.png)

**7. En el menú de configuración del módulo, le ponemos un nombre, seleccionamos el plugin antes configurado y se le debe dar a "crear".**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/V3Himage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/V3Himage.png)

**8. Se creara el agente con los módulos o los módulos en el agente seleccionado en la siguiente ejecución del plugin :**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/y25image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/y25image.png)

# Agentes y módulos generados por el plugin

El plugin creará los módulos en el agente seleccionado con el parámetro -agent, o en su defecto creará uno nuevo.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/scaled-1680-/rAdimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2024-02/rAdimage.png)