Cambium Networks cnPilot and cnMaestro Integration with Purple WiFi
Esta guía de referencia detalla la integración de los puntos de acceso cnPilot y el controlador en la nube cnMaestro de Cambium Networks con la plataforma de inteligencia Purple WiFi. Cubre la arquitectura, la configuración del Captive Portal, los requisitos de walled garden, el Wi-Fi para personal mediante 802.1X y la segmentación dinámica de VLAN utilizando Cambium ePSK para entornos multi-inquilino.
Escuchar esta guía
Ver transcripción del podcast
- Resumen Ejecutivo
- Análisis Técnico Detallado
- Arquitectura de Integración
- Requisitos de Walled Garden
- Segmentación Multitenant con Cambium ePSK
- Guía de Implementación
- 1. Configurar la WLAN de Invitados
- 2. Habilitar el Hotspot Externo
- 3. Configurar la Autenticación y Contabilidad de RADIUS
- 4. Definir el Walled Garden
- 5. Configurar 802.1X para el WiFi del Personal
- Best Practices
- Troubleshooting & Risk Mitigation
- ROI & Business Impact

Resumen Ejecutivo
Para aquellos entornos empresariales que estandarizan su infraestructura con Cambium Networks, el despliegue de una solución de WiFi para invitados de nivel de producción requiere una integración estrecha entre la capa de acceso inalámbrico y la plataforma de gestión de identidades. Esta guía proporciona una estrategia definitiva para integrar los puntos de acceso Cambium cnPilot y el controlador en la nube cnMaestro con Purple WiFi. Al combinar el hardware escalable de Cambium con el Captive Portal, la autenticación RADIUS y las capacidades analíticas de Purple, los equipos de TI pueden transformar sus redes inalámbricas de un centro de costes a un activo estratégico. La arquitectura detallada aquí admite desde el acceso básico para invitados hasta la segmentación multiinquilino compleja mediante las claves precompartidas privadas (PPSK) de Cambium, ofreciendo una conectividad segura, compatible y rica en datos en entornos de hostelería, comercio minorista y sector público.
Análisis Técnico Detallado
La integración entre Cambium Networks y Purple se basa en protocolos estándar de redirección HTTP y RADIUS. Este enfoque independiente del proveedor garantiza una seguridad robusta, compatibilidad multiplataforma y una gestión centralizada a través de cnMaestro.
Arquitectura de Integración
El mecanismo principal consiste en un redireccionamiento de Captive Portal gestionado por el AP de Cambium, combinado con la autenticación RADIUS gestionada por Purple.

Cuando un dispositivo de invitado se asocia con un SSID de invitado abierto, el AP de Cambium intercepta la solicitud HTTP inicial. En lugar de enrutar el tráfico a Internet, el AP redirige el dispositivo a la URL del Captive Portal alojado de Purple. El invitado completa el flujo de autenticación en la página de inicio de Purple, que admite el inicio de sesión con redes sociales, el registro por correo electrónico y formularios personalizados de captura de datos.
Tras una autenticación correcta, el backend de Purple envía un mensaje RADIUS Access-Accept al AP de Cambium en el puerto UDP 1812. Este mensaje indica al AP que cambie el estado del dispositivo del cliente de un entorno limitado de preautenticación (walled garden) a un acceso total a la red. Simultáneamente, el AP envía datos de contabilidad RADIUS a Purple en el puerto UDP 1813, lo que alimenta los paneles de análisis de Purple con información sobre la duración de la sesión, el uso de datos y el tipo de dispositivo.
Requisitos de Walled Garden
El walled garden es un componente crítico del flujo del Captive Portal. Define las direcciones IP y los dominios específicos a los que puede acceder un dispositivo no autenticado. Si el walled garden está mal configurado, el dispositivo no podrá cargar el portal de Purple, lo que provocará un error de tiempo de espera en la conexión.
Para que la integración funcione, el walled garden debe incluir los dominios del portal de Purple, cualquier endpoint de la Content Delivery Network (CDN) que aloje recursos del portal y los dominios de cualquier proveedor de identidad compatible (como Facebook, Google o Microsoft Entra ID).
Segmentación Multitenant con Cambium ePSK
La implementación de Cambium de las Claves Precompartidas Privadas (Private Pre-Shared Keys), denominada comercialmente ePSK, permite a los arquitectos de red segmentar el tráfico de forma segura sin transmitir múltiples SSIDs.

