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 la implementación paso a paso en hardware Cisco Meraki, HPE Aruba y Juniper Mist. Proporciona a los gerentes 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 resueltos4 preguntas de práctica📚 10 definiciones clave

Escucha esta guía

Ver transcripción del podcast
Bienvenido al Technical Briefing de Purple. Soy su anfitrión, y hoy analizaremos a fondo una integración crítica 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 usted es gerente de TI, arquitecto de redes o director de operaciones en un hotel, cadena de retail o espacio público, ya conoce el desafío. Desea ofrecer un WiFi para invitados sin fricciones, pero su equipo de marketing exige datos de primera mano. Los formularios de registro manual provocan abandonos y los inicios de sesión sociales genéricos no siempre dan en el blanco con los visitantes internacionales, particularmente aquellos 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. Comencemos con la arquitectura. ¿Cómo funciona esto realmente? La autenticación de WeChat WiFi reemplaza el registro manual tradicional en formularios con 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 de API a la plataforma abierta de WeChat. El usuario autoriza la conexión dentro de su aplicación de WeChat, y WeChat devuelve un token de acceso y datos de perfil de usuario (como OpenID, unionid, apodo y avatar) a la plataforma de Purple. Luego, Purple le indica a su servidor RADIUS que envíe un mensaje Access-Accept a su hardware de red, otorgando acceso a Internet y aplicando cualquier política configurada, como límites de ancho de banda o asignación de VLAN. Es un intercambio seguro y sin interrupciones entre cinco sistemas distintos, todo ocurriendo en menos de tres segundos desde la perspectiva del usuario. Ahora, ¿qué necesita para que esto suceda? Hay cuatro componentes clave. Primero, la cuenta oficial de WeChat. Debe poseer 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 requeridos para la comunicación de la API. Segundo, el Captive Portal en sí. Esta es 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 manejar correctamente la URI de redireccionamiento de OAuth. Tercero, la gestión de identidades y accesos. La plataforma Purple actúa como intermediaria aquí, gestionando el intercambio de tokens de OAuth, mapeando los datos de perfil de WeChat a su CRM y manejando la comunicación RADIUS. Esta es la capa de inteligencia que conecta el ecosistema de WeChat con su infraestructura de red. Y cuarto, 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 la cuenta oficial de WeChat. Registre el dominio de su Captive Portal como el dominio de retorno de llamada autorizado. Esto garantiza que WeChat solo devuelva códigos de autorización a su infraestructura de confianza. Luego, 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 de WeChat e ingrese su AppID y AppSecret. Diseñe su página de inicio para que el inicio de sesión de WeChat sea prominente. Y, fundamentalmente, configure sus redireccionamientos posteriores a la autenticación. No envíe simplemente a los usuarios a una página de éxito genérica. Rediríjalos al perfil de su cuenta oficial de WeChat para fomentar que lo 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 del Captive Portal externo. Ingrese la URL del Captive Portal de Purple. Y aquí está el paso de configuración más importante: configure las entradas de 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 omite este paso, todo el flujo se interrumpe. 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 fallas en los inicios de sesión de WeChat en implementaciones de producción. Si el dispositivo no puede comunicarse 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 lanzar el servicio. Otro problema común es la discrepancia de redireccionamiento de OAuth (OAuth Redirect Mismatch). Si la URL de retorno 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 una barra diagonal al final: estos detalles importan. Además, tenga cuidado con 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. Por el lado de la estrategia, no desperdicie la interacción posterior al inicio de sesión. Impulse a los usuarios a seguir su cuenta oficial, acceder a un mapa interior o ver un menú digital. Manténgalos comprometidos 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 los términos 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 usar una cuenta de suscripción de WeChat? No. Necesita una cuenta de servicio verificada. Punto final. Pregunta: ¿Necesito incluir los dominios de WeChat en la lista blanca de cada punto de acceso? Sí. El walled garden debe configurarse a nivel de SSID en el controlador inalámbrico. Pregunta: ¿Cuánto tiempo mantiene WeChat válido el token de acceso? 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 múltiples 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 resumir, aquí tiene los cinco puntos clave de la sesión de hoy. Primero: La autenticación de WeChat WiFi utiliza OAuth 2.0 para reemplazar el ingreso manual de formularios con un inicio de sesión de un solo toque, lo que aumenta las tasas de finalización entre un 20 y un 30 por ciento. Segundo: Es obligatoria una cuenta de servicio de WeChat verificada. Las cuentas de suscripción no funcionarán. Tercero: La configuración del walled garden en sus puntos de acceso es el paso más crítico y el que se pasa por alto con más frecuencia. Cuarto: Las redirecciones posteriores a 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 cubran los requisitos tanto de GDPR como de PIPL antes de entrar en producción. Ese es el informe técnico sobre la integración del inicio de sesión de WeChat WiFi. Para obtener más información sobre estrategia de WiFi para invitados, analíticas y cumplimiento, visite purple dot ai. Gracias por escuchar.

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 primera fuente para los establecimientos que atienden a visitantes chinos y al ecosistema de WeChat en general. Para los gerentes 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 las normativas. 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 sobre hardware que incluye Cisco Meraki, HPE Aruba, Ruckus y Juniper Mist. Muestra cómo la plataforma de Guest WiFi de Purple intermedia el flujo de OAuth, mapea los datos de perfil a 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 mil 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 las implementaciones de producción.


