Saltar al contenido principal

Integrating WeChat WiFi Login: Capturing Engagement via Social Captive Portals

Esta guía detalla cómo integrar la autenticación de WeChat WiFi en los Captive Portals empresariales, abarcando la arquitectura OAuth 2.0, la integración de RADIUS y el despliegue paso a paso en hardware de Cisco Meraki, HPE Aruba y Juniper Mist. Proporciona a los directores de TI y arquitectos de red un marco práctico para capturar datos de primera mano de los 1.300 millones de usuarios de WeChat, al tiempo que impulsa la interacción mediante el seguimiento de Cuentas Oficiales y redireccionamientos posteriores al inicio de sesión.

📖 8 min de lectura📝 1,875 palabras🔧 2 ejemplos prácticos4 preguntas de práctica📚 10 definiciones clave

Escuchar esta guía

Ver transcripción del podcast
Bienvenido al Informe Técnico de Purple. Soy su anfitrión, y hoy vamos a profundizar en una integración fundamental para los establecimientos que buscan captar la interacción de un grupo demográfico masivo: la integración del inicio de sesión de WeChat WiFi a través de Captive Portals sociales. Si es usted director de TI, arquitecto de redes o director de operaciones en un hotel, cadena de tiendas o espacio público, ya conoce el reto. Quiere ofrecer un acceso WiFi para invitados sin fricciones, pero su equipo de marketing exige datos de origen (first-party data). Los formularios de registro manual provocan abandonos, y los inicios de sesión social genéricos no siempre dan en el clavo con los visitantes internacionales, especialmente los procedentes de China, donde WeChat es el ecosistema digital dominante. Ahí es donde entra en juego la autenticación de WeChat WiFi. Transforma un Captive Portal estándar en una herramienta estratégica de captura de datos. Hoy desglosaremos la arquitectura técnica, los pasos de implementación y los errores comunes que debe evitar. Empecemos por la arquitectura. ¿Cómo funciona realmente? La autenticación de WeChat WiFi sustituye la tradicional introducción manual de datos en un formulario por un flujo OAuth 2.0 integrado directamente en la experiencia del Captive Portal. Cuando un invitado se conecta a su red WiFi, su punto de acceso o controlador de LAN inalámbrica intercepta el tráfico y redirige al usuario a un Captive Portal alojado en la plataforma Purple Cloud. En lugar de escribir una dirección de correo electrónico, el usuario selecciona la opción de inicio de sesión de WeChat. Esto activa una llamada API a la plataforma abierta de WeChat. El usuario autoriza la conexión dentro de su aplicación WeChat, y WeChat devuelve un token de acceso y datos de perfil de usuario (como OpenID, unionid, apodo y avatar) a la plataforma Purple. A continuación, Purple indica a su servidor RADIUS que envíe un mensaje Access-Accept a su hardware de red, concediendo acceso a Internet y aplicando las políticas configuradas, como los límites de ancho de banda o la asignación de VLAN. Se trata de un intercambio de información seguro y sin interrupciones entre cinco sistemas distintos, y todo ocurre en menos de tres segundos desde la perspectiva del usuario. Ahora bien, ¿qué se necesita para que esto ocurra? Hay cuatro componentes clave. En primer lugar, la cuenta oficial de WeChat. Debe disponer de una cuenta de servicio de WeChat verificada, conocida en chino como Fuwuhao. Las cuentas de suscripción carecen de los permisos de API necesarios para la integración de OAuth. Este es un requisito indispensable. La cuenta de servicio proporciona el AppID y el AppSecret necesarios para la comunicación de la API. En segundo lugar, el propio Captive Portal. Se trata de la página de bienvenida personalizada que intercepta la sesión y presenta el botón de inicio de sesión de WeChat. Debe ser adaptable a dispositivos móviles y capaz de gestionar correctamente la URI de redireccionamiento de OAuth. En tercer lugar, la gestión de identidades y accesos. La plataforma Purple actúa aquí como intermediaria, gestionando el intercambio de tokens OAuth, vinculando los datos de perfil de WeChat con su CRM y gestionando la comunicación RADIUS. Esta es la capa de inteligencia que conecta el ecosistema de WeChat con su infraestructura de red. Y en cuarto lugar, su hardware de red. Puntos de acceso empresariales de proveedores como Cisco Meraki, HPE Aruba o Juniper Mist, configurados para redirigir el tráfico no autenticado al Captive Portal externo y aplicar los atributos de autorización RADIUS. Entonces, ¿cómo implementamos esto? Es un proceso de tres pasos. Paso uno: Configurar la cuenta de desarrollador de WeChat. Deberá habilitar la función de autorización de página web OAuth 2.0 en la plataforma de cuentas oficiales de WeChat. Registre el dominio de su Captive Portal como el dominio de devolución de llamada (callback) autorizado. Esto garantiza que WeChat solo devuelva códigos de autorización a su infraestructura de confianza. A continuación, obtenga su AppID y AppSecret. Paso dos: Configurar la plataforma Purple. Diríjase a la configuración de métodos de autenticación, habilite el inicio de sesión social con WeChat e introduzca su AppID y AppSecret. Diseñe su splash page para que el inicio de sesión de WeChat sea destacado. Y, fundamentalmente, configure sus redirecciones posteriores a la autenticación. No envíe simplemente a los usuarios a una página genérica de éxito. Rediríjalos al perfil de su cuenta oficial de WeChat para fomentar que le sigan, o a una página de destino promocional específica. Paso tres: Configuración de la infraestructura de red. En su controlador inalámbrico, configure el SSID de invitados para la autenticación de Captive Portal externa. Introduzca la URL del Captive Portal de Purple. Y aquí está el paso de configuración más importante: configure las entradas del walled garden o lista blanca. Debe incluir en la lista blanca los dominios de la API de WeChat y los rangos de IP para que el dispositivo del usuario pueda comunicarse con WeChat antes de estar completamente autenticado en la red. Si se salta este paso, todo el flujo fallará. Ahora hablemos de las mejores prácticas y la resolución de problemas. ¿Qué suele fallar y cómo evitarlo? Acabo de mencionar el walled garden. Un walled garden mal configurado es la causa número uno de fallos en los inicios de sesión de WeChat en entornos de producción. Si el dispositivo no puede conectarse con los servidores de WeChat antes de la autenticación, el flujo de OAuth no puede iniciarse. Asegúrese de que todos los dominios de WeChat necesarios sean accesibles antes de la autenticación. Pruebe esto a fondo antes de la puesta en marcha. Otro problema común es la discrepancia en la redirección de OAuth (OAuth Redirect Mismatch). Si la URL de devolución de llamada registrada en WeChat no coincide exactamente con la URL de su Captive Portal, WeChat bloqueará la autorización. Los protocolos y subdominios deben coincidir perfectamente. HTTPS frente a HTTP, con o sin barra diagonal final: estos detalles importan. Además, preste atención a la interferencia del asistente del Captive Portal. Los sistemas operativos móviles utilizan estos mini-navegadores para gestionar redes cautivas, pero a menudo carecen de funcionalidad completa y pueden interferir con la llamada a la aplicación WeChat. Es posible que deba implementar un script de detección de JavaScript para forzar el inicio de sesión en el navegador nativo del sistema. En cuanto a la estrategia, no desaproveche la interacción posterior al inicio de sesión. Impulse a los usuarios a seguir su cuenta oficial, acceder a un mapa de interior o ver un menú digital. Manténgalos activos dentro del ecosistema de WeChat. Y sobre la minimización de datos: solicite únicamente los datos del perfil de WeChat necesarios para sus objetivos de marketing. Solicitar permisos en exceso aumenta las tasas de abandono y complica el cumplimiento de la privacidad. Hablando de cumplimiento, la recopilación de datos a través de WeChat debe cumplir con las leyes de privacidad regionales, incluido el GDPR en Europa y la Ley de Protección de Información Personal en China. Asegúrese de que las condiciones de servicio de su Captive Portal articulen claramente qué datos se recopilan, cómo se utilizan y con quién se comparten. Implemente mecanismos de consentimiento explícito antes de iniciar el flujo de OAuth. Ahora, una sesión rápida de preguntas y respuestas sobre las dudas que escuchamos con más frecuencia. Pregunta: ¿Puedo utilizar una cuenta de suscripción de WeChat? No. Necesita una cuenta de servicio verificada. Punto final. Pregunta: ¿Tengo que incluir los dominios de WeChat en la lista blanca de cada punto de acceso? Sí. El jardín vallado debe configurarse a nivel de SSID en el controlador inalámbrico. Pregunta: ¿Durante cuánto tiempo es válido el token de acceso de WeChat? Los tokens de acceso de WeChat caducan después de dos horas. Asegúrese de que su plataforma esté configurada para actualizarlos automáticamente. Pregunta: ¿Qué datos obtengo realmente de WeChat? Recibe el OpenID del usuario, su unionid si ha autorizado varias aplicaciones, su apodo, la URL de su foto de perfil y su ciudad y país de registro. No recibe su número de teléfono ni su dirección de correo electrónico directamente de WeChat. Para terminar, aquí tiene los cinco puntos clave de la sesión de hoy. Primero: la autenticación de WeChat WiFi utiliza OAuth 2.0 para sustituir la introducción manual de formularios por un inicio de sesión con un solo toque, lo que aumenta las tasas de finalización entre un 20 y un 30 por ciento. Segundo: es obligatorio disponer de una cuenta de servicio de WeChat verificada. Las cuentas de suscripción no funcionarán. Tercero: la configuración del jardín vallado en sus puntos de acceso es el paso más crítico y el que más se suele pasar por alto. Cuarto: las redirecciones tras la autenticación a su cuenta oficial convierten a los visitantes transitorios en seguidores digitales a largo plazo. Y quinto: asegúrese de que sus declaraciones de consentimiento y privacidad cubren los requisitos tanto del GDPR como de la PIPL antes de la puesta en marcha. Esta es la sesión técnica sobre la integración del inicio de sesión con WeChat WiFi. Para obtener más información sobre estrategia de WiFi para invitados, analítica y cumplimiento, visite purple dot ai. Gracias por escucharnos.

