Inicio / Notas técnicas / Diagnóstico de falso desconectado del canal de autenticación

Canal de autenticación "falso desconectado": un diagnóstico profundo

Un dispositivo se muestra perfectamente en línea en la interfaz de administración del inquilino — canal de configuración en verde, página de gestión de dispositivos limpia — y la autenticación Portal aun así falla para todos los usuarios detrás de él. La página de gestión de dispositivos lee el canal de configuración, no el que realmente autentica a los usuarios. Así se demuestra que el propio canal de autenticación ha quedado desconectado silenciosamente mientras todo lo demás sigue reportando salud, usando el registro del canal del dispositivo y, cuando eso no es concluyente, una comparación directa del conteo de caché mediante redis-cli en una sesión SSH.

By Yuwen Zhang (Atlas), founder of AtlasCommTech — 13 years of carrier & enterprise network deployments · Updated July 2026

Por qué "en línea" en la interfaz no significa lo que usted cree

Un controlador no rastrea un único estado en línea/desconectado por dispositivo — rastrea varios, y la interfaz de administración solo le muestra uno de ellos.

La conexión de un dispositivo con un controlador de campus gestionado en la nube no es una única marca en línea/desconectado. Se divide en canales separados — configuración, rendimiento, autenticación y (en despliegues fabric) un canal IP Group — cada uno con su propio estado independiente. La página de gestión de dispositivos que la mayoría de los ingenieros revisa primero lee el canal de configuración. Si ese canal está activo, el dispositivo se muestra en verde, y resulta tentador descartar el dispositivo por completo. Pero si específicamente el canal de autenticación quedó obsoleto mientras el canal de configuración se mantuvo activo, los inicios de sesión Portal siguen fallando y nada en el lugar obvio le dice por qué.

A continuación, el triaje que delimita correctamente este tipo de falla, el método del registro del canal del dispositivo que cubre la mayoría de los casos, la comparación de caché por root SSH más redis-cli para los casos que ese método no resuelve, y la elección de remediación entre reiniciar un solo AP y reiniciar todo el servicio de autenticación.

La ruta de diagnóstico, de principio a fin

Cuatro causas producen el mismo ticket de "Portal sigue fallando" — aquí es donde se ubica el canal de autenticación falso desconectado entre ellas, y cómo pasar del síntoma a la prueba.

Portal Authentication Keeps Failing Cloud service exceptionPortalServer / LVSService down site-wide AP or network faultno portal page reaches the client at all Fake Offline · This Noteconfig channel up, auth channel stale Compatibility issueone device / browser type only 1 · Method one — device channel logcheck the last recorded state of the auth channel specifically 2 · Method two — count the two sides independentlyadmin-visible online AP count vs redis cache online count 3 · Counts don't match → fake offline confirmedthe auth channel entry never updated after the device reconnected 4a · Small gap — restart the affected APforces the auth channel to rebuild 4b · Large gap — restart CampusAAAAuthServiceforces every device to rebuild its auth channel at once

Las etiquetas del diagrama se mantienen en inglés por claridad técnica.

Las otras tres causas se anuncian claramente — una interrupción del servicio en la nube es a nivel de todo el sitio, una falla de red aparece en la URL del navegador y en los registros de acceso, un problema de compatibilidad se limita a un tipo de dispositivo. El falso desconectado es el silencioso: todo lo que está aguas arriba parece estar bien.

Recorriendo el diagnóstico

Primero delimite el alcance, luego pruébelo de dos formas distintas, y después elija la corrección del tamaño adecuado.

Paso 1 — El triaje de las tres hachas

Antes de perseguir específicamente el canal de autenticación, delimite la falla usando las mismas tres comprobaciones que se aplican a cualquier reclamo de autenticación.

  1. Confirme el alcance afectado: ¿fallan todos los terminales con el mismo síntoma (sospeche de un servicio en la nube), o solo los terminales de ciertos sitios o bajo ciertos dispositivos (sospeche de ese dispositivo específico), o solo un modelo de teléfono o tipo de navegador (sospeche de un problema de compatibilidad), o solo un método de autenticación (sospeche de la cadena propia de ese método)?
  2. Capture evidencia del lado del terminal: la dirección MAC e IP desde la configuración de Wi-Fi del dispositivo, la URL de Portal y una captura de pantalla de la página de fallo si es un flujo Portal, y la hora exacta en que falló la autenticación.
  3. Revise las páginas del lado de la nube: la página de gestión de dispositivos del inquilino y su vista general de dispositivo individual y registro de eventos, y el registro de en línea/desconectado de terminales bajo monitoreo, filtrado por sitio, tipo y rango de tiempo, para buscar un patrón.

Paso 2 — Método uno: verificar el registro del canal del dispositivo

Este es el camino rápido — responde directamente si el canal de autenticación específicamente fue registrado como desconectado alguna vez.

  1. Inicie sesión con la cuenta de inquilino, vaya a Mantenimiento de red > Registros de dispositivo > Registros de dispositivo, y abra la pestaña Registro del canal del dispositivo.
  2. Configure un filtro para el dispositivo afectado, actualice y revise sus entradas de registro en línea/desconectado. Verifique específicamente si el último estado registrado del canal de autenticación es desconectado — no el canal de configuración, que es el que la página de gestión de dispositivos ya le mostró como correcto.

