Les exigences de l'établissement d'un serveur de portail externe (ci-dessus Omada Controller 4.1.5)

Convient pour Omada Controller 4.1.5 à 4.4.6.

Pour Omada Controller 5.0.15 ou supérieur, veuillez vous référer à la FAQ 3231

Pour Omada Controller 2.6.0 à 3.2.17, veuillez vous référer à la FAQ 2274

Pour Omada Controller 2.5.4 ou inférieur, veuillez vous référer à la FAQ 928

Remarque : Les mots-clés en italique gras indiquent des paramètres automatiquement renseignés par EAP ou Gateway, et doivent être correctement identifiés et fournis par votre serveur de portail externe. La signification des paramètres est indiquée dans la première apparition.

Ce document décrit les exigences pour établir un serveur de portail externe ( portail en abrégé). L'image ci-dessous illustre le flux de données entre les périphériques réseau, ce qui peut aider à mieux comprendre le mécanisme de travail.

Étapes 1 et 2.

Lorsqu'un client est connecté au réseau sans fil ou câblé lié avec un portail activé et tente d'accéder à Internet, sa requête HTTP sera interceptée par EAP ou Gateway, respectivement, puis redirigée vers le contrôleur Omada SDN (contrôleur en abrégé) le long avec les informations de connexion renseignées automatiquement par EAP ou Gateway dans l'URL.

Étapes 3 et 4.

Après cela, le client enverra une requête HTTP GET avec les informations de connexion au contrôleur et sera redirigé vers le portail par la réponse du contrôleur avec une réponse HTTP avec le code d'état 302. La réponse HTTP inclut l'URL du portail dans le champ d'emplacement ainsi que la connexion. information.

URL pour EAP : http(s):// PORTAL ?clientMac= CLIENT_MAC &apMac= AP_MAC &ssidName= SSID_NAME &t= TIME_SINCE_EPOCH &radioId= RADIO_ID &site= SITE_NAME &redirectUrl= LANDING_PAGE .

URL de la passerelle : http(s):// PORTAL ?clientMac= CLIENT_MAC &gatewayMac= GATEWAY_MAC &vid= VLAN_ID &t= TIME_SINCE_EPOCH &site= SITE_NAME &redirectUrl= LANDING_PAGE .

Étapes 5 et 6.

Le client enverra une requête HTTP GET au portail avec l'URL ci-dessus. Le portail doit être en mesure de reconnaître et de conserver les informations de connexion dans la chaîne de requête de la requête HTTP GET et de renvoyer la page Web pour authentification.

Étapes 7, 8 et 9.

Le client soumettra les informations d'authentification au portail, qui seront transmises au serveur d'authentification et seront vérifiées. Ensuite, le serveur d'authentification renvoie le résultat de l'authentification au portail.

Vous pouvez décider comment Portal obtient les informations d'authentification du client et comment Portal communique avec le serveur d'authentification, selon vos propres exigences, ce qui dépasse le cadre de cet article.

REMARQUE : Dans la figure ci-dessus, le portail et le serveur d'authentification sont séparés. Vous pouvez les installer sur le même serveur que vous le souhaitez. La méthode d'authentification dépend également de vous. Assurez-vous simplement que Portal peut connaître le résultat de l'authentification à partir du serveur d'authentification.

Étapes 10 et 11.

Si la demande d'authentification est autorisée, le portail doit envoyer les informations du client au contrôleur en appelant son API.

Tout d'abord, il doit se connecter au Controller en envoyant une requête HTTP POST . L'URL de la requête doit être https:// CONTROLLER : PORT /api/v2/hotspot/login et doit contenir les informations du compte de l'opérateur au format JSON dans le corps du message HTTP : "name= OPERATOR_USERNAME &password= OPERATOR_PASSWORD " .

L'interface d'appel est POST /api/v2/hotspot/login. Le paramètre de passage est JSON : {“name”:”xxx”, “password”:”xxx”}. Notez que le compte et le mot de passe ici sont l'opérateur ajouté dans l'interface du gestionnaire de points d'accès, plutôt que le compte et le mot de passe du compte du contrôleur.

Modèle de code PHP :

connexion de fonction statique privée ()