header_image.png

Resumen ejecutivo

La integración del inicio de sesión de WeChat WiFi transforma un Captive Portal estándar en un motor estratégico de datos de origen (first-party data) para establecimientos que reciben visitantes chinos y para el ecosistema de WeChat en general. Para los responsables de TI y arquitectos de red, implementar el inicio de sesión de WeChat a través de OAuth 2.0 y RADIUS requiere equilibrar un acceso de invitados sin fricciones con una recopilación de datos segura y conforme a la normativa. Esta guía detalla la arquitectura técnica, los pasos de implementación y las consideraciones de seguridad para desplegar la autenticación de WeChat WiFi en redes empresariales con hardware que incluye Cisco Meraki, HPE Aruba, Ruckus y Juniper Mist. Muestra cómo la plataforma Guest WiFi de Purple media en el flujo de OAuth, mapea los datos de perfil en su CRM e impulsa la interacción mediante redirecciones posteriores al inicio de sesión hacia su cuenta oficial de WeChat.

WeChat cuenta con más de 1.300 millones de usuarios activos mensuales, y los turistas chinos gastaron un estimado de 255.000 millones de dólares a nivel internacional en 2023 (datos de la Organización Mundial del Turismo). Para hoteles, tiendas de lujo, aeropuertos y centros de conferencias, ofrecer el inicio de sesión de WeChat WiFi es un canal directo hacia ese grupo demográfico. Purple opera en más de 80.000 establecimientos activos y registró 440 millones de inicios de sesión en 2024, lo que nos brinda visibilidad directa de lo que funciona y lo que falla en los despliegues de producción.


