1Vamos a Sistema / Router

2Seleccionamos una zona.

3Damos click en Agregar Cliente.

4Completamos los campos requeridos en Datos de Conexion

5En datos del cliente va la informacion personal del cliente como nombre y apellidos,domicliio,etc.

6En Configuración avanzada, podemos agregar información adicional como Modelo de la antena, password del portal del cliente, password de la antena, datos del modem wifi,etc Damos click en guardar.

7Ya que se guarde el cliente en el sistema saldra una leyenda que diga que se agrego el cliente correctamente en e rb y en el sistema

8En el rb el cliente se agregara con el nombre,la ip y el plan que asigamos

1Vamos a Sistema / Router.

2Seleccionamos una zona.

3Damos click en Agregar Cliente.

4Completamos los campos requeridos en Datos de Conexion

Datos de Conexion PPOE

1-User PPPOE: Nombre del cliente o servicio 

2-Password PPPOE: Por default WispHub crea una aleatoria pero usted puede colocar la que guste

3-Remote Address PPPOE: :Seleccionamos una de las ip que estan disponibles o escribimos una manualmente

4-Local  Address: Es opcional

5-Plan de Internet PPPOE: Seleccionar el plan PPPOE que le asignaremos al cliente

5En datos del cliente va la informacion personal del cliente como nombre y apellidos,domicliio,etc.

6En Configuración avanzada, podemos agregar información adicional como Modelo de la antena, password del portal del cliente, password de la antena, datos del modem wifi,etc Damos click en guardar.

7Ya que se guarde el cliente en el sistema saldra una leyenda que diga que se agrego el cliente correctamente en e rb y en el sistema

8En el rb el cliente se agregara con el nombre,la ip y el plan que asigamos

¿Como puedo ver la lista de conectados pppoe?

1Para poder observar a los clientes que están conectados por pppoe nos dirigimos a lista de router https://wisphub.net/router/ .

2 Seleccionamos el Router

3 Nos dirigimos a la sección de herramientas y elegimos la opción de PPP Active Connections

4 Enseguida nos mandara a la pantalla donde podremos observar a los clientes que estén activos en ese momento

1Vamos a Sistema / Router

2Seleccionamos una zona.

3Damos click en Agregar Cliente.

4Completamos los campos requeridos en Datos de Conexion

5En datos del cliente va la informacion personal del cliente como nombre y apellidos,domicliio,etc.

6En Configuración avanzada, podemos agregar información adicional como Modelo de la antena, password del portal del cliente, password de la antena, datos del modem wifi,etc Damos click en guardar.

7Ya que se guarde el cliente en el sistema saldra una leyenda que diga que se agrego el cliente correctamente en e rb y en el sistema

8En el rb el cliente se agregara con el nombre,la ip y el plan que asigamos

Agregar Cliente HotSpot

1Vamos a Sistema / Router

2Seleccionamos una zona.

3Damos click en Agregar Cliente.

4Completamos los campos requeridos en Datos de Conexion

Datos de Conexion HotSpot

1-User Hotspot: Nombre del cliente o servicio 

2-Password HotSpot: Por default WispHub crea una aleatoria pero usted puede colocar la que guste 

3-Server Hotspot: Por default WispHub coloca all pero usted puede colocar el server con el cual desee trabajar, en caso de no saber cual server utilizar dejar el de all 

4-Ip:Seleccionamos una de las ip que estan disponibles o escribimos una manualmente 

5-Plan de Internet Hotspot: Seleccionar el plan de Hotspot que le asignaremos al cliente 

5En datos del cliente va la informacion personal del cliente como nombre y apellidos,domicliio,etc.

6En Configuración avanzada, podemos agregar información adicional como Modelo de la antena, password del portal del cliente, password de la antena, datos del modem wifi,etc Damos click en guardar.

7Ya que se guarde el cliente en el sistema saldra una leyenda que diga que se agrego el cliente correctamente en e rb y en el sistema

