Resolución de problemas del Captive Portal de Ruckus: lista de comprobación de redirección WISPr, hotspot y walled garden

La mayoría de los fallos del Captive Portal de Ruckus se deben a cinco factores: la URL de inicio de sesión y la página de inicio del punto de acceso (WISPr), la falta de entradas en el walled garden para el portal y sus activos, una contraseña no coincidente en la interfaz del portal hacia el norte (northbound), fallos de autenticación o contabilidad de RADIUS, y advertencias de certificado de redirección HTTPS. Compruébelos en ese orden, utilizando el historial de eventos del cliente en SmartZone, Ruckus One o Unleashed.

¿Qué aspecto tiene un Captive Portal de Ruckus con fallos?

Un servicio de punto de acceso Ruckus utiliza WISPr (itinerancia de proveedor de servicios de Internet inalámbrico). Se trata de un marco en el que el controlador mantiene a un invitado no autenticado detrás de un Captive Portal hasta que un sistema externo lo aprueba. Un Captive Portal es la página de bienvenida que completa un invitado antes de acceder a internet. Cuando la cadena se rompe, el invitado experimenta uno de estos seis síntomas:

• Sin redirección alguna. El dispositivo se conecta al SSID y recibe una dirección IP, pero no aparece ninguna pantalla de inicio de sesión y el navegador agota el tiempo de espera.
• Página de bienvenida en blanco o a medio cargar. Se abre la pantalla, pero no se cargan los logotipos, las fuentes, los scripts o los botones de inicio de sesión social.
• Una advertencia de certificado antes del portal. El navegador muestra "La conexión no es privada" o un mensaje similar, y el invitado debe hacer clic para continuar.
• Un bucle de inicio de sesión. El invitado completa el formulario y vuelve a la página de bienvenida, todavía sin conexión.
• Sin pantalla de inicio de sesión, pero sin internet. El dispositivo informa de que está conectado, por lo que el asistente de red cautiva nunca se abre.
• Conectado, pero sin datos de sesión. Los invitados navegan con normalidad, pero los inicios de sesión y la duración de las sesiones nunca llegan a sus informes.

Los dos últimos síntomas son fáciles de pasar por alto porque nadie llama al servicio de asistencia. Se dará cuenta más tarde, cuando sus datos de invitados dejen de crecer.

¿Qué suele causar los fallos del Captive Portal de Ruckus?

Resulta útil conocer la secuencia en primer lugar. El artículo de soporte del Captive Portal de Purple lo detalla. El controlador gestiona la interacción WiFi con los servidores de páginas de bienvenida de Purple. Esos servidores recopilan los datos del invitado y emiten un inicio de sesión de un solo uso. A continuación, el controlador pasa ese inicio de sesión al servidor RADIUS de Purple para completar el acceso. RADIUS (Remote Authentication Dial-In User Service, RFC 2865) es el protocolo que autentica la sesión. La contabilidad RADIUS (RFC 2866) informa de la sesión posteriormente.

Cada paso tiene su propio modo de fallo.

Ajustes de redirección del servicio de punto de acceso y de la página de inicio

El servicio de punto de acceso contiene la URL de inicio de sesión externa y la página de inicio. La URL de inicio de sesión es a donde se envía a los invitados no autenticados. La página de inicio es donde aterrizan tras iniciar sesión. Una errata, una URL obsoleta tras un cambio de portal o un servicio de punto de acceso incorrecto asociado a la WLAN detienen la redirección. Una página de inicio que apunte a una URL bloqueada o retirada hace que un inicio de sesión correcto parezca un fallo.

Vacíos en el walled garden

El walled garden es la lista de destinos a los que un invitado no autenticado puede acceder antes de iniciar sesión. Debe incluir el nombre de host del portal y todos los hosts desde los que la página de bienvenida carga recursos. También debe incluir los dominios de cualquier proveedor de identidad social o de inicio de sesión único que ofrezca. Si añade una opción de inicio de sesión, lea cómo habilitar el inicio de sesión único y añada los dominios de ese proveedor. Un solo host de recursos que falte producirá una página a medio cargar.

El error contrario también causa problemas. Los dispositivos prueban la conectividad comprobando un nombre de dominio predefinido, según el artículo de soporte de Purple. Si ese dominio de prueba se encuentra en el walled garden, el dispositivo cree que está conectado. La solicitud nunca aparece y el invitado se queda tirado.

