Plantilla de código fuente para portal web externo (Controller 4.1.5 o superior)

Adecuado para Omada Controller V4.1.5 o superior.

Para Omada Controller V3.1.4 o superior, consultar  FAQ2390

Para Omada Controller V3.0.5 o anterior, consultar  FAQ916

Este documento describe los requisitos al establecer un servidor de portal web externo. En Omada Controller,  el Portal web externo  solo se puede usar cuando el tipo de autenticación del portal es  Servidor Radius externo.

La siguiente imagen muestra el flujo de trabajo entre el cliente inalámbrico, EAP, el controlador Omada, el portal web externo y el servidor Radius. Le ayudará a comprender mejor los requisitos para establecer un servidor de portal web externo.

1. Para clientes inalámbricos y clientes cableados, cuando están conectados al SSID de la red inalámbrica o la red LAN cableada e intentan acceder a Internet, el EAP o la puerta de enlace interceptarán la solicitud HTTP del cliente y luego la redireccionarán al controlador Omada. (Paso 1 y Paso 2)

2. El Controlador Omada luego redirige la solicitud del cliente a la página del portal externo respondiendo una respuesta HTTP con el código de estado 302 Encontrado al cliente. (Paso 3 y Paso 4)

3. El cliente envía una solicitud HTTP/HTTPS GET a un portal web externo con el parámetro “?target=target_controller_ip&targetPort=target_controller_port&clientMac=client_mac&clientIp=client_ip&raidusServerIp=radius_server_ip&apMac=ap_mac&gatewayMac=gateway_mac&scheme=scheme&ssidName==ssid_name&radioId=radio_id(0 para radio 2.4G, 1 para radio 5G)&vid=vid&originUrl=redirecturl(si no se configuró la URL de redirección después de que los clientes inalámbricos/cableados pasaran la autenticación del portal, la URL de redirección predeterminada depende de los clientes inalámbricos)”.
Por ejemplo: "https://www.externalportal.com/?target=172.30.30.113&targetPort=8088&clientMac=F8-1E-DF-AA-AA-AA&clientIP=172.30.30.103&raidusServerIp=172.30.30.120&apMac=AC-84-C6-BB- BB-BB&GatewayMac=172.30.0.1&scheme=https&ssidName=eap_test&radioId=1&originalUrl=https%3A%2F%2Fwww.tp-link.com ” (Paso 5)

4. El servidor del portal web externo debe poder obtener el valor de los  parámetros clientMac, clientIp, apMac, gatewayMac, ssidName, radioId, vid, Scheme, originUrl  . Luego, el servidor del portal web externo debe redirigir al cliente al controlador con la información de nombre de usuario, contraseña, clientMac, clientIp, apMac, gatewayMac, ssidName, esquema, vid, radioId, originUrl. (Paso 6)

5. El client envía paquetes HTTP/HTTPS POST a (http) https://target_controller_ip:targetport/portal/radius/auth con formato JSON en el cuerpo del mensage HTTP  una vez submetido.El puerto por defecto “targetport” del portal es el 8843 (Step7)

Nota: Desde el Controlador 5.0, el campo "Access-Control-Allow-Origin:URL" debe enviarse en el encabezado HTTP para mejorar la seguridad durante el uso compartido de recursos entre orígenes (CORS). Por ejemplo, si el nombre de dominio del portal web externo es "www.tplinkportal.com", debe agregar "Access-Control-Allow-Origin:https://www.tplinkportal.com". Descargar la demostración al final del artículo como referencia.

6. El controlador Omada se comunica con el servidor RADIUS para verificar el nombre de usuario y la contraseña. (Paso 8 y Paso 9)

7. Si se pasa la autenticación, por ejemplo, se recibe Access-Accept desde el servidor de Radius, el controlador de Omada redirigirá a una página de éxito integrada o una página web predefinida de acuerdo con la configuración de los clientes. (Paso 10)

Nota:

1. El cliente debe enviar HTTP/HTTPS POST al controlador en el paso 7, ya que Controller 4.1.5 (o superior) no admite HTTP/HTTPS GET de esta manera.

2. Si el controlador (4.1.5 o superior) se actualiza desde el controlador 3. xx, tener en cuenta que hemos cambiado algunos "Nombres" de los parámetros.

3. En el paso 7, si su formulario tiene caracteres que no son ASCII (por ejemplo, el nombre del SSID es chino u otro idioma), se debe usar la codificación UTF-8 al enviar HTTP/HTTPS POST al controlador.

4. Tener en cuenta el campo "Access-Control-Allow-Origin:URL" para Controller 5.0 y superior.

La siguiente plantilla html es una demostración simple para el desarrollo personal del Portal Web Externo trabajando con el Controlador Omada:

Demostración de servidor web externo