Análisis técnico profundo

Cómo funciona la autenticación de WeChat WiFi

La autenticación de WeChat WiFi reemplaza el llenado manual de formularios con 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 de 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 intercambia 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 otorga 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 falla más común en las implementaciones de WeChat WiFi. Debe utilizar una Cuenta de Servicio (服务号) verificada de WeChat. Las cuentas de suscripción (订阅号) no exponen las API de autorización de páginas web OAuth 2.0 requeridas 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

Obtener una Cuenta de Servicio verificada requiere una licencia comercial china o un proceso de solicitud especial en el extranjero a través de Tencent, el cual conlleva una tarifa de verificación anual de $99 USD 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 completar 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 podrá iniciar el saludo (handshake) de OAuth y el inicio de sesión fallará de forma silenciosa.

Como mínimo, se debe permitir el acceso a los siguientes dominios en la lista blanca:

  • *.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 en Guest Portal.

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

Purple actúa como un proxy RADIUS en esta arquitectura. Después de un intercambio exitoso de OAuth de WeChat, Purple envía un mensaje RADIUS Access-Accept al controlador inalámbrico del establecimiento. El mensaje Access-Accept puede contener 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 después de 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 agregue el dominio de su Captive Portal como un dominio de devolución de llamada autorizado (por ejemplo, wifi.yourvenue.com). WeChat solo devolverá códigos de autorización a los dominios registrados aquí; una discrepancia provocará un fallo silencioso.

Recupere su AppID y AppSecret desde el panel de 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. Ingrese el AppID y el AppSecret. Diseñe la página de inicio del Captive Portal utilizando el editor de arrastrar y soltar de Purple. Coloque el botón de inicio de sesión de WeChat como 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 miniprograma de WeChat
  • Una página de encuesta utilizando las herramientas de WiFi Analytics de Purple
  • Una página de registro para el programa de lealtad

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 típica de visitas (siete días para comercio minorista, 30 días para hotelería). Los visitantes recurrentes se conectarán automáticamente sin ver el portal de nuevo, mientras que su visita se seguirá registrando en el panel de analíticas.

Paso 3: Configurar el hardware de red

En su controlador inalámbrico, configure el SSID de invitados para utilizar un Captive Portal externo. Ingrese la URL del portal de Purple como la URL de la página de inicio. Agregue los dominios de WeChat a la lista de acceso permitido (walled garden). Establezca las direcciones IP del servidor RADIUS y los secretos compartidos proporcionados por Purple.

Pruebe el flujo completo desde un dispositivo móvil antes de lanzarlo en vivo. Específicamente:

  1. Conéctese al SSID de invitados.
  2. Confirme que el Captive Portal se cargue en el mininavegador del Captive Portal Assistant (CPA).
  3. Toque el botón de inicio de sesión de WeChat y confirme que se abra la aplicación de WeChat.
  4. Autorice la conexión y confirme que se otorgue acceso a Internet.
  5. Confirme que la redirección posterior al inicio de sesión se ejecute correctamente.

Mejores prácticas

Optimice la lista de acceso permitido (walled garden). Una lista de acceso permitido mal configurada es la causa número uno de fallos en los inicios de sesión de WeChat en producción. Pruébela antes del lanzamiento y vuelva a probarla 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.

Impulse 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 tiempo después de haber abandonado el establecimiento.