Con ePSK, un único SSID admite hasta 2.000 contraseñas únicas. Cada contraseña se asocia a una VLAN específica. Cuando un usuario se conecta utilizando su clave única, el AP de Cambium asigna automáticamente su tráfico a la VLAN asignada. Esta función es de gran valor para entornos multitenant, como espacios de coworking o edificios residenciales, donde cada inquilino requiere un segmento de red aislado. Purple se integra con esta arquitectura gestionando el ciclo de vida de ePSK a través de la API de cnMaestro, automatizando el aprovisionamiento, la asignación de VLAN y la revocación de las credenciales de los inquilinos.
Guía de Implementación
La implementación de la integración entre Cambium y Purple requiere una configuración precisa en la consola de cnMaestro en la nube. Siga estos pasos para establecer el servicio básico de WiFi para invitados.
1. Configurar la WLAN de Invitados
Navegue hasta el menú de Configuración en cnMaestro, seleccione Perfiles de WiFi y abra la pestaña WLANs. Cree un nuevo perfil de WLAN.
- Nombre / SSID: Defina el nombre de la red de invitados (p. ej., "Venue Guest WiFi").
- Seguridad: Establézcala en Abierta.
- Aislamiento de Clientes: Establézcalo en Habilitar para evitar que los dispositivos de los invitados se comuniquen entre sí en la subred local.
2. Habilitar el Hotspot Externo
Dentro de la configuración de la WLAN, localice la sección Acceso de Invitados (Guest Access).
- Habilitar Acceso de Invitados: Marque esta casilla.
- Tipo de Portal: Seleccione External Hotspot (Hotspot Externo).
- URL de Página Externa: Introduzca la URL específica del Captive Portal proporcionada por su administrador de cuentas de Purple.
3. Configurar la Autenticación y Contabilidad de RADIUS
En la misma sección de Acceso de Invitados, configure los parámetros de RADIUS.
- Servidor de Autenticación: Introduzca la dirección IP del servidor RADIUS principal de Purple.
- Puerto de Autenticación:
1812 - Servidor de Contabilidad: Introduzca la dirección IP del servidor RADIUS principal de Purple.
- Puerto de Contabilidad:
1813 - Secreto Compartido: Introduzca el secreto compartido complejo proporcionado por Purple. Asegúrese de que coincida exactamente en ambas plataformas.
4. Definir el Walled Garden
En la configuración del Hotspot Externo, complete la lista del walled garden. Debe añadir los dominios principales de Purple y los dominios específicos requeridos para los métodos de autenticación elegidos (p. ej., proveedores de inicio de sesión social).
5. Configurar 802.1X para el WiFi del Personal
Para asegurar el acceso del personal, cree un perfil de WLAN independiente en cnMaestro.
- Security: Set to WPA2-Enterprise.
- RADIUS Server: Point to Purple's RADIUS server IP on port 1812.
Staff authenticate using their corporate credentials via Microsoft Entra ID or Google Workspace, which Purple validates. Purple then returns a Tunnel-Private-Group-ID RADIUS attribute, instructing the Cambium AP to place the staff device onto the secure corporate VLAN.
Best Practices
- VLAN Trunking: Ensure that all required VLANs (Guest, Staff, Management) are trunked on the switch ports connecting to the Cambium APs. If the VLAN is missing from the trunk, authenticated clients will fail to obtain an IP address via DHCP.
- Firmware Consistency: Standardise your AP estate on cnPilot firmware version 6.0 or later. This version provides the most stable support for external hotspot redirection and ePSK functionality.
- Accounting is Mandatory: Never disable RADIUS accounting. Purple relies entirely on the UDP 1813 accounting stream to generate dwell time metrics, visit frequency data, and compliance logs.
- Avoid Local PSKs for Staff: Replace legacy shared passwords with 802.1X authentication for staff networks. This approach aligns with ISO 27001 requirements by tying network access to individual, auditable identities.
Troubleshooting & Risk Mitigation
When integration issues arise, they typically manifest during the initial Captive Portal redirect or the RADIUS authentication phase.
- Portal Fails to Load: This is almost always a walled garden issue. If a guest device connects to the SSID but receives a connection timeout instead of the splash page, the AP is blocking access to the Purple portal domain. Verify your walled garden entries in cnMaestro and ensure DNS resolution is permitted pre-authentication.
- Authentication Fails (Invalid Credentials Error): Check the RADIUS shared secret. A mismatch between cnMaestro and Purple will cause the RADIUS server to silently drop the authentication requests.
- Device Authenticates but Lacks Internet Access: This indicates a failure in the dynamic VLAN assignment or DHCP process. Verify that Purple is returning the correct VLAN ID in the RADIUS response and confirm that the switch port trunking configuration allows that VLAN.
ROI & Business Impact
Deploying Purple WiFi on Cambium Networks infrastructure transforms a standard network utility into a measurable business asset. By capturing first-party data at the point of authentication, venues can build comprehensive visitor profiles and drive targeted marketing campaigns.
Por ejemplo, Harrods implementó Purple Guest WiFi y logró un ROI de marketing de 57 veces al integrar los datos capturados con su programa de fidelización. De manera similar, AGS Airports generó un ROI del 842% al utilizar un ancho de banda escalonado y una interacción dirigida con los pasajeros. Al estandarizar con Cambium cnMaestro y Purple, los líderes de TI pueden ofrecer una conectividad segura y conforme a la normativa, al tiempo que proporcionan a la organización de marketing los datos necesarios para impulsar los ingresos.
Definiciones clave
Captive Portal
Una página de inicio de sesión personalizada que requiere que los usuarios se autentiquen o acepten los términos antes de obtener acceso a una red WiFi pública o empresarial.
Utilizado en implementaciones de WiFi de invitados para recopilar datos de primera mano, aplicar políticas de uso aceptable y presentar la imagen de marca del establecimiento antes de conceder acceso a internet.
RADIUS
Remote Authentication Dial-In User Service (Servicio de autenticación remota de usuario de conexión telefónica); un protocolo de red que proporciona una gestión centralizada de Autenticación, Autorización y Contabilidad (AAA).
El protocolo que utilizan los puntos de acceso de Cambium para comunicarse con Purple para verificar las credenciales del usuario y notificar los datos de la sesión.
Walled Garden
Un entorno limitado que controla el acceso de los usuarios a contenidos y servicios web antes de la autenticación.
Requerido en cnMaestro para permitir que los dispositivos de los invitados accedan a la página de bienvenida de Purple y a los dominios del proveedor de identidad (como Facebook o Google) antes de tener acceso completo a internet.
ePSK
Enhanced Pre-Shared Key (Clave precompartida mejorada); la implementación de Cambium de claves precompartidas privadas, que permite contraseñas únicas para usuarios individuales en un solo SSID.
Utilizado para proporcionar segmentos de red seguros y aislados para entornos multi-inquilino sin necesidad de transmitir múltiples SSIDs.
Dynamic VLAN Assignment
El proceso de colocar un dispositivo autenticado en una red de área local virtual específica basándose en los atributos de RADIUS en lugar del puerto físico o SSID.
Permite al departamento de TI utilizar un único SSID al tiempo que separa de forma segura el tráfico de invitados del tráfico del personal o de administración.
802.1X
Un estándar de la IEEE para el control de acceso a redes basado en puertos, que proporciona un mecanismo de autenticación para los dispositivos que desean conectarse a una LAN o WLAN.
El estándar utilizado para el WiFi seguro del personal, que sustituye las contraseñas compartidas por credenciales corporativas individuales validadas contra un proveedor de identidad.
cnMaestro
La plataforma de gestión local o basada en la nube de Cambium Networks para el control centralizado de la infraestructura de red cableada e inalámbrica.
La interfaz donde los arquitectos de red configuran los perfiles WLAN, la configuración de RADIUS y los walled gardens necesarios para la integración con Purple.
First-Party Data
Información que una empresa recopila directamente de sus clientes y que posee por completo.
El principal resultado de negocio de una implementación de WiFi de invitados de Purple, utilizado para impulsar campañas de marketing y comprender el comportamiento de los visitantes.
Ejemplos prácticos
Un hotel de 200 habitaciones necesita implementar un Wi-Fi seguro para huéspedes, personal y un centro de conferencias. Los huéspedes requieren un Captive Portal personalizado, el personal necesita acceso seguro a los sistemas internos y el centro de conferencias requiere redes aisladas para los diferentes organizadores de eventos. ¿Cómo debe configurar el arquitecto de red el entorno Cambium cnMaestro para dar soporte a esto utilizando Purple?
El arquitecto debe implementar tres perfiles de WLAN distintos en cnMaestro.
- WLAN de invitados (Guest): Configurada como una red abierta con la opción "External Hotspot" habilitada. La URL de redirección apunta al Captive Portal de Purple. La autenticación RADIUS (UDP 1812) y la contabilidad (UDP 1813) apuntan a los servidores de Purple. El walled garden incluye los dominios de Purple.
- WLAN de personal (Staff): Configurada como WPA2-Enterprise (802.1X). El RADIUS apunta a Purple, que se integra con el Microsoft Entra ID del hotel. El personal se autentica con sus credenciales corporativas y Purple los asigna a la VLAN de personal.
- WLAN de conferencias: Configurada con clave precompartida WPA2 y con Cambium ePSK habilitado. Purple proporciona frases de contraseña ePSK únicas para cada organizador de eventos a través de la API de cnMaestro, asignando cada clave a una VLAN aislada (por ejemplo, VLAN 301, 302).
Una cadena de tiendas ha implementado AP Cambium e410 y ha configurado el Captive Portal de Purple. Sin embargo, los compradores informan de que la página de bienvenida nunca aparece en sus smartphones; en su lugar, el navegador muestra un tiempo de espera de conexión agotado. ¿Cuál es la causa raíz y cómo se resuelve?
La causa raíz es una configuración incompleta del walled garden en cnMaestro. El AP de Cambium está bloqueando el tráfico HTTP/HTTPS requerido para cargar el portal de Purple antes de que el usuario sea autenticado.
Para resolver esto, el ingeniero de red debe iniciar sesión en cnMaestro, navegar al perfil de WLAN de invitados (Guest) y actualizar la lista de walled garden del Hotspot externo. Debe añadir los dominios específicos del portal de Purple y cualquier punto de enlace de CDN asociado. Una vez aplicado, los dispositivos no autenticados podrán acceder al portal y completar el flujo de inicio de sesión.
Preguntas de práctica
Q1. Estás desplegando Purple Guest WiFi en 50 tiendas minoristas utilizando APs Cambium e505. Los usuarios pueden conectarse al SSID y ver la splash page, pero después de iniciar sesión, no pueden acceder a internet. Verificas que Purple está enviando el mensaje Access-Accept. ¿Cuál es el problema de infraestructura más probable?
Sugerencia: Considera qué sucede a nivel de switch cuando un dispositivo intenta obtener una dirección IP después de la autenticación.
Ver respuesta modelo
El problema más probable es la falta de VLAN trunking en los puertos del switch que se conectan a los APs Cambium. Aunque el AP autoriza al dispositivo, si la VLAN de invitados asignada no está permitida en el trunk del switch, el dispositivo no puede comunicarse con el servidor DHCP para obtener una dirección IP, lo que resulta en la falta de acceso a internet.
Q2. Un campus universitario quiere utilizar un único SSID para todos los estudiantes en las residencias, pero requiere que los dispositivos de cada estudiante estén aislados en su propio segmento de red privada para permitir la transmisión (casting) a su Smart TV específico. ¿Cómo se implementa esto utilizando Cambium y Purple?
Sugerencia: Observa la implementación de claves precompartidas privadas de Cambium.
Ver respuesta modelo
Implementa Cambium ePSK (Enhanced Pre-Shared Key) en la WLAN de la residencia. Purple gestionará el ciclo de vida de ePSK a través de la API de cnMaestro, generando una contraseña única para cada estudiante. Cuando un estudiante conecta sus dispositivos utilizando su clave específica, el AP de Cambium los asigna a una VLAN única, creando una red de área privada aislada.
Q3. Durante un despliegue piloto, el panel de analíticas de Purple muestra cero tiempo de permanencia o métricas de uso de datos para el sitio de prueba de Cambium, a pesar de que los usuarios se están autenticando y navegando por internet con éxito. ¿Qué paso de configuración se omitió en cnMaestro?
Sugerencia: Las analíticas requieren datos de sesión, que se gestionan a través de un puerto UDP específico en la configuración AAA.
Ver respuesta modelo
No se configuró el RADIUS Accounting. El ingeniero de red debe habilitar RADIUS Accounting en el perfil WLAN de invitados de cnMaestro y apuntarlo al servidor RADIUS de Purple en el puerto UDP 1813. Sin esto, Purple solo gestiona la autenticación y no recibe datos sobre el ciclo de vida de la sesión.
Continúe leyendo esta serie
Integración de CommScope Ruckus con Purple WiFi: Guía de instalación y configuración
Esta guía de referencia técnica proporciona un manual de configuración definitivo para integrar arquitecturas de CommScope Ruckus con Purple WiFi. Detalla implementaciones paso a paso para captive portals de Guest WiFi, WiFi seguro para el personal a través de 802.1X y aislamiento de red multiinquilino mediante Ruckus Dynamic PSK.
Integración de puntos de acceso Allied Telesis con Purple WiFi
Esta guía proporciona un manual de configuración completo para integrar los puntos de acceso de la serie TQ de Allied Telesis con Purple WiFi. Cubre la redirección externa de Captive Portal, la autenticación RADIUS 802.1X y el direccionamiento dinámico de VLAN mediante claves precompartidas privadas (PPSK) para despliegues multiinquilino seguros.
Integración de los puntos de acceso Grandstream GWN con Purple WiFi
Esta guía técnica de referencia autorizada detalla cómo integrar los puntos de acceso Grandstream GWN con la plataforma de análisis y Guest WiFi de Purple. Cubre la configuración del Captive Portal de Grandstream, los ajustes de RADIUS AAA, la configuración de walled garden, la autenticación segura para el personal mediante 802.1X con direccionamiento dinámico de VLAN y la segmentación PPSK multiinquilino, proporcionando una guía práctica paso a paso para MSP e instalaciones de TI que desplieguen WiFi para invitados y personal a gran escala.