Análisis técnico detallado

Cómo funciona la autenticación de WeChat WiFi

La autenticación de WeChat WiFi sustituye la introducción manual de datos en formularios por un flujo de OAuth 2.0 integrado directamente en la experiencia del Captive Portal. La secuencia involucra a cinco componentes que se comunican en un orden definido:

  1. El dispositivo del invitado se conecta al SSID del establecimiento.
  2. El punto de acceso intercepta el tráfico HTTP no autenticado y redirige el dispositivo al Captive Portal alojado por Purple.
  3. El usuario selecciona la opción de inicio de sesión de WeChat en la página de bienvenida.
  4. El portal inicia una solicitud de autorización OAuth 2.0 a la API de la plataforma abierta de WeChat, enviando el AppID del establecimiento y un URI de redirección.
  5. La aplicación WeChat se abre en el dispositivo y solicita al usuario que autorice la conexión.
  6. WeChat devuelve un código de autorización al URI de redirección.
  7. La plataforma Purple canjea el código por un token de acceso y recupera los datos de perfil del usuario: OpenID, unionid, apodo, avatar y ubicación registrada.
  8. Purple indica al servidor RADIUS que emita un mensaje Access-Accept al punto de acceso.
  9. El punto de acceso concede acceso a internet y aplica las políticas configuradas (asignación de VLAN, límites de ancho de banda, tiempo de espera de la sesión).
  10. El portal redirige al usuario a la cuenta oficial de WeChat del establecimiento o a una página de destino específica.

authentication_flow_diagram.png

Requisitos del tipo de cuenta

Este es el punto de fallo más común en los despliegues de WeChat WiFi. Debe utilizar una Cuenta de Servicio (服务号) de WeChat verificada. Las cuentas de suscripción (订阅号) no exponen las API de autorización de páginas web OAuth 2.0 necesarias para la integración con el Captive Portal. La siguiente tabla resume las diferencias clave:

Característica Cuenta de Servicio (服务号) Cuenta de Suscripción (订阅号)
Inicio de sesión WiFi por OAuth 2.0 No
Nivel de acceso a la API Completo Limitado
Mensajes push al mes 4 30
Aparece como contacto Agrupado en carpeta
Integración con WeChat Pay No
Verificación requerida

Para obtener una Cuenta de Servicio verificada se requiere una licencia comercial china o un proceso de solicitud especial en el extranjero a través de Tencent, lo que conlleva una tasa de verificación anual de 99 $ y un periodo de revisión de dos a cuatro semanas.

El walled garden: la configuración de red más crítica

Un walled garden (también llamado lista blanca de preautenticación) define a qué direcciones IP y dominios puede acceder un dispositivo antes de haber completado la autenticación en el Captive Portal. Si los dominios de la API de WeChat no están en el walled garden, el dispositivo no puede iniciar el protocolo de enlace OAuth y el inicio de sesión falla de forma silenciosa.

Como mínimo, se debe incluir en la lista blanca los siguientes dominios:

  • *.weixin.qq.com
  • *.wechat.com
  • *.wx.qq.com
  • res.wx.qq.com
  • mp.weixin.qq.com
  • Rangos de IP de la CDN de WeChat (consulte la documentación de rangos de IP publicada por Tencent, ya que cambian periódicamente)