8En el rb el cliente se agregara con el nombre,la ip y el plan que asigamos

¿Como puedo ver la lista de conectados HotSpot?

1Para poder observar a los clientes que están conectados por HotSpot nos dirigimos a lista de router https://wisphub.net/router/ .

2 Seleccionamos el Router

3 Nos dirigimos a la sección de herramientas y elegimos la opción de HotsPot, dentro de esa opción elegimos la opción de HotSpot Active

4 Enseguida nos mandara a la pantalla donde podremos observar a los clientes que estén activos en ese momento

¿Cómo generar un link de Auto-Login para el portal del cliente?

VIDEO INFORMATIVO

Esta característica puedes generar un link de Auto-Login y mandárselo al cliente, para que este entre al portal del cliente sin la necesidad de ingresar usuario y contraseña, es decir sea redirijo directo a su portal, para poder ver sus datos, facturas, plan, pagar facturas, reportar pagos, ect.

1Ir a la lista de clientes:  https://wisphub.net/clientes/ seleccionar el cliente, botón Herramientas y seleccionar Auto-Login Portal del Cliente

2Para probar que funciona la url de Auto-Login

1-Da click en Copiar link portal del cliente: abres otro navegador y pegas la url y veas que te redireccione automáticamente al portal del cliente.

2.-Dar click en Ir al portal del cliente: aquí te va a cerrar sesión con tu cuenta de administrador y te va loguar como cliente en el portal del cliente.

Obtenida dicha url puedes enviársela al cliente, comentándole que ahí puede ver sus facturas pagadas, pendientes, pagar facturas pendientes, reportar pagos, abrir tickets de soporte, consultar su historial de trafico ect.

y asi se seria la vista del portal del cliente.

¿Cómo le envió el link de Auto-Login de forma masiva a mis clientes?

Enviar las URLs de Auto-Login de forma masiva por medio de SMS

Esta opción solo sirve estando en la sección de Facturas.

1Ir a la lista de facturas: https://wisphub.net/facturas/.

1-Seleccionar todas las facturas que en este caso serían los clientes

2-En la parte de Acciones por lote, seleccionar: Enviar SMS Recordatorio/Vencimiento de pago.

2Escribir lo siguiente.

Por default va a salir un mensaje ya escrito, dicho mensaje lo vamos a borrar y lo vamos a reemplazar por el siguiente tal cual como se muestra a continuación.  Mensaje a Reemplezar:

Estimado cliente de la empresa {{ empresa }} . Le anexo su link para entrar a su portal del cliente. {{ url_autologin }}

Lo que esta entre llaves {{ empresa }} y  {{ url_autologin }} dejalo asi no lo quites, ya que WispHub toma y busca esos datos de forma dinámica, ya que eso toma el nombre de tu empresa y la url de AutoLogin. Si quieres personalizar mas ese mensaje escribelo en la caja de texto, siempre y cuando pongas la tag: {{ url_autologin }} y no te pases mas de 164 caracteres. Puedes saber usar un  contador de caracteres

3Confirmamos que el mensaje haya salido de manera correcta

Yo en mi caso estoy usando la pasarela que WispHub tiene integrada SMS GATEWAY

Por último es opcional, no quieres que la URL de AutoLogin sea la que te da WispHub por default que es la siguiente: avisos.wisphub.net  y quieres personalizarla con tu propio dominio, te anexo la siguiente documentación sobre como personalizar el dominio portal del cliente por tu propio dominio: https://wisphub.net/documentacion/articulo/personalizar-la-url-default-del-portal-del-cliente-por-mi-propio-dominio-166/

¿Para que sirve el correo de bienvenida?

R= Con esta función se le podra enviar a un cliente un correo confirmado su nuevo servicio junto a un boton de auto-login para poder accesar a su portar de cliente. 

Enviar Correo de Bienvenida 

1Ir a https://wisphub.net/clientes/

2Seleccionar al cliente al que se mandara el correo.

