api midrotik instalacion sistemas

1. Ejemplos de Integración
API Mikrotik
MUM Montevideo 2017

2. Agenda
HablaIP
Integración & Desarrollo
• Introducción
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

3. Sobre nosotros
HablaIP
Integración & Desarrollo
• Adolfo Troncoso <adolfo.troncoso@hablaip.com>
– Desarrollador con más de 20 años de experiencia
en programación de aplicaciones desktop, web y
móviles con integración en telemetría y procesos
de negocio.
– MTCNA - MTCTCE
• Jaime Cruz M. <jaime.cruz@hablaip.com>
– Integrador de sistemas con más de 10 años de
experiencia en telecomunicaciones, Sistemas
Linux, Asterisk y telefonía IP.
– MTCNA - MTCTCE

4. Sobre HablaIP
HablaIP
Integración & Desarrollo
www.Hablaip.com
Santiago de Chile
• Inicios en el 2015
• Asesoría y soporte
• Desarrollo de aplicaciones
– Telefonía, SMS
– Aplicaciones Android
• Integración de sistemas
– Monitoreo
– Geolocalización

5. Agenda
HablaIP
Integración & Desarrollo
• Introducción
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

6. Introducción
HablaIP
Integración & Desarrollo
• Que es?
–Viene del inglés Application Programming
Interface
–es un conjunto de funciones que permiten
controlar un Mikrotik desde un sistema
externo
• Como funciona la API de Mikrotik:
– A través del envío de comando y recepción del
resultado de su ejecución utilizando el protocolo
Telnet al puerto por defecto 8728/tcp.

7. Introducción
HablaIP
Integración & Desarrollo
• Comandos simples:
/login
/system/reboot
/user/active/listen
• Comandos con atributos:
/queue/simple/add=max-
limit=256k/1M=name=Cli=target=10.10.10.0/24
(consulta de interfaces)
/interface/print?type=ether?type=vlan?#|!

8. Introducción
HablaIP
Integración & Desarrollo
• Ejemplo de traza de comando /login:

9. Introducción
HablaIP
Integración & Desarrollo
• Consulta de información systema:

10. Introducción
HablaIP
Integración & Desarrollo
• Hay una forma facil de usa la API
de Mikrotik¿?

11. HablaIP
Integración & Desarrollo
• Existen librerías para
– PHP
– Delphi
– C /++/#
– Python
– Ruby on rails
– VB .Net
– Java
– Perl
– Etc.
Introducción

12. Agenda
HablaIP
Integración & Desarrollo
• Introduccion
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

13. Ejemplo PHP
HablaIP
Integración & Desarrollo
• Habilitar API en Mikrotik
– IP -> Service
– Enable “api”
– Aplicar seguridad al servicio “api”

14. Ejemplo PHP
HablaIP
Integración & Desarrollo
• Crear un “Group List”
– Aplicar Policies: “api, read, write”

15. Ejemplo PHP
HablaIP
Integración & Desarrollo
• Crear un usuario
– Crear usuario
– Asignar grupo “geo-api”
– Aplicar seguridad

16. Ejemplo en PHP
HablaIP
Integración & Desarrollo
• Librerías de ejemplo
(Denis Basta)
https://wiki.mikrotik.com/wiki/API_PHP_class
(Kamil Trzcinski) GPL
https://wiki.mikrotik.com/wiki/RouterOS_PHP_class
(Vasil Rangelov) LGPL 2.1
https://wiki.mikrotik.com/wiki/API_PHP_package