En Cisco Meraki, configure esto en Wireless > Access Control > Walled Garden. En HPE Aruba, utilice la lista blanca de Captive Portal Profile. En Juniper Mist, configure la lista de dominios permitidos de Guest Portal.

Integración de RADIUS y aplicación de políticas

Purple actúa como un proxy RADIUS en esta arquitectura. Tras un intercambio de OAuth de WeChat exitoso, Purple envía un mensaje RADIUS Access-Accept al controlador inalámbrico del establecimiento. El mensaje Access-Accept puede transportar atributos RADIUS estándar para aplicar políticas por usuario:

  • Tunnel-Type y Tunnel-Private-Group-ID para la asignación de VLAN (aislando el tráfico de invitados de las redes corporativas, de acuerdo con las mejores prácticas de segmentación IEEE 802.1X)
  • Session-Timeout para la desconexión automática tras un periodo definido
  • WISPr-Bandwidth-Max-Up y WISPr-Bandwidth-Max-Down para la limitación del ancho de banda

Esta arquitectura es independiente del hardware. Purple se integra con Cisco Meraki, HPE Aruba, Ruckus, Juniper Mist, Ubiquiti UniFi, Cambium, Extreme y Fortinet sin necesidad de cambios de firmware ni servidores locales adicionales.

venue_deployment_overview.png


Guía de implementación

Paso 1: Configurar la cuenta de desarrollador de WeChat

Inicie sesión en la plataforma de cuentas oficiales de WeChat en mp.weixin.qq.com. Vaya a Configuración > Centro de seguridad > Autorización de página web. Habilite la autorización de página web OAuth 2.0 y añada el dominio de su Captive Portal como un dominio de retorno autorizado (por ejemplo, wifi.yourvenue.com). WeChat solo devolverá códigos de autorización a los dominios registrados aquí; un desajuste provocará un fallo silencioso.

Recupere su AppID y AppSecret desde el panel Desarrollo > Configuración básica. Guarde el AppSecret de forma segura; trátelo como una clave privada.

Paso 2: Configurar Purple

En el portal de Purple, vaya a Autenticación > Inicio de sesión social y habilite WeChat. Introduzca el AppID y el AppSecret. Diseñe la página de bienvenida del Captive Portal utilizando el editor de arrastrar y soltar de Purple. Haga que el botón de inicio de sesión de WeChat sea la llamada a la acción principal en la parte superior de la página.

Configure la redirección posterior a la autenticación. Las opciones incluyen:

  • La página de seguimiento de la cuenta oficial de WeChat del establecimiento (recomendado para fomentar la interacción)
  • Una página de destino promocional alojada dentro de un Mini Programa de WeChat
  • Una página de encuesta utilizando las herramientas de WiFi Analytics de Purple
  • Una página de inscripción en un programa de fidelización

Habilite el almacenamiento en caché de direcciones MAC en Autenticación > Configuración de visitantes recurrentes. Establezca la duración de la caché para que coincida con la frecuencia de visita típica (siete días para comercios, 30 días para hostelería). Los visitantes recurrentes se conectarán automáticamente sin volver a ver el portal, mientras que su visita se seguirá registrando en el panel de análisis.

Paso 3: Configurar el hardware de red

En su controlador inalámbrico, configure el SSID de invitados para utilizar un Captive Portal externo. Introduzca la URL del portal de Purple como la URL de la página de bienvenida. Añada los dominios de WeChat al walled garden. Establezca las direcciones IP del servidor RADIUS y los secretos compartidos proporcionados por Purple.

Pruebe todo el flujo desde un dispositivo móvil antes de ponerlo en marcha. Específicamente:

  1. Conéctese al SSID de invitados.
  2. Confirme que el Captive Portal se carga en el mini-navegador del Captive Portal Assistant (CPA).
  3. Toque el botón de inicio de sesión de WeChat y confirme que se abre la aplicación WeChat.
  4. Autorice la conexión y confirme que se concede acceso a Internet.
  5. Confirme que la redirección posterior al inicio de sesión se ejecuta correctamente.

Buenas prácticas

Optimice el walled garden. Un walled garden mal configurado es la causa número uno de fallos en los inicios de sesión de WeChat en producción. Pruébelo antes del lanzamiento y vuelva a probarlo después de cualquier actualización de firmware de la red, ya que algunos controladores restablecen las entradas de la lista blanca durante las actualizaciones.

Fomente la interacción posterior al inicio de sesión. El momento posterior a la autenticación es el punto de mayor atención en el recorrido de WiFi para invitados. Redirija a los usuarios a la página de seguimiento de su cuenta oficial. Un invitado que sigue su cuenta es localizable a través de notificaciones push mucho después de haber abandonado el establecimiento. Implemente el almacenamiento en caché de MAC para los visitantes recurrentes. Exigir una autenticación repetida en cada visita degrada la experiencia. El almacenamiento en caché de MAC elimina la fricción para los clientes que regresan, al tiempo que registra la visita para fines analíticos. Consulte WiFi Analytics de Purple para obtener informes sobre el tiempo de permanencia y las visitas recurrentes.