3Ir a las opciones de herramientas y elegir la opción "Enviar correo de bienvenida".

4A continuacion se desplegara una ventana de confirmación, para continuar con el proceso confirme el envio al cliente.

5Al terminar el proceso podra ver un mensaje de confirmación indicando que el mensaje fue enviado correctamente.

Por defecto el correo bienvenida contiene esta estructura base.

Podra editarla en cualquier momento desde la seccion de plantillas en https://wisphub.net/plantillas/ sellecionando la opcion editar.

Pasos para realizar Amarre IP/MAC desde la lista de clientes

1Seleccione el cliente con el servicio

Para realizar un amarre ip/mac desde la lista de clientes ingrese a https://wisphub.net/clientes/ y selecciona a el cliente, y despúes dar click en Herramientas y de la lista desplegable seleccione Hacer Amarre IP-MAC

Ahora en la siguiente tabla podemos observar si la mac del cliente seleccionado coincide con lo registrado en la lista ARP del RB.Sin embargo, para realizar un amarre IP/MAC del cliente, seleccione el registro y de la lista de acciones elija Importar Mac Address e interfaz a Wisphub y Hacer Make Static para después dar click en Ejecutar

Por último solo nos quedará confirmar dando click en Si, Estoy Seguro

Si todo es correcto veras lo siguientes avisos

Eliminar Clientes de mi cuenta de WispHub + RouterBoard (RB)

Esta opción te permite borrar clientes de tu cuenta de WispHub + RB.

Es decir, va a borrar el registro del cliente de tu cuenta y luego va a conectar a tu RouterBoard y va a eliminar el cliente también, ya sea que este por: Simple Queues, PCQ + Address List, PPoE, HotsPot.

Esta acción solo te permite borrar 1 cliente a la vez, por motivos de precaución

1-Ir lista de clientes:  https://wisphub.net/clientes/

2-Seleccionar el cliente a eliminar.

3-Botón “Herramientas” ->Seleccionar “Eliminar clientes de WispHub + RB”

Después de seleccionar el o los clientes que queremos eliminar nos pedirá una confirmación para eliminar, daremos click en Sí, Estoy Seguro

Por ultimo nos pedirá una doble confirmación. Escribiremos eliminar_clientes y daremos click en Eliminar Cliente(s)

Posterior a esto el cliente o los clientes estarán eliminados.

Pasos Para Eliminar ONU de WispHub Desde lista de Clientes

1 Ingresar a https://wisphub.net/clientes/ y seleccionamos a el cliente que le deseamos eliminar la ONU asignada, para posteriormente dar click en el menú Herramientas, en la opción Eliminar ONU de WispHub

2 A continuación solo confirmamos que deseamos eliminar la ONU de WispHub en Si, Estoy Seguro

Y veremos el siguiente mensaje, confirmando la acción

A partir de ahora, puede usar los pasos de ¿Cómo autorizar una ONU? para usar de nuevo la ONU

Integración de Wisphub Wifi

Wisphub Wifi es un sistema que nos permite actualizar la información de la red wifi(nombre de red wifi y contraseña) de nuestros usuarios, para poder utilizar esta función es importante seguir una serie de pasos, de igual manera es importante cumplir con ciertos requisitos, a continuación se detallan los pasos a seguir para poder usar esta función.

Requisitos

1. Mikrotik v7.4 o superior
2. Mikrotik con arquitecturas compatibles x86, arm, arm64 o amd64
3. Al menos 1GB de almacenamiento disponible
4. En caso de no contar con un Mikrotik compatible, se puede hacer uso de  CHR o algun dispositivo capaz de soportar el uso de contenedores (Docker)

Consideraciones