{

$ch = curl_init();

// poste

curl_setopt($ch, CURLOPT_POST, TRUE);

// Définit le retour à une valeur, pas le retour à la page

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Configurer les cookies. COOKIE_FILE_PATH définit où enregistrer le cookie.

curl_setopt($ch, CURLOPT_COOKIEJAR, COOKIE_FILE_PATH);

curl_setopt($ch, CURLOPT_COOKIEFILE, COOKIE_FILE_PATH);

// Autoriser les certificats auto-signés

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

// Appel d'API

curl_setopt($ch, CURLOPT_URL, CONTROLLER.":".PORT."/api/v2/hotspot/login” );

curl_setopt($ch, CURLOPT_POSTFIELDS, "name=" . OPERATOR_USER ."&password=" . OPERATOR_PASSWORD);

$res = curl_exec($ch);

$resObj = json_decode($res);

// Empêche CSRF. TOKEN_FILE_PATH définit où enregistrer le jeton.

if($resObj->succès == vrai){

self ::setCSRFToken($resObj->value);

}

curl_close($ch);

}

fonction statique privée setCSRFToken($token){

$myfile = fopen(TOKEN_FILE_PATH, "w") or die("Impossible d'ouvrir le fichier !");

fwrite($monfichier, $jeton);

fclose($monfichier);

retourne $token ;

}

Si l'authentification de connexion réussit, le contrôleur répondra avec le JSON suivant dans le corps HTTP.

{

"code d'erreur": 0,

"msg": "Connexion hotspot réussie.",

"résultat": {

"jeton": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

}

}

Étapes 12 et 13.

Après une connexion réussie, Portal peut envoyer le résultat de l'authentification du client à https:// CONTROLLER : PORT /api/v2/hotspot/extPortal/auth?token=CSRFToken avec la méthode HTTP POST . Les informations client doivent être encapsulées au format JSON et doivent contenir les paramètres suivants.

Pour EAP : " clientMac= CLIENT_MAC &apMac= AP_MAC &ssidName= SSID_NAME &radioId= RADIO_ID &site= SITE_NAME &time= EXPIRE_TIME & authType =4 "

Pour Gateway : " clientMac= CLIENT_MAC &gatewayMac= GATEWAY_MA C&vid= VLAN_ID &site= SITE_NAME &time= EXPIRE_TIM E& authType =4 "

Modèle de code PHP pour EAP :

fonction statique privée autorise($clientMac,$apMac,$ssidName,$radioId,$ millisecondes,$site)

{

// Envoie l'utilisateur à autoriser et le temps imparti

$authInfo = tableau(

'clientMac' => $clientMac,

'apMac' => $apMac,

''ssidName => $ssidName,

'radioId ' => $radioId,

'time' => $millisecondes,

'authType' => 4

);

$ch = curl_init();

// poste

curl_setopt($ch, CURLOPT_POST, TRUE);

// Définit le retour à une valeur, pas le retour à la page

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Configurer les cookies.

curl_setopt($ch, CURLOPT_COOKIEJAR, COOKIE_FILE_PATH);

curl_setopt($ch, CURLOPT_COOKIEFILE, COOKIE_FILE_PATH);

// Autoriser les certificats auto-signés

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);

// Appel d'API

$csrfToken = self::getCSRFToken();

curl_setopt($ch, CURLOPT_URL, CONTROLLER.":". PORT."/api/v2/hotspot/extPortal/auth/”.”?token=".$csrfToken);

$data = json_encode($authInfo);

curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($authInfo));

$res = curl_exec($ch);

$resObj = self::resultConvert($res);

if($resObj['succès'] == faux){

echo $res;

}

curl_close($ch);

}

fonction statique privée resultConvert($json)

{

$json = str_replace(array('{','}',':',','),array('[{" ',' }]','":',',"'),$json );

fonction cb_quote($v)

{

return '"'.trim($v[1]).'"' ;

}

$newJSON=preg_replace_callback("~\"(.*?)\"~","cb_quote", $json);

$res = json_decode($newJSON, true)[0] ;

retourne $res ;

}

fonction statique privée getCSRFToken(){

$myfile = fopen(TOKEN_FILE_PATH, "r") or die("Impossible d'ouvrir le fichier !");

$token = fgets($monfichier);

fclose($monfichier);

retourne $token ;

}

Si la demande d'authentification est acceptée, le Controller répondra avec le JSON suivant :

{ "code d'erreur": 0 }

Remarque : Le portail doit pouvoir répondre aux deux exigences suivantes :

1. Autoriser le certificat auto-signé . Ou vous téléchargerez votre propre certificat HTTPS sur Controller.

2. Lisez et enregistrez le « TPEAP_SESSIONID » dans Cookie et envoyez une demande d'authentification avec le cookie.