Lea Linux - Contributions [fr]

Souris Logitech MediaPlay

2007-06-20T11:53:29Z

Manu : /* Conclusion */

[[Catégorie:Configurer votre matériel]]
[[Catégorie:Paramétrer X Window]]
= Configuration de la souris Logitech MediaPlay =

== Introduction ==
Voici comment configurer les boutons multimédia de la souris '''Logitech MediaPlay'''. Ce document se base sur la distribution [http://www.kubuntu.org/ Kubuntu 6.10 Edy Eft] et un kernel 2.6.17.

Ce n'est pas bien long ni bien compliqué, les étapes sont :
* Installer le module lmpcm_usb
* Modifier l'ordre de chargement des modules
* Modifier la configuration du serveur X
* Redémarrer le PC
* Configurer les boutons à l'aide d'un script à exécuter au démarrage

== Installer le module lmpcm_usb ==
Ce n'est sûrement pas toutes les souris multimédia qui sont bien reconnue sous Linux, mais heureusement quelqu'un a codé un pilote pour gérer la souris MediaPlay de Logitech. On peux dire merci à David Oliveira pour son travail!

Téléchargez le module [http://daemon.prozone.org/~david/projects/lmpcm_usb/ "lmpcm_usb" de David Oliveira]. Ensuite, le décompresser, le compiler et l'installer. À la commande ''sudo'', entrez votre mot de pase. Évidemment, changez le nom du fichier au besoin :

<code multi>
$ tar zxvf lmpcm_usb-0.5.5.tar.gz
$ cd lmpcm_usb-0.5.5
$ make
$ sudo make install
</code>

Selon votre distribution, au lieu d'utiliser ''sudo'' vous pouvez aussi changer d'utilisateur pour devenir ''root'' avec la commande ''su'' :

<code multi>
$ su
Password:
# make install
# exit
</code>

Dans la version 0.5.5 la commande ''depmod'' est en commentaire dans le fichier Makefile, probablement une erreur du développeur. Vous devez donc la tapper manuellement :
<code>$ sudo depmod -A</code>

Maintenant, chargez le module pour voir s'il est bien compilé et qu'il se charge sans problème :
<code>$ sudo modprobe lmpcm_usb</code>

Pour voir s'il est bien chargé :
<code multi>
$ lsmod | grep lmpcm
lmpcm_usb 7680 0
usbcore 134912 5 usbhid,lmpcm_usb,ehci_hcd,ohci_hcd

$ dmesg | grep MediaPlay
[17179595.036000] /home/alain/src/lmpcm_usb-0.5.5/lmpcm_usb.c: v0.5.5:USB Logitech MediaPlay Cordless Mouse driver
</code>

== Modifier l'ordre de chargement des modules ==
Pour que le module lmpcm_usb soit utilisé pour gérer la souris MediaPlay, il faut qu'il soit chargé avant les modules usbmouse et usbhid. Dans la documentation de lmpcm_usb on demande d'enlever les modules usbmouse et usbhid. Le problème est qu'on peut en avoir besoin pour d'autres périphériques, par exemple le clavier Logitech G15 a besoin du module usbhid.

Pour que le module lmpcm_usb soit chargé en premier, il faut modifier le fichier '''modules.dep''' pour rendre usbmouse et usbhid dépendant de lmpcm_usb, ce qui oblige lmpcm_usb à être chargé en premier. Ici on utilise l'éditeur graphique ''kate'' ou l'éditeur texte ''emacs''. Utilisez l'éditeur de votre choix. Dans ''kate'', décochez l'option ''Retour à la ligne dynamique'' du menu ''Affichage'' pour plus de facilité. Vous devez modifier le fichier correspondant à la version de votre kernel, ici le 2.6.17-11.

<code>kdesu kate /lib/modules/2.6.17-11-generic/modules.dep</code>
ou
<code>sudo emacs /lib/modules/2.6.17-11-generic/modules.dep</code>

Repérez la ligne correspondant à lmpcm_usb :
<code>/lib/modules/2.6.17-11-generic/misc/lmpcm_usb.ko: /lib/modules/2.6.17-11-generic/kernel/drivers/usb/core/usbcore.ko</code>
et ajoutez-la aux modules ''usbhid'' et ''usbmouse'' (entre le ":" et le module usbcore) .

; Avant :
<code multi>
/lib/modules/2.6.17-11-generic/kernel/drivers/usb/input/usbmouse.ko: /lib/modules/2.6.17-11-generic/kernel/drivers/usb/core/usbcore.ko
/lib/modules/2.6.17-11-generic/kernel/drivers/usb/input/usbhid.ko: /lib/modules/2.6.17-11-generic/kernel/drivers/usb/core/usbcore.ko
</code>

; Après :
<code multi>
/lib/modules/2.6.17-11-generic/kernel/drivers/usb/input/usbmouse.ko: /lib/modules/2.6.17-11-generic/misc/lmpcm_usb.ko /lib/modules/2.6.17-11-generic/kernel/drivers/usb/core/usbcore.ko
/lib/modules/2.6.17-11-generic/kernel/drivers/usb/input/usbhid.ko: /lib/modules/2.6.17-11-generic/misc/lmpcm_usb.ko /lib/modules/2.6.17-11-generic/kernel/drivers/usb/core/usbcore.ko
</code>

== Configuration du serveur X ==
Pour que le serveur X puisse utiliser les boutons multimédia, on doit d'abord changer la configuration de la souris.
Faites une copie de sauvegarde de votre fichier xorg.conf au cas où ça tournerait mal :
<code multi>
$ cd /etc/X11
$ sudo cp xorg.conf xorg.conf.backup
$ kdesu kate xorg.conf
</code>

Ajoutez les options suivantes :

; Avant :
<code multi>
Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
option "CorePointer"
option "Device" "/dev/input/mice"
option "Protocol" "ExplorerPS/2"
option "ZAxisMapping" "4 5"
option "Emulate3Buttons" "true"
EndSection

Section "ServerLayout"
...
InputDevice "Configured Mouse"
...
EndSection
</code>

; Après :
<code multi>
Section "InputDevice"
Identifier "LMPCM"
Driver "mouse"
option "CorePointer"
option "Device" "/dev/input/mice"
option "Protocol" "ExplorerPS/2"
option "ZAxisMapping" "4 5 6 7"
Option "Buttons" "9"
Option "Name" "MediaPlay"
Option "Vendor" "Logitech"
EndSection

Section "ServerLayout"
...
InputDevice "LMPCM"
...
EndSection
</code>

== Redémarrer ==
À ce point-ci, un redémarrage de la machine est nécéssaire. Il faut que les modules soient chargés dans le bon ordre (changé précédemment dans le fichier '''modules.dep''') et le serveur X doit être redémarré pour que les nouveaux paramètres soient prit en compte (changé précédemment dans le fichier '''xorg.conf''').

On pourrait tenter de décharger les modules à la main avec ''rmmod'' et les recharger avec ''modprobe'' dans le bon ordre, mais on risquerait de se retrouver sans clavier opérationnel si on possède un clavier USB. Il faudrait ensuite fermer notre session et redémarrer le serveur X. Un redémarrage est beaucoup plus simple et va nous confirmer que tout est bien configuré.

Si par malheur vous avez fait une erreur et que ça ne démarre plus, choisissez l'option '''rescue mode''' dans le menu de Grub (menu apparaîssant au boot). Si ça ne marche pas non plus, bootez avec le CD de Kubuntu, ou tout autre ''Live CD''. Ça va vous permettre de faire les changements nécéssaires aux fichiers de configuration.

== Configuration des boutons ==
Pour bien configurer la souris il faut savoir que certains boutons de la souris sont perçu comme étant des boutons normaux de souris, alors que d'autres sont perçu comme des touches de clavier. Ce qui permet de leur assigner facilement une fonctions dans KDE ou Gnome.

<cadre type=note>
'''Numéros des boutons de souris'''
{| border="0" width="300"
|Bouton de gauche || align="right" | 1
|-
|Clic de la molette || align="right" | 2
|-
|Bouton de droite || align="right" | 3
|-
|Molette vers le haut || align="right" | 6
|-
|Molette vers le bas || align="right" | 7
|-
|Bouton bleu précédant || align="right" | 8
|-
|Bouton bleu suivant || align="right" | 9
|}

'''Codes des touches de clavier'''
{| border ="0" width="300"
|Molette vers la droite || align="right" | 233
|-
|Molette vers la gauche || align="right" | 234
|-
|Media || align="right" | 168
|-
|Play / pause || align="right" | 162
|-
|Piste suivante || align="right" | 153
|-
|Piste précédante || align="right" | 144
|-
|Volume + || align="right" | 176
|-
|Volume - || align="right" | 174
|}
</cadre>

Il faut maintenant dire au serveur X d'utiliser tout ces beaux boutons! En plus du fichier xorg.conf, il faut exécuter un script pour faire connaître les nouveaux boutons qui sont perçu comme des touches de clavier grâce à leur ''keycode''.

À ce point-ci les boutons devraient être reconnus par le kernel. Pour connaître les ''keycodes'' et pour être certains qu'ils sont bien reconnu on peut exécuter xev et voir quel code est associé à quel bouton en appuyant sur chacun d'eux :
<code multi>
$ xev
...
KeyRelease event, serial 31, synthetic NO, window 0x2e00001,
root 0x75, subw 0x0, time 4143197446, (76,59), root:(79,853),
state 0x10, keycode 176 (keysym 0x1008ff13, XF86AudioRaiseVolume), same_screen YES,
XLookupString gives 0 bytes:
XFilterEvent returns: False

KeyRelease event, serial 31, synthetic NO, window 0x2e00001,
root 0x75, subw 0x0, time 4143199326, (76,59), root:(79,853),
state 0x10, keycode 168 (keysym 0x1008ff32, XF86AudioMedia), same_screen YES,
XLookupString gives 0 bytes:
XFilterEvent returns: False
...
</code>

Pour que le serveur X reconnaisse les nouveaux boutons, il faut exécuter '''xmodmap'''. Pour ne pas avoir à l'exécuter à la main à chaque redémarrage, nous allons faire un petit script.

Fichier '''.Xmodmap''' à placer dans votre répertoire ''home'' : '''~/''' ou '''/home/votre_usager/''' :
<code multi>
keycode 234 = XF86Back
keycode 233 = XF86Forward
keycode 174 = XF86AudioLowerVolume
keycode 176 = XF86AudioRaiseVolume
keycode 162 = XF86AudioPlay
keycode 144 = XF86AudioPrev
keycode 153 = XF86AudioNext
keycode 168 = XF86AudioMedia
pointer = 1 2 3 4 5 8 9 6 7
</code>

Fichier '''mediaplay.sh''' à placer dans le répertoire '''~/.kde/Autostart''' :
<code multi>
xmodmap ~/.Xmodmap
</code>

Rendez le exécutable : <code>chmod +x ~/.kde/Autostart/mediaplay.sh</code>
et exécutez-le : <code>~/.kde/Autostart/mediaplay.sh</code>
Vous pouvez aussi terminer votre session et vous reconnecter pour vous assurer qu'il est bien exécuté automatiquement.

== Conclusion ==
Ben voilà, c'était pas si compliqué, juste un peu chiant ! Ça devrait être le job de Logitech de se taper tout ce trouble, mais bon, faut pas trop rêver ! Une chance qu'il y ait Léa ! ;-)

{{Copy|2007|[[Utilisateur:Meloman|Meloman]] (Alain Rivest)|CC-BY-SA}}

Point d'accès sécurisé par hostAPd

2006-05-05T08:06:22Z

Manu : /* Activation */

= Introduction =
[[Catégorie:Administration réseau]][[Catégorie:Réseau]][[Catégorie:Réseau local]]
Ce n'est pas vraiment un tutoriel, mais plutôt un retour d'expérience. Mais finalement c'est ce que sont tous les tutoriels. Je tiens simplement à vous prévenir qu'avant ce week-end, je n'avais jamais installé de matériels Wi-fi. Je ne suis donc pas un expert, mais j'ai appris un certain nombre de choses qui pourront être utiles.

= Présentation =
== But recherché ==
Tout d'abord, il convient de préciser ce que je voulais faire, en plus de « installer le wifi chez moi ». Pour ne pas verser dans l'étalage de vie privée, voici ce dont je disposais :
* Une freebox basique (sans fonctions routeur ni wifi).
* Un PC (passerelle pour le reste du document) connecté directement à la freebox sous Debian/testing. Elle dispose de deux cartes réseau Ethernet RJ45 (filaire) qui sont identifiées par l'OS en tant que eth_adsl et eth_local. La freebox est reliée sur eth_adsl. Un firewall tourne entre eth_adsl et eth_local à l'aide d'iptables.
* Un switch branché sur eth_local, et sur lequel sont reliés deux clients de manière on ne peut plus classique.
* Une carte Wi-Fi D-Link DWL-G520 PCI avec chipset Atheros (le chipset importe beaucoup plus que la carte, croyez moi !!).
* Un ordinateur portable Asus A7D, avec une carte Ethernet et une carte Wi-fi avec un chipset Broadcom 4318 (là encore, il a fallu le trouver...)

TODO : schéma

Le but est donc pour moi de faire que le portable puisse se brancher en Wi-fi sur le réseau local, exactement comme les autres clients. Je ne voulais pas me taper des règles firewall en plus, alors j'ai opté pour le bridge.

== Prérequis ==
Voici les connaissances ou le matériel que je considère comme requis :
* La passerelle tourne sous Debian.
* La passerelle dispose d'un serveur DHCP fonctionnel pour le réseau local.
* Les commandes tapées sur la passerelle sont à faire en tant que root. Vous devez donc avoir le mot de passe administrateur de cette machine.
* Avoir quelques connaissances requises, au moins sur le vocabulaire d'un réseau local.
* Pour le Wi-fi et son vocabulaire, vous pouvez aller voir [[hardware-hard_net-wifi|par là]]
* Un pot de rillettes et du bon pain. Les musulmans sont bien évidemment invités à choisir une mousse de canard ou des tranches de dinde.

= Le bridge, invention magique =
== Présentation du bridge ==
Le bridge (pont en anglais) permet de faire une chose miraculeuse : réunir de manière transparente plusieurs cartes réseaux, en une seule virtuelle. Il y a quelques inconvénients, notamment sur le fait que le démarrage est un peu plus lent, le temps que le bridge se fasse, et que c'est un peu compliqué pour la tête. Mais je voulais vraiment que le portable se connecte en Wi-fi en changeant le minimum de choses sur la passerelle.

== Installation ==
Pour cela, il est donc nécessaire d'avoir un noyau compilés avec les bonnes options. Pour l'utilisateur normal qui n'a pas recompilé son noyau, ne chercher pas, c'est bon, ça ira :) Pour les autres, trouvez comment activer le bridging dans le noyau, je ne sais pas comment on fait :p
Ensuite, il faut installer les utilitaires nécessaires :

<code>apt-get install bridge-utils
</code>

Pour les autres systèmes ça doit être dans le même style.
Il faut donc créer ce bridge. Sachez d'abord que tout sera géré par ce futur bridge. Cela veut donc dire que vous ne parlerez plus directement à vos interfaces (ici eth_local et ath0), mais directement à bridge_local (j'aime bien les noms explicites :) ). Cela implique donc que vous n'avez RIEN à configurer sur les cartes réseaux qui vont être incluses dans ce bridge, et même mieux : il faut enlever ce qui est propre à la configuration de ces cartes.
Chez Debian, tout se passe dans /etc/network/interfaces ce qui est plutôt pratique. Voici donc le fichier AVANT l'installation du bridge :

<code># This file describes the network interfaces available on your system

# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

auto eth_local
iface eth_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
</code>

La carte eth_adsl est donc initialisée au démarrage (ligne auto eth_adsl), a une adresse IPv4 (inet) et ses paramètres réseaux lui sont attribués automatiquement (dhcp), en l'occurence par la Freebox.
De même, la carte eth_local est initialisée au démarrage, mais ses paramètres réseaux sont fixés par moi (static), avec les paramètres spécifiés en dessous. Je pense que c'est assez clair.

Après l'installation du bridge, voici ce que j'ai :

<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

iface ath0 inet static
wireless-mode master
wireless-channel 9

auto bridge_local
iface bridge_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
bridge_ports eth_local ath0
</code>

La partie eth_adsl n'a pas changé : c'est normal :) Par contre, on voit que bridge_local a les même paramètres que mon ex-carte eth_local. Sauf que en plus, on lui dit que c'est un bridge qui contient les cartes eth_local et ath0. Ainsi, dès que j'envoie des paquets depuis la passerelle sur l'adresse 192.168.0.254, ceux-ci seront transmis automatiquement aux deux cartes, et réciproquement, lorsqu'une carte reçoit un paquet pour 192.168.0.254, elle le transmet au bridge. Moi, je trouve ça magique :)
Il y a également une partie sur ath0 me direz-vous. Oui d'accord, mais elle n'est là que pour régler certains paramètres propres au Wi-fi, rien de plus ! Vous remarquerez qu'il n'y a pas de ligne auto ath0, donc elle n'est pas initialisée au démarrage.

== Activation ==
Ceci étant fait, il y a plusieurs méthodes pour activer ce bridge. Sachez que dans la plupart des cas, ceci va foutre en l'air la connexion ! C'est ce qui m'est arrivé, ça fait un peu tout drôle. Normalement, l'ADSL reste en place, mais ce n'est pas le cas de la connexion sur eth_local.

Soit vous faites :<code>/etc/init.d/networking/force-reload
</code>

Soit :<code>/etc/init.d/networking/stop && /etc/init.d/networking/start
</code>

Soit carrément un bon vieux reboot :
reboot
Je sais pas pourquoi je mets la commande... On sait jamais :p
Enfin, après l'une de ses trois méthodes (voire les trois), en tapant

<code>ifconfig
</code>

Vous devriez voir ça :
<code>ath0 Lien encap:Ethernet HWaddr 00:15:E9:3F:AA:90
adr inet6: fe80::215:e9ff:fe3f:aa90/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:2290 Metric:1
RX packets:163080 errors:955516 dropped:0 overruns:0 frame:955509
TX packets:315546 errors:613 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:200
RX bytes:13726343 (13.0 MiB) TX bytes:462013643 (440.6 MiB)
Interruption:185 Mémoire:e08e0000-e08f0000

bridge_lo Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
inet adr:192.168.0.254 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:294178 errors:0 dropped:0 overruns:0 frame:0
TX packets:454533 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:458148569 (436.9 MiB) TX bytes:541885943 (516.7 MiB)

eth_adsl Lien encap:Ethernet HWaddr 00:11:D8:09:6D:31
inet adr:xx.xx.xx.xx Bcast:xx.xx.xx.xx Masque:255.255.255.0
adr inet6: fe80::211:d8ff:fe09:6d31/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:279243 errors:0 dropped:0 overruns:0 frame:0
TX packets:264750 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:189704796 (180.9 MiB) TX bytes:66643253 (63.5 MiB)
Interruption:177 Adresse de base:0xb000

eth_local Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:403023 errors:0 dropped:0 overruns:0 frame:0
TX packets:142751 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:460239899 (438.9 MiB) TX bytes:80409812 (76.6 MiB)
Interruption:169 Adresse de base:0xd800

lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:38438 errors:0 dropped:0 overruns:0 frame:0
TX packets:38438 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:3297781 (3.1 MiB) TX bytes:3297781 (3.1 MiB)
</code>

On constate donc que eth_local et ath0 n'ont aucune adresse IPv4 (inet adr) et que bridge_local a bien l'adresse 192.168.0.254. Quant à eth_adsl, pour les xx, c'est moi qui les ai mis : j'ai une IP fixe, je tiens à garder ma vie privée :)

Avant de passer à la prochaine étape, je vous conseille de suivre la procédure suivante :
* Découper une tranche de pain.
* La tartiner abondamment de rillettes (ou de mousse de canard :) ).
* La savourer délicatement.
Cela permet, en plus de reposer vos mains meurtries par ces infâmes périphériques de saisie, de soulager les cris blafards de votre estomac. Vous pourrez alors apprécier à leur juste valeur les hormones de bien-être sécrétées par une digestion bien méritée :)

= Créer le point d'accès =
== Présentation de hostAPd ==
Étape suivante : transformer une simple carte Wi-fi en puissant point d'accès (accesss point en anglais soit AP). Pour cela, après avoir parcouru rapidement le web, une solution s'est imposée : hostAPd disponible sur [http://hostap.epitest.fi/hostapd/ cette page]
Attention, il faut différencier les 3 projets du site : hostAP driver, hostAPd et wpa_supplicant. hostAP driver ne m'intéressait pas : c'est l'implémentation libre d'un driver pour carte Wi-fi. Wpa_supplicant est un client WPA, comme on va le voir par la suite. Et hostAPd est le logiciel capable de faire tourner votre carte Wi-fi « de base » en point d'accès genre « Enterprise » :)

== Installation ==
Là, j'ai été confronté à l'instabilité de Debian/testing... En effet, les binaires hostAPd sont présents mais pas compilés avec les bonnes options pour madwifi, et les sources sont celles de la version 0.5.0 pleines de bugs corrigés depuis. J'ai perdu un temps monstre sur ça, que je vais vous épargner ici :) Mais du coup le moment est bien choisi pour aborder la compilation « à la mimine ».

Pour cela, il faut d'abord installer quelques outils, dont le fameux gcc. Sous Debian (et là ça marche bien :p ) :

<code>apt-get install build-essential gcc
</code>

Je pense que seul gcc est nécessaire dans notre cas, mais bon on sait jamais, ça pourra servir :). Ensuite, on va avoir besoin des sources de hostAPd (normal). Ce qui m'intéressait étant aussi de faire fonctionner hostAPd avec madwifi, il me fallait également les sources de madwifi. On fait donc un petit

<code>apt-get install madwifi-source
</code>

Et un téléchargement de hostAPd dans le répertoire /usr/src/, classique pour toute compilation standard. Il faut maintenant extraire les fichiers :

<code>tar xvfj madwifi.tar.bz2
tar xvfz hostapd-0.5.2.tar.gz</code>

Vous avez donc remarqué qu'à cette heure, la version en cours de hostAPd est la 0.5.2 ;) Rendez-vous dans le répertoire hostapd-0.5.2/ créé lors de l'extraction. Vous pouvez lire le README, c'est en anglais, mais ça peut faire du bien de temps à autre. L'essentiel à comprendre est qu'il faut créer un fichier .config lui disant quoi mettre lors de la compilation. Heureusement, un listing des options est présent. Faites donc :

<code>cp defconfig .config
</code>
Et éditez ce fichier .config. Voilà à quoi ressemble le mien :

<code># Driver interface for Host AP driver
#CONFIG_DRIVER_HOSTAP=y

# Driver interface for wired authenticator
#CONFIG_DRIVER_WIRED=y

# Driver interface for madwifi driver
CONFIG_DRIVER_MADWIFI=y
CFLAGS += -I../modules/madwifi/ # change to reflect local setup; directory for madwifi src

# Driver interface for Prism54 driver
#CONFIG_DRIVER_PRISM54=y

# Driver interface for drivers using Devicescape IEEE 802.11 stack
#CONFIG_DRIVER_DEVICESCAPE=y

# Driver interface for FreeBSD net80211 layer (e.g., Atheros driver)
#CONFIG_DRIVER_BSD=y
#CFLAGS += -I/usr/local/include
#LIBS += -L/usr/local/lib

# IEEE 802.11F/IAPP
#CONFIG_IAPP=y

# WPA2/IEEE 802.11i RSN pre-authentication
#CONFIG_RSN_PREAUTH=y

# IEEE 802.11i/IEEE 802.11e STAKey negotiation for direct link connection
#CONFIG_STAKEY=y

# Integrated EAP server
CONFIG_EAP=y

# EAP-MD5 for the integrated EAP server
#CONFIG_EAP_MD5=y

# EAP-TLS for the integrated EAP server
CONFIG_EAP_TLS=y
</code>

Tout le reste est commenté, j'en ai rien à faire, je n'ai besoin que du WPA avec un driver madwifi. Pour les plus curieux, j'ai dû laisser CONFIG_EAP et CONFIG_EAP_TLS, parce que sinon ça plantait, ce sera visiblement corrigé dans la version 0.5.3. Remarquez aussi la ligne pour madwifi : CFLAGS contient le chemin vers les sources de madwifi, fraîchement décompressé dans le répertoire /usr/src/modules/madwifi/. Sauvegardez et quittez.
C'est parti pour l'instant geek crucial :

<code>make
</code>

Simple non ? Moi ça me déroute parfois tout ce qu'il peut écrire avec aussi peu de lettres tapées :) Si tout se passe bien, il n'affiche aucune ligne trop inquiétante remplie d'étoiles et de mot ERROR. Sinon, ben euh, posez vos questions après le bip.

Maintenant que c'est compilé, faut l'installer. En gros, la plupart du temps, ça consiste en un simple copier/coller des fichiers compilés. Rassurez-vous la procédure standard est on ne peut plus explicite :

<code>make install
</code>

Et pouf. Comme c'est indiqué, les exécutables sont installés dans /usr/local/bin par défaut. C'est très bien là où c'est :)

== Configuration de hostAPd ==
Prochaine étape : la configuration de hostAPd. Je vous propose une astuce pour pas trop se casser la tête : installer le paquet Debian de hostAPd, qui, même s'il est défectueux, installe les fichiers par défaut au bon endroit pour vous. Il n'y aura plus qu'à faire quelques retouches. C'est parti :

<code>apt-get install hostapd
</code>
Si jamais vous voulez retirer les exécutables (présent dans /sbin ou /usr/sbin pour le paquet Debian) pour éviter de s'emmêler les pinceaux :

<code>apt-get remove hostapd
</code>
Et normalement les fichier de configuration sont restés là :) À savoir :
* ''/etc/default/hostapd'' - Permet d'activer ou de désactiver le lancement automatique de hostAPd
* ''/etc/hostapd/hostapd.conf'' - Fichier de configuration de hostAPd
* ''/etc/init.d/hostapd'' - Script shell gérant l'exécution et l'arrêt de hostAPd en tant que démon.
On va d'abord éditer le script afin de lancer le bon programme. Dans votre éditeur de texte chercher la ligne suivante :

<code>DAEMON=/usr/sbin/hostapd
</code>
Chez moi, c'est la douzième. Remplacez la par :

<code>DAEMON=/usr/local/bin/hostapd
</code>
Ensuite, on va aller configurer hostAPd. Le plus dur est de lire tous les commentaires en fait :) Mais pour aller un peu plus vite, voici les lignes qui servent dans MON cas (simple WPA-PSK) :
<code>#La carte Wifi, forcément indispensable :)
interface=ath0

#Si la carte est bridgée et utilise madwifi, il faut préciser le nom du bridge
bridge=bridge_local

# Le driver nécessité par la carte
driver=madwifi

#Options de log par défaut, elles sont très bien :)
logger_syslog=-1
logger_syslog_level=1
logger_stdout=-1
logger_stdout_level=2

debug=2

dump_file=/tmp/hostapd.dump

#Contrôle du programme, encore une fois, le réglage par défaut est nickel :)
ctrl_interface=/var/run/hostapd

ctrl_interface_group=0

#Le nom de votre réseau. C'est important. Choisissez un nom à peu près reconnaissable et pas trop long.
ssid=MADOUIFI

#Comment gérer les adresses MAC (adresse Hardware des cartes réseaux)
# C'est une sécurité qui peut facilement être contournée, mais est
# néanmoins pratique, car elle est facile à mettre en place
# En effet, hostAPd va vérifier l'adresse MAC de la carte Wifi qui fait une
# demande d'accès et pourra alors, sur cette seule adresse, soit continuer le
# processus d'identification, soit s'arrêter et refuser la carte.
# Les paramètres possibles sont les suivants :
# 0 : Tout accepter à moins qu'elle ne soit dans la liste noire
# 1 : Tout refuser, à moins qu'elle ne soit dans la liste blanche
# 2 : Vérifier l'adresse auprès d'un serveur RADIUS (honnêtement, pour son réseau local, ça ne sert à rien)
# Le meilleur paramètre pour commencer est 1. Ça réduit de beaucoup les risques de piratage.
macaddr_acl=1

#Chemin des fichiers pour les listes noire et blanche
# Je vous conseille de les créer tout de suite, on verra plus tard pour les remplir correctement
accept_mac_file=/etc/hostapd/hostapd.accept
deny_mac_file=/etc/hostapd/hostapd.deny

# La description anglaise pour les curieux :)
auth_algs=1

#Celui là, je sais pas trop... Je crois qu'on peut l'enlever, mais bon je suis pas sûr, j'ai pas testé :)
eap_server=0

#Dis qu'on veut faire du WPA-PSK
wpa=1

# Votre clé, le coeur de la sécurité du WPA-PSK :)
wpa_passphrase=SupèRecléDelAmor,Avecdetrucch3l0us;)

# Pour un petit peu plus de sécurité, vous pouvez attribuer une clé WPA par adresse MAC (donc par ordinateur).
#C'est quand même un peu plus embêtant à maintenir...
#wpa_psk_file=/etc/hostapd/wpa_psk

# On définit ce qu'on veut comme WPA
wpa_key_mgmt=WPA-PSK

# Et l'algo de cryptage
wpa_pairwise=TKIP

# Quelques options temporelles. Pas forcément nécessaire pour que ça marche :)
wpa_group_rekey=600

wpa_gmk_rekey=86400
</code>

Et la touche finale. Éditez le fichier /etc/default/hostapd et décommentez la ligne suivante :

<code>RUN_DAEMON=yes
</code>
Et voilà. C'est fini. Enfin, non, ce n'est pas tout à fait exact. La configuration du serveur est finie. Il reste à la tester et à configurer des clients :) En avant toute !

== Première validation du point d'accès ==
Premier test. Normalement, la commande suivante :

<code>/etc/init.d/hostapd start
</code>

devrait donner un résultat positif. Faites ensuite

<code>/etc/init.d/hostapd stop
hostapd -dd /etc/hostapd/hostapd.conf</code>

Cela lance le programme en avant plan en mode débug, idéal pour vérifier que tout marche bien. Ne vous inquiétez pas trop de ce qu'il dit, tant qu'il ne vous redonne pas la main, c'est bon signe :) En général, il dit qu'il se met en attente. Pendant qu'il se lance, n'hésitez pas à attaquer encore le pot de rillettes ou de canard qui commence à se barrer en douce.

= Configurer le client =
La dernière étape, c'est de configurer son client.
== Sous Ubuntu ... ==
Ceci s'applique à une Ubuntu Breezy Badger fraîchement installée. La carte Wifi doit déjà être détectée.

TODO : lier vers une page d'install ou en faire une :)

Je vais appeler la carte Wi-fi wlan0. La méthode suivante va donner beaucoup plus d'importance à la carte Wi-fi qu'à la carte Ethernet. Je dois avouer que je n'ai pas réussi à faire marcher le gestionnaire de réseau sous Gnome, donc j'y suis allé ''comme un geek''.
<cadre type=alert>Cette solution n'est donc pas optimale si vous utilisez aussi fréquemment la carte filaire que la carte sans-fil. Cependant, ceci risque de devenir obsolète dans la version suivante de Ubuntu qui devrait intégrer Network-Manager, qui fait du beau travail à en croire les captures d'écrans :)</cadre>

=== Configuration des interfaces ===
Tout d'abord, on va un peu épurer le fichier de configuration automatique des interfaces.
<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
iface eth0 inet dhcp

auto wlan0
iface wlan0 inet dhcp
pre-up /etc/init.d/wpasupplicant start
wireless-mode Managed
wireless-essid "MADOUIFI"
wireless-key "SupèRecléDelAmor,Avecdetrucch3l0us;)"
pre-down /etc/init.d/wpasupplicant stop
</code>
Maintenant que vous êtes un baroudeur de ce fichier vous avez dû remarquer les choses suivantes :
* eth0 n'est plus confiée à hotplug : celui-ci à la facheuse tendance de lui faire prendre le dessus sur wlan0, ça m'énervait :)
* On laisse tout de même eth0 en mode DHCP, mais plus en initialisation automatique (C'est là que je dis que ça favorise plutôt la carte Wi-fi).
* Les lignes pre-up et pre-down vont démarrer quelque chose encore inconnu et sûrement non installé. Mais gardez patience, sinon on ne va pas y arriver :)
* Les lignes wireless- servent à configurer la carte Wi-fi. Je ne crois pas que ce soit utile, car wpasupplicant devrais s'en charger, mais bon. C'est là l'une des marques de mes lacunes ;)

=== Installation et utilisation de wpasupplicant ===
Si vous vous en souvenez, wpasupplicant est un des projets développés en même temps que hostAPd. Ça tombe plutôt bien :). Wpasupplicant est un client WPA permettant de faire marcher quasiment n'importe quelle carte Wi-fi sur un réseau protégé en WPA.

On commence donc par télécharger le paquet Ubuntu :

<code>sudo apt-get install wpasupplicant
</code>

Ensuite, on va éditez son fichier de configuration pour qu'il convienne à notre réseau. Ce fichier s'appelle /etc/wpa_supplicant.conf :

<code># Faites zless /usr/share/doc/wpasupplicant/wpa_supplicant.conf.gz pour voir toutes les otptions disponibles

# Ne rien changer ici
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0

eapol_version=1
ap_scan=1
fast_reauth=1

# Déclaration et paramétrage d'un réseau
network={
# Le même SSID du point d'accès
ssid="MADOUIFI"
key_mgmt=WPA-PSK
psk="SupèRecléDelAmor,Avecdetrucch3l0us;)"
}
</code>

Et on redémarre le réseau à l'aide de la commande :

<code>sudo /etc/init.d/networking restart
</code>

Ensuite, il suffit d'attendre un certain moment, le temps que l'authentification se fasse et que le serveur DHCP réagisse. Normalement, en tapant /sbin/ifconfig vous devriez obtenir ceci :
<code>lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:142349 errors:0 dropped:0 overruns:0 frame:0
TX packets:142349 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:10530324 (10.0 MiB) TX bytes:10530324 (10.0 MiB)

wlan0 Lien encap:Ethernet HWaddr 00:15:F2:CC:F4:39
inet adr:192.168.0.3 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::215:f2ff:fecc:f439/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:90878 errors:0 dropped:0 overruns:0 frame:0
TX packets:60354 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:98143829 (93.5 MiB) TX bytes:5812510 (5.5 MiB)
Mémoire:fe3fc000-fe3fdfff
</code>
La carte wlan0 avec l'état ''UP'' et une adresse IP (''inet adr'').

=== Pistes en cas de problèmes ===
* Lancer hostAPd à la main en mode debug avec la commande
<code>/usr/local/bin/hostapd -dd /etc/hostapd/hostapd.conf
</code>Puis relancez le client. Le journal qui s'affiche peut aider grandement le diagnostic.
* Vérifier que votre serveur DHCP est bien actif. Sur le client, tapez :
<code>sudo dhclient
</code>Si ça ne se finit pas par l'attribution d'une adresse IP, il y a un problème.

== ... comme sous Windows ==
Il est également possible d'utiliser wpasupplicant sous Windows. Seulement, quitte à utiliser ce système d'exploitation, autant le faire à fond.
La plupart du temps, un utilitaire de connexion Wi-fi est fourni avec votre matériel. Je ne peux malheureusement pas vous aider là-dessus de façon globale :(

Sinon, je vous rassure, avec Windows XP SP2, l'utilitaire de connexion sans fil Windows marche très bien. Cliquez sur la petite icône de votre carte réseau en bas à droite à côté de l'heure (souvent, c'est un petit écran depuis lequel partent des ondes stylisées). Il devrait vous afficher la liste des réseaux sans-fils. Choisissez le votre, cliquez sur "Connecter" et rentrez la clé. Bienvenue chez vous :)

= Conclusion =

Le wifi sous Linux c'est possible et ça marche bien. Je n'ai jamais utilisé de solutions propriétaires, donc je ne peux pas comparer, mais j'ai pu monter mon réseau sécurisé à moindre coût (mais avec un peu de temps :p).

<cadre type=alert>Je tiens à prévenir le public sensible qu'aucun pot de rillettes n'a été maltraité pendant la réalisation de ce tutorial, pour mon plus grand malheur
</cadre>

{{Copy|Avril 2006|Glandos|FDL}}

Point d'accès sécurisé par hostAPd

2006-05-05T08:01:24Z

Manu : /* Introduction */

= Introduction =
[[Catégorie:Administration réseau]][[Catégorie:Réseau]][[Catégorie:Réseau local]]
Ce n'est pas vraiment un tutoriel, mais plutôt un retour d'expérience. Mais finalement c'est ce que sont tous les tutoriels. Je tiens simplement à vous prévenir qu'avant ce week-end, je n'avais jamais installé de matériels Wi-fi. Je ne suis donc pas un expert, mais j'ai appris un certain nombre de choses qui pourront être utiles.

= Présentation =
== But recherché ==
Tout d'abord, il convient de préciser ce que je voulais faire, en plus de « installer le wifi chez moi ». Pour ne pas verser dans l'étalage de vie privée, voici ce dont je disposais :
* Une freebox basique (sans fonctions routeur ni wifi).
* Un PC (passerelle pour le reste du document) connecté directement à la freebox sous Debian/testing. Elle dispose de deux cartes réseau Ethernet RJ45 (filaire) qui sont identifiées par l'OS en tant que eth_adsl et eth_local. La freebox est reliée sur eth_adsl. Un firewall tourne entre eth_adsl et eth_local à l'aide d'iptables.
* Un switch branché sur eth_local, et sur lequel sont reliés deux clients de manière on ne peut plus classique.
* Une carte Wi-Fi D-Link DWL-G520 PCI avec chipset Atheros (le chipset importe beaucoup plus que la carte, croyez moi !!).
* Un ordinateur portable Asus A7D, avec une carte Ethernet et une carte Wi-fi avec un chipset Broadcom 4318 (là encore, il a fallu le trouver...)

TODO : schéma

Le but est donc pour moi de faire que le portable puisse se brancher en Wi-fi sur le réseau local, exactement comme les autres clients. Je ne voulais pas me taper des règles firewall en plus, alors j'ai opté pour le bridge.

== Prérequis ==
Voici les connaissances ou le matériel que je considère comme requis :
* La passerelle tourne sous Debian.
* La passerelle dispose d'un serveur DHCP fonctionnel pour le réseau local.
* Les commandes tapées sur la passerelle sont à faire en tant que root. Vous devez donc avoir le mot de passe administrateur de cette machine.
* Avoir quelques connaissances requises, au moins sur le vocabulaire d'un réseau local.
* Pour le Wi-fi et son vocabulaire, vous pouvez aller voir [[hardware-hard_net-wifi|par là]]
* Un pot de rillettes et du bon pain. Les musulmans sont bien évidemment invités à choisir une mousse de canard ou des tranches de dinde.

= Le bridge, invention magique =
== Présentation du bridge ==
Le bridge (pont en anglais) permet de faire une chose miraculeuse : réunir de manière transparente plusieurs cartes réseaux, en une seule virtuelle. Il y a quelques inconvénients, notamment sur le fait que le démarrage est un peu plus lent, le temps que le bridge se fasse, et que c'est un peu compliqué pour la tête. Mais je voulais vraiment que le portable se connecte en Wi-fi en changeant le minimum de choses sur la passerelle.

== Installation ==
Pour cela, il est donc nécessaire d'avoir un noyau compilés avec les bonnes options. Pour l'utilisateur normal qui n'a pas recompilé son noyau, ne chercher pas, c'est bon, ça ira :) Pour les autres, trouvez comment activer le bridging dans le noyau, je ne sais pas comment on fait :p
Ensuite, il faut installer les utilitaires nécessaires :

<code>apt-get install bridge-utils
</code>

Pour les autres systèmes ça doit être dans le même style.
Il faut donc créer ce bridge. Sachez d'abord que tout sera géré par ce futur bridge. Cela veut donc dire que vous ne parlerez plus directement à vos interfaces (ici eth_local et ath0), mais directement à bridge_local (j'aime bien les noms explicites :) ). Cela implique donc que vous n'avez RIEN à configurer sur les cartes réseaux qui vont être incluses dans ce bridge, et même mieux : il faut enlever ce qui est propre à la configuration de ces cartes.
Chez Debian, tout se passe dans /etc/network/interfaces ce qui est plutôt pratique. Voici donc le fichier AVANT l'installation du bridge :

<code># This file describes the network interfaces available on your system

# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

auto eth_local
iface eth_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
</code>

La carte eth_adsl est donc initialisée au démarrage (ligne auto eth_adsl), a une adresse IPv4 (inet) et ses paramètres réseaux lui sont attribués automatiquement (dhcp), en l'occurence par la Freebox.
De même, la carte eth_local est initialisée au démarrage, mais ses paramètres réseaux sont fixés par moi (static), avec les paramètres spécifiés en dessous. Je pense que c'est assez clair.

Après l'installation du bridge, voici ce que j'ai :

<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

iface ath0 inet static
wireless-mode master
wireless-channel 9

auto bridge_local
iface bridge_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
bridge_ports eth_local ath0
</code>

La partie eth_adsl n'a pas changé : c'est normal :) Par contre, on voit que bridge_local a les même paramètres que mon ex-carte eth_local. Sauf que en plus, on lui dit que c'est un bridge qui contient les cartes eth_local et ath0. Ainsi, dès que j'envoie des paquets depuis la passerelle sur l'adresse 192.168.0.254, ceux-ci seront transmis automatiquement aux deux cartes, et réciproquement, lorsqu'une carte reçoit un paquet pour 192.168.0.254, elle le transmet au bridge. Moi, je trouve ça magique :)
Il y a également une partie sur ath0 me direz-vous. Oui d'accord, mais elle n'est là que pour régler certains paramètres propres au Wi-fi, rien de plus ! Vous remarquerez qu'il n'y a pas de ligne auto ath0, donc elle n'est pas initialisée au démarrage.

== Activation ==
Ceci étant fait, il y a plusieurs méthodes pour activer ce bridge. Sachez que dans la plupart des cas, ceci va foutre en l'air la connexion ! C'est ce qui m'est arrivé, ça fait un peu tout drôle. Normalement, l'ADSL reste en place, mais ce n'est pas le cas de la connexion sur eth_local.

Soit vous faites :<code>/etc/init.d/networking/force-reload
</code>

Soit :<code>/etc/init.d/networking/stop && /etc/init.d/networking/start
</code>

Soit carrément un bon vieux reboot :
reboot
Je sais pas pourquoi je mets la commande... On sait jamais :p
Enfin, après l'une de ses trois méthodes (voire les trois), en tapant

<code>ifconfig
</code>

Vous devriez voir ça :
<code>ath0 Lien encap:Ethernet HWaddr 00:15:E9:3F:AA:90
adr inet6: fe80::215:e9ff:fe3f:aa90/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:2290 Metric:1
RX packets:163080 errors:955516 dropped:0 overruns:0 frame:955509
TX packets:315546 errors:613 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:200
RX bytes:13726343 (13.0 MiB) TX bytes:462013643 (440.6 MiB)
Interruption:185 Mémoire:e08e0000-e08f0000

bridge_lo Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
inet adr:192.168.0.254 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:294178 errors:0 dropped:0 overruns:0 frame:0
TX packets:454533 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:458148569 (436.9 MiB) TX bytes:541885943 (516.7 MiB)

eth_adsl Lien encap:Ethernet HWaddr 00:11:D8:09:6D:31
inet adr:xx.xx.xx.xx Bcast:xx.xx.xx.xx Masque:255.255.255.0
adr inet6: fe80::211:d8ff:fe09:6d31/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:279243 errors:0 dropped:0 overruns:0 frame:0
TX packets:264750 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:189704796 (180.9 MiB) TX bytes:66643253 (63.5 MiB)
Interruption:177 Adresse de base:0xb000

eth_local Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:403023 errors:0 dropped:0 overruns:0 frame:0
TX packets:142751 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:460239899 (438.9 MiB) TX bytes:80409812 (76.6 MiB)
Interruption:169 Adresse de base:0xd800

lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:38438 errors:0 dropped:0 overruns:0 frame:0
TX packets:38438 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:3297781 (3.1 MiB) TX bytes:3297781 (3.1 MiB)
</code>

On constate donc que eth_local et ath0 n'ont aucune adresse IPv4 (inet adr) et que bridge_local a bien l'adresse 192.168.0.254. Quant à eth_adsl, pour les xx, c'est moi qui les ai mis : j'ai une IP fixe, je tiens à garder ma vie privée :)

Avant de passer à la prochaine étape, je vous conseille de suivre la procédure suivante :
* Découper une tranche de pain.
* La tartiner abondamment de rillettes (ou de mousse de canard :) ).
* La savourer délicatement.
Cela permet, en plus de reposer vos mains meurtris par ces infâmes périphériques de saisie, de soulager les cris blafards de votre estomac. Vous pourrez alors apprécier à sa juste valeur les hormones de bien-être sécrétées par une digestion bien mérité :)

= Créer le point d'accès =
== Présentation de hostAPd ==
Étape suivante : transformer une simple carte Wi-fi en puissant point d'accès (accesss point en anglais soit AP). Pour cela, après avoir parcouru rapidement le web, une solution s'est imposée : hostAPd disponible sur [http://hostap.epitest.fi/hostapd/ cette page]
Attention, il faut différencier les 3 projets du site : hostAP driver, hostAPd et wpa_supplicant. hostAP driver ne m'intéressait pas : c'est l'implémentation libre d'un driver pour carte Wi-fi. Wpa_supplicant est un client WPA, comme on va le voir par la suite. Et hostAPd est le logiciel capable de faire tourner votre carte Wi-fi « de base » en point d'accès genre « Enterprise » :)

== Installation ==
Là, j'ai été confronté à l'instabilité de Debian/testing... En effet, les binaires hostAPd sont présents mais pas compilés avec les bonnes options pour madwifi, et les sources sont celles de la version 0.5.0 pleines de bugs corrigés depuis. J'ai perdu un temps monstre sur ça, que je vais vous épargner ici :) Mais du coup le moment est bien choisi pour aborder la compilation « à la mimine ».

Pour cela, il faut d'abord installer quelques outils, dont le fameux gcc. Sous Debian (et là ça marche bien :p ) :

<code>apt-get install build-essential gcc
</code>

Je pense que seul gcc est nécessaire dans notre cas, mais bon on sait jamais, ça pourra servir :). Ensuite, on va avoir besoin des sources de hostAPd (normal). Ce qui m'intéressait étant aussi de faire fonctionner hostAPd avec madwifi, il me fallait également les sources de madwifi. On fait donc un petit

<code>apt-get install madwifi-source
</code>

Et un téléchargement de hostAPd dans le répertoire /usr/src/, classique pour toute compilation standard. Il faut maintenant extraire les fichiers :

<code>tar xvfj madwifi.tar.bz2
tar xvfz hostapd-0.5.2.tar.gz</code>

Vous avez donc remarqué qu'à cette heure, la version en cours de hostAPd est la 0.5.2 ;) Rendez-vous dans le répertoire hostapd-0.5.2/ créé lors de l'extraction. Vous pouvez lire le README, c'est en anglais, mais ça peut faire du bien de temps à autre. L'essentiel à comprendre est qu'il faut créer un fichier .config lui disant quoi mettre lors de la compilation. Heureusement, un listing des options est présent. Faites donc :

<code>cp defconfig .config
</code>
Et éditez ce fichier .config. Voilà à quoi ressemble le mien :

<code># Driver interface for Host AP driver
#CONFIG_DRIVER_HOSTAP=y

# Driver interface for wired authenticator
#CONFIG_DRIVER_WIRED=y

# Driver interface for madwifi driver
CONFIG_DRIVER_MADWIFI=y
CFLAGS += -I../modules/madwifi/ # change to reflect local setup; directory for madwifi src

# Driver interface for Prism54 driver
#CONFIG_DRIVER_PRISM54=y

# Driver interface for drivers using Devicescape IEEE 802.11 stack
#CONFIG_DRIVER_DEVICESCAPE=y

# Driver interface for FreeBSD net80211 layer (e.g., Atheros driver)
#CONFIG_DRIVER_BSD=y
#CFLAGS += -I/usr/local/include
#LIBS += -L/usr/local/lib

# IEEE 802.11F/IAPP
#CONFIG_IAPP=y

# WPA2/IEEE 802.11i RSN pre-authentication
#CONFIG_RSN_PREAUTH=y

# IEEE 802.11i/IEEE 802.11e STAKey negotiation for direct link connection
#CONFIG_STAKEY=y

# Integrated EAP server
CONFIG_EAP=y

# EAP-MD5 for the integrated EAP server
#CONFIG_EAP_MD5=y

# EAP-TLS for the integrated EAP server
CONFIG_EAP_TLS=y
</code>

Tout le reste est commenté, j'en ai rien à faire, je n'ai besoin que du WPA avec un driver madwifi. Pour les plus curieux, j'ai dû laisser CONFIG_EAP et CONFIG_EAP_TLS, parce que sinon ça plantait, ce sera visiblement corrigé dans la version 0.5.3. Remarquez aussi la ligne pour madwifi : CFLAGS contient le chemin vers les sources de madwifi, fraîchement décompressé dans le répertoire /usr/src/modules/madwifi/. Sauvegardez et quittez.
C'est parti pour l'instant geek crucial :

<code>make
</code>

Simple non ? Moi ça me déroute parfois tout ce qu'il peut écrire avec aussi peu de lettres tapées :) Si tout se passe bien, il n'affiche aucune ligne trop inquiétante remplie d'étoiles et de mot ERROR. Sinon, ben euh, posez vos questions après le bip.

Maintenant que c'est compilé, faut l'installer. En gros, la plupart du temps, ça consiste en un simple copier/coller des fichiers compilés. Rassurez-vous la procédure standard est on ne peut plus explicite :

<code>make install
</code>

Et pouf. Comme c'est indiqué, les exécutables sont installés dans /usr/local/bin par défaut. C'est très bien là où c'est :)

== Configuration de hostAPd ==
Prochaine étape : la configuration de hostAPd. Je vous propose une astuce pour pas trop se casser la tête : installer le paquet Debian de hostAPd, qui, même s'il est défectueux, installe les fichiers par défaut au bon endroit pour vous. Il n'y aura plus qu'à faire quelques retouches. C'est parti :

<code>apt-get install hostapd
</code>
Si jamais vous voulez retirer les exécutables (présent dans /sbin ou /usr/sbin pour le paquet Debian) pour éviter de s'emmêler les pinceaux :

<code>apt-get remove hostapd
</code>
Et normalement les fichier de configuration sont restés là :) À savoir :
* ''/etc/default/hostapd'' - Permet d'activer ou de désactiver le lancement automatique de hostAPd
* ''/etc/hostapd/hostapd.conf'' - Fichier de configuration de hostAPd
* ''/etc/init.d/hostapd'' - Script shell gérant l'exécution et l'arrêt de hostAPd en tant que démon.
On va d'abord éditer le script afin de lancer le bon programme. Dans votre éditeur de texte chercher la ligne suivante :

<code>DAEMON=/usr/sbin/hostapd
</code>
Chez moi, c'est la douzième. Remplacez la par :

<code>DAEMON=/usr/local/bin/hostapd
</code>
Ensuite, on va aller configurer hostAPd. Le plus dur est de lire tous les commentaires en fait :) Mais pour aller un peu plus vite, voici les lignes qui servent dans MON cas (simple WPA-PSK) :
<code>#La carte Wifi, forcément indispensable :)
interface=ath0

#Si la carte est bridgée et utilise madwifi, il faut préciser le nom du bridge
bridge=bridge_local

# Le driver nécessité par la carte
driver=madwifi

#Options de log par défaut, elles sont très bien :)
logger_syslog=-1
logger_syslog_level=1
logger_stdout=-1
logger_stdout_level=2

debug=2

dump_file=/tmp/hostapd.dump

#Contrôle du programme, encore une fois, le réglage par défaut est nickel :)
ctrl_interface=/var/run/hostapd

ctrl_interface_group=0

#Le nom de votre réseau. C'est important. Choisissez un nom à peu près reconnaissable et pas trop long.
ssid=MADOUIFI

#Comment gérer les adresses MAC (adresse Hardware des cartes réseaux)
# C'est une sécurité qui peut facilement être contournée, mais est
# néanmoins pratique, car elle est facile à mettre en place
# En effet, hostAPd va vérifier l'adresse MAC de la carte Wifi qui fait une
# demande d'accès et pourra alors, sur cette seule adresse, soit continuer le
# processus d'identification, soit s'arrêter et refuser la carte.
# Les paramètres possibles sont les suivants :
# 0 : Tout accepter à moins qu'elle ne soit dans la liste noire
# 1 : Tout refuser, à moins qu'elle ne soit dans la liste blanche
# 2 : Vérifier l'adresse auprès d'un serveur RADIUS (honnêtement, pour son réseau local, ça ne sert à rien)
# Le meilleur paramètre pour commencer est 1. Ça réduit de beaucoup les risques de piratage.
macaddr_acl=1

#Chemin des fichiers pour les listes noire et blanche
# Je vous conseille de les créer tout de suite, on verra plus tard pour les remplir correctement
accept_mac_file=/etc/hostapd/hostapd.accept
deny_mac_file=/etc/hostapd/hostapd.deny

# La description anglaise pour les curieux :)
auth_algs=1

#Celui là, je sais pas trop... Je crois qu'on peut l'enlever, mais bon je suis pas sûr, j'ai pas testé :)
eap_server=0

#Dis qu'on veut faire du WPA-PSK
wpa=1

# Votre clé, le coeur de la sécurité du WPA-PSK :)
wpa_passphrase=SupèRecléDelAmor,Avecdetrucch3l0us;)

# Pour un petit peu plus de sécurité, vous pouvez attribuer une clé WPA par adresse MAC (donc par ordinateur).
#C'est quand même un peu plus embêtant à maintenir...
#wpa_psk_file=/etc/hostapd/wpa_psk

# On définit ce qu'on veut comme WPA
wpa_key_mgmt=WPA-PSK

# Et l'algo de cryptage
wpa_pairwise=TKIP

# Quelques options temporelles. Pas forcément nécessaire pour que ça marche :)
wpa_group_rekey=600

wpa_gmk_rekey=86400
</code>

Et la touche finale. Éditez le fichier /etc/default/hostapd et décommentez la ligne suivante :

<code>RUN_DAEMON=yes
</code>
Et voilà. C'est fini. Enfin, non, ce n'est pas tout à fait exact. La configuration du serveur est finie. Il reste à la tester et à configurer des clients :) En avant toute !

== Première validation du point d'accès ==
Premier test. Normalement, la commande suivante :

<code>/etc/init.d/hostapd start
</code>

devrait donner un résultat positif. Faites ensuite

<code>/etc/init.d/hostapd stop
hostapd -dd /etc/hostapd/hostapd.conf</code>

Cela lance le programme en avant plan en mode débug, idéal pour vérifier que tout marche bien. Ne vous inquiétez pas trop de ce qu'il dit, tant qu'il ne vous redonne pas la main, c'est bon signe :) En général, il dit qu'il se met en attente. Pendant qu'il se lance, n'hésitez pas à attaquer encore le pot de rillettes ou de canard qui commence à se barrer en douce.

= Configurer le client =
La dernière étape, c'est de configurer son client.
== Sous Ubuntu ... ==
Ceci s'applique à une Ubuntu Breezy Badger fraîchement installée. La carte Wifi doit déjà être détectée.

TODO : lier vers une page d'install ou en faire une :)

Je vais appeler la carte Wi-fi wlan0. La méthode suivante va donner beaucoup plus d'importance à la carte Wi-fi qu'à la carte Ethernet. Je dois avouer que je n'ai pas réussi à faire marcher le gestionnaire de réseau sous Gnome, donc j'y suis allé ''comme un geek''.
<cadre type=alert>Cette solution n'est donc pas optimale si vous utilisez aussi fréquemment la carte filaire que la carte sans-fil. Cependant, ceci risque de devenir obsolète dans la version suivante de Ubuntu qui devrait intégrer Network-Manager, qui fait du beau travail à en croire les captures d'écrans :)</cadre>

=== Configuration des interfaces ===
Tout d'abord, on va un peu épurer le fichier de configuration automatique des interfaces.
<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
iface eth0 inet dhcp

auto wlan0
iface wlan0 inet dhcp
pre-up /etc/init.d/wpasupplicant start
wireless-mode Managed
wireless-essid "MADOUIFI"
wireless-key "SupèRecléDelAmor,Avecdetrucch3l0us;)"
pre-down /etc/init.d/wpasupplicant stop
</code>
Maintenant que vous êtes un baroudeur de ce fichier vous avez dû remarquer les choses suivantes :
* eth0 n'est plus confiée à hotplug : celui-ci à la facheuse tendance de lui faire prendre le dessus sur wlan0, ça m'énervait :)
* On laisse tout de même eth0 en mode DHCP, mais plus en initialisation automatique (C'est là que je dis que ça favorise plutôt la carte Wi-fi).
* Les lignes pre-up et pre-down vont démarrer quelque chose encore inconnu et sûrement non installé. Mais gardez patience, sinon on ne va pas y arriver :)
* Les lignes wireless- servent à configurer la carte Wi-fi. Je ne crois pas que ce soit utile, car wpasupplicant devrais s'en charger, mais bon. C'est là l'une des marques de mes lacunes ;)

=== Installation et utilisation de wpasupplicant ===
Si vous vous en souvenez, wpasupplicant est un des projets développés en même temps que hostAPd. Ça tombe plutôt bien :). Wpasupplicant est un client WPA permettant de faire marcher quasiment n'importe quelle carte Wi-fi sur un réseau protégé en WPA.

On commence donc par télécharger le paquet Ubuntu :

<code>sudo apt-get install wpasupplicant
</code>

Ensuite, on va éditez son fichier de configuration pour qu'il convienne à notre réseau. Ce fichier s'appelle /etc/wpa_supplicant.conf :

<code># Faites zless /usr/share/doc/wpasupplicant/wpa_supplicant.conf.gz pour voir toutes les otptions disponibles

# Ne rien changer ici
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0

eapol_version=1
ap_scan=1
fast_reauth=1

# Déclaration et paramétrage d'un réseau
network={
# Le même SSID du point d'accès
ssid="MADOUIFI"
key_mgmt=WPA-PSK
psk="SupèRecléDelAmor,Avecdetrucch3l0us;)"
}
</code>

Et on redémarre le réseau à l'aide de la commande :

<code>sudo /etc/init.d/networking restart
</code>

Ensuite, il suffit d'attendre un certain moment, le temps que l'authentification se fasse et que le serveur DHCP réagisse. Normalement, en tapant /sbin/ifconfig vous devriez obtenir ceci :
<code>lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:142349 errors:0 dropped:0 overruns:0 frame:0
TX packets:142349 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:10530324 (10.0 MiB) TX bytes:10530324 (10.0 MiB)

wlan0 Lien encap:Ethernet HWaddr 00:15:F2:CC:F4:39
inet adr:192.168.0.3 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::215:f2ff:fecc:f439/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:90878 errors:0 dropped:0 overruns:0 frame:0
TX packets:60354 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:98143829 (93.5 MiB) TX bytes:5812510 (5.5 MiB)
Mémoire:fe3fc000-fe3fdfff
</code>
La carte wlan0 avec l'état ''UP'' et une adresse IP (''inet adr'').

=== Pistes en cas de problèmes ===
* Lancer hostAPd à la main en mode debug avec la commande
<code>/usr/local/bin/hostapd -dd /etc/hostapd/hostapd.conf
</code>Puis relancez le client. Le journal qui s'affiche peut aider grandement le diagnostic.
* Vérifier que votre serveur DHCP est bien actif. Sur le client, tapez :
<code>sudo dhclient
</code>Si ça ne se finit pas par l'attribution d'une adresse IP, il y a un problème.

== ... comme sous Windows ==
Il est également possible d'utiliser wpasupplicant sous Windows. Seulement, quitte à utiliser ce système d'exploitation, autant le faire à fond.
La plupart du temps, un utilitaire de connexion Wi-fi est fourni avec votre matériel. Je ne peux malheureusement pas vous aider là-dessus de façon globale :(

Sinon, je vous rassure, avec Windows XP SP2, l'utilitaire de connexion sans fil Windows marche très bien. Cliquez sur la petite icône de votre carte réseau en bas à droite à côté de l'heure (souvent, c'est un petit écran depuis lequel partent des ondes stylisées). Il devrait vous afficher la liste des réseaux sans-fils. Choisissez le votre, cliquez sur "Connecter" et rentrez la clé. Bienvenue chez vous :)

= Conclusion =

Le wifi sous Linux c'est possible et ça marche bien. Je n'ai jamais utilisé de solutions propriétaires, donc je ne peux pas comparer, mais j'ai pu monter mon réseau sécurisé à moindre coût (mais avec un peu de temps :p).

<cadre type=alert>Je tiens à prévenir le public sensible qu'aucun pot de rillettes n'a été maltraité pendant la réalisation de ce tutorial, pour mon plus grand malheur
</cadre>

{{Copy|Avril 2006|Glandos|FDL}}

Point d'accès sécurisé par hostAPd

2006-05-05T07:52:37Z

Manu : /* Introduction */

= Introduction =
[[Catégorie:Administration réseau]][[Catégorie:Réseau]][[Catégorie:Réseau local]]
Ce n'est pas vraiment un tutorial, mais plutôt un retour d'expérience. Mais finalement c'est ce que sont tous les tutoriaux. Je tiens simplement à vous prévenir qu'avant ce week-end, je n'avais jamais installé de matériels Wi-fi. Je ne suis donc pas un expert, mais j'ai appris un certain nombre de choses qui pourront être utiles.

= Présentation =
== But recherché ==
Tout d'abord, il convient de préciser ce que je voulais faire, en plus de « installer le wifi chez moi ». Pour ne pas verser dans l'étalage de vie privée, voici ce dont je disposais :
* Une freebox basique (sans fonctions routeur ni wifi).
* Un PC (passerelle pour le reste du document) connecté directement à la freebox sous Debian/testing. Elle dispose de deux cartes réseau Ethernet RJ45 (filaire) qui sont identifiées par l'OS en tant que eth_adsl et eth_local. La freebox est reliée sur eth_adsl. Un firewall tourne entre eth_adsl et eth_local à l'aide d'iptables.
* Un switch branché sur eth_local, et sur lequel sont reliés deux clients de manière on ne peut plus classique.
* Une carte Wi-Fi D-Link DWL-G520 PCI avec chipset Atheros (le chipset importe beaucoup plus que la carte, croyez moi !!).
* Un ordinateur portable Asus A7D, avec une carte Ethernet et une carte Wi-fi avec un chipset Broadcom 4318 (là encore, il a fallu le trouver...)

TODO : schéma

Le but est donc pour moi de faire que le portable puisse se brancher en Wi-fi sur le réseau local, exactement comme les autres clients. Je ne voulais pas me taper des règles firewall en plus, alors j'ai opté pour le bridge.

== Prérequis ==
Voici les connaissances ou le matériel que je considère comme requis :
* La passerelle tourne sous Debian.
* La passerelle dispose d'un serveur DHCP fonctionnel pour le réseau local.
* Les commandes tapées sur la passerelle sont à faire en tant que root. Vous devez donc avoir le mot de passe administrateur de cette machine.
* Avoir quelques connaissances requises, au moins sur le vocabulaire d'un réseau local.
* Pour le Wi-fi et son vocabulaire, vous pouvez aller voir [[hardware-hard_net-wifi|par là]]
* Un pot de rillettes et du bon pain. Les musulmans sont bien évidemment invités à choisir une mousse de canard ou des tranches de dinde.

= Le bridge, invention magique =
== Présentation du bridge ==
Le bridge (pont en anglais) permet de faire une chose miraculeuse : réunir de manière transparente plusieurs cartes réseaux, en une seule virtuelle. Il y a quelques inconvénients, notamment sur le fait que le démarrage est un peu plus lent, le temps que le bridge se fasse, et que c'est un peu compliqué pour la tête. Mais je voulais vraiment que le portable se connecte en Wi-fi en changeant le minimum de choses sur la passerelle.

== Installation ==
Pour cela, il est donc nécessaire d'avoir un noyau compilés avec les bonnes options. Pour l'utilisateur normal qui n'a pas recompilé son noyau, ne chercher pas, c'est bon, ça ira :) Pour les autres, trouvez comment activer le bridging dans le noyau, je ne sais pas comment on fait :p
Ensuite, il faut installer les utilitaires nécessaires :

<code>apt-get install bridge-utils
</code>

Pour les autres systèmes ça doit être dans le même style.
Il faut donc créer ce bridge. Sachez d'abord que tout sera géré par ce futur bridge. Cela veut donc dire que vous ne parlerez plus directement à vos interfaces (ici eth_local et ath0), mais directement à bridge_local (j'aime bien les noms explicites :) ). Cela implique donc que vous n'avez RIEN à configurer sur les cartes réseaux qui vont être incluses dans ce bridge, et même mieux : il faut enlever ce qui est propre à la configuration de ces cartes.
Chez Debian, tout se passe dans /etc/network/interfaces ce qui est plutôt pratique. Voici donc le fichier AVANT l'installation du bridge :

<code># This file describes the network interfaces available on your system

# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

auto eth_local
iface eth_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
</code>

La carte eth_adsl est donc initialisée au démarrage (ligne auto eth_adsl), a une adresse IPv4 (inet) et ses paramètres réseaux lui sont attribués automatiquement (dhcp), en l'occurence par la Freebox.
De même, la carte eth_local est initialisée au démarrage, mais ses paramètres réseaux sont fixés par moi (static), avec les paramètres spécifiés en dessous. Je pense que c'est assez clair.

Après l'installation du bridge, voici ce que j'ai :

<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
auto eth_adsl
iface eth_adsl inet dhcp

iface ath0 inet static
wireless-mode master
wireless-channel 9

auto bridge_local
iface bridge_local inet static
address 192.168.0.254
netmask 255.255.255.0
broadcast 192.168.0.255
bridge_ports eth_local ath0
</code>

La partie eth_adsl n'a pas changé : c'est normal :) Par contre, on voit que bridge_local a les même paramètres que mon ex-carte eth_local. Sauf que en plus, on lui dit que c'est un bridge qui contient les cartes eth_local et ath0. Ainsi, dès que j'envoie des paquets depuis la passerelle sur l'adresse 192.168.0.254, ceux-ci seront transmis automatiquement aux deux cartes, et réciproquement, lorsqu'une carte reçoit un paquet pour 192.168.0.254, elle le transmet au bridge. Moi, je trouve ça magique :)
Il y a également une partie sur ath0 me direz-vous. Oui d'accord, mais elle n'est là que pour régler certains paramètres propres au Wi-fi, rien de plus ! Vous remarquerez qu'il n'y a pas de ligne auto ath0, donc elle n'est pas initialisée au démarrage.

== Activation ==
Ceci étant fait, il y a plusieurs méthodes pour activer ce bridge. Sachez que dans la plupart des cas, ceci va foutre en l'air la connexion ! C'est ce qui m'est arrivé, ça fait un peu tout drôle. Normalement, l'ADSL reste en place, mais ce n'est pas le cas de la connexion sur eth_local.

Soit vous faites :<code>/etc/init.d/networking/force-reload
</code>

Soit :<code>/etc/init.d/networking/stop && /etc/init.d/networking/start
</code>

Soit carrément un bon vieux reboot :
reboot
Je sais pas pourquoi je mets la commande... On sait jamais :p
Enfin, après l'une de ses trois méthodes (voire les trois), en tapant

<code>ifconfig
</code>

Vous devriez voir ça :
<code>ath0 Lien encap:Ethernet HWaddr 00:15:E9:3F:AA:90
adr inet6: fe80::215:e9ff:fe3f:aa90/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:2290 Metric:1
RX packets:163080 errors:955516 dropped:0 overruns:0 frame:955509
TX packets:315546 errors:613 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:200
RX bytes:13726343 (13.0 MiB) TX bytes:462013643 (440.6 MiB)
Interruption:185 Mémoire:e08e0000-e08f0000

bridge_lo Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
inet adr:192.168.0.254 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:294178 errors:0 dropped:0 overruns:0 frame:0
TX packets:454533 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:458148569 (436.9 MiB) TX bytes:541885943 (516.7 MiB)

eth_adsl Lien encap:Ethernet HWaddr 00:11:D8:09:6D:31
inet adr:xx.xx.xx.xx Bcast:xx.xx.xx.xx Masque:255.255.255.0
adr inet6: fe80::211:d8ff:fe09:6d31/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:279243 errors:0 dropped:0 overruns:0 frame:0
TX packets:264750 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:189704796 (180.9 MiB) TX bytes:66643253 (63.5 MiB)
Interruption:177 Adresse de base:0xb000

eth_local Lien encap:Ethernet HWaddr 00:11:95:C5:44:61
adr inet6: fe80::211:95ff:fec5:4461/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:403023 errors:0 dropped:0 overruns:0 frame:0
TX packets:142751 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:460239899 (438.9 MiB) TX bytes:80409812 (76.6 MiB)
Interruption:169 Adresse de base:0xd800

lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:38438 errors:0 dropped:0 overruns:0 frame:0
TX packets:38438 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:3297781 (3.1 MiB) TX bytes:3297781 (3.1 MiB)
</code>

On constate donc que eth_local et ath0 n'ont aucune adresse IPv4 (inet adr) et que bridge_local a bien l'adresse 192.168.0.254. Quant à eth_adsl, pour les xx, c'est moi qui les ai mis : j'ai une IP fixe, je tiens à garder ma vie privée :)

Avant de passer à la prochaine étape, je vous conseille de suivre la procédure suivante :
* Découper une tranche de pain.
* La tartiner abondamment de rillettes (ou de mousse de canard :) ).
* La savourer délicatement.
Cela permet, en plus de reposer vos mains meurtris par ces infâmes périphériques de saisie, de soulager les cris blafards de votre estomac. Vous pourrez alors apprécier à sa juste valeur les hormones de bien-être sécrétées par une digestion bien mérité :)

= Créer le point d'accès =
== Présentation de hostAPd ==
Étape suivante : transformer une simple carte Wi-fi en puissant point d'accès (accesss point en anglais soit AP). Pour cela, après avoir parcouru rapidement le web, une solution s'est imposée : hostAPd disponible sur [http://hostap.epitest.fi/hostapd/ cette page]
Attention, il faut différencier les 3 projets du site : hostAP driver, hostAPd et wpa_supplicant. hostAP driver ne m'intéressait pas : c'est l'implémentation libre d'un driver pour carte Wi-fi. Wpa_supplicant est un client WPA, comme on va le voir par la suite. Et hostAPd est le logiciel capable de faire tourner votre carte Wi-fi « de base » en point d'accès genre « Enterprise » :)

== Installation ==
Là, j'ai été confronté à l'instabilité de Debian/testing... En effet, les binaires hostAPd sont présents mais pas compilés avec les bonnes options pour madwifi, et les sources sont celles de la version 0.5.0 pleines de bugs corrigés depuis. J'ai perdu un temps monstre sur ça, que je vais vous épargner ici :) Mais du coup le moment est bien choisi pour aborder la compilation « à la mimine ».

Pour cela, il faut d'abord installer quelques outils, dont le fameux gcc. Sous Debian (et là ça marche bien :p ) :

<code>apt-get install build-essential gcc
</code>

Je pense que seul gcc est nécessaire dans notre cas, mais bon on sait jamais, ça pourra servir :). Ensuite, on va avoir besoin des sources de hostAPd (normal). Ce qui m'intéressait étant aussi de faire fonctionner hostAPd avec madwifi, il me fallait également les sources de madwifi. On fait donc un petit

<code>apt-get install madwifi-source
</code>

Et un téléchargement de hostAPd dans le répertoire /usr/src/, classique pour toute compilation standard. Il faut maintenant extraire les fichiers :

<code>tar xvfj madwifi.tar.bz2
tar xvfz hostapd-0.5.2.tar.gz</code>

Vous avez donc remarqué qu'à cette heure, la version en cours de hostAPd est la 0.5.2 ;) Rendez-vous dans le répertoire hostapd-0.5.2/ créé lors de l'extraction. Vous pouvez lire le README, c'est en anglais, mais ça peut faire du bien de temps à autre. L'essentiel à comprendre est qu'il faut créer un fichier .config lui disant quoi mettre lors de la compilation. Heureusement, un listing des options est présent. Faites donc :

<code>cp defconfig .config
</code>
Et éditez ce fichier .config. Voilà à quoi ressemble le mien :

<code># Driver interface for Host AP driver
#CONFIG_DRIVER_HOSTAP=y

# Driver interface for wired authenticator
#CONFIG_DRIVER_WIRED=y

# Driver interface for madwifi driver
CONFIG_DRIVER_MADWIFI=y
CFLAGS += -I../modules/madwifi/ # change to reflect local setup; directory for madwifi src

# Driver interface for Prism54 driver
#CONFIG_DRIVER_PRISM54=y

# Driver interface for drivers using Devicescape IEEE 802.11 stack
#CONFIG_DRIVER_DEVICESCAPE=y

# Driver interface for FreeBSD net80211 layer (e.g., Atheros driver)
#CONFIG_DRIVER_BSD=y
#CFLAGS += -I/usr/local/include
#LIBS += -L/usr/local/lib

# IEEE 802.11F/IAPP
#CONFIG_IAPP=y

# WPA2/IEEE 802.11i RSN pre-authentication
#CONFIG_RSN_PREAUTH=y

# IEEE 802.11i/IEEE 802.11e STAKey negotiation for direct link connection
#CONFIG_STAKEY=y

# Integrated EAP server
CONFIG_EAP=y

# EAP-MD5 for the integrated EAP server
#CONFIG_EAP_MD5=y

# EAP-TLS for the integrated EAP server
CONFIG_EAP_TLS=y
</code>

Tout le reste est commenté, j'en ai rien à faire, je n'ai besoin que du WPA avec un driver madwifi. Pour les plus curieux, j'ai dû laisser CONFIG_EAP et CONFIG_EAP_TLS, parce que sinon ça plantait, ce sera visiblement corrigé dans la version 0.5.3. Remarquez aussi la ligne pour madwifi : CFLAGS contient le chemin vers les sources de madwifi, fraîchement décompressé dans le répertoire /usr/src/modules/madwifi/. Sauvegardez et quittez.
C'est parti pour l'instant geek crucial :

<code>make
</code>

Simple non ? Moi ça me déroute parfois tout ce qu'il peut écrire avec aussi peu de lettres tapées :) Si tout se passe bien, il n'affiche aucune ligne trop inquiétante remplie d'étoiles et de mot ERROR. Sinon, ben euh, posez vos questions après le bip.

Maintenant que c'est compilé, faut l'installer. En gros, la plupart du temps, ça consiste en un simple copier/coller des fichiers compilés. Rassurez-vous la procédure standard est on ne peut plus explicite :

<code>make install
</code>

Et pouf. Comme c'est indiqué, les exécutables sont installés dans /usr/local/bin par défaut. C'est très bien là où c'est :)

== Configuration de hostAPd ==
Prochaine étape : la configuration de hostAPd. Je vous propose une astuce pour pas trop se casser la tête : installer le paquet Debian de hostAPd, qui, même s'il est défectueux, installe les fichiers par défaut au bon endroit pour vous. Il n'y aura plus qu'à faire quelques retouches. C'est parti :

<code>apt-get install hostapd
</code>
Si jamais vous voulez retirer les exécutables (présent dans /sbin ou /usr/sbin pour le paquet Debian) pour éviter de s'emmêler les pinceaux :

<code>apt-get remove hostapd
</code>
Et normalement les fichier de configuration sont restés là :) À savoir :
* ''/etc/default/hostapd'' - Permet d'activer ou de désactiver le lancement automatique de hostAPd
* ''/etc/hostapd/hostapd.conf'' - Fichier de configuration de hostAPd
* ''/etc/init.d/hostapd'' - Script shell gérant l'exécution et l'arrêt de hostAPd en tant que démon.
On va d'abord éditer le script afin de lancer le bon programme. Dans votre éditeur de texte chercher la ligne suivante :

<code>DAEMON=/usr/sbin/hostapd
</code>
Chez moi, c'est la douzième. Remplacez la par :

<code>DAEMON=/usr/local/bin/hostapd
</code>
Ensuite, on va aller configurer hostAPd. Le plus dur est de lire tous les commentaires en fait :) Mais pour aller un peu plus vite, voici les lignes qui servent dans MON cas (simple WPA-PSK) :
<code>#La carte Wifi, forcément indispensable :)
interface=ath0

#Si la carte est bridgée et utilise madwifi, il faut préciser le nom du bridge
bridge=bridge_local

# Le driver nécessité par la carte
driver=madwifi

#Options de log par défaut, elles sont très bien :)
logger_syslog=-1
logger_syslog_level=1
logger_stdout=-1
logger_stdout_level=2

debug=2

dump_file=/tmp/hostapd.dump

#Contrôle du programme, encore une fois, le réglage par défaut est nickel :)
ctrl_interface=/var/run/hostapd

ctrl_interface_group=0

#Le nom de votre réseau. C'est important. Choisissez un nom à peu près reconnaissable et pas trop long.
ssid=MADOUIFI

#Comment gérer les adresses MAC (adresse Hardware des cartes réseaux)
# C'est une sécurité qui peut facilement être contournée, mais est
# néanmoins pratique, car elle est facile à mettre en place
# En effet, hostAPd va vérifier l'adresse MAC de la carte Wifi qui fait une
# demande d'accès et pourra alors, sur cette seule adresse, soit continuer le
# processus d'identification, soit s'arrêter et refuser la carte.
# Les paramètres possibles sont les suivants :
# 0 : Tout accepter à moins qu'elle ne soit dans la liste noire
# 1 : Tout refuser, à moins qu'elle ne soit dans la liste blanche
# 2 : Vérifier l'adresse auprès d'un serveur RADIUS (honnêtement, pour son réseau local, ça ne sert à rien)
# Le meilleur paramètre pour commencer est 1. Ça réduit de beaucoup les risques de piratage.
macaddr_acl=1

#Chemin des fichiers pour les listes noire et blanche
# Je vous conseille de les créer tout de suite, on verra plus tard pour les remplir correctement
accept_mac_file=/etc/hostapd/hostapd.accept
deny_mac_file=/etc/hostapd/hostapd.deny

# La description anglaise pour les curieux :)
auth_algs=1

#Celui là, je sais pas trop... Je crois qu'on peut l'enlever, mais bon je suis pas sûr, j'ai pas testé :)
eap_server=0

#Dis qu'on veut faire du WPA-PSK
wpa=1

# Votre clé, le coeur de la sécurité du WPA-PSK :)
wpa_passphrase=SupèRecléDelAmor,Avecdetrucch3l0us;)

# Pour un petit peu plus de sécurité, vous pouvez attribuer une clé WPA par adresse MAC (donc par ordinateur).
#C'est quand même un peu plus embêtant à maintenir...
#wpa_psk_file=/etc/hostapd/wpa_psk

# On définit ce qu'on veut comme WPA
wpa_key_mgmt=WPA-PSK

# Et l'algo de cryptage
wpa_pairwise=TKIP

# Quelques options temporelles. Pas forcément nécessaire pour que ça marche :)
wpa_group_rekey=600

wpa_gmk_rekey=86400
</code>

Et la touche finale. Éditez le fichier /etc/default/hostapd et décommentez la ligne suivante :

<code>RUN_DAEMON=yes
</code>
Et voilà. C'est fini. Enfin, non, ce n'est pas tout à fait exact. La configuration du serveur est finie. Il reste à la tester et à configurer des clients :) En avant toute !

== Première validation du point d'accès ==
Premier test. Normalement, la commande suivante :

<code>/etc/init.d/hostapd start
</code>

devrait donner un résultat positif. Faites ensuite

<code>/etc/init.d/hostapd stop
hostapd -dd /etc/hostapd/hostapd.conf</code>

Cela lance le programme en avant plan en mode débug, idéal pour vérifier que tout marche bien. Ne vous inquiétez pas trop de ce qu'il dit, tant qu'il ne vous redonne pas la main, c'est bon signe :) En général, il dit qu'il se met en attente. Pendant qu'il se lance, n'hésitez pas à attaquer encore le pot de rillettes ou de canard qui commence à se barrer en douce.

= Configurer le client =
La dernière étape, c'est de configurer son client.
== Sous Ubuntu ... ==
Ceci s'applique à une Ubuntu Breezy Badger fraîchement installée. La carte Wifi doit déjà être détectée.

TODO : lier vers une page d'install ou en faire une :)

Je vais appeler la carte Wi-fi wlan0. La méthode suivante va donner beaucoup plus d'importance à la carte Wi-fi qu'à la carte Ethernet. Je dois avouer que je n'ai pas réussi à faire marcher le gestionnaire de réseau sous Gnome, donc j'y suis allé ''comme un geek''.
<cadre type=alert>Cette solution n'est donc pas optimale si vous utilisez aussi fréquemment la carte filaire que la carte sans-fil. Cependant, ceci risque de devenir obsolète dans la version suivante de Ubuntu qui devrait intégrer Network-Manager, qui fait du beau travail à en croire les captures d'écrans :)</cadre>

=== Configuration des interfaces ===
Tout d'abord, on va un peu épurer le fichier de configuration automatique des interfaces.
<code># This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
iface eth0 inet dhcp

auto wlan0
iface wlan0 inet dhcp
pre-up /etc/init.d/wpasupplicant start
wireless-mode Managed
wireless-essid "MADOUIFI"
wireless-key "SupèRecléDelAmor,Avecdetrucch3l0us;)"
pre-down /etc/init.d/wpasupplicant stop
</code>
Maintenant que vous êtes un baroudeur de ce fichier vous avez dû remarquer les choses suivantes :
* eth0 n'est plus confiée à hotplug : celui-ci à la facheuse tendance de lui faire prendre le dessus sur wlan0, ça m'énervait :)
* On laisse tout de même eth0 en mode DHCP, mais plus en initialisation automatique (C'est là que je dis que ça favorise plutôt la carte Wi-fi).
* Les lignes pre-up et pre-down vont démarrer quelque chose encore inconnu et sûrement non installé. Mais gardez patience, sinon on ne va pas y arriver :)
* Les lignes wireless- servent à configurer la carte Wi-fi. Je ne crois pas que ce soit utile, car wpasupplicant devrais s'en charger, mais bon. C'est là l'une des marques de mes lacunes ;)

=== Installation et utilisation de wpasupplicant ===
Si vous vous en souvenez, wpasupplicant est un des projets développés en même temps que hostAPd. Ça tombe plutôt bien :). Wpasupplicant est un client WPA permettant de faire marcher quasiment n'importe quelle carte Wi-fi sur un réseau protégé en WPA.

On commence donc par télécharger le paquet Ubuntu :

<code>sudo apt-get install wpasupplicant
</code>

Ensuite, on va éditez son fichier de configuration pour qu'il convienne à notre réseau. Ce fichier s'appelle /etc/wpa_supplicant.conf :

<code># Faites zless /usr/share/doc/wpasupplicant/wpa_supplicant.conf.gz pour voir toutes les otptions disponibles

# Ne rien changer ici
ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0

eapol_version=1
ap_scan=1
fast_reauth=1

# Déclaration et paramétrage d'un réseau
network={
# Le même SSID du point d'accès
ssid="MADOUIFI"
key_mgmt=WPA-PSK
psk="SupèRecléDelAmor,Avecdetrucch3l0us;)"
}
</code>

Et on redémarre le réseau à l'aide de la commande :

<code>sudo /etc/init.d/networking restart
</code>

Ensuite, il suffit d'attendre un certain moment, le temps que l'authentification se fasse et que le serveur DHCP réagisse. Normalement, en tapant /sbin/ifconfig vous devriez obtenir ceci :
<code>lo Lien encap:Boucle locale
inet adr:127.0.0.1 Masque:255.0.0.0
adr inet6: ::1/128 Scope:Hôte
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:142349 errors:0 dropped:0 overruns:0 frame:0
TX packets:142349 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:0
RX bytes:10530324 (10.0 MiB) TX bytes:10530324 (10.0 MiB)

wlan0 Lien encap:Ethernet HWaddr 00:15:F2:CC:F4:39
inet adr:192.168.0.3 Bcast:192.168.0.255 Masque:255.255.255.0
adr inet6: fe80::215:f2ff:fecc:f439/64 Scope:Lien
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:90878 errors:0 dropped:0 overruns:0 frame:0
TX packets:60354 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 lg file transmission:1000
RX bytes:98143829 (93.5 MiB) TX bytes:5812510 (5.5 MiB)
Mémoire:fe3fc000-fe3fdfff
</code>
La carte wlan0 avec l'état ''UP'' et une adresse IP (''inet adr'').

=== Pistes en cas de problèmes ===
* Lancer hostAPd à la main en mode debug avec la commande
<code>/usr/local/bin/hostapd -dd /etc/hostapd/hostapd.conf
</code>Puis relancez le client. Le journal qui s'affiche peut aider grandement le diagnostic.
* Vérifier que votre serveur DHCP est bien actif. Sur le client, tapez :
<code>sudo dhclient
</code>Si ça ne se finit pas par l'attribution d'une adresse IP, il y a un problème.

== ... comme sous Windows ==
Il est également possible d'utiliser wpasupplicant sous Windows. Seulement, quitte à utiliser ce système d'exploitation, autant le faire à fond.
La plupart du temps, un utilitaire de connexion Wi-fi est fourni avec votre matériel. Je ne peux malheureusement pas vous aider là-dessus de façon globale :(

Sinon, je vous rassure, avec Windows XP SP2, l'utilitaire de connexion sans fil Windows marche très bien. Cliquez sur la petite icône de votre carte réseau en bas à droite à côté de l'heure (souvent, c'est un petit écran depuis lequel partent des ondes stylisées). Il devrait vous afficher la liste des réseaux sans-fils. Choisissez le votre, cliquez sur "Connecter" et rentrez la clé. Bienvenue chez vous :)

= Conclusion =

Le wifi sous Linux c'est possible et ça marche bien. Je n'ai jamais utilisé de solutions propriétaires, donc je ne peux pas comparer, mais j'ai pu monter mon réseau sécurisé à moindre coût (mais avec un peu de temps :p).

<cadre type=alert>Je tiens à prévenir le public sensible qu'aucun pot de rillettes n'a été maltraité pendant la réalisation de ce tutorial, pour mon plus grand malheur
</cadre>

{{Copy|Avril 2006|Glandos|FDL}}

LéaLinux:Accueil

2005-10-13T22:12:07Z

Manu : /* Transition */

__NOTOC__
= Bienvenue sur Léa =
{| width="100%"
| valign="top" |
== Léa passe au Wiki ==
Les contributeurs de Léa sont très nombreux, mais contribuer à Léa a toujours été problématique. L'histoire de Léa est longue et lourde. Je veux dire par là que pendant très longtemps les évolutions de Léa ont été suspendues aux bonnes volontés du tout petit groupe d'administrateurs.

Il fallait que ça change. Tout d'abord les administrateurs se trouvent crouler (pleurez avec nous) sous la charge de travail. Ensuite les contributeurs ont l'impression que nous n'apprécions pas leur travail puisque nous ne le mettons pas en ligne. Enfin, rien n'était ''user friendly''.

C'est pourquoi Léa a décidé de changer presque complètement : elle passe au Wiki. C'est à dire que tout le monde peut proposer des modifications pour toutes les pages. Seulement, pour que ces modifications restent un minimum vérifiées, à la différence d'un wiki classique, celui de Léa sera modéré a priori. C'est à dire que les modifications n'apparaîtront de suite, elles devront être validées par les modérateurs.

Pour éviter un minimum les robots et autres spammeurs en puissance, nous avons aussi décidé qu'il faudrait être enregistré pour pouvoir éditer une page. Ceci dit, la création d'un compte sera simple, et ne nécessitera pas notre approbation.

| valign="top" |
== Utilisateurs ==

Léa aura aussi besoin de 2 nouvelles catégories d'utilisateurs : les '''éditeurs''' et les '''modérateurs''', les premiers seront des utilisateurs pouvant voir et modifier l'intégralité du wiki de Léa et en modifier les pages (enfin pour les modifications, certaines parties du site resteront en accès administrateur uniquement). Les seconds auront les mêmes droits, plus celui de valider les modifications d'une page pour affichage sur la partie publique du site.

Les adhérents de l'association Léa auront de droit un accès éditeurs. Il faudra quand même qu'ils le demandent. Les modérateurs seront recrutés parmi l'ensemble des utilisateurs habituels de Léa par les administrateurs du site.

Il est prévu d'unifier les identifications à phorum et mediawiki par l'intermédiaire d'un ''plugin'' d'authentification à mediawiki. Pour l'instant ce ''plugin'' est à l'étude.

|-
| valign="top" |

== Choix du Wiki ==

Nous avons choisi comme wiki pour Léa : [http://mediawiki.org mediawiki], il est bien maintenu et dispose d'une grande base d'utilisateurs. Comme mediawiki ne permet pas la modération à priori des articles nous avons donc du développer une interface de modération ainsi qu'un cache statique (ie: une page du wiki ne générera en général qu'un seul appel à PHP, elle sera ensuite sauvée sous son nom dans l'arborescence de Léa évitant à la demande suivante un appel à php, et donc limitera la charge du serveur). De plus nous avons installé TurckMMCache sur le serveur de Léa puisque mediawiki sait le gérer.

PS: Il semblerait que TurckMMCache occasionne des plantages d'apache. Nous ne savons donc pas encore s'il va rester en place.

| valign="top" |

== Transition ==
Il a fallu transformer la plupart des pages de Léa au format Wiki, cette transformation n'a pas été faite à la main ! Nous ne sommes pas des bêtes de somme ! Le revers de la médaille c'est que certaines pages ont été mal converties. Nous allons donc faire appel à vous et au fait que Léa est maintenant un wiki pour régler ce problème. Pas la peine de nous consulter : '''éditez vous même !''' Vous verrez c'est facile.

'''P.S. :''' normalement, toutes les anciennes pages de Léa restent accessibles, soit qu'elles aient été traduites en wiki, soit que les répertoires en question restent inchangés. Si une page a disparu : [[LéaLinux:BugReport|faites un rapport de bug]]
|}

Ceci dit, il y a aussi des bugs ! Vous serez gentils de bien vouloir les signaler sur cette page : [[LéaLinux:BugReport]].

<newbox>Un premier travail collectif</newbox>
Comme premier travail collectif, nous vous demandons de concevoir le contenu de la page d'accueil. Pour cela nous n'allons pas travailler sur cette page ci, mais sur la page : [[LéaLinux:Accueil]]

<newbox>Les nouvelles du libres (en direct des flux RSS)</newbox>
{| width="100%" border="0"
| width="50%" valign="top" |<rss>http://www.agendadulibre.org/rss.php?region=all|short|max=5</rss>
| width="50%" valign="top" |<rss>http://linuxfr.org/backend/news/rss20.rss|short|max=5</rss>
|}

<newbox>Les pages d'introduction à Linux</newbox>
{| width="100%" border="0"
! width="50%" valign="top" align="left" | Les pages suivantes constituent le point d'entrée obligatoire à Léa.
! width="50%" valign="top" align="left" | Les pages suivantes sont des fiches spéciales débutant
|-
| valign="top" | <DPL>category=Introduction à Linux</DPL>
| valign="top" |<DPL>category=Fiches pratiques</DPL>
|}

{{DP}}

LéaLinux:Accueil

2005-10-13T22:10:39Z

Manu : /* Choix du Wiki */

__NOTOC__
= Bienvenue sur Léa =
{| width="100%"
| valign="top" |
== Léa passe au Wiki ==
Les contributeurs de Léa sont très nombreux, mais contribuer à Léa a toujours été problématique. L'histoire de Léa est longue et lourde. Je veux dire par là que pendant très longtemps les évolutions de Léa ont été suspendues aux bonnes volontés du tout petit groupe d'administrateurs.

Il fallait que ça change. Tout d'abord les administrateurs se trouvent crouler (pleurez avec nous) sous la charge de travail. Ensuite les contributeurs ont l'impression que nous n'apprécions pas leur travail puisque nous ne le mettons pas en ligne. Enfin, rien n'était ''user friendly''.

C'est pourquoi Léa a décidé de changer presque complètement : elle passe au Wiki. C'est à dire que tout le monde peut proposer des modifications pour toutes les pages. Seulement, pour que ces modifications restent un minimum vérifiées, à la différence d'un wiki classique, celui de Léa sera modéré a priori. C'est à dire que les modifications n'apparaîtront de suite, elles devront être validées par les modérateurs.

Pour éviter un minimum les robots et autres spammeurs en puissance, nous avons aussi décidé qu'il faudrait être enregistré pour pouvoir éditer une page. Ceci dit, la création d'un compte sera simple, et ne nécessitera pas notre approbation.

| valign="top" |
== Utilisateurs ==

Léa aura aussi besoin de 2 nouvelles catégories d'utilisateurs : les '''éditeurs''' et les '''modérateurs''', les premiers seront des utilisateurs pouvant voir et modifier l'intégralité du wiki de Léa et en modifier les pages (enfin pour les modifications, certaines parties du site resteront en accès administrateur uniquement). Les seconds auront les mêmes droits, plus celui de valider les modifications d'une page pour affichage sur la partie publique du site.

Les adhérents de l'association Léa auront de droit un accès éditeurs. Il faudra quand même qu'ils le demandent. Les modérateurs seront recrutés parmi l'ensemble des utilisateurs habituels de Léa par les administrateurs du site.

Il est prévu d'unifier les identifications à phorum et mediawiki par l'intermédiaire d'un ''plugin'' d'authentification à mediawiki. Pour l'instant ce ''plugin'' est à l'étude.

|-
| valign="top" |

== Choix du Wiki ==

Nous avons choisi comme wiki pour Léa : [http://mediawiki.org mediawiki], il est bien maintenu et dispose d'une grande base d'utilisateurs. Comme mediawiki ne permet pas la modération à priori des articles nous avons donc du développer une interface de modération ainsi qu'un cache statique (ie: une page du wiki ne générera en général qu'un seul appel à PHP, elle sera ensuite sauvée sous son nom dans l'arborescence de Léa évitant à la demande suivante un appel à php, et donc limitera la charge du serveur). De plus nous avons installé TurckMMCache sur le serveur de Léa puisque mediawiki sait le gérer.

PS: Il semblerait que TurckMMCache occasionne des plantages d'apache. Nous ne savons donc pas encore s'il va rester en place.

| valign="top" |

== Transition ==
Il a fallu transformer la plupart des pages de Léa au format Wiki, cette transformation n'a pas été faite à la main ! Nous ne sommes pas des bêtes de somme ! Le revers de la médaille c'est que certaines pages ont été mal converties. Nous allons donc faire appel à vous et au fait que Léa est maintenant un wiki pour régler ce problème. Pas la peine de nous consulter : '''éditez vous même !''' Vous verrez c'est facile.

'''P.S. :''' normalement, toutes les anciennes pages de Léa restent accessibles, soit qu'elles aient été traduites en wiki, soit que les répertoires en question restent inchangé. Si une page a disparu : [[LéaLinux:BugReport|faites un rapport de bug]]
|}

Ceci dit, il y a aussi des bugs ! Vous serez gentils de bien vouloir les signaler sur cette page : [[LéaLinux:BugReport]].

<newbox>Un premier travail collectif</newbox>
Comme premier travail collectif, nous vous demandons de concevoir le contenu de la page d'accueil. Pour cela nous n'allons pas travailler sur cette page ci, mais sur la page : [[LéaLinux:Accueil]]

<newbox>Les nouvelles du libres (en direct des flux RSS)</newbox>
{| width="100%" border="0"
| width="50%" valign="top" |<rss>http://www.agendadulibre.org/rss.php?region=all|short|max=5</rss>
| width="50%" valign="top" |<rss>http://linuxfr.org/backend/news/rss20.rss|short|max=5</rss>
|}

<newbox>Les pages d'introduction à Linux</newbox>
{| width="100%" border="0"
! width="50%" valign="top" align="left" | Les pages suivantes constituent le point d'entrée obligatoire à Léa.
! width="50%" valign="top" align="left" | Les pages suivantes sont des fiches spéciales débutant
|-
| valign="top" | <DPL>category=Introduction à Linux</DPL>
| valign="top" |<DPL>category=Fiches pratiques</DPL>
|}

{{DP}}

LéaLinux:Accueil

2005-10-13T22:08:26Z

Manu : /* Utilisateurs */

__NOTOC__
= Bienvenue sur Léa =
{| width="100%"
| valign="top" |
== Léa passe au Wiki ==
Les contributeurs de Léa sont très nombreux, mais contribuer à Léa a toujours été problématique. L'histoire de Léa est longue et lourde. Je veux dire par là que pendant très longtemps les évolutions de Léa ont été suspendues aux bonnes volontés du tout petit groupe d'administrateurs.

Il fallait que ça change. Tout d'abord les administrateurs se trouvent crouler (pleurez avec nous) sous la charge de travail. Ensuite les contributeurs ont l'impression que nous n'apprécions pas leur travail puisque nous ne le mettons pas en ligne. Enfin, rien n'était ''user friendly''.

C'est pourquoi Léa a décidé de changer presque complètement : elle passe au Wiki. C'est à dire que tout le monde peut proposer des modifications pour toutes les pages. Seulement, pour que ces modifications restent un minimum vérifiées, à la différence d'un wiki classique, celui de Léa sera modéré a priori. C'est à dire que les modifications n'apparaîtront de suite, elles devront être validées par les modérateurs.

Pour éviter un minimum les robots et autres spammeurs en puissance, nous avons aussi décidé qu'il faudrait être enregistré pour pouvoir éditer une page. Ceci dit, la création d'un compte sera simple, et ne nécessitera pas notre approbation.

| valign="top" |
== Utilisateurs ==

Léa aura aussi besoin de 2 nouvelles catégories d'utilisateurs : les '''éditeurs''' et les '''modérateurs''', les premiers seront des utilisateurs pouvant voir et modifier l'intégralité du wiki de Léa et en modifier les pages (enfin pour les modifications, certaines parties du site resteront en accès administrateur uniquement). Les seconds auront les mêmes droits, plus celui de valider les modifications d'une page pour affichage sur la partie publique du site.

Les adhérents de l'association Léa auront de droit un accès éditeurs. Il faudra quand même qu'ils le demandent. Les modérateurs seront recrutés parmi l'ensemble des utilisateurs habituels de Léa par les administrateurs du site.

Il est prévu d'unifier les identifications à phorum et mediawiki par l'intermédiaire d'un ''plugin'' d'authentification à mediawiki. Pour l'instant ce ''plugin'' est à l'étude.

|-
| valign="top" |

== Choix du Wiki ==

Nous avons choisi comme wiki pour Léa : [http://mediawiki.org mediawiki], il est bien maintenu et dispose d'une grande base d'utilisateur. Comme mediawiki ne permet pas la modération à priori des articles nous avons donc du développer un interface de modération ainsi qu'un cache statique (ie: une page du wiki ne générera en général qu'un seul appel à PHP, elle sera ensuite sauvée sous son nom dans l'arborescence de Léa évitant à la demande suivant un appel à php, et donc limitera la charge du serveur. De plus nous avons installé TurckMMCache sur le serveur de Léa puisque mediawiki sait le gérer.

PS: Il semblerait que TurckMMCache occasionne des plantages d'apache. Nous ne savons donc pas encore s'il va rester en place.

| valign="top" |
== Transition ==
Il a fallu transformer la plupart des pages de Léa au format Wiki, cette transformation n'a pas été faite à la main ! Nous ne sommes pas des bêtes de somme ! Le revers de la médaille c'est que certaines pages ont été mal converties. Nous allons donc faire appel à vous et au fait que Léa est maintenant un wiki pour régler ce problème. Pas la peine de nous consulter : '''éditez vous même !''' Vous verrez c'est facile.

'''P.S. :''' normalement, toutes les anciennes pages de Léa restent accessibles, soit qu'elles aient été traduites en wiki, soit que les répertoires en question restent inchangé. Si une page a disparu : [[LéaLinux:BugReport|faites un rapport de bug]]
|}

Ceci dit, il y a aussi des bugs ! Vous serez gentils de bien vouloir les signaler sur cette page : [[LéaLinux:BugReport]].

<newbox>Un premier travail collectif</newbox>
Comme premier travail collectif, nous vous demandons de concevoir le contenu de la page d'accueil. Pour cela nous n'allons pas travailler sur cette page ci, mais sur la page : [[LéaLinux:Accueil]]

<newbox>Les nouvelles du libres (en direct des flux RSS)</newbox>
{| width="100%" border="0"
| width="50%" valign="top" |<rss>http://www.agendadulibre.org/rss.php?region=all|short|max=5</rss>
| width="50%" valign="top" |<rss>http://linuxfr.org/backend/news/rss20.rss|short|max=5</rss>
|}

<newbox>Les pages d'introduction à Linux</newbox>
{| width="100%" border="0"
! width="50%" valign="top" align="left" | Les pages suivantes constituent le point d'entrée obligatoire à Léa.
! width="50%" valign="top" align="left" | Les pages suivantes sont des fiches spéciales débutant
|-
| valign="top" | <DPL>category=Introduction à Linux</DPL>
| valign="top" |<DPL>category=Fiches pratiques</DPL>
|}

{{DP}}