1. Para un correcto funcionamiento, las ONU's deben tener habilitado el puerto HTTP, caso contrario no podrá utilizar esta función.
2. Actualmente el proyecto esta diseñado para funcionar unicamente con ONU's de la marca Huawei, por lo que, en caso de utilizar ONU's de otras marcas no podrá hacer uso de esta función.
3. No todos los modelos de Mikrotik son compatibles con esta función, por lo que en caso de querer usarla tendrá que recurrir a algun otro dispositivo capaz de ejecutar contenedores, asi mismo dicho dispositivo tendrá que estar bajo la misma red y debe ser capáz de conectarse a las ONU's.
4. Si desea utilizar in CHR tendrá que asegurarse de que este sea capaz de conectarse a las ONU's de sus cliente, igualmente tendrá que crear las reglas necesarias para que la petición sea procesada por el CHR.

Ejemplo de configuraciones de red

Opción 1 - Configuración con Mikrotik v7 y almacenamiento externo SSD

En el primer escenario, se muestra la configuración de una conexión con Mikrotik v7 mientras se aprovecha el uso de contenedores en el mismo dispositivo. Este enfoque ofrece una gestión eficiente de redes y servicios. En este ejemplo se puede observar que el Mikrotik v6 que no es compatible con el uso de contenedores esta conectado al Mikrotik v7 el cual es el encargado de ejecutar los contenedores, por lo que, con esta configuración el Mikrotik v7 es capaz de interactuar con los clientes del Mikrotik v6, esto gracias a que existe una conexión entre ambos.

Ventajas:

• Si todos los Mikrotik estan bajo la misma red o tienen conexión entre si, basta con configurar unicamente un Mikrotik que cumpla con los requisitos necesarios para el uso de contenedores.

Desventajas

• Para que este escenario sea posible, es necesario el uso de un almacenamiento adicional, debido a que el almacenamiento de fabrica con el que cuenta la mayoria de Mikrotik no es suficiente para poder almacenar contenedores.
• No todos los dispositivos Mikrotik son compatibles, debe verificar que su arquitectura soporte el uso de contenedores.
• Si los Mikrotik no estan conectados entre si o en la misma ubicación seria necesario configurar otro Mikrotik v7 con el almacenamiento adicional en la otra ubicación.

Este escenario es el mismo que el anterior, sin embargo, en este ejemplo el Mikrotik v6 podria estar conectado a la misma OLT que el Mikrotik v7, de igual manera ambos Mikrotik deben tener conexión entre si.

Opción 2 - Configuración con CHR

El segundo caso implica la interconexión entre dos Mikrotik v6 (Mk v6) y un Mikrotik Cloud Hosted Router v7 (CHR v7). En este ejemplo ambos Mikrotik estan conectados al mismo CHR, por lo que el CHR es capaz de realizar acciones en ambos Mikrotik sin la necesidad de que los Mikrotik esten conectados entre si.

Ventajas:

• Opción recomendada
• Todo esta centralizado en el CHR y no es necesario realizar modificaciones a la red.
• Los Mikrotik pueden estar fisicamente en diferentes ubicaciones

Desventajas:

Opción 3 - Configuración con Dispositivo Linux/Raspberry Pi

En el tercer escenario, se muestra la conectividad entre dos Mikrotik v6 (Mk v6) y uno de ellos conectado a un dispositivo Linux que ejecuta contenedores. En este ejemplo ambos Mikrotik estan conectados entre si, esto con el fin de que el dispositivo Linux sea capaz de realizar acciones en los clientes de ambos Mikrotik.

Ventajas:

• No es necesario que el Mikrotik cumpla con los requisitos necesarios para el uso de contenedores, puesto que, el dispositivo Linux sera el encargado de ejecutar los contenedores.
• Si todos los Mikrotik estan bajo la misma red o tienen comunicación entre si, unicamente deberia configurar un dispositivo Linux el cual podrá estar conectado al Mikrotik de su preferencia.

Desventajas:

• Tendra que depender de algun dispositivo externo que soporte el uso de contenedores.
• Si los Mikrotik no estan conectados entre si o en la misma ubicación seria necesario instalar otro dispositivo en la otra ubicación.

Habilitar Contenedores en Mikrotik