Aplique la minimización de datos. Solicite únicamente los campos del perfil de WeChat que su CRM realmente utilice. Solicitar permisos innecesarios aumenta la tasa de abandono de la autorización y añade complejidad al cumplimiento del GDPR. Para la mayoría de los establecimientos, el OpenID, el apodo y el avatar son suficientes para la personalización.

Segmente el tráfico de invitados a través de VLAN. Asigne a los invitados autenticados con WeChat a una VLAN dedicada, aislada de su red corporativa o de TPV. Esto cumple con los requisitos de segmentación de red de PCI DSS y limita el radio de impacto de cualquier incidente de seguridad en el lado del invitado. Para un análisis completo de la arquitectura de seguridad WiFi, consulte nuestra guía de seguridad WiFi para empresas .

Cumpla con el GDPR y la PIPL. Muestre un aviso de privacidad claro en la splash page antes de que el usuario inicie el flujo de OAuth de WeChat. El aviso debe identificar al responsable del tratamiento de los datos, enumerar las categorías de datos recopilados de WeChat, indicar la base jurídica del tratamiento y proporcionar un enlace a la política de privacidad completa. Para obtener una guía detallada, consulte nuestra guía de cumplimiento de GDPR para WiFi .


Resolución de problemas y mitigación de riesgos

Discrepancia en la redirección de OAuth

Si la URL de retorno registrada en la consola de desarrollador de WeChat no coincide exactamente con la URL que Purple utiliza para la redirección, WeChat devuelve un código de error y bloquea la autorización. Compruebe si hay discrepancias en los protocolos (HTTP frente a HTTPS), barras diagonales finales y diferencias en los subdominios. El dominio registrado debe coincidir exactamente con la cadena de texto.

Interferencia del Captive Portal Assistant (CPA)

Los sistemas operativos móviles utilizan un mini-navegador CPA para detectar y gestionar redes cautivas. Estos mini-navegadores a menudo carecen de la capacidad de abrir aplicaciones nativas, lo que interrumpe la llamada a la aplicación WeChat en el flujo de OAuth. Las opciones de mitigación incluyen:

  • Implementar una redirección de JavaScript que detecte el entorno CPA y abra el navegador completo del sistema antes de iniciar el flujo de OAuth.
  • Mostrar una instrucción clara en la splash page que indique a los usuarios que abran la página en su navegador completo si el botón de WeChat no responde.

Expiración de tokens y sesiones obsoletas

Los tokens de acceso de WeChat expiran después de dos horas. Si su plataforma no actualiza el token, el registro de CRM del usuario dejará de actualizarse tras la sesión inicial. Configure los ajustes de actualización de tokens de Purple para mantener los tokens activos durante la estancia del invitado.

Riesgo geopolítico y regulatorio

WeChat está sujeto a la regulación del gobierno chino y a las políticas de plataforma de Tencent. El acceso a la API puede suspenderse o modificarse sin previo aviso. Mitigue este riesgo asegurándose de que su Captive Portal admita múltiples métodos de autenticación (correo electrónico, SMS, otros inicios de sesión social) para que una interrupción de la API de WeChat no deje fuera de servicio todo su WiFi para invitados. El portal multimétodo de Purple admite esta arquitectura de respaldo de forma nativa.


ROI e impacto empresarial

La implementación de la autenticación WiFi de WeChat ofrece retornos medibles en tres vectores.

Mayor tasa de captura de datos. El inicio de sesión social reduce la fricción al completar formularios. Los establecimientos que utilizan las opciones de inicio de sesión social de Purple informan de tasas de finalización de autenticación entre un 20% y un 30% más altas que los portales equivalentes que solo requieren correo electrónico (datos internos de Purple, 2024). En un establecimiento que procesa 500 conexiones WiFi de invitados al día, un aumento del 25% significa la captura diaria de 125 perfiles verificados adicionales.

Crecimiento de seguidores de la Cuenta Oficial. Redirigir a los usuarios autenticados a la página de seguimiento de la Cuenta Oficial convierte la afluencia transitoria en una audiencia digital accesible. Un hotel con 200 huéspedes autenticados con WeChat al día que logre una tasa de seguimiento del 40% suma 80 nuevos seguidores de la Cuenta Oficial diariamente, seguidores que pueden recibir notificaciones push segmentadas sobre ofertas para volver a visitarlo, actualizaciones del programa de fidelización y promociones estacionales.

Visibilidad operativa. La plataforma WiFi Analytics de Purple asocia las sesiones autenticadas de WeChat con el tiempo de permanencia, la frecuencia de las visitas y los datos de movimiento a nivel de zona. Esto proporciona a los directores de operaciones de los establecimientos los datos necesarios para optimizar el personal, la distribución y el calendario promocional. Para los establecimientos de hospitality , estos datos se integran directamente con los sistemas PMS para enriquecer los perfiles de los huéspedes.

Para los entornos de retail , la combinación de la autenticación de WeChat y la plataforma de analítica de Purple replica la riqueza de datos del comercio electrónico en el contexto de una tienda física, una capacidad que adquiere cada vez más valor a medida que la desaparición de las cookies de terceros reduce la eficacia del retargeting digital.