17. HablaIP
Integración & Desarrollo
• Ejemplo código PHP consulta
– Utiliza clase PHP gentileza: Denis Basta
[http://wiki.mikrotik.com/wiki/API_PHP_class]
Ejemplo en PHP

18. Ejemplo en PHP
HablaIP
Integración & Desarrollo
DEMOSTRACION

19. Agenda
HablaIP
Integración & Desarrollo
• Introduccion
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

20. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación de accesos HotSpot basados en el
número de anexo de la habitación para poder
identificar fácilmente cada usuario
– Usuario = número de habitación (ej. 1020)
– Clave = Ingresada por el usuario desde su anexo
por DTFM

21. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación de accesos HotSpot basados en el
número de anexo de la habitación para poder
identificar fácilmente cada usuario
– Usuario = número de anexo (ej. 1020)
– Clave = Ingresada por el usuario desde su anexo
API

22. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Ingreso al HotSpot mediante nro. habitación

23. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación IVR en Asterisk: extensions.conf
demo: 2904 0172

24. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación IVR en Asterisk: extensions.conf
• Debug de consola de Asterisk
demo: 2904 0172

25. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación de usuario/clave vía API de Mikrotik
demo: 2904 0172

26. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
• Creación de usuario/clave vía API de Mikrotik
demo: 2904 0172
Comando de creación de
usuario HotSpot Mikrotik

27. Asterisk & HotSpot
HablaIP
Integración & Desarrollo
DEMOSTRACION
+(598) 2904 0172

28. Agenda
HablaIP
Integración & Desarrollo
• Introduccion
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

29. Android & HotSpot
HablaIP
Integración & Desarrollo
• Creacion de accesos HotSpot basados en un
mensaje SMS
– Usuario = número de teléfono móvil
– Clave = generada automática y enviada por SMS
wifi
Su clave es: 5476
API Mikrotik

30. Android & HotSpot
HablaIP
Integración & Desarrollo
• Ejemplo de mensajería de envío & respuesta
wifi
Su clave es: 5476
API Mikrotik

31. Android & HotSpot
HablaIP
Integración & Desarrollo
• Número demo +598 9529 9847
• Enviar mensaje: wifi

32. Android & HotSpot
HablaIP
Integración & Desarrollo
DEMOSTRACION
+598 9529 9847

33. Agenda
HablaIP
Integración & Desarrollo
• Introduccion
• Ejemplo básico con PHP
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Ejemplo en C# con PRTG
• Q & A

34. C# & Mikrotik
HablaIP
Integración & Desarrollo
• Ejemplo código C# consultas
– Utiliza clase C# de Wiki Mikrotik
[https://wiki.mikrotik.com/wiki/API_in_C_Sharp]

35. C# & Mikrotik
HablaIP
Integración & Desarrollo
• Creación de un PlugIN de monitoreo en C#
para sistema PRTG.
Dispositivo Mikrotik HotSpot
Sensor vía API de Mikrotik

36. C# & Mikrotik
HablaIP
Integración & Desarrollo
• Se integró un sensor de Mikrotik vía API
– Número de usuarios HotSpot activos
– Número de usuarios HotSpot creados
Sensor creado en Visual C# con
API de Mikrotik

37. C# & Mikrotik
HablaIP
Integración & Desarrollo
Usuarios activos en Mikrotik
HotSpot

38. C# & Mikrotik
HablaIP
Integración & Desarrollo
Gráfico de usuarios
creados/activos en Mikrotik
HotSpot

39. C# & Mikrotik
HablaIP
Integración & Desarrollo
• Ejecutable en C# contra API Mikrotik consulta:
– Número de usuarios HotSpot activos
– Número de usuarios HotSpot creados
API

40. C# & Mikrotik
HablaIP
Integración & Desarrollo
• Ejecutable en C# contra API Mikrotik:
API
Consulta de todos los usuarios
en HotSpot Mikrotik

41. C# & Mikrotik
HablaIP
Integración & Desarrollo
Así se ve en el resultado en PRTG

42. Agenda
HablaIP
Integración & Desarrollo
• Introducción & El problema
• Dashboard con API Mikrotik
• Integración Asterisk & Hotspot
• Integración Android & HotSpot
• Monitoreo integrado con PRTG
• Potencialidad de la API Mikrotik

43. Potencial de API Mikrotik
HablaIP
Integración & Desarrollo
• Posibilidad de integración con cualquier
sistema a través de una red TCP/IP.
– Con o sin Internet
• Existe librerías en múltiples lenguajes
– PHP, Python, Delphi, C#, etc.

44. Potencial de API Mikrotik
HablaIP
Integración & Desarrollo
• Ejemplos presentados hoy:
Posibilidades LÍMITADAS solo por tu imaginación

45. HablaIP
Integración & Desarrollo
Q & A

46. Ejemplos de Integración
API Mikrotik
MUM Montevideo 2017