Differences between revisions 2 and 7 (spanning 5 versions)
Revision 2 as of 2008-10-28 18:52:42
Size: 937
Editor: FranklinPiat
Comment: import ipw3945's wpasuplicant section.
Revision 7 as of 2009-01-22 08:33:51
Size: 5518
Editor: GeoffSimmons
Comment: Add link to WiFi/AdHoc.
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
||<tablestyle="width: 100%;" style="border: 0px hidden">~-[:DebianWiki/EditorGuide#translation:Translation(s)]: none-~||<style="text-align: right;border: 0px hidden"> (!) [:/Discussion:Discussion]||
----
= How to use a WiFi interface =
This page describes how to configure a !WiFi interface on a Debian system, for use on a network.
Line 3: Line 7:
= How To use Wifi network adapter =
''Foreword : The [wiki:WikiPedia:Wired_Equivalent_Privacy WEP] wireless protocol is insecure. DO NOT USE IT ! (It is very easy to capture the network traffic, including your email content and password)''
[[TableOfContents(3)]]
Line 6: Line 9:
 {i} This page is ''under construction'' : your contribution is welcome. Once your wireless device has an interface available (verifiable with ["iwconfig"]), it is required to be configured to access a network. If you do not have a wireless interface present, please refer to ["WiFi"] for information on providing a driver for your device.
Line 8: Line 11:
== Gnome GUI == Wireless network interface configuration can be performed using a connection manager (such as ["NetworkManager"]) or through Debian's /etc/network/interfaces file with a special purpose utility (such as wpa_supplicant). Examples of !NetworkManager and wpa_supplicant configuration are described below.
Line 10: Line 13:
== KDE GUI == <!> The [wiki:WikiPedia:Wired_Equivalent_Privacy WEP] algorithm is insecure and deprecated by ["WPA"]. Use of WEP is '''not recommended''' and is not covered within this document.
Line 12: Line 15:
== Command line == == Network Manager ==
## 'network-manager' is brought in as a dependency of either frontend package.
NetworkManager is configured by graphical interfaces, which are available for [:Gnome:GNOME] and ["KDE"]. Your wireless interface should ''not'' be referenced within Debian's /etc/network/interfaces file.
Line 14: Line 19:
== WPA : using wpasupplicant == === GNOME ===
 1. Install the DebPkg:network-manager-gnome package: {{{
$ su
# aptitude update
# aptitude install network-manager-gnome
}}}
 1. Right-click on a GNOME panel and select "Add to Panel...".
 1. From the list presented, select "Network Monitor" and click "Add". A new systray applet will appear. Click "Close".
 1. Right-click on the applet and select "Properties".
 1. From the dialog presented, click "Configure". You will be asked for the administrative (root) password.
 1. A list of network interfaces will be displayed. Select your wireless interface, then click "Properties".
 1. Tick "Enable this connection" and enter details regarding your wireless network. Click "OK" when finished.
Line 16: Line 32:
Theoretically, you can just install DebPkg:wpasupplicant : See also ["NetworkManager"] for frequently asked questions, documentation and support references.

=== KDE ===
 1. Install the DebPkg:network-manager-kde package: {{{
$ su
# aptitude update
# aptitude install network-manager-kde
}}}
 1. From the K Menu, select "Run Command". Enter "knetworkmanager" and click "Run".
 1. A new systray applet will appear.
ToDo: Complete knetworkmanager procedure.

See also ["NetworkManager"] for frequently asked questions, documentation and support references.

== wpa_supplicant ==
wpa_supplicant is a ["WPA"] client and IEEE 802.1X [wiki:WikiPedia:Supplicant_(computer) supplicant], packaged for Debian as DebPkg:wpasupplicant.

The wpasupplicant package provides {{{wpa-*}}} DebPkg:ifupdown options for /etc/network/interfaces. If these options are specified, wpa_supplicant is started in the background when your wireless interface is raised and stopped when brought down.

Before continuing, install the DebPkg:wpasupplicant package:
Line 18: Line 53:
apt-get install wpasupplicant $ su
#
aptitude update
# aptitude
install wpasupplicant
Line 21: Line 58:
Look at the [http://manpages.debian.net/cgi-bin/man.cgi?query=wpa_supplicant.conf&apropos=0&sektion=5 wpa_supplicant.conf] manpage to determine how to write it. === WPA-PSK and WPA2-PSK ===
{i} Also known as "WPA Personal" and "WPA2 Personal" respectively.
Line 23: Line 61:
 1. Restrict the permissions of /etc/network/interfaces, to prevent PSK disclosure: {{{
# chmod 0600 /etc/network/interfaces
}}}
 1. Open /etc/network/interfaces in a text editor: {{{
# sensible-editor /etc/network/interfaces
}}}
 1. Define appropriate stanzas for your wireless interface, along with the SSID and pre-shared key (PSK). For example: {{{
auto wlan0
iface wlan0 inet dhcp
    wpa-ssid mynetworkname
    wpa-psk mysecretpassphrase
}}}
 The "auto" stanza will bring your interface up at system startup. If not desired, remove or comment this line.
Line 24: Line 75:
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
[[BR]]
 1. Save the file and exit the editor.
 1. Bring your interface up. This will start wpa_supplicant as a background process. {{{
# ifup wlan0
}}}
Line 39: Line 80:
------
CategoryProposedDeletion : This page was created on 2008-10. It should be deleted by 2009-04 if it's still empty.
Additional {{{wpa-*}}} options are described within /usr/share/doc/wpasupplicant/README.modes.gz. This should also be read if connecting to a network not broadcasting its SSID.

For general /etc/network/interfaces information, see the [http://manpages.debian.net/cgi-bin/man.cgi?query=interfaces&apropos=0&sektion=5 interfaces] man page.

=== WPA-EAP ===

For networks using [wiki:WikiPedia:Extensible_Authentication_Protocol EAP-TLS], you are required to establish a wpa_supplicant configuration file and provide the client-side certificate. An example WPA2-EAP configuration file can be found at [file:///usr/share/doc/wpasupplicant/examples/wpa2-eap-ccmp.conf /usr/share/doc/wpasupplicant/examples/wpa2-eap-ccmp.conf].

Once available, reference your configuration file in /etc/network/interfaces. For example:
 {{{
auto wlan0
iface wlan0 inet dhcp
    wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf
}}}

More information can be found in the [http://manpages.debian.net/cgi-bin/man.cgi?query=wpa_supplicant.conf&apropos=0&sektion=5 wpa_supplicant.conf] man page. A fully-commented wpa_supplicant configuration file example is at /usr/share/doc/wpasupplicant/README.wpa_supplicant.conf.gz.

== See Also ==
 * ["WiFi/AdHoc"] - Establishing a !WiFi network without an access point.
 * ["iwconfig"]
 * ["NetworkConfiguration"]
 * ["NetworkManager"]
 * ["WiFi"]
 * ["WPA"]

----
CategoryNetwork CategoryWireless

[:DebianWiki/EditorGuide#translation:Translation(s)]: none

(!) [:/Discussion:Discussion]


How to use a WiFi interface

This page describes how to configure a WiFi interface on a Debian system, for use on a network.

?TableOfContents(3)

Once your wireless device has an interface available (verifiable with ["iwconfig"]), it is required to be configured to access a network. If you do not have a wireless interface present, please refer to ["WiFi"] for information on providing a driver for your device.

Wireless network interface configuration can be performed using a connection manager (such as ["NetworkManager"]) or through Debian's /etc/network/interfaces file with a special purpose utility (such as wpa_supplicant). Examples of NetworkManager and wpa_supplicant configuration are described below.

<!> The [wiki:Wired_Equivalent_Privacy WEP] algorithm is insecure and deprecated by ["WPA"]. Use of WEP is not recommended and is not covered within this document.

Network Manager

NetworkManager is configured by graphical interfaces, which are available for [:Gnome:GNOME] and ["KDE"]. Your wireless interface should not be referenced within Debian's /etc/network/interfaces file.

GNOME

  1. Install the network-manager-gnome package:

    $ su
    # aptitude update
    # aptitude install network-manager-gnome
  2. Right-click on a GNOME panel and select "Add to Panel...".
  3. From the list presented, select "Network Monitor" and click "Add". A new systray applet will appear. Click "Close".
  4. Right-click on the applet and select "Properties".
  5. From the dialog presented, click "Configure". You will be asked for the administrative (root) password.
  6. A list of network interfaces will be displayed. Select your wireless interface, then click "Properties".
  7. Tick "Enable this connection" and enter details regarding your wireless network. Click "OK" when finished.

See also ["NetworkManager"] for frequently asked questions, documentation and support references.

KDE

  1. Install the network-manager-kde package:

    $ su
    # aptitude update
    # aptitude install network-manager-kde
  2. From the K Menu, select "Run Command". Enter "knetworkmanager" and click "Run".
  3. A new systray applet will appear.

ToDo: Complete knetworkmanager procedure.

See also ["NetworkManager"] for frequently asked questions, documentation and support references.

wpa_supplicant

wpa_supplicant is a ["WPA"] client and IEEE 802.1X [wiki:Supplicant_(computer) supplicant], packaged for Debian as wpasupplicant.

The wpasupplicant package provides wpa-* ifupdown options for /etc/network/interfaces. If these options are specified, wpa_supplicant is started in the background when your wireless interface is raised and stopped when brought down.

Before continuing, install the wpasupplicant package:

  • $ su
    # aptitude update
    # aptitude install wpasupplicant

WPA-PSK and WPA2-PSK

{i} Also known as "WPA Personal" and "WPA2 Personal" respectively.

  1. Restrict the permissions of /etc/network/interfaces, to prevent PSK disclosure:

    # chmod 0600 /etc/network/interfaces
  2. Open /etc/network/interfaces in a text editor:

    # sensible-editor /etc/network/interfaces
  3. Define appropriate stanzas for your wireless interface, along with the SSID and pre-shared key (PSK). For example:

    auto wlan0
    iface wlan0 inet dhcp
        wpa-ssid mynetworkname
        wpa-psk mysecretpassphrase
    The "auto" stanza will bring your interface up at system startup. If not desired, remove or comment this line.
  4. Save the file and exit the editor.
  5. Bring your interface up. This will start wpa_supplicant as a background process.

    # ifup wlan0

Additional wpa-* options are described within /usr/share/doc/wpasupplicant/README.modes.gz. This should also be read if connecting to a network not broadcasting its SSID.

For general /etc/network/interfaces information, see the [http://manpages.debian.net/cgi-bin/man.cgi?query=interfaces&apropos=0&sektion=5 interfaces] man page.

WPA-EAP

For networks using [wiki:Extensible_Authentication_Protocol EAP-TLS], you are required to establish a wpa_supplicant configuration file and provide the client-side certificate. An example WPA2-EAP configuration file can be found at [file:///usr/share/doc/wpasupplicant/examples/wpa2-eap-ccmp.conf /usr/share/doc/wpasupplicant/examples/wpa2-eap-ccmp.conf].

Once available, reference your configuration file in /etc/network/interfaces. For example:

  • auto wlan0
    iface wlan0 inet dhcp
        wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf

More information can be found in the [http://manpages.debian.net/cgi-bin/man.cgi?query=wpa_supplicant.conf&apropos=0&sektion=5 wpa_supplicant.conf] man page. A fully-commented wpa_supplicant configuration file example is at /usr/share/doc/wpasupplicant/README.wpa_supplicant.conf.gz.

See Also


CategoryNetwork CategoryWireless