Para obtener orientación relacionada, consulte nuestra guía de cumplimiento de WiFi GDPR y nuestra guía de seguridad WiFi para empresas . Para explorar cómo se implementa Purple en sectores específicos, visite nuestras páginas para hospitality , retail , healthcare y transport .

Definiciones clave

OAuth 2.0

Un protocolo de autorización estándar del sector que permite a un usuario conceder a una aplicación de terceros acceso a los datos de su cuenta en otro servicio sin compartir su contraseña. En la autenticación de WeChat WiFi, el Captive Portal es la aplicación de terceros y WeChat es el proveedor de identidad.

El mecanismo subyacente para todo inicio de sesión social de WiFi. Los equipos de TI lo encuentran al configurar el AppID, el AppSecret y la URI de redirección en la consola de desarrollador de WeChat y en la plataforma Purple.

Captive portal

Una página web que intercepta el tráfico de red de un dispositivo y requiere que el usuario se autentique o acepte los términos antes de concederle acceso a Internet. Funciona redirigiendo todas las peticiones HTTP a la URL del portal hasta que se completa la autenticación.

El componente orientado al usuario del sistema de inicio de sesión de WeChat WiFi. Purple aloja y gestiona el Captive Portal como una capa en la nube sobre el hardware existente del establecimiento.

Walled garden

Una lista blanca de preautenticación de direcciones IP y dominios a los que un dispositivo puede acceder antes de completar el inicio de sesión en el Captive Portal. Es necesario para permitir que el dispositivo se comunique con los servidores de autenticación de WeChat durante el flujo de OAuth.

El elemento que más se configura incorrectamente en los despliegues de WeChat WiFi. Debe configurarse a nivel de SSID en el controlador inalámbrico.

RADIUS

Remote Authentication Dial-In User Service. Un protocolo de red que proporciona autenticación, autorización y contabilidad centralizadas para el acceso a la red. Tras un intercambio de OAuth de WeChat correcto, Purple envía un mensaje RADIUS Access-Accept al punto de acceso para conceder acceso a Internet.

El protocolo que conecta la plataforma de identidad de Purple con el hardware de red del establecimiento. Los equipos de TI configuran las direcciones IP del servidor RADIUS y los secretos compartidos en el controlador inalámbrico.

WeChat Service Account (服务号)

Una categoría de cuenta oficial de WeChat diseñada para empresas, que ofrece acceso completo a la API, incluida la autorización de páginas web mediante OAuth 2.0. Aparece como un contacto en la lista de chat del usuario. Requiere el registro de la empresa en China o una verificación en el extranjero.

El tipo de cuenta obligatorio para el inicio de sesión de WeChat WiFi. Las cuentas de suscripción no se pueden utilizar para este fin.

OpenID

Un identificador único asignado por WeChat a un usuario específico para una cuenta oficial concreta. Dos cuentas oficiales diferentes recibirán OpenIDs distintos para el mismo usuario.

La clave principal utilizada por el CRM para identificar y realizar el seguimiento de usuarios individuales a través de las sesiones de WiFi.

Unionid

Un identificador único asignado por WeChat a un usuario específico en todas las cuentas oficiales y miniprogramas registrados bajo la misma cuenta de la plataforma abierta de WeChat. Permite el reconocimiento de usuarios en diferentes productos.

Relevante para marcas con múltiples puntos de contacto de WeChat (por ejemplo, una cadena de tiendas que cuenta tanto con un portal de WiFi como con un miniprograma de compras) que desean unificar el perfil de usuario en todas las interacciones.

MAC address caching

Una función de red que almacena el identificador de hardware único de un dispositivo (dirección MAC) tras la autenticación inicial, lo que permite a la red conceder acceso automáticamente en conexiones posteriores sin tener que mostrar de nuevo el Captive Portal.

Se utiliza para mejorar la experiencia de los visitantes que regresan. Purple registra la visita de retorno para analíticas incluso cuando no se muestra el portal.

Captive Portal Assistant (CPA)

El mininavegador que inician automáticamente iOS y Android cuando detectan una red que requiere autenticación mediante Captive Portal. Los CPA tienen una funcionalidad limitada y es posible que no admitan las llamadas a aplicaciones nativas necesarias para el flujo de OAuth de WeChat.

Los equipos de TI deben probar el flujo de inicio de sesión de WeChat específicamente dentro del entorno del CPA e implementar la detección de JavaScript para redirigir al navegador completo del sistema si es necesario.

VLAN

Virtual Local Area Network. Un segmento de red lógico que aísla el tráfico de otros segmentos en la misma infraestructura física. Se utiliza para separar el tráfico de la WiFi de invitados de las redes corporativas o de los terminales de punto de venta (POS).

Los atributos RADIUS devueltos por Purple pueden asignar a los invitados autenticados mediante WeChat a una VLAN específica, cumpliendo con los requisitos de segmentación de red de PCI DSS.

Ejemplos prácticos

