Gestión de relés de Internet desde RouterOS Mikrotik a través de API

Una herramienta útil para administrar PDU en enrutadores MikroTik

Funciones de RouterOS para la gestión de PDU

• Encender / apagar de forma remota la alimentación de los dispositivos conectados a la PDU
• Controle de forma remota la PDU ante la ocurrencia de varios eventos en la red (por ejemplo, si no hay respuesta de algún dispositivo para hacer ping, cuando un cliente VPN específico, un cliente de red wifi, etc., está conectado al enrutador), dependiendo del tiempo (programado)
• Notifique al administrador o usuarios sobre el cambio en el estado del relé en la PDU por correo electrónico o número de teléfono (a través de SMS)

Gestión de PDU a través del comando de enrutador "fetch"

/tool fetch url="http://[:]@192.168.1.20/protect/rb0n" 

 /tool fetch url="http://[:]@192.168.1.20/protect/rb0n" mode=http dst-path="Rodosanswer.txt"; :local Rodosanswer [/file get Rodosanswer.txt contents]; 

• “¡Éxito! "- en caso de ejecución exitosa del comando
• "Fallo": si el comando no se ejecuta (como regla, al acceder sin indicar el inicio de sesión y la contraseña de la PDU en la línea URL, si la PDU está en modo "protegido")

Creamos la función de gestión de PDU Rodos en el repositorio del enrutador Mikrotik

 ################ FuncRODOS10rele ###################### #     PDU RODOS-10 # by Sergej Serkov 23.12.2017 ####################################################### #  ,   :global FuncRODOS10rele do={ :local Sport ""; :if ([:len $Rport]=0) do={:set Sport "80";} else={:set Sport $Rport;} :global FuncPing; :local PingAnswer [$FuncPing PingAdr=$Radr]; :if ($PingAnswer="OK") do={ :local Rprotect; :local Wprotect; :local Rmode "0"; :local Nrele 0; :local Act; :if (([:len $Rlogin]=0) and ([:len $Rpass]=0)) do={:set Rprotect ""; set Wprotect "";} else={:set Rprotect ("$Rlogin".":"."$Rpass"."@"); set Wprotect "/protect";} :if ($Rstatus="on") do={:set Rmode "1"; :set Act "n"} :if ($Rstatus="off") do={:set Rmode "1"; :set Act "f"} :if ($Rstatus="inv") do={:set Rmode "1"; :set Act "s"} else={} :if ($Rmode="1") do={ :set Nrele ([:tonum $Rrele] - 1); :if (($Nrele > -1 and ($Nrele < 4)) do={ :local StrFetchRodos; :set StrFetchRodos ("http://"."$Rprotect"."$Radr".":"."$Sport"."$Wprotect"."/rb"."$Nrele"."$Act".".cgi"); do { [/tool fetch url=$StrFetchRodos mode=http dst-path="Rodosanswer.txt";]; } on-error={: log info ""; :log error ("Call ERROR function <RODOS10rele> ERROR fetch command"); :local Rodosanswer "ERROR: command ROS <fetch>"; : log info ""; :return $Rodosanswer} :log info ""; :log warning ("all "."$Wprotect "."function <RODOS10rele> set rele #"."$Rrele "."is ["."$Rstatus"."]"); :log info ""; :delay 2s; :local Rodosanswer [/file get Rodosanswer.txt contents]; /file remove Rodosanswer.txt; :return $Rodosanswer; } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> set rele#"."$Rrele"." but NUMBER RELE MISMATCH"); :log info ""; :local Rodosanswer "ERROR: rele range mismath"; :return $Rodosanswer;} } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> set rele#"."$Rrele"." but RELE REGIME SET MISMATCH"); :log info ""; :local Rodosanswer "ERROR: rele regime set mismatch"; :return $Rodosanswer;} } else={ :log info ""; :log error ("all ERROR"."$Wprotect "."function <RODOS10rele> but DEVICE NOT RESPONDED"); :log info ""; :local Rodosanswer "ERROR: device not responded"; :return $Rodosanswer;} } 

 :global FuncPing do={ :local PingCount 3; #  ; :local Result [/ping $PingAdr count=$PingCount]; :delay 2s; :local PingAnswer ""; :local MainIfInetOk false; :set MainIfInetOk ((3*$Result) >= (2 * $PingCount)) :put "MainIfInetOk=$MainIfInetOk" if (!$MainIfInetOk) do={ :set PingAnswer "ERROR" } if ($MainIfInetOk) do={ :set PingAnswer "OK" } :return $PingAnswer;} 

Aplicación de la función de control de relé

• Radr - dirección IP del dispositivo
• Rport - puerto http. Si el puerto estándar para http (80) está configurado, este parámetro puede omitirse
• Rrele: el número del relé sobre el que realizamos una acción (para RODOS-10 [1-4]),
  para RODOS-9 [1-2], para RODOS-8 no se transmite)
