====== interfaces : configuration WiFi ======

  * Objet : Configuration du WiFi dans le fichier interfaces
  * Niveau requis : {{tag>débutant avisé}}
  * Commentaires : //Écrire la configuration de connexion pour le WiFi.//
  * Débutant, à savoir : [[doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] - [[doc:reseau:wifi|Prérequis WiFi]] - [[doc:reseau:interfaces|Le fichier interfaces]] :-)
  * Suivi : {{tag>à-tester}} 
    * Création par [[user>deuchdeb]] le 16/11/2010
    * Testé par <...> le <...>
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=7412|ici]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

===== Introduction =====

Le fichier **/etc/network/interfaces** sert à paramétrer l'accès de votre ordinateur à un réseau. \\ 
Nous allons voir dans ce tuto comment le configurer de façon simple et basique pour que votre ordinateur se connecte à internet en **WiFi** par l'intermédiaire d'un point d'accès, habituellement un routeur comme par exemple la //Box// de votre fournisseur d'accès.

===== Détection du matériel =====

On supposera ici que le matériel WiFi est correctement détecté. Si ça n'est pas le cas, suivez le tutoriel suivant :

  * [[doc:materiel:wifi:detecter|Pas à pas : Faire que sa carte WiFi soit détectée]]

===== Conflits entre outils =====

La configuration du réseau via le fichier **interfaces** utilise les outils [[doc:reseau:wireless-tools|wireless-tools]] et [[doc:reseau:wpasupplicant|wpasupplicant]].

Assurez-vous qu'ils sont installés.

<code root>apt-get update && apt-get install wireless-tools wpasupplicant</code>

Il est à noter que **wpasupplicant** n'est nécessaire que pour l'utilisation d'un chiffrement **WPA**, ce qui doit être le cas si votre réseau est réellement sécurisé.

<note info>Suivant leur configuration, d'autres outils de gestion du WiFi peuvent entrer en conflit (toutefois cela ne devrait plus se produire depuis Debian 7 Wheezy). Si vous ne les utilisez pas, désinstallez-les :
<code root>apt-get remove --purge network-manager wicd</code></note>

===== Identifier la carte réseau WiFi =====

Nous allons utiliser la commande **iwconfig** dans un [[doc:systeme:terminal|terminal]] en [[doc:systeme:superutilisateur|root]] :

<code root>iwconfig </code>

Cela doit nous retourner quelque chose comme ceci :
<file config retour de la commande>lo        no wireless extensions.

eth0      no wireless extensions.

wlp3s0    IEEE 802.11b  ESSID:off/any
          Mode:Managed  Channel:0  Access Point: Not-Associated
          Bit Rate:54 Mb/s   Sensitivity=-200 dBm
          RTS thr=2346 B   Fragment thr=2346 B
          Encryption key:off
          Power Management:off
          Link Quality:0  Signal level:0  Noise level:0
          Rx invalid nwid:0  Rx invalid crypt:0  Rx invalid frag:0
          Tx excessive retries:0  Invalid misc:0   Missed beacon:0</file>

Notre carte réseau sans fil est détectée et s'appelle (dans cet exemple) : **wlp3s0**. \\
Nous pouvons maintenant configurer cette carte pour qu'elle communique avec notre //SuperBox// :-D

==== Carte WiFi non détectée ====