Una marca de venta minorista de lujo en Londres quiere ofrecer un acceso Wi-Fi sin interrupciones a los turistas chinos, al tiempo que aumenta los seguidores en su Cuenta Oficial de WeChat. Actualmente utilizan puntos de acceso Cisco Meraki y un portal estándar de captura de correo electrónico. Su equipo de TI tiene dos semanas para realizar el despliegue antes de una importante campaña del Año Nuevo Chino.

Semana uno: Registrar y verificar una Cuenta de Servicio de WeChat si aún no se ha hecho (prever de dos a cuatro semanas para la aprobación de Tencent, por lo que este paso debería haber comenzado antes; si no es así, utilizar una entidad china externa verificada como medida provisional). Configurar la consola de desarrollador de WeChat con el dominio de devolución de llamada que coincida con la URL del portal de Purple. En la plataforma Purple, habilitar el inicio de sesión social de WeChat, introducir el AppID y el AppSecret, y diseñar la página de bienvenida con WeChat como opción principal de inicio de sesión. Configurar el redireccionamiento posterior a la autenticación a la página de seguimiento de la Cuenta Oficial de WeChat de la marca. Semana dos: En el panel de control de Meraki, actualizar el SSID de invitados para que apunte a la URL del portal de Purple. Añadir todos los dominios de la API de WeChat al walled garden de Meraki en Red inalámbrica > Control de acceso. Configurar los detalles del servidor RADIUS. Probar todo el flujo de extremo a extremo desde un dispositivo iOS y Android. Habilitar la caché de direcciones MAC para el reconocimiento de visitantes recurrentes durante 30 días. Puesta en marcha.

Comentario del examinador: Este enfoque utiliza el hardware Meraki existente sin necesidad de realizar cambios en el firmware. El elemento crítico del proceso es la verificación de la cuenta de WeChat, que debe iniciarse con bastante antelación a la fecha límite de cualquier campaña. El redireccionamiento posterior al inicio de sesión a la página de seguimiento de la Cuenta Oficial es la decisión de configuración de mayor valor, ya que convierte un inicio de sesión Wi-Fi único en un canal de marketing a largo plazo.

Un estadio con capacidad para 15.000 personas alberga una serie de eventos internacionales con una gran afluencia de asistentes de habla china. El director de TI informa de que el 35% de los invitados abandonan el formulario de inicio de sesión de Wi-Fi antes de completarlo. La red funciona con puntos de acceso HPE Aruba gestionados a través de Aruba Central.

Desplegar el Captive Portal de Purple con WeChat como opción principal de inicio de sesión social, junto con alternativas de correo electrónico y SMS. Configurar el perfil del Captive Portal de Aruba Central para redirigir a Purple y añadir los dominios de WeChat a la lista de permitidos. Implementar un script de detección de CPA en JavaScript en la página de bienvenida para forzar el flujo de OAuth en el navegador nativo del sistema, evitando el mini-navegador CPA de Aruba. Configurar los atributos de RADIUS para asignar a los aficionados autenticados a una VLAN de invitados dedicada, aislada de la red operativa del estadio. Establecer el tiempo de espera de la sesión en cuatro horas para cubrir la duración típica de un evento sin necesidad de volver a autenticarse. Tras la autenticación, redirigir a los aficionados a un Mini Programa de WeChat que albergue el programa del evento, los resultados en directo y un servicio de pedido de comida.

Comentario del examinador: El script de detección de CPA es el diferenciador técnico clave en este caso. Sin él, la llamada a la aplicación WeChat falla en el mini-navegador y los usuarios experimentan un error. El redireccionamiento al Mini Programa maximiza la interacción posterior a la autenticación al ofrecer a los aficionados un valor inmediato y relevante, lo que también aumenta la probabilidad de que sigan la Cuenta Oficial del recinto.

Preguntas de práctica

Q1. El nuevo inicio de sesión de WeChat WiFi de tu establecimiento está fallando. Los invitados pulsan el botón de WeChat en la página de inicio, pero la página agota el tiempo de espera antes de que se abra la aplicación de WeChat. El panel de control de Cisco Meraki muestra que el SSID está en línea y que la URL del portal de Purple está correctamente configurada. ¿Cuál es la causa más probable y cómo se soluciona?

Sugerencia: Considera qué acceso a la red tiene el dispositivo antes de completar la autenticación.

Ver respuesta modelo

El walled garden en el SSID de Meraki está mal configurado. El dispositivo no puede acceder a los dominios de la API de WeChat antes de la autenticación, por lo que el protocolo de enlace OAuth no puede iniciarse. Solución: navega a Wireless > Access Control en el panel de control de Meraki, localiza la sección Walled Garden y añade los dominios de WeChat requeridos, incluidos *.weixin.qq.com, *.wechat.com y *.wx.qq.com. Realiza una prueba intentando el flujo de inicio de sesión de nuevo desde un dispositivo que no se haya conectado previamente al SSID.

Q2. Un director de marketing quiere utilizar su cuenta de suscripción de WeChat existente (订阅号) para habilitar el inicio de sesión de WiFi porque permite la publicación diaria de artículos a los seguidores. Te piden que configures la integración. ¿Cómo respondes?