Paso 3 — Método dos: comparar directamente los dos recuentos

Cuando el registro del canal no es concluyente por sí solo, esta comparación lo resuelve — los dos recuentos coinciden o no.

  1. Inicie sesión con la cuenta admin y anote el número de AP que la plataforma muestra actualmente como en línea.
  2. Inicie sesión en el backend con la cuenta root en cualquier nodo y consulte directamente en la caché el número total de entradas almacenadas para el canal de autenticación. Luego salga de la sesión root.
  3. Si los dos recuentos no coinciden, se confirma una condición de falso desconectado del canal de autenticación — la lista de dispositivos de la plataforma y la caché de autenticación se han desviado entre sí.
/opt/redis/bin/redis-cli -h 10.173.10.11 -p 26542 -cipherdir /opt/redis/etc/cipher -a campuscachedb@ossdbuser@Example@123
hgetall "ac_campus_portalserver_devtonode"
exit

Paso 4 — Elegir la corrección del tamaño adecuado

El tamaño de la discrepancia en los recuentos decide qué palanca activar — reiniciar APs individualmente no se adapta a una desviación a escala de plataforma.

  1. Para una discrepancia pequeña que afecte a uno o unos pocos dispositivos, reinicie el AP afectado para forzarlo a reconstruir su sesión — esto restablece el canal de autenticación solo para ese dispositivo.
  2. Para una discrepancia grande que abarque muchos dispositivos, reinicie en su lugar el servicio de negocio CampusAAAAuthService, lo que fuerza a todos los dispositivos a restablecer su conexión de una vez en lugar de reiniciarlos uno por uno.
https://<management-plane-ip>:18102
// log in with the admin account, open the product's Services tab
// search for the target service, select it, click Stop, wait for status to change, then click Start

5 trampas que hay que conocer antes de perseguir esto

El mecanismo anterior es sencillo una vez que se ve — estas son las formas en que realmente hace tropezar a los ingenieros.

1. "En línea" en la interfaz de administración no es un solo hecho — son varios

SÍNTOMALa página de gestión de dispositivos muestra el dispositivo en verde y saludable, pero los usuarios detrás de él no pueden completar la autenticación Portal.

CAUSAUn controlador rastrea la configuración, el rendimiento, la autenticación y (en escenarios fabric) el estado IP Group como canales separados. La página de gestión de dispositivos lee específicamente el canal de configuración. Un dispositivo puede mostrarse totalmente en línea ahí mientras su canal de autenticación — el que realmente importa para los inicios de sesión Portal — está obsoleto.

SOLUCIÓNUna vez que el canal de configuración se verifica como correcto y la autenticación sigue fallando, deje de mirar la página de gestión de dispositivos y vaya directamente al registro del canal del dispositivo para el historial del canal de autenticación de ese dispositivo específico.

2. La discrepancia es invisible a menos que cuente ambos lados por separado

SÍNTOMANada en la interfaz de administración misma marca un problema — sin alarma, sin estado rojo, sin discrepancia evidente en ninguna parte de la pantalla.

CAUSALa interfaz no verifica cruzadamente la lista de dispositivos de la plataforma contra el propio recuento de registros de la caché de autenticación — los dos números pueden desviarse silenciosamente, y nada revela esa desviación a menos que alguien cuente ambos lados de forma independiente y los compare.

SOLUCIÓNTrate el recuento en línea visible en la administración y el recuento en línea de la caché redis como dos números independientes que deben compararse activamente — no asuma que la interfaz le avisaría si hubieran divergido.

3. redis-cli sin los indicadores exactos falla de forma engañosa

SÍNTOMAEjecutar un comando redis-cli simple contra la caché del controlador devuelve un error de autenticación o nada en absoluto, haciendo parecer que el propio servicio de caché está caído.

CAUSALa instancia de redis de este controlador se ejecuta en un puerto no predeterminado con TLS habilitado a través de un directorio de cifrado específico y una contraseña de cuenta de servicio — nada de eso lo proporciona una invocación simple de redis-cli. El comando debe llevar exactamente -h, -p, -cipherdir y -a, o falla antes de siquiera llegar a la consulta real de la caché.

SOLUCIÓNInvóquelo siempre con el conjunto completo de indicadores — host, puerto, directorio de cifrado y credencial de cuenta de servicio — como un solo comando, no construido interactivamente, y salga de la sesión root en cuanto termine la consulta.

/opt/redis/bin/redis-cli -h 10.173.10.11 -p 26542 -cipherdir /opt/redis/etc/cipher -a campuscachedb@ossdbuser@Example@123
hgetall "ac_campus_portalserver_devtonode"

4. Reiniciar todos los AP es la palanca equivocada para una desviación a escala de plataforma

SÍNTOMAReiniciar el único AP afectado soluciona ese dispositivo, pero la misma falla sigue apareciendo en otros lugares del inquilino.