Credenciales de la interfaz del portal hacia el norte (Northbound)

En SmartZone, la interfaz del portal hacia el norte es el método que utiliza un portal externo para indicar al controlador que un invitado ha iniciado sesión. El portal se autentica en esa interfaz con una contraseña establecida en el controlador. Si esa contraseña cambia en un solo lado, el portal no podrá autorizar a nadie. El invitado completa el formulario y vuelve a entrar en un bucle hacia la página de bienvenida.

Autenticación y contabilidad RADIUS

El controlador reenvía el inicio de sesión único a RADIUS. La autenticación falla si el secreto compartido difiere, si el servidor RADIUS no está disponible o si las solicitudes llegan desde una dirección que el servidor no reconoce. Los fallos de contabilidad son más silenciosos. Los invitados se conectan a internet, pero los registros de inicio y fin de sesión nunca llegan.

Comportamiento de redirección HTTPS

Los navegadores modernos esperan una página de inicio de sesión a través de HTTPS. El artículo sobre certificados Cisco WLC de Purple describe el efecto en los controladores Cisco. Una redirección HTTP a una dirección de controlador activa una advertencia de seguridad, y el invitado debe hacer clic para continuar. La solución en este caso es un certificado de confianza pública cuyo Common Name coincida con el nombre de host de autenticación web del controlador. El mismo principio se aplica al habilitar la redirección HTTPS en un controlador Ruckus. Un certificado caducado, o un error de coincidencia de nombre, hace que la advertencia vuelva a aparecer.

¿Cómo averiguar cuál es la causa?

Empiece por el síntoma, no por la configuración. La tabla asocia cada síntoma con su causa más probable y con el primer lugar donde debería mirar.

Síntoma	Causa más probable	Dónde mirar primero	Primera comprobación
No hay solicitud de inicio de sesión, el navegador agota el tiempo de espera	URL de inicio de sesión del punto de acceso incorrecta, o servicio de punto de acceso incorrecto en la WLAN	Ajustes del servicio de punto de acceso (WISPr) y de la WLAN	Abra neverssl.com en un dispositivo de prueba y vea dónde aterriza
La página de bienvenida se carga sin imágenes ni botones	Falta el host de recursos o del proveedor de identidad en el walled garden	Lista del walled garden	Cargue el portal en un portátil y enumere todos los hosts bloqueados en las herramientas de desarrollo del navegador
El dispositivo indica que está en línea, no hay solicitud, no hay internet	Dominio de prueba de conectividad en el walled garden	Lista del walled garden	Elimine las entradas de comodín genéricas y vuelva a probar
El formulario se completa, el invitado vuelve al bucle	Discrepancia en la contraseña de la interfaz del portal Northbound	Configuración de la interfaz Northbound e integración del portal	Confirme que la contraseña coincide en ambos lados
Inicio de sesión rechazado tras el formulario	Discrepancia en el secreto compartido de RADIUS o en la dirección de origen	Servicio de autenticación RADIUS y eventos de clientes	Busque tiempos de espera de autenticación o rechazos
Invitados conectados, sin datos de sesión	RADIUS accounting mal configurado o no vinculado	Servicio de RADIUS accounting en la WLAN	Confirme que el accounting está habilitado y apunta al servidor correcto

Reprodúzcalo en un dispositivo limpio

Olvide el SSID en un teléfono de prueba y en un ordenador portátil de prueba, y luego vuelva a conectarse. Si la solicitud no se abre, el artículo de soporte de Purple recomienda navegar a neverssl.com. Ese sitio evita los problemas de redirección SSL, por lo que muestra si la redirección en sí funciona.

Lea los eventos del cliente

Todas las plataformas Ruckus mantienen un historial de eventos del cliente. En SmartZone, utilice los registros de eventos y alarmas y el historial de conexiones del cliente. En Ruckus One, abra el cliente y revise sus eventos. En Unleashed, verifique el registro de eventos para ver la dirección MAC del cliente. Busque tres cosas: si el cliente se asoció, si fue redireccionado y si RADIUS lo aceptó o lo rechazó. Esa secuencia le indica qué eslabón de la cadena se rompió.

¿Cómo se soluciona en SmartZone, Ruckus One y Unleashed?