Si notre carte WiFi n'est pas détectée, voir :
  * [[doc:materiel:wifi:detecter#etape-1identifier-la-carte-reseau|Étape 1 : Identifier la carte réseau]]

===== Édition du fichier /etc/network/interfaces =====

<note tip>Pour la syntaxe générale de ce fichier, nous vous recommandons de parcourir le tutoriel suivant : [[doc:reseau:interfaces|le fichier interfaces]]. En effet, une interface WiFi est une interface réseau traditionnelle, à laquelle on ajoute en plus des informations de connexion WiFi.</note>

==== Sans chiffrement ====

Si vous n'avez pas mis de dispositif de clé ce sont ces lignes qu'il faut utiliser :

<code>
auto wlp3s0=wifi-maison
iface wifi-maison inet dhcp
wireless-mode  managed
wireless-essid NomDuReseau
wireless-key   off
</code>

==== Cas du chiffrement WEP ====

<note importante>Le chiffrement WEP est obsolète et quasiment inutile. \\
Mais si, comme moi, vous avez une vieille //SuperBox//, il faudra vous en contenter.</note>

Pour que la carte **wlp3s0** se connecte au réseau ''NomDuReseau'' protégé par la clé WEP ''MaSuperCleWep'', vous ajoutez les lignes suivantes :

<code>
auto wlp3s0=wifi-maison
iface wifi-maison inet dhcp
wireless-mode  managed
wireless-essid NomDuReseau
wireless-key   s:MaSuperCleWep
</code>

Si vous disposez de la clé WEP sous forme hexadécimale, les lignes à ajouter sont du type :

<code>
auto wlp3s0=wifi-maison
iface wifi-maison inet dhcp
wireless-mode  managed
wireless-essid NomDuReseau
wireless-key   4d615375706572436c65576570
</code>

<note tip>On note que l'ESSID est le nom du réseau WiFi, et que la clé doit être préfixée de « s: » si elle n'est pas donnée en hexadécimal.</note>

==== Cas du chiffrement WPA / WPA2 ====

<note>Le chiffrement WPA est bien plus solide que le WEP. C'est désormais le standard.</note>

Pour que la carte **wlp3s0** se connecte au réseau ''NomDuReseau'' protégé par la clé WPA ''CleDeChiffrement'', vous ajoutez les lignes suivantes :

<code>
auto wlp3s0=wifi-maison
iface wifi-maison inet dhcp
wpa-ssid "NomDuReseau"
wpa-psk  "CleDeChiffrement"
</code>
Vous pouvez alternativement utiliser la valeur ''psk'' générée par l'outil **wpa_passphrase** :
<code user>wpa_passphrase "NomDuReseau" "CleDeChiffrement"</code>
<code config retour de la commande>network={
	ssid="NomDuReseau"
	#psk="CleDeChiffrement"
	psk=9cf6db70550f7aeab81180db86673bbd441dffa29ab51bdfc80b9983507e5866
}</code>
C'est-à-dire finalement :
<code>
auto wlp3s0=wifi-maison
iface wifi-maison inet dhcp
wpa-ssid "NomDuReseau"
wpa-psk  9cf6db70550f7aeab81180db86673bbd441dffa29ab51bdfc80b9983507e5866
</code>

<note warning>Les clés de chiffrement présentées ici sous forme hexadécimale sont des //exemples//, ne les copiez pas dans //votre// propre fichier interfaces. Par ailleurs, en cas de souci de configuration du WiFi, ne postez pas //votre// propre clé de chiffrement sur le forum, une personne désœuvrée mais fière de son pouvoir de nuisance pourrait chercher à l'exploiter de façon bête et méchante !</note>

===== Relancer l'interface =====

Pour relancer l'interface réseau((Dans la configuration de ce tuto.)) :

<code root>ifconfig wlp3s0 down
#ou, pour buster
ip link set wlp3s0 down</code>
<code root>ifup wlp3s0=wifi-maison</code>

===== Liens utiles, voire très utiles =====

  * [[https://web.archive.org/web/20160407122505/http://wiki.chezlefab.net:80/tuto_nix/config_network|Configuration réseau sous Debian, pour faire comme les grands]] (Internet Archive)
  * [[https://web.archive.org/web/20160407084333/http://wiki.chezlefab.net/tuto_nix/comprendre_wifi|Comprendre la configuration du WiFi]] (Internet Archive)
  * [[http://pwet.fr/man/linux/administration_systeme/iwconfig|man iwconfig]] (en français)
  * [[http://pwet.fr/man/linux/formats/interfaces|man interfaces]] (en anglais)
  * [[http://guide.debianizzati.org/index.php/Configurazione_di_una_connessione_wireless|Configurazione di una connessione wireless]] (en italien, oui)
  * [[https://www.debian.org/doc/manuals/debian-reference/ch05.fr.html#_the_basics_of_wireless_lan_interface|Les bases de l’interface réseau sans fil]] (Référence Debian. Configuration du réseau)