• Rstatus - acción que se está tomando ("off" - deshabilitar; "on" - habilitar; "inv" - dar un impulso)
• Rlogin - inicio de sesión, Rpass - contraseña de acceso al dispositivo
  (si no están configurados, la llamada de comando se usa sin "/ protect")
  

 [$FuncRODOS10rele Radr="192.168.1.20" Rrele="2" Rstatus="on"] 

 [$FuncRODOS10rele Radr="192.168.1.20" Rport="8021" Rrele="2" Rstatus="off" Rlogin="login" Rpass="password"] 

  • "¡Éxito!" - en caso de una llamada exitosa y la ejecución de un equipo

  • "Fallo": en caso de manejo erróneo y no ejecución de un comando

  • "ERROR: desajuste de rango de liberación": si se especifica un número de relé no válido 
	 en el parámetro de la función Rrele para esta versión del dispositivo

  • "ERROR: el régimen de relevo no coincide" - en caso de no especificado o incorrecto 
     El parámetro especificado de la función Rstatus ("on", "off", "inv")

  • "ERROR: el dispositivo no respondió" - si no hay respuesta del dispositivo 
     hacer ping

  • "ERROR: comando ROS <fetch>" - en caso de error directamente
     al ejecutar el comando URL de búsqueda de RouterOS (generalmente si no
     el número de puerto especificado en Rport, parámetros de Rlogine especificados incorrectamente
     y / o Rpass)

1. Primero debe ejecutar scripts que coloquen las funciones necesarias en el entorno de las variables del repositorio del enrutador. Esto se puede hacer una vez, por ejemplo, al iniciar el enrutador desde el Planificador de RouterOS ( / planificador del sistema )
   
   

    #          /system script run Func_RODOS10rele; #      «FuncPing» # (  FuncRODOS10rele) /system script run Func_Ping; 