Las soluciones siguen el mismo orden en las tres plataformas. Los menús difieren, por lo que debe seguir la documentación de Ruckus para su versión y el artículo de soporte del Captive Portal para obtener los valores de Purple.

SmartZone

Confirme que la WLAN utiliza el servicio de punto de acceso (WISPr) que espera y que su URL de inicio de sesión coincide con la integración. Vuelva a crear el walled garden a partir de la lista actual, no de memoria. Compruebe que la contraseña de la interfaz del portal Northbound coincide con la configurada para el portal. Luego, confirme que los servicios de autenticación y accounting de RADIUS apuntan a los servidores correctos con el secreto compartido correcto.

Ruckus One

Ruckus One gestiona los mismos elementos WISPr de forma centralizada. Compruebe la configuración del proveedor del portal de la red de invitados, el walled garden y los servicios de RADIUS. Las anulaciones a nivel de ubicación merecen atención, ya que una ubicación puede desviarse de la plantilla aplicada en todos los demás lugares.

Unleashed

Unleashed ejecuta la función de controladora en un punto de acceso, por lo que debe comprobar el servicio de punto de acceso en ese AP maestro. Preste atención a la configuración del walled garden y de RADIUS, y confirme que el servicio de punto de acceso está vinculado a la WLAN de invitados.

Descarte fallos similares

Algunas quejas parecen fallos del portal pero no lo son. Si a los clientes se les vuelve a solicitar que se registren al pasar de un punto de acceso a otro, lea resolución de problemas de roaming en WLAN corporativas. Si las sesiones se caen de forma aleatoria en canales de 5GHz, la lista de verificación de diagnóstico de eventos de radar DFS es el mejor punto de partida.

¿Cómo se ve esto en un entorno real?

Los dos escenarios siguientes son ilustrativos. Muestran el método en lugar de informar sobre un despliegue específico.

Escenario 1: un hotel de 200 habitaciones después del rediseño de la página de bienvenida

Situación. El equipo de marketing relanzó la página de bienvenida del hotel. A la mañana siguiente, recepción informó de que los huéspedes veían una página en blanco con un único campo de formulario.

Qué se hizo. El ingeniero cargó el portal en un ordenador portátil y enumeró las solicitudes bloqueadas en las herramientas de desarrollo del navegador. El nuevo diseño extraía fuentes e imágenes de un host que faltaba en el walled garden de SmartZone. El ingeniero añadió ese host, volvió a conectar un teléfono y un portátil de prueba, y confirmó que ambos mostraban la página completa.

Resultado. La página de bienvenida completa se mostró en ambos dispositivos de prueba en la primera repetición de la prueba. La solución consistió en una sola entrada en el walled garden, y los eventos de clientes mostraron que los huéspedes volvían a superar la redirección y la aceptación de RADIUS. Para obtener más información sobre la experiencia de los clientes en este sector, consulte Purple para Hoteles.

Escenario 2: una cadena minorista de 40 tiendas después de una migración de controlador

Situación. Un minorista trasladó sus tiendas a un nuevo clúster de SmartZone. Los compradores aún podían conectarse a Internet, pero los informes de clientes mostraban cero sesiones nuevas en las 40 tiendas.

Qué se hizo. Los eventos de clientes mostraron aceptaciones de autenticación RADIUS pero ningún registro de contabilidad. El servicio de contabilidad no se había asociado a la WiFi de invitados en el nuevo clúster. El ingeniero lo asoció y confirmó que el secreto compartido coincidía.

Resultado. Los registros de sesión volvieron a aparecer en las 40 tiendas. Los compradores no experimentaron interrupciones, ya que solo se habían visto afectados los informes. Consulte Purple para Retail para ver cómo esos datos de sesión alimentan la información sobre los compradores.

¿Cómo evitar que vuelvan a ocurrir fallos en el Captive Portal de Ruckus?

La mayoría de los fallos repetidos provienen de los cambios, no de los errores del sistema. Cinco hábitos los previenen:

1. Trate el walled garden como un documento controlado. Registre cada entrada, su propietario y el motivo de su existencia. Revíselo cada vez que cambie la página de bienvenida.
2. Rotar los secretos en ambos lados a la vez. Cambie la contraseña de la interfaz del portal hacia el norte y el secreto compartido de RADIUS en una única ventana de cambio, nunca en un solo lado.
3. Realice un seguimiento de la caducidad de los certificados. Agende la renovación mucho antes de que caduque el certificado de redirección HTTPS y vuelva a comprobar la coincidencia de nombres después.
4. Realice pruebas después de cada cambio. Realice la misma comprobación en un iPhone, un teléfono Android, un portátil Windows y un portátil macOS. Los diferentes sistemas operativos gestionan el Captive Network Assistant de distintas maneras.
5. Supervise el recuento de sesiones a diario. Una caída repentina a cero en sus análisis de WiFi apunta a la contabilidad (accounting) antes de que cualquier invitado se queje.

Mantenga abierta la red de invitados, tal como recomienda el artículo de soporte de Purple. Una red abierta es la convención estándar, y un comportamiento familiar reduce la fricción al iniciar sesión. Para los operadores de transporte, donde los pasajeros se conectan en movimiento, se aplican las mismas comprobaciones; consulte Purple para Trenes.

Preguntas frecuentes

¿Funciona Purple con Ruckus SmartZone, Ruckus One y Unleashed?

Sí, Purple Guest WiFi se ejecuta en los servicios de punto de acceso (WISPr) de Ruckus como un Captive Portal externo. Purple es independiente del hardware y también funciona con Cisco Meraki, HPE Aruba, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme y Fortinet. El controlador gestiona la redirección y el RADIUS, mientras que Purple aloja la página de bienvenida y autentica al invitado. Los valores y pasos de configuración se encuentran en el artículo de soporte del Captive Portal de Purple.

¿Necesitamos nuevos puntos de acceso para añadir Purple a una red Ruckus existente?

No, Purple se ejecuta como una superposición en la nube sobre los puntos de acceso y el controlador de Ruckus que ya posee. Configura un servicio de punto de acceso, un walled garden y los ajustes de RADIUS en el controlador, y luego apunta la WLAN de invitados a Purple. No se reemplaza nada en las instalaciones. La mayor parte del esfuerzo se centra en probar la redirección en dispositivos iOS, Android, Windows y macOS antes de la puesta en marcha.

¿Podemos pasar del portal de invitados integrado de Ruckus a Purple sin interrumpir a los invitados?

Sí, siempre que cree primero la configuración de Purple en una WLAN de prueba independiente. Configure el servicio de punto de acceso, el walled garden y los servicios RADIUS junto a su red de invitados activa, y demuestre el inicio de sesión completo en dispositivos de prueba. Una vez que funcione, asocie el nuevo servicio de punto de acceso a la WLAN activa durante un período de baja actividad. Los invitados verán una nueva página de bienvenida, no una interrupción del servicio.

¿Cómo gestiona Purple los datos de los invitados recopilados a través de un Captive Portal de Ruckus?

Purple recopila datos de origen (first-party data) a través de opciones de consentimiento consciente en la página de bienvenida. Purple cuenta con las certificaciones ISO 27001 y Cyber Essentials, y opera de acuerdo con el GDPR y la CCPA. El controlador de Ruckus no almacena datos de marketing. Pasa un inicio de sesión único al servidor RADIUS de Purple, por lo que los detalles de los invitados permanecen dentro de la plataforma certificada de Purple en lugar de dispersarse por los controladores de cada ubicación.

¿Cuánto tiempo se tarda en implementar un Captive Portal de Ruckus con Purple?

Un único centro suele configurarse en una sola sesión de trabajo, ya que no se realizan cambios de hardware. El controlador necesita un servicio de punto de acceso, un walled garden y autenticación y contabilidad (accounting) RADIUS. Los despliegues en múltiples ubicaciones requieren más tiempo, principalmente por las pruebas y el control de cambios más que por la configuración. En Ruckus One o SmartZone, una plantilla aplicada de forma centralizada mantiene la coherencia en cada establecimiento y reduce el riesgo de desviaciones entre ubicaciones.

¿A qué escala está probada la plataforma de WiFi de invitados de Purple?

Purple funciona en más de 80.000 recintos activos y registró 440 millones de inicios de sesión en 2024, según los propios datos de la empresa Purple. Estos recintos abarcan los sectores de hostelería, comercio minorista, transporte, educación y el sector público. Purple opera desde 2012, y cada implantación utiliza la misma página de bienvenida y el mismo flujo RADIUS descritos en esta guía, independientemente del proveedor de hardware compatible que gestione la red subyacente.