Integrar un controlador Cisco con Janus.
El controlador se integra en modo CWA (Central Web Authentication): el WLC consulta a Janus por RADIUS cada dispositivo que se asocia, Janus le indica que lo redirija al portal y, cuando la persona se registra, Janus le envía un CoA Reauthenticate para que le habilite internet.
Acá está, paso a paso, qué configura el equipo de redes del cliente en un Catalyst 9800 y su equivalente en AireOS.
Cómo funciona
- El dispositivo se asocia al SSID abierto. El WLC envía un Access-Request por MAC (MAB) a Janus.
- Janus no encuentra registro para esa MAC y responde Access-Accept con dos atributos
Cisco-AVPair:url-redirect=<URL del portal>yurl-redirect-acl=<nombre de la ACL>. - El WLC aplica la ACL de pre-autenticación: el dispositivo sólo alcanza DNS, DHCP y el portal; cualquier otro tráfico web se redirige al portal.
- La persona completa el registro, con el formulario o con una cuenta de Facebook, Google o Microsoft.
- Janus envía al WLC un CoA-Request (UDP 1700 en el 9800) con
subscriber:command=reauthenticate. - El WLC vuelve a consultar por la MAC. Janus responde Access-Accept con
Session-Timeouty sin redirección: el dispositivo navega. - El WLC envía accounting (Start, Interim-Update, Stop), con el que Janus registra la sesión.
Lo esencial
El único tráfico que entra a la red del cliente es el CoA del paso 5. Sin él, la persona queda en el portal sin internet.
Datos que entrega Janus antes de empezar
Janus asigna a cada cliente su propio par de puertos RADIUS y su propio secreto compartido. Los valores entre < > de esta guía se reemplazan por estos:
| Dato | Valor | Uso en el WLC |
|---|---|---|
| IP del servidor Janus | 54.233.195.155 | Servidor RADIUS, cliente de CoA, ACL |
| Nombre del portal | portal001.januswifi.tech | Lo resuelve el DNS del cliente; no se configura en el WLC |
<PUERTO_AUTH> | Lo asigna Janus, par, por ejemplo 1834 | Autenticación RADIUS |
<PUERTO_ACCT> | <PUERTO_AUTH> + 1 | Accounting RADIUS |
<SECRETO> | Lo asigna Janus, 12 caracteres o más | RADIUS y CoA, el mismo en los dos |
<ACL> | JANUS-PREAUTH, puede usarse otro nombre si se informa | ACL de pre-autenticación |
Cuidado
El secreto se entrega por un canal seguro, nunca por correo electrónico. La URL del portal no hace falta configurarla: Janus la envía en cada respuesta RADIUS.
Configuración en el controlador
Son siete pasos. Los comandos son de Catalyst 9800 y se verificaron el 3 de noviembre de 2026 contra la documentación de Cisco para IOS XE 26.x, cuya versión más nueva es la 26.2, y AireOS 8.10.196.0.
Antes de aplicar
Los nombres en mayúsculas, JANUS-..., son sugeridos y pueden cambiarse, salvo la ACL, cuyo nombre debe coincidir con el informado a Janus. El responsable de redes del cliente debe validar los comandos en su versión antes de aplicarlos.
1. Servidor RADIUS, autenticación y accounting
radius server JANUS
address ipv4 54.233.195.155 auth-port <PUERTO_AUTH> acct-port <PUERTO_ACCT>
key <SECRETO>
!
aaa group server radius JANUS-GRUPO
server name JANUS
!
aaa authorization network JANUS-AUTHZ group JANUS-GRUPO
aaa accounting identity JANUS-ACCT start-stop group JANUS-GRUPO
2. Atributos que Janus necesita en cada pedido
Janus obtiene el SSID del Called-Station-Id con el formato MAC-del-AP:SSID, y registra las sesiones con los Interim-Update del accounting.
radius-server attribute wireless authentication call-station-id ap-macaddress-ssid
radius-server attribute wireless accounting call-station-id ap-macaddress-ssid
aaa accounting update periodic 5
El Interim-Update debe enviarse cada 10 minutos o menos: Janus da por abandonada una sesión que pasa 30 minutos sin accounting.
El punto que más falla
El NAS-IP-Address debe ser la IP por la que Janus alcanza al WLC. Janus identifica al controlador por ese atributo y le envía el CoA a esa misma dirección.
El WLC pone ahí su IP de gestión, o la de la interfaz de origen que fije ip radius source-interface. Ni el 9800 ni AireOS documentan una forma de cambiarla por otra IP. Con una VPN sitio a sitio funciona tal cual. Si el WLC sale a internet por NAT, el CoA no tiene destino, y ese caso debe acordarse con Janus antes de configurar.
3. CoA, Change of Authorization
aaa server radius dynamic-author
client 54.233.195.155 server-key <SECRETO>
El 9800 escucha el CoA en UDP 1700. Ese puerto debe ser alcanzable desde 54.233.195.155 y sólo desde allí, con filtrado de origen en el firewall o por VPN.
4. ACL de pre-autenticación
En la redirect ACL del 9800 la lógica es inversa a una ACL de seguridad: deny deja pasar el tráfico sin redirigir y permit lo redirige al portal.
ip access-list extended JANUS-PREAUTH
10 deny udp any any eq domain
20 deny udp any eq domain any
30 deny tcp any any eq domain
40 deny tcp any eq domain any
50 deny ip any host 54.233.195.155
60 deny ip host 54.233.195.155 any
70 permit tcp any any eq www
No hace falta habilitar dominios de Microsoft, Google ni Facebook: la ventana para el login con terceros la abre Janus por CoA. Sólo se redirige HTTP, el puerto 80, que es lo que usan los teléfonos para detectar el portal. Redirigir HTTPS muestra advertencias de certificado.
Para interceptar y redirigir, el WLC necesita escuchar HTTP en el puerto 80. Se habilita con el servidor HTTP o, en su lugar, con webauth-http-enable en parameter-map type webauth global. ip http secure-server sólo hace falta para interceptar HTTPS, que Cisco desaconseja por el consumo de CPU.
ip http server
5. SSID abierto con filtrado por MAC
wlan JANUS-WIFI <ID_WLAN> "<SSID>"
mac-filtering JANUS-AUTHZ
no security ft adaptive
no security wpa
no security wpa wpa2
no security wpa wpa2 ciphers aes
no security wpa akm dot1x
no shutdown
6. Policy profile
aaa-override y nac son obligatorios: sin ellos el WLC ignora la redirección, el Session-Timeout y el CoA.
wireless profile policy JANUS-POLICY
aaa-override
nac
accounting-list JANUS-ACCT
vlan <VLAN_INVITADOS>
no shutdown
7. Policy tag y APs de prueba
wireless tag policy JANUS-TAG
wlan JANUS-WIFI policy JANUS-POLICY
!
ap <MAC_DEL_AP>
policy-tag JANUS-TAG
Para la prueba de concepto, el tag se aplica sólo a un grupo acotado de APs.
Los mismos pasos en la interfaz web del 9800
Todo puede configurarse desde la interfaz web salvo los atributos del paso 2, que sólo tienen comando de consola documentado. En la columna «Verificado», un «no» quiere decir que la ruta no figura en la documentación oficial de Cisco.
| Paso | Ruta en la interfaz web | Verificado |
|---|---|---|
| 1 | Configuration → Security → AAA → Servers/Groups → RADIUS → Servers (+ Add); luego Server Groups (+ Add), con el servidor en «Assigned Servers» | sí |
| 1 | Configuration → Security → AAA → AAA Method List → Authorization y Accounting (+ Add) | sí |
| 2 | Called-Station-Id e Interim-Update periódico: sólo por consola. La Wireless AAA Policy de la interfaz web configura el NAS-ID, no estos atributos | no |
| 3 | Casilla Support for CoA al crear el servidor RADIUS. Desde la 17.4 pide además la CoA Server Key, que es el mismo <SECRETO>. Comprobar con show running-config | section dynamic-author que haya creado el cliente de CoA | la casilla sí; su efecto, no |
| 4 | ACL: Configuration → Security → ACL (+ Add, tipo IPv4 Extended). webauth-http-enable: Configuration → Security → Web Auth, parameter map global | sí |
| 5 | Configuration → Tags & Profiles → WLANs (en la guía 26.x: Configuration → Wireless → WLANs) → Security → Layer2: MAC Filtering y Authorization List | sí |
| 6 | Configuration → Tags & Profiles → Policy. La VLAN va en Access Policies; Allow AAA Override, NAC State (NAC Type: RADIUS) y Accounting List van en Advanced | sí |
| 7 | Configuration → Tags & Profiles → Tags → Policy. Asignación: Configuration → Wireless → Access Points → (AP) → General → Tags | sí |
Equivalente en AireOS
| Paso | Dónde | Qué configurar | Comando equivalente |
|---|---|---|---|
| 1 | Security → AAA → RADIUS → Authentication | Servidor 54.233.195.155, puerto <PUERTO_AUTH>, <SECRETO>, Support for CoA en Enabled. Revisarlo: según la versión viene apagado | config radius auth rfc3576 enable <índice> |
| 1 | Security → AAA → RADIUS → Accounting | Servidor 54.233.195.155, puerto <PUERTO_ACCT>, <SECRETO> | — |
| 2 | Security → AAA → RADIUS → Authentication | Auth Called Station ID Type: AP MAC Address:SSID. Por defecto viene en System MAC Address | config radius auth callStationIdType ap-macaddr-ssid |
| 3 | — | Informar a Janus en qué puerto UDP recibe el CoA el controlador. La documentación de Cisco cita 1700 en los ejemplos con ISE, y la guía 8.10 no indica un valor por defecto | — |
| 4 | Security → Access Control Lists | ACL JANUS-PREAUTH. Lógica opuesta al 9800: permit pasa sin redirigir; deny, incluido el implícito del final, se redirige. Permitir DNS en los dos sentidos y todo el tráfico desde y hacia 54.233.195.155 | — |
| 5 | WLANs → Security → Layer 2 / Layer 3 | Layer 2: None más MAC Filtering. Layer 3: None | — |
| 5 | WLANs → Security → AAA Servers | Servidores de autenticación y accounting de Janus; Interim Interval de 300 a 600 segundos, se admite de 0 a 3600 | config wlan radius_server acct interim-update <seg> <id_wlan> |
| 6 | WLANs → Advanced | Allow AAA Override habilitado; NAC State: ISE NAC, que antes de la 8.5 se llamaba RADIUS NAC | config wlan nac radius enable <id_wlan> |
Datos que el cliente devuelve a Janus
Con estos datos Janus da de alta el controlador. Sin el alta, Janus rechaza los pedidos del WLC en lugar de redirigirlos al portal.
| Dato | Ejemplo | Por qué |
|---|---|---|
NAS-IP-Address que envía el WLC | 10.20.0.5 | Identifica al controlador y es el destino del CoA |
| Cómo llega el CoA a esa IP | VPN sitio a sitio, o IP pública filtrada | Ver el paso 2 |
| IP de salida del WLC hacia internet | 200.x.x.x | Para filtrar y diagnosticar del lado de Janus |
| Modelo y versión | Catalyst 9800-CL 17.12 | Janus envía el CoA al puerto que use el equipo: 1700 en el 9800; en AireOS hay que confirmarlo |
| Nombre de la ACL | JANUS-PREAUTH | Janus lo envía en url-redirect-acl; debe coincidir exactamente |
| SSID | Invitados | Aparece en el panel y en los reportes |
| Contacto técnico de redes | Nombre y teléfono | Para la prueba de CoA y la puesta en marcha |
Verificación y problemas frecuentes
La prueba se hace en este orden, y no se avanza al paso siguiente sin que el anterior funcione:
- CoA. Janus envía un CoA de prueba y el WLC responde ACK. Un timeout significa que el paquete no llega, por firewall, NAT o VPN. Un NAK significa que llega pero el secreto o la IP del cliente de CoA no coinciden.
- Redirección. Un teléfono nuevo se conecta al SSID y el portal se abre solo. En el WLC,
show wireless client mac-address <MAC> detailmuestra la URL de redirección y la ACL aplicadas. - Acceso. Tras el registro, el mismo comando muestra al cliente en estado
RUN, sin redirección, y el panel de Janus lo muestra conectado.
| Síntoma | Causa probable |
|---|---|
| El teléfono se conecta pero el portal no aparece | Falta aaa-override o nac en el policy profile, el nombre de la ACL no coincide, o ip http server está apagado |
| El portal aparece pero no carga | La ACL no deja pasar DNS o el tráfico hacia 54.233.195.155 |
| La persona se registra y queda sin internet | El CoA no llega al WLC: puerto, filtrado de origen, NAS-IP-Address o secreto del cliente de CoA |
| El WLC no recibe respuesta de Janus | Puertos o secreto RADIUS distintos de los asignados, o el firewall del cliente bloquea la salida UDP hacia esos puertos |
| El panel no muestra sesiones, o las cierra solas | Accounting apagado, o Interim-Update de más de 10 minutos |
| Facebook, Google o Microsoft no terminan el login | La ventana de 120 segundos depende del CoA: revisar el paso 1 de la verificación |
¿Trabado en algún paso?
Decinos en cuál y qué devuelve el comando de verificación. Si es la prueba de CoA, lo miramos desde nuestro lado en el momento. Te respondemos en menos de 24 horas hábiles.

