JanusJanus Setup · Cisco
Otras marcas

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.

Para el equipo de redes Catalyst 9800 · AireOS 8.10 Revisada el 3 de noviembre de 2026

Cómo funciona

  1. El dispositivo se asocia al SSID abierto. El WLC envía un Access-Request por MAC (MAB) a Janus.
  2. Janus no encuentra registro para esa MAC y responde Access-Accept con dos atributos Cisco-AVPair: url-redirect=<URL del portal> y url-redirect-acl=<nombre de la ACL>.
  3. 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.
  4. La persona completa el registro, con el formulario o con una cuenta de Facebook, Google o Microsoft.
  5. Janus envía al WLC un CoA-Request (UDP 1700 en el 9800) con subscriber:command=reauthenticate.
  6. El WLC vuelve a consultar por la MAC. Janus responde Access-Accept con Session-Timeout y sin redirección: el dispositivo navega.
  7. 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:

DatoValorUso en el WLC
IP del servidor Janus54.233.195.155Servidor RADIUS, cliente de CoA, ACL
Nombre del portalportal001.januswifi.techLo resuelve el DNS del cliente; no se configura en el WLC
<PUERTO_AUTH>Lo asigna Janus, par, por ejemplo 1834Autenticación RADIUS
<PUERTO_ACCT><PUERTO_AUTH> + 1Accounting RADIUS
<SECRETO>Lo asigna Janus, 12 caracteres o másRADIUS y CoA, el mismo en los dos
<ACL>JANUS-PREAUTH, puede usarse otro nombre si se informaACL 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

Catalyst 9800
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.

Catalyst 9800
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

Catalyst 9800
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.

Catalyst 9800
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.

Catalyst 9800
ip http server

5. SSID abierto con filtrado por MAC

Catalyst 9800
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.

Catalyst 9800
wireless profile policy JANUS-POLICY
 aaa-override
 nac
 accounting-list JANUS-ACCT
 vlan <VLAN_INVITADOS>
 no shutdown

7. Policy tag y APs de prueba

Catalyst 9800
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.

PasoRuta en la interfaz webVerificado
1Configuration → Security → AAA → Servers/Groups → RADIUS → Servers (+ Add); luego Server Groups (+ Add), con el servidor en «Assigned Servers»sí
1Configuration → Security → AAA → AAA Method List → Authorization y Accounting (+ Add)sí
2Called-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 atributosno
3Casilla 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 CoAla casilla sí; su efecto, no
4ACL: Configuration → Security → ACL (+ Add, tipo IPv4 Extended). webauth-http-enable: Configuration → Security → Web Auth, parameter map globalsí
5Configuration → Tags & Profiles → WLANs (en la guía 26.x: Configuration → Wireless → WLANs) → Security → Layer2: MAC Filtering y Authorization Listsí
6Configuration → Tags & Profiles → Policy. La VLAN va en Access Policies; Allow AAA Override, NAC State (NAC Type: RADIUS) y Accounting List van en Advancedsí
7Configuration → Tags & Profiles → Tags → Policy. Asignación: Configuration → Wireless → Access Points → (AP) → General → Tagssí

Equivalente en AireOS

PasoDóndeQué configurarComando equivalente
1Security → AAA → RADIUS → AuthenticationServidor 54.233.195.155, puerto <PUERTO_AUTH>, <SECRETO>, Support for CoA en Enabled. Revisarlo: según la versión viene apagadoconfig radius auth rfc3576 enable <índice>
1Security → AAA → RADIUS → AccountingServidor 54.233.195.155, puerto <PUERTO_ACCT>, <SECRETO>—
2Security → AAA → RADIUS → AuthenticationAuth Called Station ID Type: AP MAC Address:SSID. Por defecto viene en System MAC Addressconfig 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—
4Security → Access Control ListsACL 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—
5WLANs → Security → Layer 2 / Layer 3Layer 2: None más MAC Filtering. Layer 3: None—
5WLANs → Security → AAA ServersServidores de autenticación y accounting de Janus; Interim Interval de 300 a 600 segundos, se admite de 0 a 3600config wlan radius_server acct interim-update <seg> <id_wlan>
6WLANs → AdvancedAllow AAA Override habilitado; NAC State: ISE NAC, que antes de la 8.5 se llamaba RADIUS NACconfig 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.

DatoEjemploPor qué
NAS-IP-Address que envía el WLC10.20.0.5Identifica al controlador y es el destino del CoA
Cómo llega el CoA a esa IPVPN sitio a sitio, o IP pública filtradaVer el paso 2
IP de salida del WLC hacia internet200.x.x.xPara filtrar y diagnosticar del lado de Janus
Modelo y versiónCatalyst 9800-CL 17.12Janus envía el CoA al puerto que use el equipo: 1700 en el 9800; en AireOS hay que confirmarlo
Nombre de la ACLJANUS-PREAUTHJanus lo envía en url-redirect-acl; debe coincidir exactamente
SSIDInvitadosAparece en el panel y en los reportes
Contacto técnico de redesNombre y teléfonoPara 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:

  1. 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.
  2. 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> detail muestra la URL de redirección y la ACL aplicadas.
  3. 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íntomaCausa probable
El teléfono se conecta pero el portal no apareceFalta 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 cargaLa ACL no deja pasar DNS o el tráfico hacia 54.233.195.155
La persona se registra y queda sin internetEl CoA no llega al WLC: puerto, filtrado de origen, NAS-IP-Address o secreto del cliente de CoA
El WLC no recibe respuesta de JanusPuertos 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 solasAccounting apagado, o Interim-Update de más de 10 minutos
Facebook, Google o Microsoft no terminan el loginLa 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.