Unix/Linux Go Back    


Linux 2.6 - man page for wpa_supplicant.conf (linux section 5)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


WPA_SUPPLICANT.CONF(5)							   WPA_SUPPLICANT.CONF(5)

NAME
       wpa_supplicant.conf - configuration file for wpa_supplicant

OVERVIEW
       wpa_supplicant  is configured using a text file that lists all accepted networks and secu-
       rity policies, including pre-shared keys. See the example configuration file, probably  in
       /usr/share/doc/wpa_supplicant/,	for  detailed  information about the configuration format
       and supported fields.

       All file paths in this configuration file should use full (absolute, not relative to work-
       ing  directory) path in order to allow working directory to be changed. This can happen if
       wpa_supplicant is run in the background.

       Changes to configuration file can be reloaded be sending SIGHUP signal  to  wpa_supplicant
       ('killall  -HUP	wpa_supplicant').  Similarly, reloading can be triggered with the wpa_cli
       reconfigure command.

       Configuration file can include one or more network blocks, e.g., one for each  used  SSID.
       wpa_supplicant  will  automatically  select the best network based on the order of network
       blocks in the configuration file, network security level (WPA/WPA2 is preferred), and sig-
       nal strength.

QUICK EXAMPLES
       1. WPA-Personal (PSK) as home network and WPA-Enterprise with EAP-TLS as work network.

	  # allow frontend (e.g., wpa_cli) to be used by all users in 'wheel' group
	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  #
	  # home network; allow all valid ciphers
	  network={
	       ssid="home"
	       scan_ssid=1
	       key_mgmt=WPA-PSK
	       psk="very secret passphrase"
	  }
	  #
	  # work network; use EAP-TLS with WPA; allow only CCMP and TKIP ciphers
	  network={
	       ssid="work"
	       scan_ssid=1
	       key_mgmt=WPA-EAP
	       pairwise=CCMP TKIP
	       group=CCMP TKIP
	       eap=TLS
	       identity="user@example.com"
	       ca_cert="/etc/cert/ca.pem"
	       client_cert="/etc/cert/user.pem"
	       private_key="/etc/cert/user.prv"
	       private_key_passwd="password"
	  }

       2. WPA-RADIUS/EAP-PEAP/MSCHAPv2	with  RADIUS  servers  that use old peaplabel (e.g., Funk
	  Odyssey and SBR, Meetinghouse Aegis, Interlink RAD-Series)

	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  network={
	       ssid="example"
	       scan_ssid=1
	       key_mgmt=WPA-EAP
	       eap=PEAP
	       identity="user@example.com"
	       password="foobar"
	       ca_cert="/etc/cert/ca.pem"
	       phase1="peaplabel=0"
	       phase2="auth=MSCHAPV2"
	  }

       3. EAP-TTLS/EAP-MD5-Challenge configuration with anonymous identity  for  the  unencrypted
	  use. Real identity is sent only within an encrypted TLS tunnel.

	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  network={
	       ssid="example"
	       scan_ssid=1
	       key_mgmt=WPA-EAP
	       eap=TTLS
	       identity="user@example.com"
	       anonymous_identity="anonymous@example.com"
	       password="foobar"
	       ca_cert="/etc/cert/ca.pem"
	       phase2="auth=MD5"
	  }

       4. IEEE	802.1X (i.e., no WPA) with dynamic WEP keys (require both unicast and broadcast);
	  use EAP-TLS for authentication

	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  network={
	       ssid="1x-test"
	       scan_ssid=1
	       key_mgmt=IEEE8021X
	       eap=TLS
	       identity="user@example.com"
	       ca_cert="/etc/cert/ca.pem"
	       client_cert="/etc/cert/user.pem"
	       private_key="/etc/cert/user.prv"
	       private_key_passwd="password"
	       eapol_flags=3
	  }

       5. Catch all example that allows more or less all configuration modes.  The  configuration
	  options  are	used  based on what security policy is used in the selected SSID. This is
	  mostly for testing and is not recommended for normal use.

	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  network={
	       ssid="example"
	       scan_ssid=1
	       key_mgmt=WPA-EAP WPA-PSK IEEE8021X NONE
	       pairwise=CCMP TKIP
	       group=CCMP TKIP WEP104 WEP40
	       psk="very secret passphrase"
	       eap=TTLS PEAP TLS
	       identity="user@example.com"
	       password="foobar"
	       ca_cert="/etc/cert/ca.pem"
	       client_cert="/etc/cert/user.pem"
	       private_key="/etc/cert/user.prv"
	       private_key_passwd="password"
	       phase1="peaplabel=0"
	       ca_cert2="/etc/cert/ca2.pem"
	       client_cert2="/etc/cer/user.pem"
	       private_key2="/etc/cer/user.prv"
	       private_key2_passwd="password"
	  }

       6. Authentication for wired Ethernet. This can be used with wired or roboswitch	interface
	  (-Dwired or -Droboswitch on command line).

	  ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=wheel
	  ap_scan=0
	  network={
	       key_mgmt=IEEE8021X
	       eap=MD5
	       identity="user"
	       password="password"
	       eapol_flags=0
	  }

CERTIFICATES
       Some EAP authentication methods require use of certificates. EAP-TLS uses both server side
       and client certificates whereas EAP-PEAP and EAP-TTLS only require the  server  side  cer-
       tificate.  When	client	certificate  is  used, a matching private key file has to also be
       included in configuration. If the private key uses a passphrase, this has to be configured
       in wpa_supplicant.conf ("private_key_passwd").

       wpa_supplicant  supports  X.509	certificates in PEM and DER formats. User certificate and
       private key can be included in the same file.

       If the user certificate and private key is received in PKCS#12/PFX format, they need to be
       converted to suitable PEM/DER format for wpa_supplicant. This can be done, e.g., with fol-
       lowing commands:

	      # convert client certificate and private key to PEM format
	      openssl pkcs12 -in example.pfx -out user.pem -clcerts
	      # convert CA certificate (if included in PFX file) to PEM format
	      openssl pkcs12 -in example.pfx -out ca.pem -cacerts -nokeys

SEE ALSO
       wpa_supplicant(8) openssl(1)

					07 September 2010		   WPA_SUPPLICANT.CONF(5)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:37 AM.