Implemente el almacenamiento en caché de MAC para visitantes recurrentes. Requerir autenticación repetida en cada visita degrada la experiencia. El almacenamiento en caché de MAC elimina la fricción para los invitados que regresan, al mismo 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 utiliza. Solicitar permisos innecesarios aumenta la tasa de abandono de la autorización y añade complejidad al cumplimiento de 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 punto de venta (POS). Esto cumple con los requisitos de segmentación de red de PCI DSS y limita el radio de impacto de cualquier incidente de seguridad del lado del invitado. Para un análisis completo de la arquitectura de seguridad de WiFi, consulte nuestra guía de seguridad de WiFi para empresas .

Cumpla con GDPR y 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, establecer la base legal para el procesamiento y proporcionar un enlace a la política de privacidad completa. Para obtener una guía detallada, consulte nuestra guía de cumplimiento de WiFi GDPR .


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 devolverá un código de error y bloqueará la autorización. Verifique 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 después de 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 esto 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 línea 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 de WeChat WiFi ofrece retornos medibles a través de 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 reportan 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 de WiFi para 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 el flujo de visitantes transitorios en una audiencia digital alcanzable. 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 visitas de regreso, actualizaciones de programas de lealtad y promociones de temporada.

Visibilidad operativa. La plataforma de WiFi Analytics de Purple mapea las sesiones autenticadas de WeChat con el tiempo de permanencia, la frecuencia de 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 momento de las promociones. 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 se vuelve cada vez más valiosa a medida que la desaparición de las cookies de terceros reduce la efectividad del retargeting digital.


Para obtener orientación relacionada, consulte nuestra guía de cumplimiento de WiFi GDPR y nuestra guía de seguridad de WiFi empresarial . 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 de la industria que permite a un usuario otorgar 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, AppSecret y la URI de redireccionamiento 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 otorgar acceso a internet. Funciona redireccionando todas las solicitudes 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 superposición 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 se configura incorrectamente con más frecuencia en las implementaciones 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. Después de un intercambio de OAuth de WeChat exitoso, Purple envía un mensaje RADIUS Access-Accept al punto de acceso para otorgar 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 OAuth 2.0. Aparece como un contacto en la lista de chat del usuario. Requiere registro comercial en China o 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 propósito.

OpenID

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

La clave principal utilizada por el CRM para identificar y rastrear a los 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 Mini Programas registrados bajo la misma cuenta de la plataforma abierta de WeChat. Permite el reconocimiento de usuarios entre diferentes productos.

Relevante para marcas con múltiples puntos de contacto de WeChat (por ejemplo, una cadena minorista con un portal de WiFi y un Mini Programa 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) después de la autenticación inicial, lo que permite que la red otorgue acceso automáticamente en conexiones posteriores sin presentar el Captive Portal nuevamente.

Se utiliza para mejorar la experiencia de los visitantes recurrentes. Purple registra la visita recurrente para análisis incluso cuando no se muestra el portal.

Captive Portal Assistant (CPA)

El mini-navegador que se inicia automáticamente por iOS y Android cuando detectan una red que requiere autenticación de Captive Portal. Los CPA tienen una funcionalidad limitada y es posible que no admitan las llamadas a aplicaciones nativas requeridas 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 CPA e implementar la detección de JavaScript para redireccionar 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 WiFi de invitados de las redes corporativas o de puntos de venta (POS).

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

Ejemplos resueltos

Una marca de venta minorista de lujo en Londres desea ofrecer WiFi sin fricciones a los turistas chinos, al tiempo que incrementa 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 la implementación 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 (permita 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í, utilice una entidad china externa verificada como medida provisional). Configure la consola de desarrollador de WeChat con el dominio de retorno que coincida con la URL del portal de Purple. En la plataforma de Purple, habilite el inicio de sesión social con WeChat, ingrese el AppID y el AppSecret, y diseñe la página de bienvenida con WeChat como la opción principal de inicio de sesión. Configure el redireccionamiento posterior a la autenticación hacia la página de seguimiento de la Cuenta Oficial de WeChat de la marca. Semana dos: En el panel de Meraki, actualice el SSID de invitados para que apunte a la URL del portal de Purple. Agregue todos los dominios de la API de WeChat al walled garden de Meraki en Wireless > Access Control. Configure los detalles del servidor RADIUS. Pruebe el flujo completo de extremo a extremo desde un dispositivo iOS y Android. Habilite el almacenamiento en caché de MAC para el reconocimiento de visitantes recurrentes por 30 días. Ponga en marcha el sistema.

