WikiBR - Contributions [fr]

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-18T19:44:31Z

Florian.chive : fix duplicate & links

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-18T19:40:58Z

Florian.chive : Fix header level

{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

Ce guide a été écrit principalement pour le routeur Archer C50, mais il est entièrement transposable à tout modèle de routeur sur lequel OpenWRT peut être installé. Le détail de comment flasher OpenWRT dépend cependant du modèle, et n'est pas couvert par ce guide.

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

Ce guide n'est absolument pas optimal, et l'image résultante est bien moins fonctionnelle qu'une image pré-compilée officielle. Commencez par vérifier si une image n'existe pas déjà pour votre modèle, afin de vous épargner la purge qu'est ce procédé.

== Pré-requis ==

* Un ordinateur tournant sous Linux (Debian est testé et fonctionne) (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

make menuconfig

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

nano files/etc/config/wpa.conf
nano files/etc/config/wireless
nano files/etc/init.d/wpa

cd files/etc/rc.d
ln -s -r ../init.d/wpa/S99wpa

cd ../../..

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Déterminer la <code>target</code> et la <code>subtarget</code> ===

OpenWRT peut être installé sur une grande variété de routeurs, qui sont classé par <code>target</code> et <code>subtarget</code>.

Pour déterminer quelles est notre <code>target</code> et notre <code>subtarget</code>, le plus simple est de se référer à la documentation officielle d'OpenWRT pour notre modèle, disponible [https://openwrt.org/toh/start ici]. Pour le Archer C50, la page est la [https://openwrt.org/toh/tp-link/archer-c50 suivante].

Il faut ensuite aller à la section '''Downloads''', afin d'obtenir le lien de téléchargement d'OpenWRT pour ce modèle.

Cette url se présente sous la forme suivante : https://downloads.openwrt.org/releases/<code>version</code>/targets/<code>target</code>/<code>subtarget</code>/openwrt-<code>version</code>-<code>target</code>-<code>subtarget</code>-<code>modele</code>-squashfs-factory-<code>zone</code>.bin

La partie qui nous intéresse de cette URL se situe juste après le <code>/targets/</code>.

Par exemple, pour le [https://openwrt.org/toh/tp-link/archer-c50#downloads Archer C50], le lien de téléchargement est https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin

La <code>target</code> est donc <code>ramips</code> et la subtarget <code>mt7620</code>. Cette information va nous permettre de compiler OpenWRT pour notre modèle.

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Il est cependant possible de prendre comme base un fichier de configuration pré-existant.

Un fichier de configuration créé par le BR est disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici].

La commande pour le copier est donc :

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

Ce fichier correspond à une configuration pour compiler OpenWRT sur le Archer C50 v6, mais peut être adapté à tout routeur en modifiant la cible de compilation (cf. étape suivante).

=== Configuration de la <code>target</code> et <code>subtarget</code> ===

Si votre routeur est autre chose que le Archer C50 v6, il est nécessaire de changer la cible de compilation via la commande suivante :

make menuconfig

La première chose à faire est de renseigner la <code>target</code>, la <code>subtarget</code>, puis le modèle exact dans <code>Target Profile</code>.

=== Renseignement des fichiers de configuration ===

Voici la partie cursed de ce guide. Je tiens à m'excuser profondément pour les instructions qui vont suivre.

==== rant ====

Le problème de cette méthode pour compiler OpenWRT est que, pour une raison qui m'échappe, il n'y a pas de persistance :

Théoriquement, OpenWRT utilise [trois partitions](https://openwrt.org/docs/techref/filesystems) : la <code>rom</code>, qui correspond à l'image flashée et est utilisée en tant que référence et utilise le filesystem [SquashFS](https://openwrt.org/docs/techref/filesystems#squashfs). L'intérêt est que cette partition ne peut pas être modifiée, et peut donc être utilisée comme backup en cas de fausse manipulation sur un fichier.

La deuxième partition est une partition standard, utilisant [Jssf2](https://openwrt.org/docs/techref/filesystems#jffs2). OpenWRT combine ces deux partitions via [OverlayFS](https://openwrt.org/docs/techref/filesystems#overlayfs) afin d'obtenir la racine, qui est donc modifiable, les modifications allant dans la deuxième partition.

La troisième partition est un [ramdisk](https://openwrt.org/docs/techref/filesystems#tmpfs), non persistent, qui sert pour les fichiers temporaires.

Le problème est qu'ici, ''nous n'avons pas la deuxième partition'' pour une raison qui m'échappe (je serais extrêmement heureux si quelqu'un pouvait trouver l'origine de ce problème sur lequel j'ai passé une semaine).

La conséquence est qu'il est impossible de configurer le routeur de manière standard, via SSH / LuCI (interface web d'administration), car les changements effectués ne persisteront pas après un reboot.

La seule solution que j'ai trouvé est d'inclure l'ensemble des fichiers de configuration dans l'image flashée, i.e. dans la rom.

'''CELA INCLUT LE SSID DU WIFI, LE MOT DE PASSE DU WIFI, ET LES IDENTIFIANTS EDUROAM'''.

Oui.

J'ai commis un crime de lèse-BRté : hardcoder des credentials dans une image compilée. J'ai honte. Je le referais. J'espère que quelqu'un va trouver une autre solution. En attendant, je n'ai pas mieux à proposer. Ô lecteur qui est sûrement en train de me juger, si tu te crois si malin, essaie donc de trouver un autre moyen de faire ceci, un moyen d'avoir un filesystem persistent. Rendez-vous dans une semaine (c'est le temps qu'il m'a fallut pour obtenir une image fonctionnelle).

==== do it ====

Les fichiers à inclure dans l'image doivent se trouver dans le dossier <code>files</code>. Il faut donc créer les dossiers nécessaires :

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

Ensuite, le fichier <code>files/etc/config/wpa.conf</code> doit avoir le contenu suivant, en remplaçant <code>PRENOM</code>, <code>NOM</code> et <code>PASSWORD</code> :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="PRENOM.NOM@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="PASSWORD"
phase1="auth=TTLS"
phase2="auth=PAP password=PASSWORD"
eapol_flags=0
}

Le fichier <code>files/etc/config/wireless</code> doit avoir le contenu suivant, en remplaçant <code>WIFINAME</code> et <code>MOT_DE_PASSE</code> :

config wifi-device 'radio_2g'
option type 'mac80211'
option path 'platform/10300000.wmac'
option channel '1'
option band '2g'
option htmode 'HT20'
option disabled '0'

config wifi-iface 'wifi_2g'
option device 'radio_2g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

config wifi-device 'radio_5g'
option type 'mac80211'
option path 'pci0000:00/0000:00:00.0/0000:01:00.0'
option channel '36'
option band '5g'
option htmode 'VHT80'
option disabled '0'

config wifi-iface 'wifi_5g'
option device 'radio_5g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME_5G'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

Cette configuration permet de générer deux réseaux wifi, un en 2.4GHz et un en 5GHz. Il est possible de désactiver l'un des deux en passant la valeur <code>'1'</code> à l'option <code>disabled</code> du <code>wifi-device</code> <code>radio_2g</code> ou <code>radio_5g</code>

Le fichier <code>files/etc/init.d/wpa</code> doit lui contenir le contenu suivant :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B
sleep 5
udhcpc -i eth0.2
}

Il ne reste plus qu'à créer un symlink permettant que la configuration <code>wpa_supplicant</code> démarre automatiquement :

cd files/etc/rc.d
ln -s -r ../init.d/wpa S99wpa

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

make -j1 V=s

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

La compilation est un procédé très long (10 heures), mais une fois qu'elle a été effectuée une fois, les compilations ultérieures réutilisent les artefacts générés et sont donc très rapides.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

{{Attention|Cette image ne doit surtout pas être diffusée car elle contient le mot de passe de l'élève}}

A la différence d'une image classique OpenWRT, celle-ci est directement fonctionnelle une fois flashée, mais ne peut pas être reconfigurée, sauf en recompilant.

Dans le cas du TP-Link ArchRant rant rant rant rant AAAAAAAAAAAAAHer C50, après avoir copié ce fichier sous le nom <code>owrt.bin</code>, on peut suivre le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]] afin d'obtenir le fichier <code>tp_recovery.bin</code> et le flasher.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]
{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

Ce guide a été écrit principalement pour le routeur Archer C50, mais il est entièrement transposable à tout modèle de routeur sur lequel OpenWRT peut être installé. Le détail de comment flasher OpenWRT dépend cependant du modèle, et n'est pas couvert par ce guide.

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

Ce guide n'est absolument pas optimal, et l'image résultante est bien moins fonctionnelle qu'une image pré-compilée officielle. Commencez par vérifier si une image n'existe pas déjà pour votre modèle, afin de vous épargner la purge qu'est ce procédé.

== Pré-requis ==

* Un ordinateur tournant sous Linux (Debian est testé et fonctionne) (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

make menuconfig

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

nano files/etc/config/wpa.conf
nano files/etc/config/wireless
nano files/etc/init.d/wpa

cd files/etc/rc.d
ln -s -r ../init.d/wpa/S99wpa

cd ../../..

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Déterminer la <code>target</code> et la <code>subtarget</code> ===

OpenWRT peut être installé sur une grande variété de routeurs, qui sont classé par <code>target</code> et <code>subtarget</code>.

Pour déterminer quelles est notre <code>target</code> et notre <code>subtarget</code>, le plus simple est de se référer à la documentation officielle d'OpenWRT pour notre modèle, disponible [https://openwrt.org/toh/start ici]. Pour le Archer C50, la page est la [https://openwrt.org/toh/tp-link/archer-c50 suivante].

Il faut ensuite aller à la section '''Downloads''', afin d'obtenir le lien de téléchargement d'OpenWRT pour ce modèle.

Cette url se présente sous la forme suivante : https://downloads.openwrt.org/releases/<code>version</code>/targets/<code>target</code>/<code>subtarget</code>/openwrt-<code>version</code>-<code>target</code>-<code>subtarget</code>-<code>modele</code>-squashfs-factory-<code>zone</code>.bin

La partie qui nous intéresse de cette URL se situe juste après le <code>/targets/</code>.

Par exemple, pour le [https://openwrt.org/toh/tp-link/archer-c50#downloads Archer C50], le lien de téléchargement est https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin

La <code>target</code> est donc <code>ramips</code> et la subtarget <code>mt7620</code>. Cette information va nous permettre de compiler OpenWRT pour notre modèle.

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Il est cependant possible de prendre comme base un fichier de configuration pré-existant.

Un fichier de configuration créé par le BR est disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici].

La commande pour le copier est donc :

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

Ce fichier correspond à une configuration pour compiler OpenWRT sur le Archer C50 v6, mais peut être adapté à tout routeur en modifiant la cible de compilation (cf. étape suivante).

=== Configuration de la <code>target</code> et <code>subtarget</code> ===

Si votre routeur est autre chose que le Archer C50 v6, il est nécessaire de changer la cible de compilation via la commande suivante :

make menuconfig

La première chose à faire est de renseigner la <code>target</code>, la <code>subtarget</code>, puis le modèle exact dans <code>Target Profile</code>.

=== Renseignement des fichiers de configuration ===

Voici la partie cursed de ce guide. Je tiens à m'excuser profondément pour les instructions qui vont suivre.

==== rant ====

Le problème de cette méthode pour compiler OpenWRT est que, pour une raison qui m'échappe, il n'y a pas de persistance :

Théoriquement, OpenWRT utilise [trois partitions](https://openwrt.org/docs/techref/filesystems) : la <code>rom</code>, qui correspond à l'image flashée et est utilisée en tant que référence et utilise le filesystem [SquashFS](https://openwrt.org/docs/techref/filesystems#squashfs). L'intérêt est que cette partition ne peut pas être modifiée, et peut donc être utilisée comme backup en cas de fausse manipulation sur un fichier.

La deuxième partition est une partition standard, utilisant [Jssf2](https://openwrt.org/docs/techref/filesystems#jffs2). OpenWRT combine ces deux partitions via [OverlayFS](https://openwrt.org/docs/techref/filesystems#overlayfs) afin d'obtenir la racine, qui est donc modifiable, les modifications allant dans la deuxième partition.

La troisième partition est un [ramdisk](https://openwrt.org/docs/techref/filesystems#tmpfs), non persistent, qui sert pour les fichiers temporaires.

Le problème est qu'ici, ''nous n'avons pas la deuxième partition'' pour une raison qui m'échappe (je serais extrêmement heureux si quelqu'un pouvait trouver l'origine de ce problème sur lequel j'ai passé une semaine).

La conséquence est qu'il est impossible de configurer le routeur de manière standard, via SSH / LuCI (interface web d'administration), car les changements effectués ne persisteront pas après un reboot.

La seule solution que j'ai trouvé est d'inclure l'ensemble des fichiers de configuration dans l'image flashée, i.e. dans la rom.

'''CELA INCLUT LE SSID DU WIFI, LE MOT DE PASSE DU WIFI, ET LES IDENTIFIANTS EDUROAM'''.

Oui.

J'ai commis un crime de lèse-BRté : hardcoder des credentials dans une image compilée. J'ai honte. Je le referais. J'espère que quelqu'un va trouver une autre solution. En attendant, je n'ai pas mieux à proposer. Ô lecteur qui est sûrement en train de me juger, si tu te crois si malin, essaie donc de trouver un autre moyen de faire ceci, un moyen d'avoir un filesystem persistent. Rendez-vous dans une semaine (c'est le temps qu'il m'a fallut pour obtenir une image fonctionnelle).

=== do it ===

Les fichiers à inclure dans l'image doivent se trouver dans le dossier <code>files</code>. Il faut donc créer les dossiers nécessaires :

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

Ensuite, le fichier <code>files/etc/config/wpa.conf</code> doit avoir le contenu suivant, en remplaçant <code>PRENOM</code>, <code>NOM</code> et <code>PASSWORD</code> :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="PRENOM.NOM@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="PASSWORD"
phase1="auth=TTLS"
phase2="auth=PAP password=PASSWORD"
eapol_flags=0
}

Le fichier <code>files/etc/config/wireless</code> doit avoir le contenu suivant, en remplaçant <code>WIFINAME</code> et <code>MOT_DE_PASSE</code> :

config wifi-device 'radio_2g'
option type 'mac80211'
option path 'platform/10300000.wmac'
option channel '1'
option band '2g'
option htmode 'HT20'
option disabled '0'

config wifi-iface 'wifi_2g'
option device 'radio_2g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

config wifi-device 'radio_5g'
option type 'mac80211'
option path 'pci0000:00/0000:00:00.0/0000:01:00.0'
option channel '36'
option band '5g'
option htmode 'VHT80'
option disabled '0'

config wifi-iface 'wifi_5g'
option device 'radio_5g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME_5G'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

Cette configuration permet de générer deux réseaux wifi, un en 2.4GHz et un en 5GHz. Il est possible de désactiver l'un des deux en passant la valeur <code>'1'</code> à l'option <code>disabled</code> du <code>wifi-device</code> <code>radio_2g</code> ou <code>radio_5g</code>

Le fichier <code>files/etc/init.d/wpa</code> doit lui contenir le contenu suivant :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B
sleep 5
udhcpc -i eth0.2
}

Il ne reste plus qu'à créer un symlink permettant que la configuration <code>wpa_supplicant</code> démarre automatiquement :

cd files/etc/rc.d
ln -s -r ../init.d/wpa S99wpa

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

make -j1 V=s

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

La compilation est un procédé très long (10 heures), mais une fois qu'elle a été effectuée une fois, les compilations ultérieures réutilisent les artefacts générés et sont donc très rapides.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

{{Attention|Cette image ne doit surtout pas être diffusée car elle contient le mot de passe de l'élève}}

A la différence d'une image classique OpenWRT, celle-ci est directement fonctionnelle une fois flashée, mais ne peut pas être reconfigurée, sauf en recompilant.

Dans le cas du TP-Link ArchRant rant rant rant rant AAAAAAAAAAAAAHer C50, après avoir copié ce fichier sous le nom <code>owrt.bin</code>, on peut suivre le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]] afin d'obtenir le fichier <code>tp_recovery.bin</code> et le flasher.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-18T19:40:28Z

Florian.chive : Cursed way to compile OpenWRT

{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

Ce guide a été écrit principalement pour le routeur Archer C50, mais il est entièrement transposable à tout modèle de routeur sur lequel OpenWRT peut être installé. Le détail de comment flasher OpenWRT dépend cependant du modèle, et n'est pas couvert par ce guide.

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

Ce guide n'est absolument pas optimal, et l'image résultante est bien moins fonctionnelle qu'une image pré-compilée officielle. Commencez par vérifier si une image n'existe pas déjà pour votre modèle, afin de vous épargner la purge qu'est ce procédé.

== Pré-requis ==

* Un ordinateur tournant sous Linux (Debian est testé et fonctionne) (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

make menuconfig

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

nano files/etc/config/wpa.conf
nano files/etc/config/wireless
nano files/etc/init.d/wpa

cd files/etc/rc.d
ln -s -r ../init.d/wpa/S99wpa

cd ../../..

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Déterminer la <code>target</code> et la <code>subtarget</code> ===

OpenWRT peut être installé sur une grande variété de routeurs, qui sont classé par <code>target</code> et <code>subtarget</code>.

Pour déterminer quelles est notre <code>target</code> et notre <code>subtarget</code>, le plus simple est de se référer à la documentation officielle d'OpenWRT pour notre modèle, disponible [https://openwrt.org/toh/start ici]. Pour le Archer C50, la page est la [https://openwrt.org/toh/tp-link/archer-c50 suivante].

Il faut ensuite aller à la section '''Downloads''', afin d'obtenir le lien de téléchargement d'OpenWRT pour ce modèle.

Cette url se présente sous la forme suivante : https://downloads.openwrt.org/releases/<code>version</code>/targets/<code>target</code>/<code>subtarget</code>/openwrt-<code>version</code>-<code>target</code>-<code>subtarget</code>-<code>modele</code>-squashfs-factory-<code>zone</code>.bin

La partie qui nous intéresse de cette URL se situe juste après le <code>/targets/</code>.

Par exemple, pour le [https://openwrt.org/toh/tp-link/archer-c50#downloads Archer C50], le lien de téléchargement est https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin

La <code>target</code> est donc <code>ramips</code> et la subtarget <code>mt7620</code>. Cette information va nous permettre de compiler OpenWRT pour notre modèle.

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Il est cependant possible de prendre comme base un fichier de configuration pré-existant.

Un fichier de configuration créé par le BR est disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici].

La commande pour le copier est donc :

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

Ce fichier correspond à une configuration pour compiler OpenWRT sur le Archer C50 v6, mais peut être adapté à tout routeur en modifiant la cible de compilation (cf. étape suivante).

=== Configuration de la <code>target</code> et <code>subtarget</code> ===

Si votre routeur est autre chose que le Archer C50 v6, il est nécessaire de changer la cible de compilation via la commande suivante :

make menuconfig

La première chose à faire est de renseigner la <code>target</code>, la <code>subtarget</code>, puis le modèle exact dans <code>Target Profile</code>.

=== Renseignement des fichiers de configuration ===

Voici la partie cursed de ce guide. Je tiens à m'excuser profondément pour les instructions qui vont suivre.

==== rant ====

Le problème de cette méthode pour compiler OpenWRT est que, pour une raison qui m'échappe, il n'y a pas de persistance :

Théoriquement, OpenWRT utilise [trois partitions](https://openwrt.org/docs/techref/filesystems) : la <code>rom</code>, qui correspond à l'image flashée et est utilisée en tant que référence et utilise le filesystem [SquashFS](https://openwrt.org/docs/techref/filesystems#squashfs). L'intérêt est que cette partition ne peut pas être modifiée, et peut donc être utilisée comme backup en cas de fausse manipulation sur un fichier.

La deuxième partition est une partition standard, utilisant [Jssf2](https://openwrt.org/docs/techref/filesystems#jffs2). OpenWRT combine ces deux partitions via [OverlayFS](https://openwrt.org/docs/techref/filesystems#overlayfs) afin d'obtenir la racine, qui est donc modifiable, les modifications allant dans la deuxième partition.

La troisième partition est un [ramdisk](https://openwrt.org/docs/techref/filesystems#tmpfs), non persistent, qui sert pour les fichiers temporaires.

Le problème est qu'ici, ''nous n'avons pas la deuxième partition'' pour une raison qui m'échappe (je serais extrêmement heureux si quelqu'un pouvait trouver l'origine de ce problème sur lequel j'ai passé une semaine).

La conséquence est qu'il est impossible de configurer le routeur de manière standard, via SSH / LuCI (interface web d'administration), car les changements effectués ne persisteront pas après un reboot.

La seule solution que j'ai trouvé est d'inclure l'ensemble des fichiers de configuration dans l'image flashée, i.e. dans la rom.

'''CELA INCLUT LE SSID DU WIFI, LE MOT DE PASSE DU WIFI, ET LES IDENTIFIANTS EDUROAM'''.

Oui.

J'ai commis un crime de lèse-BRté : hardcoder des credentials dans une image compilée. J'ai honte. Je le referais. J'espère que quelqu'un va trouver une autre solution. En attendant, je n'ai pas mieux à proposer. Ô lecteur qui est sûrement en train de me juger, si tu te crois si malin, essaie donc de trouver un autre moyen de faire ceci, un moyen d'avoir un filesystem persistent. Rendez-vous dans une semaine (c'est le temps qu'il m'a fallut pour obtenir une image fonctionnelle).

=== do it ===

Les fichiers à inclure dans l'image doivent se trouver dans le dossier <code>files</code>. Il faut donc créer les dossiers nécessaires :

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

Ensuite, le fichier <code>files/etc/config/wpa.conf</code> doit avoir le contenu suivant, en remplaçant <code>PRENOM</code>, <code>NOM</code> et <code>PASSWORD</code> :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="PRENOM.NOM@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="PASSWORD"
phase1="auth=TTLS"
phase2="auth=PAP password=PASSWORD"
eapol_flags=0
}

Le fichier <code>files/etc/config/wireless</code> doit avoir le contenu suivant, en remplaçant <code>WIFINAME</code> et <code>MOT_DE_PASSE</code> :

config wifi-device 'radio_2g'
option type 'mac80211'
option path 'platform/10300000.wmac'
option channel '1'
option band '2g'
option htmode 'HT20'
option disabled '0'

config wifi-iface 'wifi_2g'
option device 'radio_2g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

config wifi-device 'radio_5g'
option type 'mac80211'
option path 'pci0000:00/0000:00:00.0/0000:01:00.0'
option channel '36'
option band '5g'
option htmode 'VHT80'
option disabled '0'

config wifi-iface 'wifi_5g'
option device 'radio_5g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME_5G'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

Cette configuration permet de générer deux réseaux wifi, un en 2.4GHz et un en 5GHz. Il est possible de désactiver l'un des deux en passant la valeur <code>'1'</code> à l'option <code>disabled</code> du <code>wifi-device</code> <code>radio_2g</code> ou <code>radio_5g</code>

Le fichier <code>files/etc/init.d/wpa</code> doit lui contenir le contenu suivant :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B
sleep 5
udhcpc -i eth0.2
}

Il ne reste plus qu'à créer un symlink permettant que la configuration <code>wpa_supplicant</code> démarre automatiquement :

cd files/etc/rc.d
ln -s -r ../init.d/wpa S99wpa

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

make -j1 V=s

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

La compilation est un procédé très long (10 heures), mais une fois qu'elle a été effectuée une fois, les compilations ultérieures réutilisent les artefacts générés et sont donc très rapides.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

{{Attention|Cette image ne doit surtout pas être diffusée car elle contient le mot de passe de l'élève}}

A la différence d'une image classique OpenWRT, celle-ci est directement fonctionnelle une fois flashée, mais ne peut pas être reconfigurée, sauf en recompilant.

Dans le cas du TP-Link ArchRant rant rant rant rant AAAAAAAAAAAAAHer C50, après avoir copié ce fichier sous le nom <code>owrt.bin</code>, on peut suivre le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]] afin d'obtenir le fichier <code>tp_recovery.bin</code> et le flasher.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]
{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

Ce guide a été écrit principalement pour le routeur Archer C50, mais il est entièrement transposable à tout modèle de routeur sur lequel OpenWRT peut être installé. Le détail de comment flasher OpenWRT dépend cependant du modèle, et n'est pas couvert par ce guide.

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

Ce guide n'est absolument pas optimal, et l'image résultante est bien moins fonctionnelle qu'une image pré-compilée officielle. Commencez par vérifier si une image n'existe pas déjà pour votre modèle, afin de vous épargner la purge qu'est ce procédé.

== Pré-requis ==

* Un ordinateur tournant sous Linux (Debian est testé et fonctionne) (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

make menuconfig

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

nano files/etc/config/wpa.conf
nano files/etc/config/wireless
nano files/etc/init.d/wpa

cd files/etc/rc.d
ln -s -r ../init.d/wpa/S99wpa

cd ../../..

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Déterminer la <code>target</code> et la <code>subtarget</code> ===

OpenWRT peut être installé sur une grande variété de routeurs, qui sont classé par <code>target</code> et <code>subtarget</code>.

Pour déterminer quelles est notre <code>target</code> et notre <code>subtarget</code>, le plus simple est de se référer à la documentation officielle d'OpenWRT pour notre modèle, disponible [https://openwrt.org/toh/start ici]. Pour le Archer C50, la page est la [https://openwrt.org/toh/tp-link/archer-c50 suivante].

Il faut ensuite aller à la section '''Downloads''', afin d'obtenir le lien de téléchargement d'OpenWRT pour ce modèle.

Cette url se présente sous la forme suivante : https://downloads.openwrt.org/releases/<code>version</code>/targets/<code>target</code>/<code>subtarget</code>/openwrt-<code>version</code>-<code>target</code>-<code>subtarget</code>-<code>modele</code>-squashfs-factory-<code>zone</code>.bin

La partie qui nous intéresse de cette URL se situe juste après le <code>/targets/</code>.

Par exemple, pour le [https://openwrt.org/toh/tp-link/archer-c50#downloads Archer C50], le lien de téléchargement est https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin

La <code>target</code> est donc <code>ramips</code> et la subtarget <code>mt7620</code>. Cette information va nous permettre de compiler OpenWRT pour notre modèle.

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Il est cependant possible de prendre comme base un fichier de configuration pré-existant.

Un fichier de configuration créé par le BR est disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici].

La commande pour le copier est donc :

wget https://stratus.binets.fr/s/aokdzwtmBsBtHAb/download?path=%2F&files=config.buildinfo -O .config

Ce fichier correspond à une configuration pour compiler OpenWRT sur le Archer C50 v6, mais peut être adapté à tout routeur en modifiant la cible de compilation (cf. étape suivante).

=== Configuration de la <code>target</code> et <code>subtarget</code> ===

Si votre routeur est autre chose que le Archer C50 v6, il est nécessaire de changer la cible de compilation via la commande suivante :

make menuconfig

La première chose à faire est de renseigner la <code>target</code>, la <code>subtarget</code>, puis le modèle exact dans <code>Target Profile</code>.

=== Renseignement des fichiers de configuration ===

Voici la partie cursed de ce guide. Je tiens à m'excuser profondément pour les instructions qui vont suivre.

==== rant ====

Le problème de cette méthode pour compiler OpenWRT est que, pour une raison qui m'échappe, il n'y a pas de persistance :

Théoriquement, OpenWRT utilise [trois partitions](https://openwrt.org/docs/techref/filesystems) : la <code>rom</code>, qui correspond à l'image flashée et est utilisée en tant que référence et utilise le filesystem [SquashFS](https://openwrt.org/docs/techref/filesystems#squashfs). L'intérêt est que cette partition ne peut pas être modifiée, et peut donc être utilisée comme backup en cas de fausse manipulation sur un fichier.

La deuxième partition est une partition standard, utilisant [Jssf2](https://openwrt.org/docs/techref/filesystems#jffs2). OpenWRT combine ces deux partitions via [OverlayFS](https://openwrt.org/docs/techref/filesystems#overlayfs) afin d'obtenir la racine, qui est donc modifiable, les modifications allant dans la deuxième partition.

La troisième partition est un [ramdisk](https://openwrt.org/docs/techref/filesystems#tmpfs), non persistent, qui sert pour les fichiers temporaires.

Le problème est qu'ici, ''nous n'avons pas la deuxième partition'' pour une raison qui m'échappe (je serais extrêmement heureux si quelqu'un pouvait trouver l'origine de ce problème sur lequel j'ai passé une semaine).

La conséquence est qu'il est impossible de configurer le routeur de manière standard, via SSH / LuCI (interface web d'administration), car les changements effectués ne persisteront pas après un reboot.

La seule solution que j'ai trouvé est d'inclure l'ensemble des fichiers de configuration dans l'image flashée, i.e. dans la rom.

'''CELA INCLUT LE SSID DU WIFI, LE MOT DE PASSE DU WIFI, ET LES IDENTIFIANTS EDUROAM'''.

Oui.

J'ai commis un crime de lèse-BRté : hardcoder des credentials dans une image compilée. J'ai honte. Je le referais. J'espère que quelqu'un va trouver une autre solution. En attendant, je n'ai pas mieux à proposer. Ô lecteur qui est sûrement en train de me juger, si tu te crois si malin, essaie donc de trouver un autre moyen de faire ceci, un moyen d'avoir un filesystem persistent. Rendez-vous dans une semaine (c'est le temps qu'il m'a fallut pour obtenir une image fonctionnelle).

=== do it ===

Les fichiers à inclure dans l'image doivent se trouver dans le dossier <code>files</code>. Il faut donc créer les dossiers nécessaires :

mkdir files files/etc files/etc/config files/etc/init.d files/etc/rc.d

Ensuite, le fichier <code>files/etc/config/wpa.conf</code> doit avoir le contenu suivant, en remplaçant <code>PRENOM</code>, <code>NOM</code> et <code>PASSWORD</code> :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="PRENOM.NOM@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="PASSWORD"
phase1="auth=TTLS"
phase2="auth=PAP password=PASSWORD"
eapol_flags=0
}

Le fichier <code>files/etc/config/wireless</code> doit avoir le contenu suivant, en remplaçant <code>WIFINAME</code> et <code>MOT_DE_PASSE</code> :

config wifi-device 'radio_2g'
option type 'mac80211'
option path 'platform/10300000.wmac'
option channel '1'
option band '2g'
option htmode 'HT20'
option disabled '0'

config wifi-iface 'wifi_2g'
option device 'radio_2g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

config wifi-device 'radio_5g'
option type 'mac80211'
option path 'pci0000:00/0000:00:00.0/0000:01:00.0'
option channel '36'
option band '5g'
option htmode 'VHT80'
option disabled '0'

config wifi-iface 'wifi_5g'
option device 'radio_5g'
option network 'lan'
option mode 'ap'
option ssid 'WIFINAME_5G'
option encryption 'psk2'
option key 'MOT_DE_PASSE'
option country 'FR'

Cette configuration permet de générer deux réseaux wifi, un en 2.4GHz et un en 5GHz. Il est possible de désactiver l'un des deux en passant la valeur <code>'1'</code> à l'option <code>disabled</code> du <code>wifi-device</code> <code>radio_2g</code> ou <code>radio_5g</code>

Le fichier <code>files/etc/init.d/wpa</code> doit lui contenir le contenu suivant :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B
sleep 5
udhcpc -i eth0.2
}

Il ne reste plus qu'à créer un symlink permettant que la configuration <code>wpa_supplicant</code> démarre automatiquement :

cd files/etc/rc.d
ln -s -r ../init.d/wpa S99wpa

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

make -j1 V=s

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

La compilation est un procédé très long (10 heures), mais une fois qu'elle a été effectuée une fois, les compilations ultérieures réutilisent les artefacts générés et sont donc très rapides.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

{{Attention|Cette image ne doit surtout pas être diffusée car elle contient le mot de passe de l'élève}}

A la différence d'une image classique OpenWRT, celle-ci est directement fonctionnelle une fois flashée, mais ne peut pas être reconfigurée, sauf en recompilant.

Dans le cas du TP-Link ArchRant rant rant rant rant AAAAAAAAAAAAAHer C50, après avoir copié ce fichier sous le nom <code>owrt.bin</code>, on peut suivre le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]] afin d'obtenir le fichier <code>tp_recovery.bin</code> et le flasher.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-15T22:33:44Z

Florian.chive : Fix typo in code

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Il est également possible que la version d'OpenWRT disponible ne soit pas compatible avec la version du routeur (par exemple, OpenWRT pour le Archer C50 v5 ne fonctionne pas pour la v6). Dans ce cas, s'il n'existe pas d'image pré-compilée pour le routeur, il faut [[Compiler OpenWRT]].

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf &
}

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Trucs et astuces

2024-01-14T11:00:38Z

Florian.chive : Fix header level

{{Menu tutoriels}}
[[Catégorie:Tutoriels]]

Le saviez-vous ? Il est possible de stocker tous ses mots de passe de manière sécurisée, de regarder youtube sans les pubs, d'utiliser l'intelligence artificielle pour faire les TD d'info (sous réserve de quelques modifications) !

Ci-dessous, les trucs et astuces du BR pour avoir une vie numérique un peu plus confortable.

== Extensions de navigateur recommandées ==
Les extensions de navigateur, ça change la vie. Ci-dessous sont énumérées quelques extensions populaires qui rendent la navigation plus agréable.

'''Note:''' Si vous utilisez Firefox, vous disposerez aussi des extensions sur mobile ! Ce n'est pas le cas de Chrome, qui pourrait bien interdire les adblockers dans le futur.

=== uBlock Origin ===

[https://ublockorigin.com/ ublock Origin] est un Ad Blocker open source très efficace. Il retire l'intégralité des pubs des sites web et de youtube, et n'est pas vendu aux publicitaires.

=== Bitwarden ===

[https://bitwarden.com/download/ Bitwarden] est un gestionnaire de mot de passe open-source hébergé dans le cloud et disponible sur navigateur, mobile et desktop. Il permet de générer des mots de passe aléatoires customisés, d'avoir de l'autocomplétion sur vos sites préférés, etc. Ça vaut toujours mieux que les gestionnaires intégrés de Chrome ou Firefox, ou même que d'autres gestionnaires de mots passe propriétaires.

=== Return Youtube Dislike ===

[https://www.returnyoutubedislike.com/ Return Youtube Dislike] est une extension toute simple qui fait revenir l'affichage des dislikes sur le site de [https://www.youtube.com/ Youtube].

=== Dark Reader ===

[https://darkreader.org/ Dark Reader] est une extension qui permet d'avoir un mode sombre sur votre navigateur. Il fonctionne très bien pour la plupart des sites, et peut-être configuré pour afficher un mode sombre par défaut, ou bien seulement pour les sites que vous choisissez.

== L'appli Youtube sans pubs ==

Si vous voulez utiliser une version modifiée du client officiel, continuez votre lecture. Si vous préférez utiliser un client open source, sachez qu'il existe Newpipe qui permet également de bloquer les publicités et de télécharger les vidéos (voir [[#Applications open source sur Android]]).

'''Youtube Revanced''' est un patch open source (seul le patch est open source, pas l'application) non officiel de l'application Youtube, qui intègre de nombreuses fonctionnalités additionnelles. Elle n'est actuellement disponible que pour Android, car Apple n'autorise pas l'installation d'applications ne figurant pas sur l'Apple Store (tandis qu'Android, si). On y trouve notamment :

* Blocage des pubs et sponsorisations (configurable)
* Retour de l'affichage des dislikes
* Lecture en arrière plan
* Téléchargement de vidéos
* Contrôle du son et de la luminosité avec des swipe gestures, etc.

Le [https://revanced.app site officiel], et un [https://www.reddit.com/r/revancedapp/comments/xlcny9/revanced_manager_guide_for_dummies/ guide pour l'installation].

'''Remarque:''' même après avoir téléchargé l'application, les liens vers youtube seront toujours ouverts avec l'application youtube. Pour y remédier, il faut désactiver l'appli youtube, puis associer l'application Revanced avec les liens youtube. Cette option est disponible dans l'application '''Settings''' -> '''Applications''' -> '''Applications par défaut''' -> '''Ouverture des liens''' -> '''ReVanced''' -> '''Adr. Web prises en charge''', puis cocher les 4 adresses (testé sur téléphone Samsung).

'''Mise à jour:''' pour mettre à jour l'application (nécessaire pour résoudre les bugs susceptibles d'apparaître), il faut télécharger à nouveau l'apk la plus récente. Elle mettra automatiquement à jour l'application.

== Github Copilot ==

[https://github.com/features/copilot Github Copilot] est un outil d'intelligence artificielle utile pour accélérer le développement informatique. Il est disponible dans la plupart des IDE. En temps normal, son utilisation se paye 10$/mois, ou 100$/an, mais elle est gratuite pour les étudiants !

Pour accéder gratuitement à Github Copilot, il suffit de:
* Disposer d'un compte Github
* S'inscrire comme étudiant sur [https://education.github.com/discount_requests/application education.github.com] en ajoutant son adresse en ''polytechnique.edu'' comme preuve.
* Une fois la vérification faite, configurer l'accès à Copilot depuis les [https://github.com/settings/copilot settings] de votre compte Github.

Et voilà ! Il n'y a plus qu'à installer l'extension '''Github Copilot''' dans l'IDE de votre choix, puis d'authentifier votre compte Github, et vous êtes prêts à coder !

== Applications open source sur Android ==

Sur Android, il existe un magasin d'applications qui ne contient que des logiciels libres : F-droid. Le client officiel est daté et pose des problèmes de sécurité. On vous conseille donc d'installer un client plus récent : [https://f-droid.org/en/packages/com.looker.droidify/ Droid-ify] (bouton ''DOWNLOAD F-DROID'') (disponible uniquement sur Android, évidemment).

Cette application est un ''Google Play'' pour applications libres et open source. Pour pouvoir l'utiliser, il faudra d'abord l'autoriser comme application de téléchargement d'autres applications (à l'ouverture).

On vous recommande notamment l'application '''NewPipe''', un client Youtube libre n'utilisant pas l'API de Google qui enlève les publicités et qui permet de télécharger des vidéos et d'écouter des vidéos en arrière plan.

== Gestionnaires de versions pour coder ==

Selon les projets d'informatique que vous réalisez, vous aurez probablement besoin d'utiliser des versions de python ou node différentes (node16 pour Sigma, python3.7 pour les sites binets python hébergés par le BR).

C'est notamment une très bonne pratique pour faciliter le déploiement d'applications python que d'utiliser un environnement virtuel pour son projet, avec un liste de dépendances requirements.txt à la racine du projet. On vous explique comment configurer et utiliser tout ça.

=== Python ===

Pour le développement d'applis python, sites, etc : voir [[Trucs_et_astuces#Environnements_virtuels_python_avec_Pyenv| Pyenv]].

Pour le développement de scripts scientifiques en python, avec utilisation de notebooks jupyter et shell IPython, etc : voir [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]].

==== Environnements virtuels python avec Pyenv ====

===== Installation =====

[https://github.com/pyenv/pyenv Pyenv] est un gestionnaire de versions Python qui permet de changer rapidement de version '''sans toucher à la version python utilisée par le système'''. Les versions sont installées dans <code>/home/<username>/.pyenv/versions/</code> sous Linux, et <code>C:\Users\<username>\.pyenv\versions\</code> sous Windows.

[https://github.com/pyenv-win/pyenv-win Installer pyenv sur Windows]

[https://github.com/pyenv/pyenv Installer pyenv sur Linux] (ou via votre gestionnaire de paquets).

===== Installer des versions de python =====

Pour lister les versions de python disponibles :
pyenv install --list

Pour lister des versions spécifiques :
pyenv install --list | grep 3.11 # Sur Linux
pyenv install --list | findstr 3.11 # Sur Windows

Pour installer une version :
pyenv install -v 3.11.3 # Remplacer par le nom complet de la version désirée

Pour lister les versions disponibles via pyenv :
pyenv versions

===== Générer un environnement virtuel =====

Pour générer un environnement virtuel python à la racine d'un projet :
Activer une version de python dans le shell:
pyenv shell 3.11.3 # Utiliser cette version temporairement, dans ce shell
pyenv local 3.11.3 # Toujours utiliser cette version dans ce dossier
pyenv global 3.11.3 # Toujours utiliser cette version, partout

Créer un environnement virtuel dans un dossier <code>venv/</code> :
python -m venv venv

Activer l'environnement virtuel :
source venv/bin/activate # Sous Linux
.\venv\Scripts\activate # Sous Windows

Vous avez à présent un environnement virtuel python à la racine de votre projet, qu'il vous suffira d'activer à chaque fois que vous lancez votre projet. '''Note :''' VSCode réalise cette activation tout seul si vous lui dites d'utiliser l'environnement virtuel pour votre projet.

'''Remarque :''' si votre projet est versionné avec ''Git'', il ne faut pas commit votre venv! Ajoutez un fichier <code>.gitignore</code> à la racine de votre projet, et ajoutez une ligne <code>venv</code> dedans.

Vous pouvez à présent installer des packages (après avoir activé l'environnement virtuel !)
pip install <packages>
pip install -r requirements.txt # Si vous récupérez un projet avec des dépendances existantes

Pour générer un fichier <code>requirements.txt</code> afin de faciliter la mise en place pour vos collègues / pour le déploiement de votre app sur les serveurs du BR :
pip freeze > requirements.txt

===== Environnement virtuel global =====

Pyenv permet aussi de générer des environnements virtuels globaux avec <code>pyenv virtualenv</code>, un plugin que vous pouvez installer [https://github.com/pyenv/pyenv-virtualenv ici]. C'est similaire au fonctionnement de [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]].

Créez un environnement virtuel global avec la commande suivante :
pyenv virtualenv <version> <nom de votre environnement global custom>

Vous pouvez ensuite l'activer comme les autres environnements avec
pyenv shell <nom de votre environnement global custom>

==== Environnements python avec Mamba ====

Vous connaissez peut-être déjà [https://docs.conda.io/en/latest/ Conda], un gestionnaire de paquets et d'environnements python principalement utilisé pour des projets scientifiques. [https://github.com/mamba-org/mamba Mamba] en est une version entièrement réécrite en C++, bien plus rapide et performante.

Installation [https://mamba.readthedocs.io/en/latest/installation.html ici].

Mamba permet de créer des environnements virtuels dans <code>/home/<username>/mambaforge-pypy3/envs</code> (sous Linux, par exemple) qui seront réutilisables dans tous vos projets !

Créer un environnement virtuel :
mamba create -n nom_de_lenvironnement <liste de packages>
mamba create -n nom_de_lenvironnement <liste de packages> python=3.10 # Avec une version spécifique de python

Exemple :
mamba create -n inf442 numpy pandas scikit-learn

Activation d'un environnement virtuel :
mamba activate inf442
mamba deactivate # Pour le désactiver

Installation de paquets : après avoir activé votre environnement mamba, utilisez la commande <code>mamba install</code> au lieu de <code>pip install</code>, et le tout est joué.

==== Environnements python avec poetry ====

[https://python-poetry.org/ poetry] est un autre gestionnaire de dépendance extrêmement utile si vous développez en collaboratif notamment avec [[Git]]. Là où [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]] permet de réutiliser ses environnements, la logique de '''poetry''' est d'utiliser un environnement par projet.

L'intérêt est que '''poetry''' produit un fichier '''poetry.lock''' permettant de reproduire à l'identique l'environnement virtuel sur une autre machine en une commande, tout en gardant la possibilité d'effectuer des mises à jour des dépendances aisément.

Installation [https://python-poetry.org/docs/#installation ici]

Les principales commandes de '''poetry''' sont :

Création d'un environnement poetry :
poetry init

Cette commande permet d'initialiser '''poetry''' dans le dossier courant de manière interactive, en définissant le nom du projet, les auteurs et les dépendances.

Cette commande génère les fichiers <code>pyproject.toml</code>, qui contient toutes les informations du projet, et <code>poetry.lock</code>, qui contient l'état exact du projet (l'équivalent de <code>pip freeze</code>). Il est fortement recommandé de traquer ces fichiers avec [[Git]] si votre projet utilise [[Git]].

Installation d'un environnement '''poetry''' :
poetry install

Cette commande permet d'installer un environnement sur la base d'un fichier <code>poetry.lock</code> (typiquement suite à un <code>git clone</code>)

Ajout de dépendances :
poetry add <name>

Cette commande ajoute et installe la dépendance. La gestion des dépendances de poetry respecte [https://semver.org/ semver], c'est-à-dire qu'un projet peut indiquer être compatible avec toute version ultérieure de la dépendance ayant la même version majeure (c'est le cas par défaut). Cela est indiqué en ajoutant <code>^</code> à la version requise, par exemple <code>python = "^3.8"</code> (i.e. cela indique que le projet est compatible avec Python 3.8, 3.9, 3.10... mais pas 4.0)

Mettre à jour les dépendances :
poetry update

Lancer une commande dans l'environnement :
poetry run <commande>

Par exemple :
poetry run python mon_projet.py

Activer l'environnement :
poetry shell

Cette commande génère un shell dans l'environnement

Ces commandes sont détaillées en détail [https://python-poetry.org/docs/basic-usage/ ici]

=== Plusieurs versions de Node.js avec NVM ===

Si vous faites du développement web avec du Typescript/Javascript sans utiliser de conteneurs docker, vous avez besoin d'installer [https://nodejs.org/en/about Node.js], un runtime javascript. Selon votre système d'exploitation, il est possible que la version de node installée par défaut ne corresponde pas à celle attendue par votre projet (sous Linux, en particulier).

Le gestionnaire de versions Node [https://github.com/nvm-sh/nvm NVM] permet d'installer et switcher rapidement entre plusieurs versions de Node.

Installer une version :
nvm install <version>
nvm install 16 # Pour Sigma, par exemple

Utiliser une version :
nvm ls # Lister les versions
nvm use <version> # Utiliser une version
node -v # Vérifier que la version est bien utilisée

Pour utiliser à nouveau la version système dans votre shell :
nvm use system

== Utiliser Windows Subsystem for Linux pour faire du C++ ==

L'environnement de Windows est peu optimisé pour faire du C++. Le C++ est un langage qui, contrairement à python, javascript, Go, Rust... n'a pas de '''gestionnaire de paquets'''. Il est donc incroyablement difficile d'installer et utiliser des librairies supplémentaires sur un système d'exploitation qui n'est pas fait pour ça (Windows) ! Ce problème ne se pose pas sous Linux, dont le système de fichiers et les gestionnaires de paquets intégrés fonctionnent très bien avec ce langage.

Heureusement, Windows dispose d'un système de machines virtuelles légères pour utiliser Linux dans un terminal. Voici un guide pour la mise en place de WSL sur une machine Windows.
''Note: le script fourni dans le guide a été conçu pour mettre en place l'environnement c++ pour inf442. Si vous ne suivez pas ce cours, il vous suffit juste d'installer les outils de développement c++ avec la commande <code>apt-get install -y build-essential</code>''

Le [https://stratus.binets.fr/s/pFkqwMAqTaLK9QY guide].

Le [https://stratus.binets.fr/s/545XG3sGP3bHHqE script].

''Guide réalisé par Thibaut de Saivre, VPrez BR21. Contactez-moi si vous avez un problème avec ce setup''

Trucs et astuces

2024-01-14T11:00:05Z

Florian.chive : Documentation de poetry

{{Menu tutoriels}}
[[Catégorie:Tutoriels]]

Le saviez-vous ? Il est possible de stocker tous ses mots de passe de manière sécurisée, de regarder youtube sans les pubs, d'utiliser l'intelligence artificielle pour faire les TD d'info (sous réserve de quelques modifications) !

Ci-dessous, les trucs et astuces du BR pour avoir une vie numérique un peu plus confortable.

== Extensions de navigateur recommandées ==
Les extensions de navigateur, ça change la vie. Ci-dessous sont énumérées quelques extensions populaires qui rendent la navigation plus agréable.

'''Note:''' Si vous utilisez Firefox, vous disposerez aussi des extensions sur mobile ! Ce n'est pas le cas de Chrome, qui pourrait bien interdire les adblockers dans le futur.

=== uBlock Origin ===

[https://ublockorigin.com/ ublock Origin] est un Ad Blocker open source très efficace. Il retire l'intégralité des pubs des sites web et de youtube, et n'est pas vendu aux publicitaires.

=== Bitwarden ===

[https://bitwarden.com/download/ Bitwarden] est un gestionnaire de mot de passe open-source hébergé dans le cloud et disponible sur navigateur, mobile et desktop. Il permet de générer des mots de passe aléatoires customisés, d'avoir de l'autocomplétion sur vos sites préférés, etc. Ça vaut toujours mieux que les gestionnaires intégrés de Chrome ou Firefox, ou même que d'autres gestionnaires de mots passe propriétaires.

=== Return Youtube Dislike ===

[https://www.returnyoutubedislike.com/ Return Youtube Dislike] est une extension toute simple qui fait revenir l'affichage des dislikes sur le site de [https://www.youtube.com/ Youtube].

=== Dark Reader ===

[https://darkreader.org/ Dark Reader] est une extension qui permet d'avoir un mode sombre sur votre navigateur. Il fonctionne très bien pour la plupart des sites, et peut-être configuré pour afficher un mode sombre par défaut, ou bien seulement pour les sites que vous choisissez.

== L'appli Youtube sans pubs ==

Si vous voulez utiliser une version modifiée du client officiel, continuez votre lecture. Si vous préférez utiliser un client open source, sachez qu'il existe Newpipe qui permet également de bloquer les publicités et de télécharger les vidéos (voir [[#Applications open source sur Android]]).

'''Youtube Revanced''' est un patch open source (seul le patch est open source, pas l'application) non officiel de l'application Youtube, qui intègre de nombreuses fonctionnalités additionnelles. Elle n'est actuellement disponible que pour Android, car Apple n'autorise pas l'installation d'applications ne figurant pas sur l'Apple Store (tandis qu'Android, si). On y trouve notamment :

* Blocage des pubs et sponsorisations (configurable)
* Retour de l'affichage des dislikes
* Lecture en arrière plan
* Téléchargement de vidéos
* Contrôle du son et de la luminosité avec des swipe gestures, etc.

Le [https://revanced.app site officiel], et un [https://www.reddit.com/r/revancedapp/comments/xlcny9/revanced_manager_guide_for_dummies/ guide pour l'installation].

'''Remarque:''' même après avoir téléchargé l'application, les liens vers youtube seront toujours ouverts avec l'application youtube. Pour y remédier, il faut désactiver l'appli youtube, puis associer l'application Revanced avec les liens youtube. Cette option est disponible dans l'application '''Settings''' -> '''Applications''' -> '''Applications par défaut''' -> '''Ouverture des liens''' -> '''ReVanced''' -> '''Adr. Web prises en charge''', puis cocher les 4 adresses (testé sur téléphone Samsung).

'''Mise à jour:''' pour mettre à jour l'application (nécessaire pour résoudre les bugs susceptibles d'apparaître), il faut télécharger à nouveau l'apk la plus récente. Elle mettra automatiquement à jour l'application.

== Github Copilot ==

[https://github.com/features/copilot Github Copilot] est un outil d'intelligence artificielle utile pour accélérer le développement informatique. Il est disponible dans la plupart des IDE. En temps normal, son utilisation se paye 10$/mois, ou 100$/an, mais elle est gratuite pour les étudiants !

Pour accéder gratuitement à Github Copilot, il suffit de:
* Disposer d'un compte Github
* S'inscrire comme étudiant sur [https://education.github.com/discount_requests/application education.github.com] en ajoutant son adresse en ''polytechnique.edu'' comme preuve.
* Une fois la vérification faite, configurer l'accès à Copilot depuis les [https://github.com/settings/copilot settings] de votre compte Github.

Et voilà ! Il n'y a plus qu'à installer l'extension '''Github Copilot''' dans l'IDE de votre choix, puis d'authentifier votre compte Github, et vous êtes prêts à coder !

== Applications open source sur Android ==

Sur Android, il existe un magasin d'applications qui ne contient que des logiciels libres : F-droid. Le client officiel est daté et pose des problèmes de sécurité. On vous conseille donc d'installer un client plus récent : [https://f-droid.org/en/packages/com.looker.droidify/ Droid-ify] (bouton ''DOWNLOAD F-DROID'') (disponible uniquement sur Android, évidemment).

Cette application est un ''Google Play'' pour applications libres et open source. Pour pouvoir l'utiliser, il faudra d'abord l'autoriser comme application de téléchargement d'autres applications (à l'ouverture).

On vous recommande notamment l'application '''NewPipe''', un client Youtube libre n'utilisant pas l'API de Google qui enlève les publicités et qui permet de télécharger des vidéos et d'écouter des vidéos en arrière plan.

== Gestionnaires de versions pour coder ==

Selon les projets d'informatique que vous réalisez, vous aurez probablement besoin d'utiliser des versions de python ou node différentes (node16 pour Sigma, python3.7 pour les sites binets python hébergés par le BR).

C'est notamment une très bonne pratique pour faciliter le déploiement d'applications python que d'utiliser un environnement virtuel pour son projet, avec un liste de dépendances requirements.txt à la racine du projet. On vous explique comment configurer et utiliser tout ça.

=== Python ===

Pour le développement d'applis python, sites, etc : voir [[Trucs_et_astuces#Environnements_virtuels_python_avec_Pyenv| Pyenv]].

Pour le développement de scripts scientifiques en python, avec utilisation de notebooks jupyter et shell IPython, etc : voir [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]].

==== Environnements virtuels python avec Pyenv ====

===== Installation =====

[https://github.com/pyenv/pyenv Pyenv] est un gestionnaire de versions Python qui permet de changer rapidement de version '''sans toucher à la version python utilisée par le système'''. Les versions sont installées dans <code>/home/<username>/.pyenv/versions/</code> sous Linux, et <code>C:\Users\<username>\.pyenv\versions\</code> sous Windows.

[https://github.com/pyenv-win/pyenv-win Installer pyenv sur Windows]

[https://github.com/pyenv/pyenv Installer pyenv sur Linux] (ou via votre gestionnaire de paquets).

===== Installer des versions de python =====

Pour lister les versions de python disponibles :
pyenv install --list

Pour lister des versions spécifiques :
pyenv install --list | grep 3.11 # Sur Linux
pyenv install --list | findstr 3.11 # Sur Windows

Pour installer une version :
pyenv install -v 3.11.3 # Remplacer par le nom complet de la version désirée

Pour lister les versions disponibles via pyenv :
pyenv versions

===== Générer un environnement virtuel =====

Pour générer un environnement virtuel python à la racine d'un projet :
Activer une version de python dans le shell:
pyenv shell 3.11.3 # Utiliser cette version temporairement, dans ce shell
pyenv local 3.11.3 # Toujours utiliser cette version dans ce dossier
pyenv global 3.11.3 # Toujours utiliser cette version, partout

Créer un environnement virtuel dans un dossier <code>venv/</code> :
python -m venv venv

Activer l'environnement virtuel :
source venv/bin/activate # Sous Linux
.\venv\Scripts\activate # Sous Windows

Vous avez à présent un environnement virtuel python à la racine de votre projet, qu'il vous suffira d'activer à chaque fois que vous lancez votre projet. '''Note :''' VSCode réalise cette activation tout seul si vous lui dites d'utiliser l'environnement virtuel pour votre projet.

'''Remarque :''' si votre projet est versionné avec ''Git'', il ne faut pas commit votre venv! Ajoutez un fichier <code>.gitignore</code> à la racine de votre projet, et ajoutez une ligne <code>venv</code> dedans.

Vous pouvez à présent installer des packages (après avoir activé l'environnement virtuel !)
pip install <packages>
pip install -r requirements.txt # Si vous récupérez un projet avec des dépendances existantes

Pour générer un fichier <code>requirements.txt</code> afin de faciliter la mise en place pour vos collègues / pour le déploiement de votre app sur les serveurs du BR :
pip freeze > requirements.txt

===== Environnement virtuel global =====

Pyenv permet aussi de générer des environnements virtuels globaux avec <code>pyenv virtualenv</code>, un plugin que vous pouvez installer [https://github.com/pyenv/pyenv-virtualenv ici]. C'est similaire au fonctionnement de [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]].

Créez un environnement virtuel global avec la commande suivante :
pyenv virtualenv <version> <nom de votre environnement global custom>

Vous pouvez ensuite l'activer comme les autres environnements avec
pyenv shell <nom de votre environnement global custom>

==== Environnements python avec Mamba ====

Vous connaissez peut-être déjà [https://docs.conda.io/en/latest/ Conda], un gestionnaire de paquets et d'environnements python principalement utilisé pour des projets scientifiques. [https://github.com/mamba-org/mamba Mamba] en est une version entièrement réécrite en C++, bien plus rapide et performante.

Installation [https://mamba.readthedocs.io/en/latest/installation.html ici].

Mamba permet de créer des environnements virtuels dans <code>/home/<username>/mambaforge-pypy3/envs</code> (sous Linux, par exemple) qui seront réutilisables dans tous vos projets !

Créer un environnement virtuel :
mamba create -n nom_de_lenvironnement <liste de packages>
mamba create -n nom_de_lenvironnement <liste de packages> python=3.10 # Avec une version spécifique de python

Exemple :
mamba create -n inf442 numpy pandas scikit-learn

Activation d'un environnement virtuel :
mamba activate inf442
mamba deactivate # Pour le désactiver

Installation de paquets : après avoir activé votre environnement mamba, utilisez la commande <code>mamba install</code> au lieu de <code>pip install</code>, et le tout est joué.

=== Environnements python avec poetry ===

[https://python-poetry.org/ poetry] est un autre gestionnaire de dépendance extrêmement utile si vous développez en collaboratif notamment avec [[Git]]. Là où [[Trucs_et_astuces#Environnements_python_avec_Mamba|Mamba]] permet de réutiliser ses environnements, la logique de '''poetry''' est d'utiliser un environnement par projet.

L'intérêt est que '''poetry''' produit un fichier '''poetry.lock''' permettant de reproduire à l'identique l'environnement virtuel sur une autre machine en une commande, tout en gardant la possibilité d'effectuer des mises à jour des dépendances aisément.

Installation [https://python-poetry.org/docs/#installation ici]

Les principales commandes de '''poetry''' sont :

Création d'un environnement poetry :
poetry init

Cette commande permet d'initialiser '''poetry''' dans le dossier courant de manière interactive, en définissant le nom du projet, les auteurs et les dépendances.

Cette commande génère les fichiers <code>pyproject.toml</code>, qui contient toutes les informations du projet, et <code>poetry.lock</code>, qui contient l'état exact du projet (l'équivalent de <code>pip freeze</code>). Il est fortement recommandé de traquer ces fichiers avec [[Git]] si votre projet utilise [[Git]].

Installation d'un environnement '''poetry''' :
poetry install

Cette commande permet d'installer un environnement sur la base d'un fichier <code>poetry.lock</code> (typiquement suite à un <code>git clone</code>)

Ajout de dépendances :
poetry add <name>

Cette commande ajoute et installe la dépendance. La gestion des dépendances de poetry respecte [https://semver.org/ semver], c'est-à-dire qu'un projet peut indiquer être compatible avec toute version ultérieure de la dépendance ayant la même version majeure (c'est le cas par défaut). Cela est indiqué en ajoutant <code>^</code> à la version requise, par exemple <code>python = "^3.8"</code> (i.e. cela indique que le projet est compatible avec Python 3.8, 3.9, 3.10... mais pas 4.0)

Mettre à jour les dépendances :
poetry update

Lancer une commande dans l'environnement :
poetry run <commande>

Par exemple :
poetry run python mon_projet.py

Activer l'environnement :
poetry shell

Cette commande génère un shell dans l'environnement

Ces commandes sont détaillées en détail [https://python-poetry.org/docs/basic-usage/ ici]

=== Plusieurs versions de Node.js avec NVM ===

Si vous faites du développement web avec du Typescript/Javascript sans utiliser de conteneurs docker, vous avez besoin d'installer [https://nodejs.org/en/about Node.js], un runtime javascript. Selon votre système d'exploitation, il est possible que la version de node installée par défaut ne corresponde pas à celle attendue par votre projet (sous Linux, en particulier).

Le gestionnaire de versions Node [https://github.com/nvm-sh/nvm NVM] permet d'installer et switcher rapidement entre plusieurs versions de Node.

Installer une version :
nvm install <version>
nvm install 16 # Pour Sigma, par exemple

Utiliser une version :
nvm ls # Lister les versions
nvm use <version> # Utiliser une version
node -v # Vérifier que la version est bien utilisée

Pour utiliser à nouveau la version système dans votre shell :
nvm use system

== Utiliser Windows Subsystem for Linux pour faire du C++ ==

L'environnement de Windows est peu optimisé pour faire du C++. Le C++ est un langage qui, contrairement à python, javascript, Go, Rust... n'a pas de '''gestionnaire de paquets'''. Il est donc incroyablement difficile d'installer et utiliser des librairies supplémentaires sur un système d'exploitation qui n'est pas fait pour ça (Windows) ! Ce problème ne se pose pas sous Linux, dont le système de fichiers et les gestionnaires de paquets intégrés fonctionnent très bien avec ce langage.

Heureusement, Windows dispose d'un système de machines virtuelles légères pour utiliser Linux dans un terminal. Voici un guide pour la mise en place de WSL sur une machine Windows.
''Note: le script fourni dans le guide a été conçu pour mettre en place l'environnement c++ pour inf442. Si vous ne suivez pas ce cours, il vous suffit juste d'installer les outils de développement c++ avec la commande <code>apt-get install -y build-essential</code>''

Le [https://stratus.binets.fr/s/pFkqwMAqTaLK9QY guide].

Le [https://stratus.binets.fr/s/545XG3sGP3bHHqE script].

''Guide réalisé par Thibaut de Saivre, VPrez BR21. Contactez-moi si vous avez un problème avec ce setup''

Catégorie:IRC

2024-01-14T10:27:42Z

Florian.chive : Création de page manquante

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-14T10:25:34Z

Florian.chive : Ajout des catégories tutoriels et Wifi

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-14T10:25:06Z

Florian.chive : Ajout de la catégorie Wifi

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Il est également possible que la version d'OpenWRT disponible ne soit pas compatible avec la version du routeur (par exemple, OpenWRT pour le Archer C50 v5 ne fonctionne pas pour la v6). Dans ce cas, s'il n'existe pas d'image pré-compilée pour le routeur, il faut [[Compiler OpenWRT]].

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() { echo start wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf & }

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Routeurs Wi-Fi

2024-01-14T10:24:44Z

Florian.chive : Ajout de la catégorie Wifi

{{Menu tutoriels}}

Cette page a pour vocation d'aider les propriétaires d'un routeur paramétré par le BR. Elle recense différents conseils et méthodes pour personnaliser son routeur et résoudre les éventuels problèmes rencontrés. Si vous désirez configurer votre routeur de A à Z, des tutoriels sont disponibles sur les pages suivantes :
* [[Routeurs Wi-Fi/Tutoriel]] qui explique en particulier le cas d'anciens modèles avec peu de mémoire
* [[Routeurs Wi-Fi/Tutoriel TP-Link Archer C50]] qui explique en particulier le cas de modèles plus récents mais qui risquent d'être briqués si on fournit directement l'image d'OpenWRT depuis l'interface GUI, d'où l'utilisation du protocole TFTP qui y est détaillée

== Configuration initiale ==
Une suggestion de Rémi Grzeczkowicz : [https://amzn.eu/d/0mpDzCh Cudy WR1300 Gigabit Routeur Wi-FI Dual Band AC1200 sans Fil 5 Ports Gigabit, 4 antennes, 2,4 GHz/5 GHz, Mode d’accès Point, 128 Mo RAM, OpenWrt, VPN]

=== Flasher Openwrt ===

Les firmwares disponibles pour les différents hardwares sont listés [https://openwrt.org/toh/views/toh_fwdownload ici].

Cependant, pour certains routeurs comme le Cudy WR1300 v3 vendu sur amazon il n’existe pas de firmware compatible pour l’instant (seulement les anciennes v1 et v2 sont supportées). CEPENDANT : Cudy propose une version d’Openwrt compatible [http://www.cudytech.com/openwrt_software_download ici].

Pour Cudy, l’adresse à laquelle se connecter est http://192.168.10.1/ ou http://cudy.net/ (cf manuel). Après avoir flashé Openwrt, l’adresse est http://192.168.1.1

Il est également possible de [[Compiler OpenWRT]], même s'il est préférable de trouver une version pré-compilée.

=== Setup ===

La configuration suivante permet de se connecter en tant que client au réseau ethernet 802.1x de l’école avec le routeur, qui servira ensuite de point d’accès.

==== Packages requis ====

Il faut installer les packages suivants (via l’interface web, ou <code>opkg update</code> puis <code>opkg install xxx</code>). Pour installer wpa_supplicant, il faudra d’abord désinstaller <code>wpad-wolfssl</code> (se fait facilement via l’interface web).

* <code>nano</code> (dépendances: <code>terminfo</code>, <code>libncurses6</code>)
* <code>wpa-supplicant-openssl</code> (dépendance: <code>hostapd-common</code>) (prendre la version openssl ! Depuis août 2023, wpa_supplicant de base ne fonctionne plus…)
* <code>dhcpcd</code>

NB : il est possible que la configuration de réseau retourne une erreur d’authentification. Dans ce cas, il faut utiliser le package wpa_supplicant_openssl.

Si vous ne disposez pas d’une connexion filaire sans protection pour installer ces packages directement depuis le routeur, il est possible de télécharger les fichiers <code>.ipk</code> afin de les upload depuis l’interface web (system -> software) à l’adresse suivante:

https://downloads.openwrt.org/releases/<openwrt_version>/packages

Il faudra d’abord connaître l’architecture du routeur pour aller sur la page des bons packages. <code>cat /proc/cpuinfo</code> (ligne cpu model).

Dans le cas du routeur Cudy WR1300 v3 on obtient <code>MIPS 1004Kc V2.15</code>, ce qui correspond à <code>mipsel_24kc</code> à l’url précédente ''(testé en regardant l’url de téléchargement des packages à partir d’un point d’accès sans fil mobile)''.

''Note : quand un grand nombre de packages sont disponibles, choisir le package <code><nom_du_package>_<date></code> plutôt que <code><nom_du_package>-basic</code> ou autres.''

==== Configuration client ====

Suivre les instructions de https://portail.polytechnique.edu/dsi/acces-internet/logements/ethernet-8021x-sur-linux, section '''En ligne de commande''' ''pour utilisateurs expérimentés''.

Quelques remarques: * L’interface ethernet est '''wan''' et non '''eth0''' (même si cette interface existe bien). * Pour obtenir une adresse ip : utiliser <code>udhcpc -i wan</code> et non <code>dhcpcd wan</code>.

Tester si la connexion fonctionne bien (ping, nslookup…)

==== Configuration au démarrage ====

Pour que votre routeur se connecte automatiquement au démarrage, il suffit d’aller dans l’interface graphique System > Startup > Local startup ou en ligne de commande dans le fichier <code>/etc/rc.local</code> et d’entrer les commande :

<syntaxhighlight lang="bash" line>
service network restart
sleep 1
wpa_supplicant -c /etc/wpa_supplicant/polytechnique.conf -D wired -i NOM_DE_L'INTERFACE -B
sleep 3
udhcpc -i NOM_DE_L'INTERFACE

exit 0 # Cette ligne est déjà dans le fichier
</syntaxhighlight>

Remarque : * Si vous avez mis votre fichier .conf dans un autre chemin, pensez à corriger le chemin. * NOM_DE_L’INTERFACE est wan pour le routeur cudy v3, pour les routeurs openwrt, c'est parfois (peut être souvent) eth0.2.

==== Configuration point d’accès ====

À partir de maintenant, le routeur devrait déjà fonctionner en tant que point d’accès filaire (ethernet).

Setup du wifi depuis l’interface web:

Network -> Wireless Éditer l’une des deux interfaces marquées ''Wireless is disabled.''

[[File:Interface_wifi_routeur.png]]

Sous '''Interface configuration''' : * Dans <code>General setup</code>, mettre un ESSID (nom du point d’accès) custom. Vous pouvez définir le point d’accès comme caché ou non selon votre envie de crâner. * Dans <code>Wireless security</code> : choisir l’encryption ''WPA2-PSK (strong encryption)'' et mettre un mot de passe pour le point d’accès dans ''Key''.

Enfin, il faut '''Save & Apply''' les modifications, puis '''enable''' l’interface qui vient d’être configurée. Le point d’accès wifi est configuré !

=== Probl ===

J’ai rencontré quelques problèmes par la suite, voilà une liste de solutions possibles: * débrancher / rebrancher la prise ethernet murale * <code>service network restart</code> * Exécuter à nouveau <code>wpa_supplicant -c /etc/wpa_supplicant/polytechnique.conf -D wired -i NOM_DE_L'INTERFACE -B</code> et <code>udhcpc -i wan</code>

==== Pour la reconnexion automatique au reboot (pas encore testé) ====

Cf https://forum.openwrt.org/t/connect-router-archer-c50-to-a-802-1x-eap-network/34602/20

== Depuis l'interface LuCi ==
Toutes les manipulations qui suivent sont relativement simples et accessibles à tous. Elles s'effectuent depuis l'interface web LuCi, disponible à l'adresse http://192.168.1.1 lorsque l'on est connecté au routeur. Elles ne nécessitent donc l'installation d'aucun outil externe (par exemple PuTTY sur Windows). Pour valider les changements effectués, appuyez sur le bouton "Save & Apply", en bas de chaque page.

=== Changer le mot de passe root ===
Avant toute chose, il est conseillé de changer le mot de passe root. Le mot de passe par défaut est « root ». Allez dans "System" -> "Administration" et changez le mot de passe.

=== Changer le nom/le mot de passe du réseau Wi-Fi ===
{{Attention|
*'''Tous''' les routeurs, y compris ceux des bars d'étage, '''doivent''' être protégés par un mot de passe sécurisé. '''Le BR interdit strictement toute utilisation de routeur dont le réseau Wi-Fi n'est pas protégé par un mot de passe'''.
*En mettant un mot de passe trop simple ou trop proche de votre mot de passe LDAP/ENEX/Zimbra, vous risqueriez de compromettre sa sécurité, et donc l'ensemble de vos comptes liés, qui pourraient alors être coupés par la DSI.}}
Le nom et le mot de passe du réseau peuvent être changé en allant dans "Network" -> "Wi-Fi". Désactivez temporairement le Wi-Fi en appuyant sur le bouton "Disable", puis cliquez sur "Edit". Le nom du réseau est personnalisable via le champ "ESSID", dans l'onglet "General Setup", en bas de la page. Le mot de passe est personnalisable via l'onglet "Wireless Security". '''Laissez bien l'option "WPA2-PSK" active'''.

== Problèmes connus ==
=== Le réseau coupe souvent ===
Au 16/10/2016, une des raisons connues est un problème dans l'infrastructure de la DSI, qui touche aussi les personnes ne possédant pas de routeur. Il faut alors débrancher et brancher la prise à chaque fois que le réseau se coupe. Le routeur peut néanmoins simuler cette manipulation de lui-même à intervalles réguliers. Pour cela, ajoutez la ligne suivante dans "System" -> "Scheduled Tasks" (ne supprimez pas les autres lignes !) :
:<code>0 */1 * * * kill $(pidof wpa_supplicant) $(pidof udhcpc) && rm -rf /tmp/run/wpa_supplicant/ && /etc/init.d/wpa start</code>

Si le problème est antérieur au 08/10/2016, voir aussi [[Routeurs_Wi-Fi/Tutoriel#Je_dois_souvent_red.C3.A9marrer_mon_routeur|cette section du tutoriel]] ou encore [[Routeurs_Wi-Fi/Tutoriel#Probl.C3.A8me_de_date|celle-ci]].

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Routeurs Wi-Fi/Tutoriel

2024-01-14T10:24:16Z

Florian.chive : Fix typo in Wifi

{{Travaux|Pour toute remarque ou demande, ouvrir une tâche Panix}}

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. Si vous souhaitez acheter un routeur, tournez vous faire des modèles avec plus de RAM que celui-ci (contacter le BR direcetement pour plus d'infos) !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec le routeur '''TP-Link 841N''' ou '''TP-Link 841ND''', versions 11 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testé.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0). Cependant ce guide sera très spécifique pour le TP-link 841N et Tp-link 841ND.

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Préparation ==

=== Linux ===

Dans le cas des systèmes UNIX, la préparation est assez rapide car les outils sont déjà installés.

==== Terminal ====

Pour faire la configuration il vous faudra être capable d'accéder à votre terminal. Pour la plupart des systèmes on peut le lancer avec {{c|ctrl+alt+T}} ou en cherchant « terminal » dans le menu principal.

==== SSH et SCP ====

Vous aurez besoin d'un client {{c|ssh}} (par défaut installé sous linux) :

$ sudo apt-get install openssh-client

La commande {{c|ssh}} permet ensuite de se connecter à distance et de façon sécurisée à un terminal.

La commande {{c|scp}}, fournie par le même paquet, permet de transférer des fichiers avec le même protocole.

==== Configuration réseau ====

Pour vous connecter au routeur il vous faudra créer un nouveau profil de configuration ethernet selon les paramètres suivants :

[[Image:routeurs-settings-eth-linux.jpg|500px]]

==== Récupération ====

Pour pouvoir récupérer une erreur commise avec votre routeur, il faut tout d'abord installer un serveur ssh :

$ sudo apt-get install openssh-server
$ sudo service ssh start

Vous aurez ensuite besoin d'un nouveau profil de connexion réseau qui vous permettra de réaliser la remise à zéro du routeur :

[[Image:routeurs-settings-eth0-linux.jpg|500px]]

=== MacOS ===

==== Terminal ====

La console de MacOS est accessible via une application appelée '''Terminal'''. Vous la trouverez dans le dossier « Utilitaires » du dossier « Applications ». Elle vous permettra de taper les commandes nécessaires.

==== SSH et SCP ====

Le programme {{c|ssh}} est en général installé sur MacOS X, et permet de se connecter à distance à d'autres ordinateurs (en l'occurrence au routeur).

Il en est de même pour {{c|scp}} qui est destiné au transfert de fichiers.

==== Configuration réseau ====

Pour pouvoir se connecter facilement au routeur le plus simple est de créer un nouveau profil de configuration :

[[Image:routeurs-settings-eth-1-mac.jpg|500px]]

[[Image:routeurs-settings-eth-2-mac.jpg|500px]]

=== Windows ===

==== Terminal ====

Sous Windows il existe plusieurs options.

Soit vous utilisez le powershell (windows terminal sous windows 11), soit vous utilisez Ubuntu via WSL. Si vous utilisez WSL veuillez vous référer à la partie Linux précédente pour installer les paquets nécessaires à la réalisation du tutoriel.

==== Configuration réseau ====

Il vous faudra aussi configurer votre connexion réseau en '''DHCP''', sans la sécurité '''802.1X''', et de préférence avec les bons serveurs '''DNS'''. Si vous ne l'avez jamais fait, renseignez-vous sur le wikibr ou tout autre site décrivant la configuration réseau sous Windows.

=== Terminal ===

Dans le terminal de votre ordinateur nous n'utiliserons que '''ssh''' et '''scp''' . En revanche nous utiliserons beaucoup le terminal du routeur, qui ressemblera à ceci :

neze@neze ~$ ssh root@192.168.1.1
The authenticity of host '192.168.1.1 (192.168.1.1)' can't be established.
RSA key fingerprint is **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.1.1' (RSA) to the list of known hosts.
root@192.168.1.1's password: # ici le password n'apparaîtra pas

BusyBox v1.23.2 (2015-11-17 16:24:55 CET) built-in shell (ash)

_______ ________ __
| |.-----.-----.-----.| | | |.----.| |_
| - || _ | -__| || | | || _|| _|
|_______|| __|_____|__|__||________||__| |____|
|__| W I R E L E S S F R E E D O M
-----------------------------------------------------
CHAOS CALMER (Chaos Calmer, r47466)
-----------------------------------------------------
* 1 1/2 oz Gin Shake with a glassful
* 1/4 oz Triple Sec of broken ice and pour
* 3/4 oz Lime Juice unstrained into a goblet.
* 1 1/2 oz Orange Juice
* 1 tsp. Grenadine Syrup
-----------------------------------------------------
root@OpenWrt:~#

== Installation ==

Cette section est destinée à décrire l'installation du système '''OpenWRT''' sur un des deux routeurs traités. Plusieurs fichiers vous sont proposés. En général avant de l'installer il faut renommer un fichier.

=== Installer OpenWRT sur le routeur ===

Pour installer '''OpenWRT''' il faut d'abord préparer le fichier que vous allez mettre dans le routeur, qui est une version d'OpenWRT prévue pour le v10 et v11 et modifiée pour l'École polytechnique. Les informations sur ce fichier incluent aussi des sommes de contrôle si vous voulez vérifier que le fichier est le bon. Pensez à le décompresser avant toute chose.

'''Nom:''' openwrt-19.07.2-ath79-tiny-tplink_tl-wr841-v11-squashfs-factory.bin
(md5) c7ac93636caf4935665c54fa09ba1421
(sha1) 83a9763418ce2bda4e29f0ae46d827e3ef506e48
(sha256) 9099e9054b370676b6467b6fb29c8f5a248839d2e3960686d0b6297c5c42763a

[[Fichier:routeurv11openwrt.zip]]

Il faut commencer par renommer votre fichier pour qu'il corresponde à votre routeur, suivant le schéma suivant :

wr841nv11_wr841ndv11_en_3_16_9_up(150616).bin # tl841n v11

Ouvrez ensuite, avec votre navigateur web, la page de configuration du routeur. Son adresse est
<tt>http://192.168.1.1/</tt> ou <tt>http://192.168.0.1/</tt>
et il vous faut parfois désactiver le proxy pour y accéder.

[[Image:routeurs-tp-link-page.jpg|500px]]

Il faut ensuite se connecter à l'interface (nom d'utilisateur {{c|admin}}, même mot de passe), puis accéder à l'onglet '''System > Firmware Upgrade'''. Dans cette fenêtre vous pouvez sélectionner votre fichier ''bien renommé'', puis cliquer sur Upgrade et confirmer.

OpenWRT va être installé sur le routeur qui va ensuite redémarrer.

== Configuration ==

=== Accès SSH ===

Actuellement le routeur n'a pas de mot de passe administrateur, ce qui empêche d'utiliser {{c|ssh}} pour s'y connecter.

Pour des raisons techniques, le routeur n'a pas d'interface web. On peut dans ce cas utiliser {{c|telnet}} et la commande {{c|passwd}} lorsque l'on dispose d'un terminal. L'on peut si on le souhaite mettre un mot de passe (très fortement conseillé) :

neze@neze ~ $ ssh root@192.168.1.1

BusyBox v1.23.2 (2016-01-02 18:01:44 CET) built-in shell (ash)
_______ ________ __
| |.-----.-----.-----.| | | |.----.| |_
| - || _ | -__| || | | || _|| _|
|_______|| __|_____|__|__||________||__| |____|
|__| W I R E L E S S F R E E D O M
-----------------------------------------------------
CHAOS CALMER (15.05.1, r48532)
-----------------------------------------------------
* 1 1/2 oz Gin Shake with a glassful
* 1/4 oz Triple Sec of broken ice and pour
* 3/4 oz Lime Juice unstrained into a goblet.
* 1 1/2 oz Orange Juice
* 1 tsp. Grenadine Syrup
-----------------------------------------------------
root@OpenWrt:/# passwd
Changing password for root
New password:
Retype password:
Password for root changed by root
root@OpenWrt:/#

=== Donner l'accès internet au routeur ===

Pour que le routeur fonctionne à l'École, il faut qu'il soit branché à la prise de votre casert via la prise bleue du routeur. Il faut ensuite le configurer pour qu'il ait accès à internet.

==== 802.1X ====

Dans la plupart des caserts de l'X, la sécurité est 802.1X (celle qui demande une authentification). Pour la configurer il faut mettre vos identifiants enex dans le routeur.

* Connectez-vous au routeur via ssh.

ssh root@192.168.1.1

* Éditez le fichier de configuration de '''wpa''' en complétant les champs identity et password puis en copiant collant dans le terminal (faire CTRL+C et CTRL+V).

nano /etc/config/wpa.conf

''Une fois l'édition terminée, faire CTRL+X puis y pour valider''

*Fichier wpa.conf :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=root
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"

anonymous_identity="anonymous@polytechnique.fr"
password="xxxxx"
phase1="auth=TTLS"
phase2="auth=PAP"
}

* Rendez le fichier éxécutable :

chmod +x /etc/config/wpa.conf

* Testez la configuration. Votre routeur doit être branché à internet.

wpa_supplicant -D wired -i eth1
-c /etc/config/wpa.conf

''Si vous voyez le texte '''CTRL-EVENT-CONNECTED''' c'est bon, vous pouvez interrompre avec '''Ctrl+C''' et continuer la configuration.''
''Si vous obtenez un message d'erreur à propos du certificat (comme par exemple ci-dessous), essayez de mettre votre routeur à l'heure puis reprenez cette étape.''

X509: Certificate not valid (now=XXXXXX not_before=XXXXXX not_after=XXXXXX)

* Configurer le démarage automatique en copiant collant le fichier si dessous:

nano /etc/init.d/wpa

''Une fois l'édition terminée, faire CTRL+X puis y pour valider''

* Fichier wpa :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() {
echo start
wpa_supplicant -D wired -i eth1 -c /etc/config/wpa.conf &
}

* Activez le démarrage automatique.

/etc/init.d/wpa start
/etc/init.d/wpa enable

''Si vous obtenez un message d'erreur du type '''Permission denied''', tentez d'abord de rendre le fichier exécutable avec {{c|chmod +x /etc/init.d/wpa}}.''

Configuration de {{c|wpa-supplicant}} :

neze@neze ~ $ ssh root@192.168.1.1
root@192.168.1.1's password:
_______ ________ __
| |.-----.-----.-----.| | | |.----.| |_
| - || _ | -__| || | | || _|| _|
|_______|| __|_____|__|__||________||__| |____|
|__| W I R E L E S S F R E E D O M
-----------------------------------------------------
root@OpenWrt:~# vim /etc/config/wpa.conf
root@OpenWrt:~# wpa_supplicant
-c /etc/config/wpa.conf
-D wired -i eth1
Successfully initialized wpa_supplicant
eth1: Associated with 01:80:c2:00:00:03
WMM AC: Missing IEs
eth1: CTRL-EVENT-EAP-STARTED EAP authentication started
eth1: CTRL-EVENT-EAP-PROPOSED-METHOD vendor=0 method=21
eth1: CTRL-EVENT-EAP-METHOD EAP vendor 0 method 21 (TTLS) selected
TLSv1: you should reject under 768-bit DH prime (insecure; only 512 bits)
eth1: CTRL-EVENT-EAP-SUCCESS EAP authentication completed successfully
eth1: CTRL-EVENT-CONNECTED - Connection to **:**:**:**:**:** completed [id=0 id_str=]
^Ceth1: CTRL-EVENT-DISCONNECTED bssid=**:**:**:**:**:** reason=3 locally_generated=1
eth1: CTRL-EVENT-TERMINATING
root@OpenWrt:~# vim /etc/init.d/wpa
root@OpenWrt:~# /etc/init.d/wpa enable
root@OpenWrt:~#

==== IP fixe ====

Si votre configuration est en IP fixe, ouvrez l'interface web d'OpenWRT. Dans l'onglet '''Network > Interfaces''', cliquez sur le bouton '''Edit''' de l'interface '''WAN''', changez le protocole en « statique », confirmez en cliquant sur '''Switch protocol''' puis remplissez les trois champs « IPv4 address, IPv4 netmask, IPv4 gateway ». Enfin, rajoutez les serveurs dns {{c|129.104.201.53}} et {{c|129.104.201.51}}.

[[Image:routeurs-openwrt-ipf-gui.jpg|500px]]

Si vous n'avez pas accès à l'interface web, connectez vous en ssh au routeur puis tapez les commandes suivantes, en adaptant évidemment les valeurs de l'adresse IP, du masque de sous-réseau et de la passerelle par défaut.

root@OpenWrt:~# uci set network.wan.proto='static'
root@OpenWrt:~# uci set network.wan.ipaddr='129.104.222.109'
root@OpenWrt:~# uci set network.wan.netmask='255.255.255.0'
root@OpenWrt:~# uci set network.wan.gateway='129.104.222.254'
root@OpenWrt:~# uci set network.wan.dns='129.104.201.59 129.104.201.51'
root@OpenWrt:~# uci commit network
root@OpenWrt:~#

=== Réglages Wi-Fi ===

Cette section vous permettra de mettre en place un réseau wifi avec une sécurité correcte et aux normes françaises.

Connectez-vous au routeur en '''SSH''' et suivez la procédure ci-dessous en adaptant à votre choix de nom de réseau et mot de passe wifi.

'''Attention :''' votre mot de passe doit faire plus de 8 caractères, sans quoi le réseau wifi ne démarrera jamais.

root@OpenWrt:~# uci set wireless.@wifi-device[0].disabled=0
root@OpenWrt:~# uci set wireless.@wifi-iface[0].ssid='MON-RESEAU-WIFI'
root@OpenWrt:~# uci set wireless.@wifi-iface[0].encryption='psk2'
root@OpenWrt:~# uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
root@OpenWrt:~# uci set wireless.@wifi-device[0].country='FR'
root@OpenWrt:~# uci commit wireless; wifi
root@OpenWrt:~#

== Fonctionnalités supplémentaires ==

=== Changer l'heure du routeur ===

L'heure du routeur est assez simple à changer. ''Normalement, elle se met à l'heure automatiquement, mais vous pouvez avoir besoin de la changer '''avant''' d'avoir accès à Internet.''

C'est assez simple à faire en ligne de commande :

root@OpenWrt:~# date --set '2016-07-24 09:58'
Sun Jul 24 09:58:00 CEST 2016

Vous pouvez aussi passer, si vous le souhaitez, par l'interface graphique :

[[Image:routeurs-openwrt-date-gui.jpg|500px]]

== Récupération, problèmes ==

=== Routeur briqué ===

Il se peut, après certaines mauvaises manipulations, que le routeur ne soit plus accessible, que l'interface web disparaisse, que vous ayez des messages d'erreurs intempestifs vous empêchant de le configurer, etc.

root@OpenWrt:~# touch test
touch: test: Read-only file system
root@OpenWrt:~#

Il faut dans ce cas effectuer une opération de récupération du routeur, dont la description est faite avec Linux dans ce document (Il est assez simple de l'adapter pour un Mac, beaucoup plus compliqué pour Windows.) . Vous aurez besoin d'un profil de configuration réseau « IP fixe », décrit en début de tutoriel.

* Récupérez le fichier d'openwrt correspondant à votre routeur, et copiez-le dans le répertoire de votre choix (dans notre cas il sera dans {{c|~/firmware.bin}}).
* Redémarrez votre routeur.

Au moment où le voyant « cadenas » commence à clignoter, enfoncez le bouton '''reset''' (derrière le routeur) jusqu'à ce que le voyant clignote beaucoup plus rapidement.
* Branchez votre routeur à l'ordinateur et passez dans le profil de configuration IP fixe, puis ouvrez un terminal et exécutez la procédure ci-dessous.

neze@neze ~ $ md5sum firmware.bin
06179235c8986228ea0c545d6d69df8b firmware.bin
neze@neze ~ $ telnet 192.168.1.1
Trying 192.168.1.1...
Connected to 192.168.1.1.
Escape character is '^]'.
...
================= FAILSAFE MODE active ================
...
=======================================================

root@(none):/# mount_root
root@(none):/# cd /tmp
root@(none):/tmp# scp neze@192.168.1.22:firmware.bin ./
Do you want to continue connecting? (y/n) y
neze@192.168.1.22's password:
firmware.bin 100
root@(none):/tmp# mtd -r write firmware.bin firmware
Unlocking firmware ...

Writing from firmware.bin to firmware ... [w]
Rebooting ...

=== Routeur sans OS ===

Si vous avez installé un OpenWRT corrompu ou tenté de réinstaller le système d'origine sans réfléchir, vous avez peut-être un routeur qui ne démarre pas jusqu'au bout.

Cette section est valable si le {{c|bootloader}} est présent. Un bon moyen de le savoir est d'enfoncer le bouton reset (routeur éteint) puis d'allumer le routeur (reset enfoncé). Si au bout d'un certain temps le voyant du cadenas reste allumé, c'est probablement le cas. Éteignez alors le routeur.

''Procédure testée sur un routeur TP-Link 841N v10.''

'''Préparez votre ordinateur.''' Installez sur un ordinateur '''Linux''' (Ces remarques s'appliquent à Debian et doivent être adaptées.) un serveur {{c|tftp}} :

sudo apt-get install tftp xinetd tftpd

Normalement, {{c|xinetd}} sera alors le process chargé de gérer les serveurs. Vous pouvez vérifier que c'est lui qui tourne avec la commande {{c|ps -alxww | grep inet}}.

Vérifiez ensuite (dans {{c|/etc/services}}) que la ligne concernant {{c|tftp}} n'est pas commentée :

tftp 69/udp

Faites les réglages d'un serveur {{c|tftp}} en créant/éditant le fichier {{c|/etc/xinetd.d/tftp}} :

service tftp
{
socket_type = dgram
protocol = udp
wait = yes
user = root
server = /usr/sbin/in.tftpd
server_args = -s /tftpboot
disable = no
}

Redémarrez le service avec la commande {{c|service xinetd restart}}. Désormais tous les fichiers présents dans {{c|/tftpboot}} seront accessibles dans votre serveur tftp.

Vous pouvez par exemple tester votre serveur tftp de la sorte :

neze tmp.9B8qi7nCqn # echo "Hello World" > /tftpboot/hello.txt
neze tmp.9B8qi7nCqn # tftp localhost
tftp> get hello.txt
Received 13 bytes in 0.0 seconds
tftp> quit
neze tmp.9B8qi7nCqn # cat hello.txt
Hello World
neze tmp.9B8qi7nCqn #

Prenez une image valable d'OpenWRT, déposez-la dans {{c|/tftpboot}} renommée suivant le schéma suivant :

wr841nv10_tp_recovery.bin # tl841n v10
wr841nv11_tp_recovery.bin # tl841n v11

Configurez votre connexion ethernet en '''IP fixe''' {{c|192.168.0.66}}.

Branchez le routeur à votre ordinateur, enfoncez le bouton reset, démarrez le routeur et attendez que le routeur redémarre après réinstallation du firmware.

=== Routeur n'accepte plus le certificat ===
Une des causes possibles est que la date de votre routeur est incorrecte.
Voir la section [[#Problème_de_date|sur ce sujet-là]].

=== Problème de date ===
Pour connaître la date enregistrée par votre routeur :
:<code>date</code>

Si la date est incorrecte, vous pouvez la changer avec la commande suivante (à adapter avec la date actuelle) :
:<code>date --set '2016-07-31 19:20:00'</code>

Si le problème persiste, vous pouvez procéder ajouter les étapes suivantes :
# <code>date --set '2016-07-31 19:20:00'</code>
# <code>echo "timesave" > /etc/timesave</code> (1er fix)
# Modifier le fichier /etc/init.d/sysfixtime, en remplaçant
#:<code>[ $curtime -lt $maxtime ] && date -s @$maxtime</code>
#:par
#:<code>if [ $curtime -lt $maxtime ]; then</code>
#:<code>date -s @$maxtime</code>
#:<code>/etc/init.d/sysntpd restart</code>
#:<code>fi</code>

=== Je dois souvent redémarrer mon routeur ===
Un problème connu implique redsocks. Un workaround consiste à activer cron et à vérifier régulièrement que le service est lancé. On peut par exemple procéder ainsi :
<pre>/etc/init.d/redsocks enable

crontab -e

0 */1 * * * /etc/init.d/redsocks stop && /etc/init.d/redsocks start
*/3 * * * * /etc/init.d/redsocks start

/etc/init.d/cron enable
</pre>

[[Catégorie:Tutoriels]]

[[Catégorie:Wifi]]

Routeurs Wi-Fi/Tutoriel

2024-01-14T10:23:54Z

Florian.chive : Ajout des catégories tutoriels et WiFi

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-14T10:22:33Z

Florian.chive : Ajout de la catégorie tutoriels

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Il est également possible que la version d'OpenWRT disponible ne soit pas compatible avec la version du routeur (par exemple, OpenWRT pour le Archer C50 v5 ne fonctionne pas pour la v6). Dans ce cas, s'il n'existe pas d'image pré-compilée pour le routeur, il faut [[Compiler OpenWRT]].

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() { echo start wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf & }

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.

[[Catégorie:Tutoriels]]

Hébergement des sites des binets

2024-01-14T10:11:57Z

Florian.chive : Fix typo

{{menu services}}
[[Catégorie:Services]]

Le BR propose aux binets qui le désirent d'héberger gratuitement leur site web.

Cet hébergement s'organise selon deux formules, avec ou sans la possibilité d'accéder au site de l'extérieur du Plâtal.

Pour demander l'hébergement de ton site, [https://panix.binets.fr ouvre une tâche Panix] en précisant l'identifiant du groupe/binet au nom duquel tu fais la demande (si tu ne le connais pas, donne le lien vers le groupe/binet sur Sigma).

Tu peux également demander à mettre une [[authentification CAS]], [[openID]], ou encore protéger ton site par un portail d'authentification global si ton site est déployé sous docker (i.e. tu peux considérer que l'utilisateur est déjà connecté une fois sur le site).

En fonction des technologies utilisées, on a différents tuto à te proposer:
* un tuto pour les sites en php (sur cette page).
* un [[Tuto pour le déploiement des sites Django]] des sites binets codés en django/flask/(tout ce qui supporte uwsgi).
* un [[Tuto pour le déploiement des sites avec Docker]] pour n'importe quel site.

Les sites internes en php sont hébergés sur [[Admin:Ostizan | Ostizan]].

== Modalités techniques ==
L'hébergement classique offert par le BR présente les caractéristiques suivantes :
* Capacité de stockage limitée à 200Mo par défaut. Il est possible d'obtenir plus sur demande.
* Serveur apache avec PHP 7
* Base de données MySQL
* Accès en HTTPS/HTTP
* Hébergement Django/Flask avec uWSGI

Si vous avez des besoins plus spécifiques, n'hésitez pas à nous en parler.

== Accès au site ==

L'administration du site se fait par [[SSH]]. Il est ouvert à tous les administrateurs du binet considéré, et à eux seuls. Pour cela, utilisez vos identifiants Sigma. Exemple de commande à utiliser : <code>ssh prenom.nom@id_sigma.binets.fr</code>, puis rentrez votre mot de passe lorsque celui vous est demandé.

L'écriture du site est bien entendu à la charge du webmaster du binet ; en cas de nécessité et pour une raison valable, un BRman pourra cependant proposer son aide.

L'adresse du site est alors mon_binet.binets.fr ou mon_binet.binets.eleves.polytechnique.fr ;

La base de données MySQL est accessible par un PhpMyAdmin : [http://phpmyadmin.binets.fr/ http://phpmyadmin.binets.fr/]. Le nom d'utilisateur correspond au nom du binet tel qu'il apparaît dans le nom de domaine. Le mot de passe a été donné au binet à la création de la base SQL ; le BR ne le possède pas et vous devez le passer à vos successeurs pour éviter de le perdre à tout jamais.

=== Modification des fichiers du site ===

Les fichiers se situent sur le serveur ostizan, dans le répertoire

<pre lang="sh">/hosting/www/nom_binet/</pre>

==== Avec Git (recommandé) ====

ostizan dispose d’une installation [[Git]].

Avec Git, vous pouvez garder un historique des versions successives de votre site, travailler à plusieurs, revenir en arrière quand vous avez cassé quelque chose, savoir qui a modifié quoi, quand … C’est un outil très puissant.

'''Prérequis :''' ''avoir une clef [[SSH]] activée sur votre compte sur ostizan''

Pour savoir comment configurer et construire un projet avec Git, référez-vous à la documentation. Vous pouvez héberger votre code chez nous sur [https://gitlab.binets.fr GitLab].

Naviguez au dossier où vous voulez mettre votre site, par exemple <code>htdocs</code>:

<pre lang="sh">cd /hosting/www/nom_binet/htdocs</pre>
et initialisez un dépôt Git

<pre lang="sh">git init</pre>
Si cela a fonctionné, le terminal répondra

<pre>Initialized empty Git repository in /hosting/www/nom_binet/htdocs/.git</pre>
Ajoutez maintenant une ''remote'' qui pointera vers là où vous hébergez votre code, par exemple

<pre lang="sh">git remote add origin git@gitlab.binets.fr:domaine/site.git</pre>
pour un site dont le code est hébergé sur le GitLab, ou

Ensuite, faites

<pre lang="sh">git pull origin master</pre>
pour cloner le dépôt (si la ''remote'' que vous avez ajouté s’appelle <code>origin</code> et que votre code est sur la branche <code>master</code>).

==== En SFTP ====

Pour accéder aux fichiers, on peut utiliser un client sftp (comme [https://filezilla-project.org/download.php?type=client FileZilla] ou [https://winscp.net/eng/index.php WinSCP]) et accéder au serveur <code>sftp://id_sigma.binets.fr</code> sur le port 22.

Le serveur SFTP demande un login / mot de passe qui correspondent exactement à ceux du compte Sigma. Le dossier <code>sftp://id_sigma.binets.fr/www/id_sigma/htdocs/</code> correspond au site <code>http://id_sigma.binets.fr/</code>. Les fichiers qui ne sont pas dans htdocs ne sont pas accessibles directement par un navigateur, mais un script php peut y accéder.

=== Avec visibilité extérieure ===

Le BR a un partenariat avec la DSI qui lui permet d'exposer certains sites à l'extérieur. Ils feront l'objet d'[[un audit de sécurité]] par le BR et la DSI. Pour le passer, il faut respecter les dernières recommandations de sécurité, notamment pour tout ce qui est authentification, contenu dynamique. Notons cependant que cela ne devrait pas poser de problèmes pour les sites statiques.

Les sites souhaitant un site avec visibilité depuis l'extérieur doivent dorénavant respecter la charte suivante :

*Aucune information ne doit être diffusée qui pourrait nuire à l'image de l’École. (photos, vidéos, etc.)
*Le site doit avoir une qualité visuelle, si ce n'est professionnelle, du moins très correcte.
*Le site ne doit pas héberger de vidéos ou diffuser un flux vidéo (streaming). Toutes les vidéos du sites doivent être hébergées à l'extérieur. (Dalymotion, YouTube, etc.)
*Les images présentes sur le site ne doivent avoir une résolution suffisamment faible afin de ne pas saturer la bande passante vers l'extérieur.

{{Attention|Si le site concerne un événement extérieur avec un public de plus de 50 personnes, la DSI demande à ce que la DIRCOM soit prévenue.}}

== Quotas ==

Attention ! L'espace réservé à chaque binet est limité. Il faut se méfier quand on fait une copie, notamment a l'environnement virtuel. D'abord il pèse lourd, en plus il faudra que vous le remplaciez de toute façon. Autant ne pas le copier dès le départ...
Pour savoir si vous avez dépassé votre quota :
quota -sg
Cette commande affiche, pour chaque binet, l'espace utilisé, une «soft limit» et la vraie («hard») limit.

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-14T10:04:15Z

Florian.chive : Clarification du guide

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-14T09:49:58Z

Florian.chive : Ajout de la configuration du BR

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-14T09:41:00Z

Florian.chive : Changement de partage Stratus de perso vers BR

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/aokdzwtmBsBtHAb ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Il est également possible que la version d'OpenWRT disponible ne soit pas compatible avec la version du routeur (par exemple, OpenWRT pour le Archer C50 v5 ne fonctionne pas pour la v6). Dans ce cas, s'il n'existe pas d'image pré-compilée pour le routeur, il faut [[Compiler OpenWRT]].

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() { echo start wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf & }

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-13T23:49:57Z

Florian.chive : Ajout d'un paragraphe précisant le contexte du guide

Routeurs Wi-Fi

2024-01-13T23:47:07Z

Florian.chive : Ajout de la possibilité de compiler OpenWRT

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-13T23:27:44Z

Florian.chive : Rectification de la mise en page

{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

== Pré-requis ==

* Un ordinateur tournant sous Linux (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget [URL] -O .config # Voir l'étape correspondante pour déterminer l'URL à utiliser

make menuconfig

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT. Parmis ceux-ci se trouve notamment <code>LuCI</code>, l'interface web d'administration d'OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Cependant, on peut utiliser comme base la configuration utilisée pour compiler les images fournies d'OpenWRT.

Pour cela, le plus simple est de consulter la page correspondant à notre modèle sur le site d'OpenWRT, par exemple le [https://openwrt.org/toh/tp-link/archer-c50 Archer C50].

Dans la section [https://openwrt.org/toh/tp-link/archer-c50#downloads Downloads], on peut voir que le lien de téléchargement de l'image d'OpenWRT est [https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin].

Ce qui nous intéresse dans cette URL est la partie entre <code>/targets/</code> et le nom du fichier <code>.bin</code> : <code>ramips</code>, la <code>target</code>, et <code>mt7620</code>, la <code>subtarget</code>.

Cette information va nous permettre de récupérer la dernière version du fichier de configuration approprié : il faut aller dans le dossier [https://downloads.openwrt.org/releases/ releases] d'OpenWRT, pour trouver quelle est la dernière version d'OpenWRT disponible, par exemple <code>23.05.2</code>.

Cela a été un peu long, mais nous avons enfin tous les éléments nécessaires afin de déduire l'URL du fichier tant cherché : <code>https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo</code>. Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne <code>https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo</code>

On peut enfin télécharger ce fichier et l'enregistrer sous le nom <code>.config</code> :

wget https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo -O .config

Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne :

wget https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo -O .config

=== Configuration de OpenWRT ===

La configuration par défaut téléchargée à l'étape précédente est un début, mais elle n'est pas complète. Il est nécessaire d'entrer dans le menu de configuration de compilation avec la commande :

make menuconfig

La première chose à faire est de renseigner le modèle exact dans <code>Target Profile</code>. Attention, le modèle n'apparaît que si la bonne <code>target</code> et <code>subtarget</code> ont été sélectionnés (ce qui est normalement le cas dans la configuration que nous avons téléchargé).

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

make -j1 V=s

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

Ce fichier correspond au fichier <code>owrt.bin</code> indiqué dans le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]], qui peut ensuite être suivi dans le cas du Archer C50 afin d'obtenir le fichier <code>tp_recovery.bin</code>.

Compiler OpenWRT

2024-01-13T23:25:06Z

Florian.chive : Florian.chive a déplacé la page Compiler OpenWRT vers Routeurs Wi-Fi/Compiler OpenWRT : Catégoriastion dans Routeurs W-Fi

#REDIRECTION [[Routeurs Wi-Fi/Compiler OpenWRT]]

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-13T23:25:06Z

Florian.chive : Florian.chive a déplacé la page Compiler OpenWRT vers Routeurs Wi-Fi/Compiler OpenWRT : Catégoriastion dans Routeurs W-Fi

{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

== Pré-requis ==

* Un ordinateur tournant sous Linux (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget [URL] -O .config # Voir l'étape correspondante pour déterminer l'URL à utiliser

make menuconfig

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT. Parmis ceux-ci se trouve notamment <code>LuCI</code>, l'interface web d'administration d'OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Cependant, on peut utiliser comme base la configuration utilisée pour compiler les images fournies d'OpenWRT.

Pour cela, le plus simple est de consulter la page correspondant à notre modèle sur le site d'OpenWRT, par exemple le [https://openwrt.org/toh/tp-link/archer-c50 Archer C50].

Dans la section [https://openwrt.org/toh/tp-link/archer-c50#downloads Downloads], on peut voir que le lien de téléchargement de l'image d'OpenWRT est [https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin].

Ce qui nous intéresse dans cette URL est la partie entre <code>/targets/</code> et le nom du fichier <code>.bin</code> : <code>ramips</code>, la <code>target</code>, et <code>mt7620</code>, la <code>subtarget</code>.

Cette information va nous permettre de récupérer la dernière version du fichier de configuration approprié : il faut aller dans le dossier [https://downloads.openwrt.org/releases/ releases] d'OpenWRT, pour trouver quelle est la dernière version d'OpenWRT disponible, par exemple <code>23.05.2</code>.

Cela a été un peu long, mais nous avons enfin tous les éléments nécessaires afin de déduire l'URL du fichier tant cherché : <code>https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo</code>. Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne [https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo]

On peut enfin télécharger ce fichier et l'enregistrer sous le nom <code>.config</code> :

wget https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo -O .config

Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne :

wget https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo -O .config

=== Configuration de OpenWRT ===

La configuration par défaut téléchargée à l'étape précédente est un début, mais elle n'est pas complète. Il est nécessaire d'entrer dans le menu de configuration de compilation avec la commande :

make menuconfig

La première chose à faire est de renseigner le modèle exact dans <code>Target Profile</code>. Attention, le modèle n'apparaît que si la bonne <code>target</code> et <code>subtarget</code> ont été sélectionnés (ce qui est normalement le cas dans la configuration que nous avons téléchargé).

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

make -j1 V=s

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

Ce fichier correspond au fichier <code>owrt.bin</code> indiqué dans le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]], qui peut ensuite être suivi dans le cas du Archer C50 afin d'obtenir le fichier <code>tp_recovery.bin</code>.

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-13T23:23:37Z

Florian.chive : Ajout d'un paragraphe sur la compilation

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Il est également possible que la version d'OpenWRT disponible ne soit pas compatible avec la version du routeur (par exemple, OpenWRT pour le Archer C50 v5 ne fonctionne pas pour la v6). Dans ce cas, s'il n'existe pas d'image pré-compilée pour le routeur, il faut [[Compiler OpenWRT]].

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() { echo start wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf & }

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.

Routeurs Wi-Fi/Compiler OpenWRT

2024-01-13T23:21:22Z

Florian.chive : Création de la page

{{Attention|Si installer OpenWRT sur votre routeur risque de le briquer, compiler OpenWRT risque de briquer votre cerveau}}

== Pourquoi compiler OpenWRT ==

Il est utile de compiler soi-même OpenWRT dans deux cas :

# Il n'existe pas de version officielle d'OpenWRT pour votre routeur, et la version la plus proche ne fonctionne pas
# L'image dont vous disposez est trop grosse pour le stockage de votre routeur et vous avez besoin de l'alléger

Ce guide est adapté de celui d'[https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem OpenWRT]. Il n'est pas exhaustif et ne cherche pas à l'être, la documentation d'OpenWRT étant très complète et agréable à naviguer.

== Pré-requis ==

* Un ordinateur tournant sous Linux (les ordis de salle info ne fonctionnent ''pas'' car une dépendance est manquante (<code>libz2.so.1.0</code>), de préférence avec un accès <code>root</code> en cas de dépendances manquantes
* Beaucoup de temps (la compilation peut prendre plusieurs heures)
* Une brebis à sacrifier aux dieux de la compilation

=== Installation des dépendances ===

Les dépendances requises sont détaillées [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions ici]

Pour Debian / Ubuntu, les dépendances peuvent être installées avec cette commande :

sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev \
python3-distutils rsync unzip zlib1g-dev file wget

Pour les autres distributions, référez-vous à la [https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem#linux_gnu-linux_distributions documentation d'OpenWRT]

== Compilation ==

Bonne chance.

Voici un résumé de l'ensemble des commandes à exécuter, chacune étant ensuite détaillée.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

./scripts/feeds update -a
./scripts/feeds install -a

wget [URL] -O .config # Voir l'étape correspondante pour déterminer l'URL à utiliser

make menuconfig

make -j1 V=s

=== Téléchargement du code source ===

La première étape est de cloner le repo Git et de <code>cd</code> dedans.

git clone https://git.openwrt.org/openwrt/openwrt.git
cd openwrt

=== Téléchargement des paquets disponibles ===

Il faut ensuite télécharger, puis installer les différentes listes de paquets pouvant être ajoutés à OpenWRT. Parmis ceux-ci se trouve notamment <code>LuCI</code>, l'interface web d'administration d'OpenWRT.

./scripts/feeds update -a
./scripts/feeds install -a

=== Téléchargement d'une configuration de référence ===

La compilation d'OpenWRT est un processus complexe, avec de nombreuses options assez cryptiques. Cependant, on peut utiliser comme base la configuration utilisée pour compiler les images fournies d'OpenWRT.

Pour cela, le plus simple est de consulter la page correspondant à notre modèle sur le site d'OpenWRT, par exemple le [https://openwrt.org/toh/tp-link/archer-c50 Archer C50].

Dans la section [https://openwrt.org/toh/tp-link/archer-c50#downloads Downloads], on peut voir que le lien de téléchargement de l'image d'OpenWRT est [https://downloads.openwrt.org/releases/22.03.0/targets/ramips/mt7620/openwrt-22.03.0-ramips-mt7620-tplink_archer-c50-v1-squashfs-factory-eu.bin].

Ce qui nous intéresse dans cette URL est la partie entre <code>/targets/</code> et le nom du fichier <code>.bin</code> : <code>ramips</code>, la <code>target</code>, et <code>mt7620</code>, la <code>subtarget</code>.

Cette information va nous permettre de récupérer la dernière version du fichier de configuration approprié : il faut aller dans le dossier [https://downloads.openwrt.org/releases/ releases] d'OpenWRT, pour trouver quelle est la dernière version d'OpenWRT disponible, par exemple <code>23.05.2</code>.

Cela a été un peu long, mais nous avons enfin tous les éléments nécessaires afin de déduire l'URL du fichier tant cherché : <code>https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo</code>. Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne [https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo]

On peut enfin télécharger ce fichier et l'enregistrer sous le nom <code>.config</code> :

wget https://downloads.openwrt.org/releases/<version>/targets/<target>/<subtarget>/config.buildinfo -O .config

Pour le Archer C50 avec la version <code>23.05.2</code>, cela donne :

wget https://downloads.openwrt.org/releases/23.05.2/targets/ramips/mt7620/config.buildinfo -O .config

=== Configuration de OpenWRT ===

La configuration par défaut téléchargée à l'étape précédente est un début, mais elle n'est pas complète. Il est nécessaire d'entrer dans le menu de configuration de compilation avec la commande :

make menuconfig

La première chose à faire est de renseigner le modèle exact dans <code>Target Profile</code>. Attention, le modèle n'apparaît que si la bonne <code>target</code> et <code>subtarget</code> ont été sélectionnés (ce qui est normalement le cas dans la configuration que nous avons téléchargé).

=== Compilation ===

Il est enfin l'heure lancer la compilation avec la commande :

Attention, durant la compilation des archives sont téléchargées, il est donc nécessaire d'avoir une connexion Internet.

make -j1 V=s

Les options passées permettent d'augmenter le niveau de verbosité, ce qui permet d'avoir des détails en cas d'erreur.

Cela permet aussi d'apprécier les nombreux avertissements émis pour diverses raisons, mais qui peuvent être ignorés.

Si tout c'est bien passé sans erreur, les fichiers générés se trouvent dans le dossier <code>bin/targets/<target>/<subtarget></code>

Le fichier recherché se nomme normalement <code>openwrt-snapshot-[quelque chose]-[target]-[subtarget]-[modèle]-squashfs-sysupgrade.bin</code>. Par exemple, pour le Archer C50 v6 un nom possible est <code>openwrt-snapshot-r24801-b7f9742da8-ramips-mt76x8-tplink_archer-c50-v6-squashfs-sysupgrade.bin</code>.

Ce fichier correspond au fichier <code>owrt.bin</code> indiqué dans le guide [[Routeurs_Wi-Fi/Tutoriel_TP-Link_Archer_C50#Préparation]], qui peut ensuite être suivi dans le cas du Archer C50 afin d'obtenir le fichier <code>tp_recovery.bin</code>.

Routeurs Wi-Fi/Tutoriel TP-Link Archer C50

2024-01-12T17:48:52Z

Florian.chive : Fix typo

== Avertissements ==

{{Attention|Pour commencer, il est recommandé de lire toutes les parties qui vous intéressent ''avant'' de faire quoi que ce soit. Cela vous évitera des erreurs stupides qui vous feront perdre du temps. !}}

=== Avertissement technique ===

'''Modèle de routeur.''' Le système que vous vous apprêtez à installer n'est pas compatible avec tous les routeurs, loin de là ! Le fichier fourni par ce tutoriel est uniquement compatible avec les modèles de routeur '''TP-Link Archer C50''', '''TP-Link Archer AC1200''' ou '''TP-Link Archer A5''', versions 4 à 6 (La version est écrite sur une étiquette du routeur et sur la boîte près du code barre.) . ''D'autres versions peuvent être compatibles mais n'ont pas été testées.''

Si vous souhaitez tout de même utiliser un autre modèle, il faudra vous référer au site web d'openwrt {{c|http://openwrt.org/}} qui contient entre autres la liste des modèles compatibles. IL faut prendre des modèles avec suffisament de RAM pour que cela fonctionne et compatible avec des versions récentes d'openwrt (le plus récent le mieux pour des questions de sécurité, mais au minimum openwrt 20.0).

'''Méthode de connexion.''' Pour configurer le routeur vous allez devoir vous y connecter. Pour cela brancher un câble ethernet à votre PC et sur un port orange du routeur (pensez aussi à brancher préalablement le routeur).

'''État d'esprit.''' La procédure est relativement longue mais elle n'est pas très compliquée. Si c'est votre première installation, ne stressez pas. Si vous fruitez à un moment, il y a de grandes chances que ce soit récupérable. Lisez ce guide entièrement avant de commencer et ne vous précipitez pas.

=== Avertissement juridique ===

Si vous configurez ce routeur pour fonctionner avec 802.1X (dans les caserts de l'École polytechnique en général), cela signifie que votre routeur sera connecté au réseau avec ''vos identifiants''.

En particulier, puisque vous avez parfaitement le droit de partager votre connexion Wi-Fi avec qui bon vous semble, souvenez-vous que toute personne connectée à votre Wi-Fi est sous votre responsabilité.

== Principe ==

Les routeurs du commerce ne gèrent pas les systèmes de sécurité utilisés à l'École polytechnique pour votre connexion internet. Pour compenser ce problème, une solution est d'installer un système auxiliaire (OpenWRT) sur les routeurs, remplaçant le système d'origine. Grâce à ceci on peut obtenir un routeur qui s'authentifie lui-même sur le réseau de l'École, et fournit un réseau wifi sur lequel les réseaux interne et externe sont accessibles sans problèmes de réglages de vos téléphones et ordinateurs.

== Le hic ==
Il existe depuis l'interface GUI de TP-Link un endroit où l'on peut téléverser une mise-à-jour du microgiciel (firmware), et donc potentiellement fournir celui d'OpenWRT. Le problème qui va occuper une bonne partie de ce tutoriel, est que l'on ne peut pas directement fournir l'image d'OpenWRT depuis cette interface car '''cela va très probablement briquer le routeur'''.

Il faut donc procéder autrement, et l'on va donc utiliser le protocole TFTP [https://en.wikipedia.org/wiki/Trivial_File_Transfer_Protocol] pour pouvoir fournir notre image au routeur.

Cependant, si le Wiki de votre modèle indique que vous pouvez le faire, cela vous permet a priori de passer directement à la partie [[#Hello, OpenWRT world]].

Dans tous les cas, les liens suivants pourront vous être utiles en complément :
* Page officielle pour le modèle Archer C50 [https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions]
* Autre tutoriel qui a servi a l'élaboration de celui ci. Certains phases sont identiques et il y a d'autres compléments d'informations [[Routeurs Wi-Fi/Tutoriel]]

== Préparation ==

Pour pouvoir commencer, il va falloir créer votre image à flasher sur le système. Les instructions qui suivent sont calquées sur https://openwrt.org/toh/tp-link/archer-c50#v4_and_v5_instructions.

* 1ère possibilité: Utiliser un <code>tp_recovery.bin</code> tout fait disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]. (Utilise la version OS et pense à le renommer en <code>tp_recovery.bin</code>

* 2ème possibilité: Le faire soit même, comme ceci:

Récupérez l'image du firware TP-Link depuis le site officiel qui devra être nommé <code>tpl.bin</code>, et celle d'OpenWRT (https://firmware-selector.openwrt.org/) nommée <code>owrt.bin</code> et placez les dans un répertoire commun.

Il est probable que le firmware officiel ou OpenWRT ne soit pas disponible pour votre version du routeur. En pratique prenez la dernière version disponible. À noter également qu'il n'existe actuellement pas de firmware OpenWRT pour le Archer A5, il faut prendre celui du Archer C50.

Dans un terminal ouvert sur le répertoire, exécutez les commandes suivantes :

dd if=/dev/zero of=tp_recovery.bin bs=196608 count=1
dd if=tpl.bin of=tmp.bin bs=131584 count=1
dd if=tmp.bin of=boot.bin bs=512 skip=1
cat boot.bin >> tp_recovery.bin
cat owrt.bin >> tp_recovery.bin

Ce sera l'image <code>tp_recovery.bin</code> qui vient d'être créée qui nous intéressera par la suite. L'image doit peser environ 6 Mo.

* Si jamais à un moment ou un autre, le routeur est '''brické''' (cassé) tu peux le débloquer en utilisant le <code>tp_recovery.bin</code> disponible [https://stratus.binets.fr/s/q8joypmLcN9jbfD ici]

== Procédure TFTP ==

Comme indiqué sur le site OpenWRT, il faut maintenant déterminer si le routeur est client ou serveur TFTP. Dans le cas du C50, en regardant sur la page wiki, on voit des informations concernant ''Bootloader tftp server IPv4 address'' ce qui nous indique (contrairement à ce qu'on aurait pu penser) que le routeur sera client et le PC sera serveur.

Pour la suite, le lien suivant peut être d'une certaine utilité : https://www.youtube.com/watch?v=bL8wKx8qaZ4

Sur Windows, installer ce logiciel (https://pjo2.github.io/tftpd64/) avec les options par défaut. Si faisable, prendre un switch et connecter votre PC au switch, et le routeur ('''éteint''') au switch via un de ses ports orange (le 1 par exemple). Depuis l'interface de configuration réseau de Windows, aller dans les paramètres de votre connexion Ethernet. Vérifier tout d'abord que vous avez désactivé 802.1x (et ne pas oublier de le remettre après pour se connecter à Eduroam !) et utilisez une adresse IP statique, qui sera celle indiquée sur le Wiki d'OpenWRT comme étant ''Bootloader tftp server IPv4 address'' (dans notre cas 192.168.0.66) avec un masque 255.255.255.0. Lancer TFTPD64 et changer ''Current Directory'' pour être le répertoire dans lequel <code>tp_recovery.bin</code> est situé. Cliquez sur ''Show dir'' pour vérifier qu'il fait bien partie de la liste des fichiers présents. Ouvrez l'onglet de ''Log''. C'est assez contre-intuitif mais le serveur est bien mis en route à partir de ce moment, sans avoir besoin d'appuyer sur un bouton supplémentaire.

Maintenez maintenant le bouton reset avec le routeur éteint, et allumez le routeur. Attendez env. 10 secondes en maintenant le bouton reset, ou jusqu'à ce que la LED WPS soit allumée.

Le routeur devrait alors se connecter à votre ordinateur et télécharger le fichier. Le transfert devrait durer quelques secondes (posez-vous des questions au bout de 10min). Vous pouvez vérifier la progression sur l'onglet ''Log''.

Remarque : si vous voulez tester votre serveur avant, connectez un autre ordi au switch, et lancez la commande suivante :

atftp 192.168.0.66
get tp_recovery.bin

Qui devrait retourner sans erreur.

Après le transfert, attendez encore quelques minutes : le routeur installe le nouveau firmware. Il ne faut surtout pas éteindre le routeur à ce moment, au risque de le briquer. À la fin de l'opération, il devrait se redémarrer.

Attention: si les LEDs clignotent périodiquement après le redémarrage, cela signifie que l'installation a échoué et qu'il n'arrive pas à booter. Assurez-vous d'avoir le bon fichier <code>tp_recovery.bin</code> puis recommencez le transfert.

== Hello, OpenWRT world ==

=== Préalables ===

==== Routeur connecté à Internet ====

Heureusement tout n'en pas encore terminé. Une fois le routeur réinitialisé et redemarré, connectez-y vous par câble Ethernet (ou par le Wifi ouvert OpenWRT qui apparait et est une bonne indication que le routeur est effectivement réinitialisé).

Le routeur va avoir besoin d'Internet pour installer des paquets. Activez votre partage de co, et connectez vous depuis votre PC sur la GUI web de OpenWRT (à l'adresse 192.168.1.1).
Connectez-vous alors à votre réseau dans allant dans ''Network'', Scan et sélectionnant le bon Wifi. C'est essentiel d'avoir une bonne connexion, et cela peut être à l'origine de nombreuses erreurs par la suite (de paquets non trouvés par exemple). Vérifiez donc la connexion avec un ping, ou depuis l'onglet Diagnostics de la GUI.

==== Paquet wpa-supplicant installé ====

Connectez-vous par SSH au routeur avec :

ssh root@192.168.1.1

Sur certains modèles, il est nécessaire d'utiliser la commande <code>ssh root@192.168.1.1 -oHostKeyAlgorithms=+ssh-rsa</code>.
Dans un premier temps, mettez à jour les packets :

opkg update

Vous pouvez aussi le faire depuis le web GUI (disponible sur 192.168.1.1 mdp root) System > Software et Run update.

Installer également nano si vous le souhaitez (vim est installé par défaut) :

opkg install nano

On va maintenant installer le paquet qui va s'occuper de nous authentifier au réseau. Il est probable qu'un autre paquet (wpad-basic ou wpad-basic-wolfssl selon les modèles) est préinstallé : il va falloir le désinstaller.

opkg remove wpad-basic
opkg install wpa-supplicant-openssl

Points d'attention:
* c'est '''supplicant''' et pas '''applicant'''
* vous pouvez déterminer quelle saveur de wpad-basic est installé avec la commande <code>opkg list-installed</code>
* depuis l'été 2023, il faut installer wpa-supplicant-openssl et pas wpa-supplicant
* après avoir désinstallé wpad-basic, vous ne pourrez plus vous reconnecter à votre hotspot si vous êtes déconnecté
* si vous avez été déconnecté du hotspot avant de finir la configuration et que vous n'avez plus de connexion à Internet, vous pouvez réinstaller le système depuis le web GUI pour reprendre à la section "Hello, OpenWRT world".

==== Si l'installation échoue pour cause d'espace insufisant ====

Si l'installation de wpa-supplicant-openssl échoue par faute de place, il est possible que votre espace de stockage soit extrêmement faible, de l'ordre de 1 ou 2 Mo.

Vous pouvez vérifier l'espace de stockage avec la commande :

df -h

Il faut ensuite regarder le volume overlayfs.
En octobre 2023, une installation complète a pu être faite sur un routeur avec 1.75 Mo d'espace sur overlayfs, modulo quelques changements :
* réinitialiser le routeur depuis le web GUI pour reprendre à la section "Hello, OpenWRT world". (l'installation avortée de wpa-supplicant-openssl laisse de lourds artéfacts qui ne sont pas nettoyés par opkg) ;
* utiliser le paquet wpa-supplicant-wolfssl au lieu de wpa-supplicant-openssl. En effet ce dernier est moins lourd : environ 1 Mo dépendances comprises contre plus de 2 Mo pour le paquet avec openssl ;
* utiliser le paquet hostapd-mini au lieu de hostapd lors de la mise en place du Wifi.

À noter que le volume tmpfs est un volume virtuel qui vit sur de la RAM. Cet espace est donc vidé à chaque redémarrage et il n'est donc pas possible d'installer les paquets à cet endroit.

=== Configuration d'Ethernet ===

Ensuite configurez votre connexion en éditant :

nano /etc/config/wpa.conf

Et en insérant le texte suivant :

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=2
ap_scan=0
network={
key_mgmt=IEEE8021X
eap=TTLS
identity="prénom.nom@polytechnique.fr"
anonymous_identity="anonymous@polytechnique.fr"
password="monpassword"
phase1="auth=TTLS"
phase2="auth=PAP password=monpassword"
eapol_flags=0
}

En remplaçant les occurrences de <code>prénom.nom</code> et <code>monpassword</code> (attention il apparaît deux fois) en conséquence.

On va maintenant tenter de se connecter.

wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf

Si cela échoue,
* Regardez avec <code>ifconfig</code> quel port il vaut mieux utiliser, c'est peut-être eth1 chez vous.
* Vérifiez vos identifiants de connexion en cas d'erreur de certificat
* Vérifiez que la date du système n'est pas aberrante (une différence de quelques heures est OK)
* Vérifiez que vous avez bien installé <code>wpa-supplicant-openssl</code> et pas <code>wpa-supplicant</code>

Si la commande précédente donne CTRL-EVENT-CONNECTED, c'est bon vous pouvez continuer.

=== Configuration du démarrage automatique ===

On va maintenant changer un autre fichier pour configurer le démarrage auto :

nano /etc/init.d/wpa

avec le contenu :

#!/bin/sh /etc/rc.common
# Copyright (C) 2007 OpenWrt.org
START=99
start() { echo start wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf & }

Changez la dernière ligne en fonction de la commande qui a fonctionné pour vous à l'étape précédente (en particulier le eth0.2)

Rendre si besoin le fichier executable avec <code>chmod +x /etc/init.d/wpa</code>

Activation du démarrage auto :

/etc/init.d/wpa start

Si retourne sans erreur : OK

Puis:

/etc/init.d/wpa enable

En faisant Ctrl+C si besoin.

=== Paquet Hostapd ===

Installer maintenant le paquet hostapd, qui sera indispensable pour pouvoir sécuriser votre réseau avec un mot de passe.

Depuis un terminal en ssh, doit être :

opkg update
opkg install hostapd

Alternativement, vous pouvez utiliser le web GUI:
* Aller dans System > Software
* Run Update
* Filter: rechercher hostapd
* Install
* Dismiss

=== Config wifi ===

On va maintenant créer une nouvelle configuration Wifi :

uci set wireless.@wifi-device[0].disabled=0
uci set wireless.@wifi-iface[0].ssid='NOM_DU_WIFI'
uci set wireless.@wifi-iface[0].encryption='psk2'
uci set wireless.@wifi-iface[0].key='MOT-DE-PASSE'
uci set wireless.@wifi-device[0].country='FR'
uci commit wireless; wifi

En changeant <code>NOM_DU_WIFI</code> et <code>MOT-DE-PASSE</code> en conséquence.

Redémarrer :

reboot

Vous devriez maintenant avoir un réseau Wifi fonctionnel, émis par votre routeur, auquel vous pouvez vous connecter !

=== Si ne fonctionne pas et que wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf renvoie bien CTRL-EVENT-CONNECTED ===

Lancer <code>wpa_supplicant -D wired -i eth0.2 -c /etc/config/wpa.conf -B</code>, et depuis l'interface graphique, restart eth0.