Sugerencia: Revisa los niveles de acceso a la API para los diferentes tipos de cuentas de WeChat.

Ver respuesta modelo

Infórmales de que una cuenta de suscripción no se puede utilizar para la autenticación de WiFi. Las API de autorización de páginas web OAuth 2.0 requeridas para la integración del Captive Portal solo están disponibles para cuentas de servicio verificadas (服务号). Deberán registrar una cuenta de servicio. Esto requiere una licencia comercial china o una solicitud en el extranjero a través del proceso especial de Tencent, que tarda de dos a cuatro semanas y cuesta 99 USD anuales. La cuenta de suscripción puede seguir activa para la publicación de contenido; los dos tipos de cuenta sirven para propósitos diferentes y pueden coexistir.

Q3. Tras un despliegue exitoso de WeChat WiFi, el equipo de TI observa que los usuarios que se autenticaron hace tres semanas ya no aparecen en el CRM con datos de visitas actualizados, a pesar de que se están conectando a la red. ¿Cuál es la causa probable?

Sugerencia: Considera los ajustes de gestión de sesiones configurados en Purple y la duración de la caché de MAC.

Ver respuesta modelo

Es probable que la duración de la caché de MAC esté configurada en un valor inferior a tres semanas (por ejemplo, 14 días), por lo que a los usuarios que regresan se les concede acceso a través de la caché de MAC sin activar un nuevo evento de autenticación o actualización del CRM. Alternativamente, el token de acceso de WeChat para esos usuarios ha caducado y la plataforma no lo está renovando. Solución: amplía la duración de la caché de MAC a 30 días en la configuración de visitantes recurrentes de Purple y asegúrate de que la configuración de renovación de tokens esté activa. Confirma también que Purple está registrando las visitas con caché de MAC como eventos de visitas recurrentes en el panel de análisis, incluso cuando no se muestra el portal.

Q4. Tu establecimiento opera tanto en el Reino Unido como en China continental. Quieres desplegar un sistema unificado de autenticación WeChat WiFi. ¿Qué obligaciones de cumplimiento debes abordar antes de la puesta en marcha?

Sugerencia: Se aplican dos regímenes de privacidad distintos a las dos zonas geográficas.

Ver respuesta modelo

Debes cumplir tanto con el GDPR (aplicable a los usuarios del Reino Unido y la UE) como con la Ley de Protección de Información Personal de China (PIPL, aplicable a los usuarios de China continental). Los requisitos clave incluyen: mostrar un aviso de privacidad claro en la página de inicio antes de iniciar el flujo de OAuth, identificar al responsable del tratamiento de datos y enumerar las categorías de datos recopilados de WeChat, indicar la base legal para el procesamiento bajo cada régimen (intereses legítimos o consentimiento bajo GDPR; consentimiento bajo la PIPL), proporcionar un mecanismo para que los usuarios retiren el consentimiento y soliciten la eliminación, y garantizar que existan mecanismos de transferencia de datos si los datos de perfil de WeChat fluyen entre jurisdicciones. Consulta la guía de cumplimiento de GDPR de Purple y a tu asesor legal para conocer los requisitos específicos de cada jurisdicción.

Continúe leyendo esta serie

Cómo configurar un Captive Portal en Starlink: guía para establecimientos remotos y marítimos

Esta guía detalla cómo omitir el hardware nativo de Starlink e integrar un Captive Portal gestionado en la nube utilizando equipos de enrutamiento empresariales. Aprenderá a superar la limitación de CGNAT, aplicar la segmentación de VLAN, gestionar las limitaciones de ancho de banda satelital y garantizar el cumplimiento normativo.

Leer la guía →

Mejores prácticas de Captive Portal: diseño para una alta conversión y cumplimiento normativo

Esta guía técnica ofrece a los responsables de TI, arquitectos de redes y directores de operaciones de establecimientos un plan completo para implementar Captive Portals que equilibren la seguridad de la red con una alta conversión de usuarios. Abarca toda la arquitectura, desde la segmentación de VLAN y la autenticación RADIUS hasta el diseño de consentimiento en conformidad con el GDPR y la selección del método de autenticación. Basada en la experiencia operativa de Purple en más de 80 000 establecimientos y 440 millones de inicios de sesión en 2024, cada recomendación se fundamenta en datos reales de implementación.

Leer la guía →

Cómo optimizar los captive portals para una máxima seguridad de red y conversión de usuarios

Esta guía proporciona un esquema técnico completo para optimizar los captive portals en entornos empresariales, abarcando la arquitectura de segmentación de red, la selección del método de autenticación, el diseño de consentimiento conforme a la GDPR y la optimización de la conversión. Está dirigida a responsables de TI, arquitectos de red y CTO de hoteles, cadenas de tiendas, estadios y organizaciones del sector público que necesitan equilibrar la seguridad de la red con la captura de datos de primera mano. Purple opera la infraestructura de captive portals en más de 80.000 establecimientos con 440 millones de inicios de sesión en 2024, y los marcos de trabajo aquí presentados reflejan esa experiencia operativa.

Leer la guía →