Réseau

Unifi déployer une borne WiFi

Sébastien POULLET

13 oct. 2022 • 2 min read

Déployer des bornes Wi-Fi sur une contrôleur installé sur serveur hébergé en dehors du resau local.

Le déploiement et l'appairement de bornes Wi-Fi Ubiquiti sur un contrôleur Unifi dans un réseau local ne pose généralement pas de difficulté particulière. Il peut être effectué directement depuis le navigateur WEB à partir de l'interface graphique de Unifi.

Dans le contexte d'un SI disposant d'un contrôleur Unifi hébergé à l'extérieur de son infra local et voulant déployer une nouvelle borne Wi-FI, il va falloir passer par la ligne de commande en SSH pour effectué le déploiement.

Objectif

Cet article est une mini procédure pour permettre à nos collaborateurs stagiaires, collègues et partenaires de déployer des bornes Wi-Fi en ligne de commande à partir d'une connexion SSH sur un contrôleur Unifi hébergé en dehors du SI.

Note: Le déploiement de bornes sur un contrôleur ne signifie pas quelles seront automatiquement adoptées, cette étape est réservée à l'Administrateur du contrôleur Wi-Fi.

Localiser les bornes Wi-Fi

Dans un premier temps il va falloir localiser les bornes Wi-Fi parmi l'ensemble des équipements connecté à votre réseau local, pour en suite s'y connecter et enfin leur indiquer où est situé le contrôleur avec lequel elles doivent s'appairer.

Pour cela ouvrir un terminal de votre choix et saisir la commande pour scanner votre réseau et rechercher les bornes Wi-Fi.

Remplacer dans la commande "@ip/cird" par l'adresse ip de votre réseau local et votre masque de sous-réseau.

Note: Si votre réseau local comporte un très grand nombre de machines, le scanner sera peut être très long. Il serait plus opportun de créer un sous-réseau avec un CIDR de 24


sudo nmap -sn @ip/cidr  | awk '/Nmap scan report for/{printf $5;}/MAC Address:/{print " => "substr($0, index($0,$3)) }' | sort

La sortie de la commande va vous lister les équipements connectés à votre réseau ainsi que leurs adresses IP, les adresses MAC associées et le nom du fabricant des cartes réseaux (le "vendor") quand il est connu.

Il sera dès lors plus facile d'identifier ses bornes Wi-Fi.
Dans l'hypothèse ou vous disposer d'un grand nombre de bornes Wi-Fi, il va falloir identifier l'équipement à déployer en comparant avec l'adresse MAC inscrite sur l'équipement ou sa boite d'emballage.

Déploiement en SSH

Connexion en SSH à une borne Wi-Fi Ubiquiti

Depuis le terminal connecter vous à la borne Wi-Fi à déployer.

Note Par convention je vais nommer les bonres Wi-Fi par AP pour point d'accès.

Saisir les commande:

ssh ubnt@adresse_ip_ap

le mot de passe par défaut des équipements ubiquiti est "ubnt"

Ne vous inquiétez pas une fois la borne Wi-Fi versé sur le contrôleur il ne sera plus possible de se connecter en SSH avec ce mot de passe. Il faudra nécessairement réinitialiser physiquement la borne pour pouvoir à nouveau le faire.

Passer en mode CLI

Saisir la commande:

mca-cli

Deploiement

Il est possible qu'une fois sur l'interface CLI, vous ne verrez pas ce que vous allez saisir. le résultat sera visible une fois après avoir tapé sur "Entrée"