Para poder hacer uso de los contenedores en nuestro Mikrotik, es necesario descargar el archivo all_packages de la página oficial de Mikrotik., es importante asegurese de descargar el archivo correspondiente a su Mikrotik de lo contrario no podrá hacer uso de los contenedores.

Una vez haya descargado el archivo, debera descomprimir el archivo e importar el archivo container a nuestro Mikrotik.

Una vez importado el archivo, será necesario reiniciar nuestro Mikrotik, podemos hacerlo desde System/Reboot.

Finalmente para poder hacer uso de los contenedores es necesario ejecutar el comando

        /system/device-mode/update container=yes
      

Esto pedirá una confirmación que podemos realizar con el boton mode del Mikrotik, en caso de no contar con este boton es necesario desconectar el Mikrotik de la corriente, esperar unos segundos y conectarlo nuevamente, con esto deberia quedar habilitado el uso de contenedores en nuestro Mikrotik.

Crear Reglas en Mikrotik

Una vez hayamos habilitado el uso de contenedores es necesario agregar algunas configuraciones para nuestro contenedor.

Añadir interfaz veth para el contenedor

        /interface/veth/add name=veth1 address=172.17.0.2/24 gateway=172.17.0.1
      

Crear un bridge para nuestro conenedor, utilizar la interfaz veth

        /interface/bridge/add name=containers
      

        /ip/address/add address=172.17.0.1/24 interface=containers
      

        /interface/bridge/port add bridge=containers interface=veth1
      

Configurar NAT para el tráfico saliente

        /ip/firewall/nat/add chain=srcnat action=masquerade src-address=172.17.0.0/24
      

Configurar redireccionamiento 

        /ip/firewall/nat/add chain=dstnat protocol=tcp dst-port=7000 action=dst-nat to-address=172.17.0.2 to-ports=7000 comment=CONTENEDOR
      

Con esta instrucción estamos especificando que todo aquello que llegue por el puerto 7000 sea redirigido a nuestro contenedor, el cuál será el encargado de modificar la red wifi

Crear entorno del contenedor

        /container/envs/add name=wisphub_wifi_envs key=TZ value="America/United States"
      

        /container/envs/add name=wisphub_wifi_envs key=WEBPASSWORD value="mysecurepassword"
      

        /container/envs/add name=wisphub_wifi_envs key=DNSMASQ_USER value="root"
      

Crear mount del contenedor

        /container/mounts/add name=etc_wisphub_wifi src=disk1/etc dst=/etc/wisphub_wifi
      

        /container/mounts/add name=dnsmasq_wisphub_wifi src=disk1/etc-dnsmasq.d dst=/etc/dnsmasq.d
      

Estas son algunas variables de entorno para el uso de nuestro contenedor, puede cambiar los valores si asi lo desea.

Añadir registry-url

        /container/config/set registry-url=https://registry-1.docker.io tmpdir=disk1/pull
      

Esto nos permitirá descargar imagenes de los repositorios de Docker.

Descargar Imagen del Proyecto

Una vez hayamos realizado las configuraciones previas, procedemos a descargar la imagen con el siguiente comando, asegurese de ejectuar el comando correspondiente a la arquitectura de su Mikrotik.

X86

        /container/add remote-image=soportewisphub/wisphub_wifi:latest interface=veth1 root-dir=disk1/wisphub-wifi/ envlist=wisphub_wifi_envs mounts=dnsmasq_wisphub_wifi,etc_wisphub_wifi hostname=WisphubWifi
      

ARM

        /container/add remote-image=soportewisphub/wisphub_wifi_arm:latest interface=veth1 root-dir=disk1/wisphub-wifi/ envlist=wisphub_wifi_envs mounts=dnsmasq_wisphub_wifi,etc_wisphub_wifi hostname=WisphubWifi
      

ARM64

        /container/add remote-image=soportewisphub/wisphub_wifi_64:latest interface=veth1 root-dir=disk1/wisphub-wifi/ envlist=wisphub_wifi_envs mounts=dnsmasq_wisphub_wifi,etc_wisphub_wifi hostname=WisphubWifi
      