2. Después de definir las funciones, puede usarlas (en particular, llamar a FuncRODOS10rele)
   
   Como ejemplo, llamamos a nuestra función aplicando un pulso al relé No. 4 de la PDU RODOS-10:
   
   

    :global FuncRODOS10rele; :local Rodosanswer [$FuncRODOS10rele Radr="192.168.1.20" Rport="8021" Rrele="4" Rstatus="inv" Rlogin="login" Rpass="password"]; :log info $Rodosanswer; 

   
   La respuesta se devolverá a la variable Rodosanswer y, en este caso, se mostrará en el registro del enrutador.
   
   

   Biblioteca de funciones lista para usar para trabajar con PDU

   
   Para facilitar su uso, creé una biblioteca de funciones para las PDU Rodos de los modelos 8, 9, 10 y 10 de ejecución DIN (versión de biblioteca 1.0 del 25 de diciembre de 2017). Los scripts de la biblioteca se combinan en el archivo Func_RODOS.rsc, que puede importarse a RouterOS mediante el siguiente comando del terminal de utilidad WINBOX:
   
   

    /import file= Func_RODOS.rsc 

   
   El proceso de importación puede tomar de 20 segundos a 1 minuto, dependiendo del modelo del enrutador Mikrotik (su velocidad).
   En este caso, todos los scripts que estaban disponibles anteriormente en el enrutador no se ven afectados, las funciones y scripts de la biblioteca Func_RODOS se agregan a los scripts de repositorio existentes.
   
   
   La versión 1.0 de la biblioteca Rodos.rsc contiene los siguientes scripts:

   • start_RODOS: ejecutar este script establece todas las funciones en variables de entorno
   • Func_Ping - la función de verificar la dirección para "ping"
   • Func_Mail - función para enviar un mensaje arbitrario al correo del administrador
   • Func_RODOS8rele - Función de control de relé PDU RODOS-8
   • Func_RODOS8reset - función de reinicio ("reinicio") del relé PDU RODOS-8
   • Func_RODOS9rele - ... de manera similar para los modelos indicados ...
   • Func_RODOS9reset
   • Func_RODOS10rele
   • Func_RODOS10reset
   • call_example [...] - ejemplos de llamadas a funciones de biblioteca
   • Func_RODOS_lib: todas las funciones de PDU (excepto Ping y Mail) en un archivo de script
   
   Después de importar la biblioteca, puede eliminar funciones y scripts innecesarios del repositorio, dejando solo las funciones de su modelo de PDU y scripts con las funciones FuncMail y FuncPing.
   
   En la biblioteca, para cada uno de los modelos de PDU compatibles, también hay prácticas funciones de reinicio ("reinicio") (marcadas en los nombres como "~ reinicio"). Los parámetros de las funciones de reinicio son similares a los parámetros de las funciones de instalación del relé, con la excepción del parámetro "Rstatus", que no se utiliza durante el "reinicio" y el parámetro opcional opcional Rtime, que define el tiempo en segundos entre el apagado y encendido del relé (si Rtime no se pasa a la función, se usa por defecto tiempo 5 segundos).
   
   Las funciones de reinicio funcionan de la siguiente manera:
   
   1. El relé especificado recibe un comando de apagado.
   2. Luego espera segundos Rtime con el siguiente comando de inclusión. En este caso, las funciones de reinicio se refieren a las funciones de instalación del relé correspondientes, que deben determinarse antes del primer
   
   Por lo tanto, si, antes de la llamada a la función de reinicio, se activó un cierto relé, se apagará y después de un tiempo especificado se volverá a encender (y la carga conectada se "reiniciará"). Se realiza una operación similar en un relé apagado, y después de que se ha activado la función, el relé se enciende (es decir, en este caso, la función se cumple como una función de conmutación de relé). Es conveniente utilizar las funciones de reinicio para reiniciar el equipo de red "colgado" conectado a las PDU de Rodos (puntos de acceso, enrutadores, conmutadores, varios servidores, etc.).
   
   Los códigos fuente de la biblioteca Rodos.rsc (funciones y scripts, ejemplos de acceso a ellos) están "comentados" con suficiente detalle, lo que puede ser útil para aquellos que desean comprender la biblioteca en detalle (o tal vez modificarlos usted mismo o escribir su propia versión).
   
   En los ejemplos de llamadas a las funciones de reinicio, después de que la función se haya resuelto, es posible enviar mensajes a la dirección de correo electrónico del administrador del enrutador (en la configuración de la variable de script, puede especificar su dirección de correo). En este caso, los scripts usan el servicio de correo RouterOS desde / tool e-mail , cuyos parámetros debe configurar previamente de manera correcta.
   
   

   Planes futuros

   
   En el futuro, se ampliará la biblioteca de scripts para las PDU de Rodos: está previsto crear funciones para la estación meteorológica de Internet RODOS-16, que tiene "a bordo", además de relés, líneas de entrada / salida y sensores de temperatura / humedad / presión atmosférica. También se planea implementar el registro de las funciones no solo en el registro y el correo del enrutador, sino también en el número de teléfono especificado que elija el usuario (enviando mensajes SMS a través del módem del enrutador).
   
   Quizás, en el proceso de uso de la biblioteca por parte de los usuarios (incluidos los lectores de este material), se revelarán algunos errores que, como regla, son inevitables durante cualquier desarrollo. Infórmeme de cualquier error, comentario y sugerencia para su corrección.
   
   Enlace a la descripción del comando Fetch para enrutadores MikroTik
   Enlace a la documentación de las PDU usadas
   Enlace a la biblioteca de funciones de script para la PDU de Rodos
   
   Serkov Sergey Vladimirovich, 26 de diciembre de 2017