CAUSACuando la discrepancia en el recuento es grande, no se trata de un puñado de entradas obsoletas — es el propio servicio de autenticación el que necesita restablecer conexiones a escala de plataforma. Reiniciar los AP uno por uno trata un problema de nivel de servicio como uno de nivel de dispositivo, y nunca logra alcanzarlo.

SOLUCIÓNCompare el tamaño de la discrepancia antes de elegir un remedio: una brecha pequeña y aislada se soluciona con un reinicio de AP; una brecha grande y dispersa se soluciona reiniciando CampusAAAAuthService.

5. Este es un problema del canal Portal/Haca, no uno de 802.1X cableado

SÍNTOMAUn ticket independiente describe fallos de autenticación en puertos cableados, con códigos de error y una cadena RADIUS que no coinciden con nada descrito aquí.

CAUSAEl canal de autenticación y su modo de falla de falso desconectado son específicos de un controlador que actúa como servidor Portal sobre el protocolo Haca. La autenticación 802.1X/NAC cableada funciona con una cadena cliente-dispositivo de acceso-RADIUS completamente separada, con sus propios códigos de error y su propia CLI, y no tiene nada que ver con esta discrepancia caché-versus-interfaz.

SOLUCIÓNNo recurra a una comparación de caché con redis-cli en un ticket de autenticación cableada — trabaje la cadena 802.1X/NAC según sus propios términos.

Diseños de soluciones relacionadas

Cinco preguntas que surgen constantemente

Extraídas directamente del campo — aquellas para las que vale la pena tener una respuesta lista.

¿Qué es exactamente el "canal de autenticación", frente al canal de configuración o de rendimiento?

El canal de configuración es lo que el controlador usa para enviar configuración a un dispositivo, y también es lo que refleja el estado de la página de gestión de dispositivos. El canal de rendimiento es cómo el controlador recibe informes de CPU, memoria y conteo de terminales — su pérdida afecta la visibilidad de monitoreo, no el reenvío. El canal de autenticación existe específicamente cuando el controlador actúa como servidor Portal sobre el protocolo Haca; cuando está desconectado, la autenticación Portal para ese dispositivo falla aunque el reenvío y la gestión parezcan correctos.

¿En qué se diferencia el "falso desconectado" de que el dispositivo esté realmente desconectado?

Un dispositivo realmente desconectado se muestra desconectado en todas partes — canal de configuración, canal de rendimiento, página de gestión de dispositivos, todo. Un canal de autenticación falso desconectado es más limitado: el dispositivo es alcanzable, su canal de configuración está activo, y la interfaz de administración lo muestra saludable, pero su entrada de caché del canal de autenticación nunca se actualizó tras un ciclo anterior de desconexión-reconexión, por lo que los inicios de sesión Portal enrutados a través de él siguen fallando.

¿Es seguro ejecutar comandos redis-cli directamente contra la caché de producción?

Un comando de solo lectura como hgetall contra esta clave específica es una consulta, no una escritura, y es el método documentado para esta comprobación exacta. Las precauciones que importan son de procedimiento: use la cuenta root solo durante la consulta, proporcione todos los indicadores de conexión exactamente como está documentado, y salga de la sesión inmediatamente después en lugar de dejar una shell root abierta.

Después de confirmar una discrepancia, ¿cómo decido entre reiniciar el AP y reiniciar el servicio?

Observe cuán grande es la brecha. Si es una diferencia pequeña —un dispositivo o unos pocos— reiniciar ese AP para forzarlo a reconstruir su sesión es la corrección proporcionada. Si la brecha es grande, es el propio servicio de autenticación subyacente el que necesita reiniciarse para que todos los dispositivos se reconecten a la vez; reiniciar dispositivos individualmente a esa escala simplemente no alcanzará.

¿Esto también afecta a la autenticación 802.1X o NAC cableada?

No. Esta condición de falso desconectado es específica del canal de autenticación que un controlador mantiene cuando actúa como servidor Portal sobre Haca. La autenticación 802.1X/NAC cableada funciona con una cadena cliente-dispositivo de acceso-RADIUS completamente separada, con sus propios códigos de error y CLI, y no se ve afectada en absoluto por esta discrepancia particular de caché frente a interfaz.

Límites honestos de esta nota

Límites honestos de esta nota

Esta nota se basa en el modelo de canales de un controlador de campus gestionado en la nube específico, su registro del canal del dispositivo, y la comparación de caché por root más redis-cli documentada para él, además de la guía operativa detrás de ella. Cubre específicamente el caso de falso desconectado del canal de autenticación Portal/Haca — no cubre fallas del canal de configuración o rendimiento, estados desconectados relacionados con licencias, ni autenticación 802.1X/NAC cableada, todos los cuales siguen sus propias rutas de diagnóstico separadas.

¿Fallan los inicios de sesión Portal en dispositivos que parecen en línea?

Cuéntenos el recuento en línea visible en la administración frente a lo que muestra la caché de autenticación, y le ayudaremos a interpretar la diferencia.

Contactar a un ingeniero por WhatsApp →

Lecturas relacionadas

Solo usamos cookies para analítica anónima — sin publicidad ni rastreo entre sitios.Política de privacidad