A continuación comenzara la descarga de nuestro contenedor, en este punto unicamente debemos esperar a que se descargue la imagen

Una vez se haya extraido será necesario inicializarlo, hasta este punto nuestro contenedor deberia funcionar correctamente, por lo que, la configuración restante se haría del lado de Wisphub

Configurar eventos de API personalizada

Es necesario agregar los eventos de API personalizada al Mikrotik al que configuramos previamente, para ello nos dirigimos a la pestaña de editar router/eventos de api personalizada y agregar un nuevo registro.

En dominio ponemos la dirección IP de nuestro Mikrotik, en caso de usar VPN tendremos que poner esta dirección IP, en ambos casos tendremos que añadir el puerto 7000, el cual es el puerto a través del cual accederemos al contenedor que aloja el proyecto, activamos la API personalizada y guardamos los cambios.

Información Servicio Cliente

Para un correcto funcionamiento es necesario que nuestro cliente cuente con la información necesaria, concretamente es necesario tener los datos de acceso al router wifi, dicha información la podremos ver al editar el servicio de nuestros clientes.

Actualizar Onu Wifi

Una vez se haya realizado la configuración correspondiente, desde el listado de clientes seleccionamos al que queramos modificar la información de la red wifi, en herramientas seleccionamos la opción Cambiar Contraseña Wifi, a continuación nos llevara a una nueva vista donde podremos modificar la información.

Aqui podremos actualizar el nombre y contraseña de la red wifi, tanto la banda de 2.4ghz como la de 5ghz, al modificar la información nos mostrará una pantalla indicandonos que se estan aplicando los cambios, si todo ha salido bien al final nos mostrará un mensaje indicandonos que la información se ha actualizado correctamente.

En caso de que haya ocurrido algún error se nos mostrará un mensaje indicandonos lo ocurrido. 

Portal del Cliente

Esta función fue diseñada para que el cliente también pueda modificar su red wifi, para ello es necesario activar la opción desde los ajustes de Portal del Cliente, si no se activa el cliente no podrá hacer uso de esta funcón pero un usuario de tipo Staff si podrá realizarlo siempre y cuando se hayan configurado los eventos de API personalizada.

El cliente tendra unicamente los campos de nombre de red y contraseña wifi, esto por simplicidad, en el caso de que el router wifi del cliente soporte doble banda el cambio se realizará en las redes de 2.4ghz y 5ghz.

Como actualizar la imagen

No existe una manera automatica de actualizar la imagen por lo que cuando haya una nueva versión disponible será necesario eliminar la existente y volver a descargarla.

Detener y eliminar contenedor

Descargar nuevamente la imagen

Iniciar contenedor

Configurar Dispositivo Linux

Si no le es posible configurar su Mikrotik por limitaciones, puede optar por utilizar algún dispositivo, recomendamos el uso de un Raspberry Pi o algún dispositivo con sistema operativo Linux, a continuación le mostramos un ejemplo de como realizar la configuración en Ubuntu, tenga presente que esto es unicamente para poder configurar el dispositivo, en su Mikrotik deberá crear las reglas necesarias para que que este dispositivo sea el encargado de procesar las solicitudes.

Actualizamos nuestro sistema

        sudo apt update
      

        sudo apt upgrade
      

Instalamos Docker

        sudo snap install docker
      

Verificamos la versión de Docker

        docker --version
      

Descargamos la imagen del proyecto

        x86
        sudo docker pull soportewisphub/wisphub_wifi
      

        arm
        sudo docker pull soportewisphub/wisphub_wifi_arm
      

        arm64
        sudo docker pull soportewisphub/wisphub_wifi_64
      

Verificamos que la imagen se haya descargado

        sudo docker images
      

Corremos la imagen en el puerto 7000

        sudo docker run -p 7000:7000 soportewisphub/wisphub_wifi