Comentario del examinador: Este enfoque utiliza el hardware Meraki existente sin necesidad de realizar cambios en el firmware. El elemento crítico en la ruta de trabajo es la verificación de la cuenta de WeChat; esto debe iniciarse con bastante anticipació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 de WiFi ú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 asistencia de personas de habla china. El director de TI informa que el 35% de los invitados abandonan el formulario de inicio de sesión de WiFi antes de completarlo. La red funciona con puntos de acceso HPE Aruba administrados a través de Aruba Central.

Implemente el Captive Portal de Purple con WeChat como la opción principal de inicio de sesión social, junto con alternativas de correo electrónico y SMS. Configure el perfil del Captive Portal de Aruba Central para redirigir a Purple y agregue los dominios de WeChat a la lista de permitidos. Implemente un script de detección de CPA en JavaScript en la página de bienvenida para forzar el flujo de OAuth hacia el navegador nativo del sistema, evitando el mini-navegador CPA de Aruba. Configure los atributos de RADIUS para asignar a los aficionados autenticados a una VLAN de invitados dedicada, aislada de la red operativa del estadio. Establezca el tiempo de espera de la sesión en cuatro horas para cubrir la duración típica de un evento sin requerir una nueva autenticación. Después de la autenticación, redirija a los aficionados a un Mini Programa de WeChat que aloje el programa del evento, resultados en vivo y un servicio de pedido de alimentos.

Comentario del examinador: El script de detección de CPA es el diferenciador técnico clave aquí. Sin él, la llamada a la aplicación de WeChat falla en el mini-navegador y los usuarios experimentan una interfaz rota. El redireccionamiento al Mini Programa maximiza la interacción posterior a la autenticación al brindar 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 tocan el botón de WeChat en la página de bienvenida, pero la página agota el tiempo de espera antes de que se abra la aplicación de WeChat. El panel de Cisco Meraki muestra que el SSID está en línea y que la URL del portal de Purple está configurada correctamente. ¿Cuál es la causa más probable y cómo la solucionas?

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

Ver respuesta modelo

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

Q2. Un director de marketing quiere usar su Cuenta de Suscripción de WeChat (订阅号) existente para habilitar el inicio de sesión de WiFi porque les permite publicar artículos diariamente a sus seguidores. Te piden que configures la integración. ¿Cómo respondes?

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

Ver respuesta modelo

Infórmales 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 con el Captive Portal solo están disponibles para Cuentas de Servicio (服务号) verificadas. Necesitará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, el cual toma de dos a cuatro semanas y cuesta $99 dólares anuales. La Cuenta de Suscripción puede permanecer activa para la publicación de contenido; los dos tipos de cuentas sirven para propósitos diferentes y pueden coexistir.

Q3. Después de una implementación exitosa de WeChat WiFi, el equipo de TI nota 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 la configuración de gestión de sesiones configurada en Purple y la duración de la caché MAC.

Ver respuesta modelo

Es probable que la duración de la caché 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 otorga acceso a través de la caché MAC sin activar un nuevo evento de autenticación o actualización de CRM. Alternativamente, el token de acceso de WeChat para esos usuarios ha expirado y la plataforma no lo está renovando. Solución: extiende la duración de la caché 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. También confirma que Purple esté registrando las visitas por caché MAC como eventos de visitas recurrentes en el panel de analíticas, incluso cuando no se muestre el portal.

Q4. Tu establecimiento opera tanto en el Reino Unido como en China continental. Deseas implementar un sistema unificado de autenticación WeChat WiFi. ¿Qué obligaciones de cumplimiento debes abordar antes de lanzar el servicio?

Sugerencia: Se aplican dos regímenes de privacidad distintos a las dos geografías.

Ver respuesta modelo

Debes cumplir tanto con el GDPR (aplicable a usuarios en el Reino Unido y la UE) como con la Ley de Protección de Información Personal de China (PIPL, aplicable a usuarios en China continental). Los requisitos clave incluyen: mostrar un aviso de privacidad claro en la página de bienvenida antes de iniciar el flujo de OAuth, identificar al controlador de datos y enumerar las categorías de datos recopilados de WeChat, establecer 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: Una guía para ubicaciones remotas y marítimas

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

Leer la guía →

Mejores prácticas de Captive Portal: Diseñando para una alta conversión y cumplimiento

Esta guía técnica ofrece a los gerentes de TI, arquitectos de red 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. Cubre toda la arquitectura, desde la segmentación de VLAN y la autenticación RADIUS hasta el diseño de consentimiento conforme a 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 plan 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 GDPR y la optimización de la conversión. Está dirigida a gerentes de TI, arquitectos de red y CTOs en hoteles, cadenas de retail, 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 portal 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 →