1##### Example wpa_supplicant configuration file ############################### 2# 3# ***** Please check wpa_supplicant.conf(5) for details on these options ***** 4# 5# This file describes configuration file format and lists all available option. 6# Please also take a look at simpler configuration examples in 'examples' 7# subdirectory. 8# 9# Empty lines and lines starting with # are ignored 10 11# NOTE! This file may contain password information and should probably be made 12# readable only by root user on multiuser systems. 13 14# Note: All file paths in this configuration file should use full (absolute, 15# not relative to working directory) path in order to allow working directory 16# to be changed. This can happen if wpa_supplicant is run in the background. 17 18# Whether to allow wpa_supplicant to update (overwrite) configuration 19# 20# This option can be used to allow wpa_supplicant to overwrite configuration 21# file whenever configuration is changed (e.g., new network block is added with 22# wpa_cli or wpa_gui, or a password is changed). This is required for 23# wpa_cli/wpa_gui to be able to store the configuration changes permanently. 24# Please note that overwriting configuration file will remove the comments from 25# it. 26#update_config=1 27 28# global configuration (shared by all network blocks) 29# 30# Parameters for the control interface. If this is specified, wpa_supplicant 31# will open a control interface that is available for external programs to 32# manage wpa_supplicant. The meaning of this string depends on which control 33# interface mechanism is used. For all cases, the existence of this parameter 34# in configuration is used to determine whether the control interface is 35# enabled. 36# 37# For UNIX domain sockets (default on Linux and BSD): This is a directory that 38# will be created for UNIX domain sockets for listening to requests from 39# external programs (CLI/GUI, etc.) for status information and configuration. 40# The socket file will be named based on the interface name, so multiple 41# wpa_supplicant processes can be run at the same time if more than one 42# interface is used. 43# /var/run/wpa_supplicant is the recommended directory for sockets and by 44# default, wpa_cli will use it when trying to connect with wpa_supplicant. 45# 46# Access control for the control interface can be configured by setting the 47# directory to allow only members of a group to use sockets. This way, it is 48# possible to run wpa_supplicant as root (since it needs to change network 49# configuration and open raw sockets) and still allow GUI/CLI components to be 50# run as non-root users. However, since the control interface can be used to 51# change the network configuration, this access needs to be protected in many 52# cases. By default, wpa_supplicant is configured to use gid 0 (root). If you 53# want to allow non-root users to use the control interface, add a new group 54# and change this value to match with that group. Add users that should have 55# control interface access to this group. If this variable is commented out or 56# not included in the configuration file, group will not be changed from the 57# value it got by default when the directory or socket was created. 58# 59# When configuring both the directory and group, use following format: 60# DIR=/var/run/wpa_supplicant GROUP=wheel 61# DIR=/var/run/wpa_supplicant GROUP=0 62# (group can be either group name or gid) 63# 64ctrl_interface=/var/run/wpa_supplicant 65 66# IEEE 802.1X/EAPOL version 67# wpa_supplicant is implemented based on IEEE Std 802.1X-2004 which defines 68# EAPOL version 2. However, there are many APs that do not handle the new 69# version number correctly (they seem to drop the frames completely). In order 70# to make wpa_supplicant interoperate with these APs, the version number is set 71# to 1 by default. This configuration value can be used to set it to the new 72# version (2). 73# Note: When using MACsec, eapol_version shall be set to 3, which is 74# defined in IEEE Std 802.1X-2010. 75eapol_version=1 76 77# AP scanning/selection 78# By default, wpa_supplicant requests driver to perform AP scanning and then 79# uses the scan results to select a suitable AP. Another alternative is to 80# allow the driver to take care of AP scanning and selection and use 81# wpa_supplicant just to process EAPOL frames based on IEEE 802.11 association 82# information from the driver. 83# 1: wpa_supplicant initiates scanning and AP selection; if no APs matching to 84# the currently enabled networks are found, a new network (IBSS or AP mode 85# operation) may be initialized (if configured) (default) 86# 0: driver takes care of scanning, AP selection, and IEEE 802.11 association 87# parameters (e.g., WPA IE generation); this mode can also be used with 88# non-WPA drivers when using IEEE 802.1X mode; do not try to associate with 89# APs (i.e., external program needs to control association). This mode must 90# also be used when using wired Ethernet drivers. 91# Note: macsec_qca driver is one type of Ethernet driver which implements 92# macsec feature. 93# 2: like 0, but associate with APs using security policy and SSID (but not 94# BSSID); this can be used, e.g., with ndiswrapper and NDIS drivers to 95# enable operation with hidden SSIDs and optimized roaming; in this mode, 96# the network blocks in the configuration file are tried one by one until 97# the driver reports successful association; each network block should have 98# explicit security policy (i.e., only one option in the lists) for 99# key_mgmt, pairwise, group, proto variables 100# 101# For use in FreeBSD with the wlan module ap_scan must be set to 1. 102# 103# When using IBSS or AP mode, ap_scan=2 mode can force the new network to be 104# created immediately regardless of scan results. ap_scan=1 mode will first try 105# to scan for existing networks and only if no matches with the enabled 106# networks are found, a new IBSS or AP mode network is created. 107ap_scan=1 108 109# MPM residency 110# By default, wpa_supplicant implements the mesh peering manager (MPM) for an 111# open mesh. However, if the driver can implement the MPM, you may set this to 112# 0 to use the driver version. When AMPE is enabled, the wpa_supplicant MPM is 113# always used. 114# 0: MPM lives in the driver 115# 1: wpa_supplicant provides an MPM which handles peering (default) 116#user_mpm=1 117 118# Maximum number of peer links (0-255; default: 99) 119# Maximum number of mesh peering currently maintained by the STA. 120#max_peer_links=99 121 122# Timeout in seconds to detect STA inactivity (default: 300 seconds) 123# 124# This timeout value is used in mesh STA to clean up inactive stations. 125#mesh_max_inactivity=300 126 127# cert_in_cb - Whether to include a peer certificate dump in events 128# This controls whether peer certificates for authentication server and 129# its certificate chain are included in EAP peer certificate events. This is 130# enabled by default. 131#cert_in_cb=1 132 133# EAP fast re-authentication 134# By default, fast re-authentication is enabled for all EAP methods that 135# support it. This variable can be used to disable fast re-authentication. 136# Normally, there is no need to disable this. 137fast_reauth=1 138 139# OpenSSL Engine support 140# These options can be used to load OpenSSL engines. 141# The two engines that are supported currently are shown below: 142# They are both from the opensc project (http://www.opensc.org/) 143# By default no engines are loaded. 144# make the opensc engine available 145#opensc_engine_path=/usr/lib/opensc/engine_opensc.so 146# make the pkcs11 engine available 147#pkcs11_engine_path=/usr/lib/opensc/engine_pkcs11.so 148# configure the path to the pkcs11 module required by the pkcs11 engine 149#pkcs11_module_path=/usr/lib/pkcs11/opensc-pkcs11.so 150 151# OpenSSL cipher string 152# 153# This is an OpenSSL specific configuration option for configuring the default 154# ciphers. If not set, "DEFAULT:!EXP:!LOW" is used as the default. 155# See https://www.openssl.org/docs/apps/ciphers.html for OpenSSL documentation 156# on cipher suite configuration. This is applicable only if wpa_supplicant is 157# built to use OpenSSL. 158#openssl_ciphers=DEFAULT:!EXP:!LOW 159 160 161# Dynamic EAP methods 162# If EAP methods were built dynamically as shared object files, they need to be 163# loaded here before being used in the network blocks. By default, EAP methods 164# are included statically in the build, so these lines are not needed 165#load_dynamic_eap=/usr/lib/wpa_supplicant/eap_tls.so 166#load_dynamic_eap=/usr/lib/wpa_supplicant/eap_md5.so 167 168# Driver interface parameters 169# This field can be used to configure arbitrary driver interace parameters. The 170# format is specific to the selected driver interface. This field is not used 171# in most cases. 172#driver_param="field=value" 173 174# Country code 175# The ISO/IEC alpha2 country code for the country in which this device is 176# currently operating. 177#country=US 178 179# Maximum lifetime for PMKSA in seconds; default 43200 180#dot11RSNAConfigPMKLifetime=43200 181# Threshold for reauthentication (percentage of PMK lifetime); default 70 182#dot11RSNAConfigPMKReauthThreshold=70 183# Timeout for security association negotiation in seconds; default 60 184#dot11RSNAConfigSATimeout=60 185 186# Wi-Fi Protected Setup (WPS) parameters 187 188# Universally Unique IDentifier (UUID; see RFC 4122) of the device 189# If not configured, UUID will be generated based on the local MAC address. 190#uuid=12345678-9abc-def0-1234-56789abcdef0 191 192# Device Name 193# User-friendly description of device; up to 32 octets encoded in UTF-8 194#device_name=Wireless Client 195 196# Manufacturer 197# The manufacturer of the device (up to 64 ASCII characters) 198#manufacturer=Company 199 200# Model Name 201# Model of the device (up to 32 ASCII characters) 202#model_name=cmodel 203 204# Model Number 205# Additional device description (up to 32 ASCII characters) 206#model_number=123 207 208# Serial Number 209# Serial number of the device (up to 32 characters) 210#serial_number=12345 211 212# Primary Device Type 213# Used format: <categ>-<OUI>-<subcateg> 214# categ = Category as an integer value 215# OUI = OUI and type octet as a 4-octet hex-encoded value; 0050F204 for 216# default WPS OUI 217# subcateg = OUI-specific Sub Category as an integer value 218# Examples: 219# 1-0050F204-1 (Computer / PC) 220# 1-0050F204-2 (Computer / Server) 221# 5-0050F204-1 (Storage / NAS) 222# 6-0050F204-1 (Network Infrastructure / AP) 223#device_type=1-0050F204-1 224 225# OS Version 226# 4-octet operating system version number (hex string) 227#os_version=01020300 228 229# Config Methods 230# List of the supported configuration methods 231# Available methods: usba ethernet label display ext_nfc_token int_nfc_token 232# nfc_interface push_button keypad virtual_display physical_display 233# virtual_push_button physical_push_button 234# For WSC 1.0: 235#config_methods=label display push_button keypad 236# For WSC 2.0: 237#config_methods=label virtual_display virtual_push_button keypad 238 239# Credential processing 240# 0 = process received credentials internally (default) 241# 1 = do not process received credentials; just pass them over ctrl_iface to 242# external program(s) 243# 2 = process received credentials internally and pass them over ctrl_iface 244# to external program(s) 245#wps_cred_processing=0 246 247# Vendor attribute in WPS M1, e.g., Windows 7 Vertical Pairing 248# The vendor attribute contents to be added in M1 (hex string) 249#wps_vendor_ext_m1=000137100100020001 250 251# NFC password token for WPS 252# These parameters can be used to configure a fixed NFC password token for the 253# station. This can be generated, e.g., with nfc_pw_token. When these 254# parameters are used, the station is assumed to be deployed with a NFC tag 255# that includes the matching NFC password token (e.g., written based on the 256# NDEF record from nfc_pw_token). 257# 258#wps_nfc_dev_pw_id: Device Password ID (16..65535) 259#wps_nfc_dh_pubkey: Hexdump of DH Public Key 260#wps_nfc_dh_privkey: Hexdump of DH Private Key 261#wps_nfc_dev_pw: Hexdump of Device Password 262 263# Priority for the networks added through WPS 264# This priority value will be set to each network profile that is added 265# by executing the WPS protocol. 266#wps_priority=0 267 268# Maximum number of BSS entries to keep in memory 269# Default: 200 270# This can be used to limit memory use on the BSS entries (cached scan 271# results). A larger value may be needed in environments that have huge number 272# of APs when using ap_scan=1 mode. 273#bss_max_count=200 274 275# Automatic scan 276# This is an optional set of parameters for automatic scanning 277# within an interface in following format: 278#autoscan=<autoscan module name>:<module parameters> 279# autoscan is like bgscan but on disconnected or inactive state. 280# For instance, on exponential module parameters would be <base>:<limit> 281#autoscan=exponential:3:300 282# Which means a delay between scans on a base exponential of 3, 283# up to the limit of 300 seconds (3, 9, 27 ... 300) 284# For periodic module, parameters would be <fixed interval> 285#autoscan=periodic:30 286# So a delay of 30 seconds will be applied between each scan 287 288# filter_ssids - SSID-based scan result filtering 289# 0 = do not filter scan results (default) 290# 1 = only include configured SSIDs in scan results/BSS table 291#filter_ssids=0 292 293# Password (and passphrase, etc.) backend for external storage 294# format: <backend name>[:<optional backend parameters>] 295#ext_password_backend=test:pw1=password|pw2=testing 296 297 298# Disable P2P functionality 299# p2p_disabled=1 300 301# Timeout in seconds to detect STA inactivity (default: 300 seconds) 302# 303# This timeout value is used in P2P GO mode to clean up 304# inactive stations. 305#p2p_go_max_inactivity=300 306 307# Passphrase length (8..63) for P2P GO 308# 309# This parameter controls the length of the random passphrase that is 310# generated at the GO. Default: 8. 311#p2p_passphrase_len=8 312 313# Extra delay between concurrent P2P search iterations 314# 315# This value adds extra delay in milliseconds between concurrent search 316# iterations to make p2p_find friendlier to concurrent operations by avoiding 317# it from taking 100% of radio resources. The default value is 500 ms. 318#p2p_search_delay=500 319 320# Opportunistic Key Caching (also known as Proactive Key Caching) default 321# This parameter can be used to set the default behavior for the 322# proactive_key_caching parameter. By default, OKC is disabled unless enabled 323# with the global okc=1 parameter or with the per-network 324# proactive_key_caching=1 parameter. With okc=1, OKC is enabled by default, but 325# can be disabled with per-network proactive_key_caching=0 parameter. 326#okc=0 327 328# Protected Management Frames default 329# This parameter can be used to set the default behavior for the ieee80211w 330# parameter. By default, PMF is disabled unless enabled with the global pmf=1/2 331# parameter or with the per-network ieee80211w=1/2 parameter. With pmf=1/2, PMF 332# is enabled/required by default, but can be disabled with the per-network 333# ieee80211w parameter. 334#pmf=0 335 336# Enabled SAE finite cyclic groups in preference order 337# By default (if this parameter is not set), the mandatory group 19 (ECC group 338# defined over a 256-bit prime order field) is preferred, but other groups are 339# also enabled. If this parameter is set, the groups will be tried in the 340# indicated order. The group values are listed in the IANA registry: 341# http://www.iana.org/assignments/ipsec-registry/ipsec-registry.xml#ipsec-registry-9 342#sae_groups=21 20 19 26 25 343 344# Default value for DTIM period (if not overridden in network block) 345#dtim_period=2 346 347# Default value for Beacon interval (if not overridden in network block) 348#beacon_int=100 349 350# Additional vendor specific elements for Beacon and Probe Response frames 351# This parameter can be used to add additional vendor specific element(s) into 352# the end of the Beacon and Probe Response frames. The format for these 353# element(s) is a hexdump of the raw information elements (id+len+payload for 354# one or more elements). This is used in AP and P2P GO modes. 355#ap_vendor_elements=dd0411223301 356 357# Ignore scan results older than request 358# 359# The driver may have a cache of scan results that makes it return 360# information that is older than our scan trigger. This parameter can 361# be used to configure such old information to be ignored instead of 362# allowing it to update the internal BSS table. 363#ignore_old_scan_res=0 364 365# scan_cur_freq: Whether to scan only the current frequency 366# 0: Scan all available frequencies. (Default) 367# 1: Scan current operating frequency if another VIF on the same radio 368# is already associated. 369 370# MAC address policy default 371# 0 = use permanent MAC address 372# 1 = use random MAC address for each ESS connection 373# 2 = like 1, but maintain OUI (with local admin bit set) 374# 375# By default, permanent MAC address is used unless policy is changed by 376# the per-network mac_addr parameter. Global mac_addr=1 can be used to 377# change this default behavior. 378#mac_addr=0 379 380# Lifetime of random MAC address in seconds (default: 60) 381#rand_addr_lifetime=60 382 383# MAC address policy for pre-association operations (scanning, ANQP) 384# 0 = use permanent MAC address 385# 1 = use random MAC address 386# 2 = like 1, but maintain OUI (with local admin bit set) 387#preassoc_mac_addr=0 388 389# Interworking (IEEE 802.11u) 390 391# Enable Interworking 392# interworking=1 393 394# Homogenous ESS identifier 395# If this is set, scans will be used to request response only from BSSes 396# belonging to the specified Homogeneous ESS. This is used only if interworking 397# is enabled. 398# hessid=00:11:22:33:44:55 399 400# Automatic network selection behavior 401# 0 = do not automatically go through Interworking network selection 402# (i.e., require explicit interworking_select command for this; default) 403# 1 = perform Interworking network selection if one or more 404# credentials have been configured and scan did not find a 405# matching network block 406#auto_interworking=0 407 408# credential block 409# 410# Each credential used for automatic network selection is configured as a set 411# of parameters that are compared to the information advertised by the APs when 412# interworking_select and interworking_connect commands are used. 413# 414# credential fields: 415# 416# temporary: Whether this credential is temporary and not to be saved 417# 418# priority: Priority group 419# By default, all networks and credentials get the same priority group 420# (0). This field can be used to give higher priority for credentials 421# (and similarly in struct wpa_ssid for network blocks) to change the 422# Interworking automatic networking selection behavior. The matching 423# network (based on either an enabled network block or a credential) 424# with the highest priority value will be selected. 425# 426# pcsc: Use PC/SC and SIM/USIM card 427# 428# realm: Home Realm for Interworking 429# 430# username: Username for Interworking network selection 431# 432# password: Password for Interworking network selection 433# 434# ca_cert: CA certificate for Interworking network selection 435# 436# client_cert: File path to client certificate file (PEM/DER) 437# This field is used with Interworking networking selection for a case 438# where client certificate/private key is used for authentication 439# (EAP-TLS). Full path to the file should be used since working 440# directory may change when wpa_supplicant is run in the background. 441# 442# Alternatively, a named configuration blob can be used by setting 443# this to blob://blob_name. 444# 445# private_key: File path to client private key file (PEM/DER/PFX) 446# When PKCS#12/PFX file (.p12/.pfx) is used, client_cert should be 447# commented out. Both the private key and certificate will be read 448# from the PKCS#12 file in this case. Full path to the file should be 449# used since working directory may change when wpa_supplicant is run 450# in the background. 451# 452# Windows certificate store can be used by leaving client_cert out and 453# configuring private_key in one of the following formats: 454# 455# cert://substring_to_match 456# 457# hash://certificate_thumbprint_in_hex 458# 459# For example: private_key="hash://63093aa9c47f56ae88334c7b65a4" 460# 461# Note that when running wpa_supplicant as an application, the user 462# certificate store (My user account) is used, whereas computer store 463# (Computer account) is used when running wpasvc as a service. 464# 465# Alternatively, a named configuration blob can be used by setting 466# this to blob://blob_name. 467# 468# private_key_passwd: Password for private key file 469# 470# imsi: IMSI in <MCC> | <MNC> | '-' | <MSIN> format 471# 472# milenage: Milenage parameters for SIM/USIM simulator in <Ki>:<OPc>:<SQN> 473# format 474# 475# domain: Home service provider FQDN(s) 476# This is used to compare against the Domain Name List to figure out 477# whether the AP is operated by the Home SP. Multiple domain entries can 478# be used to configure alternative FQDNs that will be considered home 479# networks. 480# 481# roaming_consortium: Roaming Consortium OI 482# If roaming_consortium_len is non-zero, this field contains the 483# Roaming Consortium OI that can be used to determine which access 484# points support authentication with this credential. This is an 485# alternative to the use of the realm parameter. When using Roaming 486# Consortium to match the network, the EAP parameters need to be 487# pre-configured with the credential since the NAI Realm information 488# may not be available or fetched. 489# 490# eap: Pre-configured EAP method 491# This optional field can be used to specify which EAP method will be 492# used with this credential. If not set, the EAP method is selected 493# automatically based on ANQP information (e.g., NAI Realm). 494# 495# phase1: Pre-configure Phase 1 (outer authentication) parameters 496# This optional field is used with like the 'eap' parameter. 497# 498# phase2: Pre-configure Phase 2 (inner authentication) parameters 499# This optional field is used with like the 'eap' parameter. 500# 501# excluded_ssid: Excluded SSID 502# This optional field can be used to excluded specific SSID(s) from 503# matching with the network. Multiple entries can be used to specify more 504# than one SSID. 505# 506# roaming_partner: Roaming partner information 507# This optional field can be used to configure preferences between roaming 508# partners. The field is a string in following format: 509# <FQDN>,<0/1 exact match>,<priority>,<* or country code> 510# (non-exact match means any subdomain matches the entry; priority is in 511# 0..255 range with 0 being the highest priority) 512# 513# update_identifier: PPS MO ID 514# (Hotspot 2.0 PerProviderSubscription/UpdateIdentifier) 515# 516# provisioning_sp: FQDN of the SP that provisioned the credential 517# This optional field can be used to keep track of the SP that provisioned 518# the credential to find the PPS MO (./Wi-Fi/<provisioning_sp>). 519# 520# Minimum backhaul threshold (PPS/<X+>/Policy/MinBackhauldThreshold/*) 521# These fields can be used to specify minimum download/upload backhaul 522# bandwidth that is preferred for the credential. This constraint is 523# ignored if the AP does not advertise WAN Metrics information or if the 524# limit would prevent any connection. Values are in kilobits per second. 525# min_dl_bandwidth_home 526# min_ul_bandwidth_home 527# min_dl_bandwidth_roaming 528# min_ul_bandwidth_roaming 529# 530# max_bss_load: Maximum BSS Load Channel Utilization (1..255) 531# (PPS/<X+>/Policy/MaximumBSSLoadValue) 532# This value is used as the maximum channel utilization for network 533# selection purposes for home networks. If the AP does not advertise 534# BSS Load or if the limit would prevent any connection, this constraint 535# will be ignored. 536# 537# req_conn_capab: Required connection capability 538# (PPS/<X+>/Policy/RequiredProtoPortTuple) 539# This value is used to configure set of required protocol/port pairs that 540# a roaming network shall support (include explicitly in Connection 541# Capability ANQP element). This constraint is ignored if the AP does not 542# advertise Connection Capability or if this constraint would prevent any 543# network connection. This policy is not used in home networks. 544# Format: <protocol>[:<comma-separated list of ports] 545# Multiple entries can be used to list multiple requirements. 546# For example, number of common TCP protocols: 547# req_conn_capab=6,22,80,443 548# For example, IPSec/IKE: 549# req_conn_capab=17:500 550# req_conn_capab=50 551# 552# ocsp: Whether to use/require OCSP to check server certificate 553# 0 = do not use OCSP stapling (TLS certificate status extension) 554# 1 = try to use OCSP stapling, but not require response 555# 2 = require valid OCSP stapling response 556# 557# sim_num: Identifier for which SIM to use in multi-SIM devices 558# 559# for example: 560# 561#cred={ 562# realm="example.com" 563# username="user@example.com" 564# password="password" 565# ca_cert="/etc/wpa_supplicant/ca.pem" 566# domain="example.com" 567#} 568# 569#cred={ 570# imsi="310026-000000000" 571# milenage="90dca4eda45b53cf0f12d7c9c3bc6a89:cb9cccc4b9258e6dca4760379fb82" 572#} 573# 574#cred={ 575# realm="example.com" 576# username="user" 577# password="password" 578# ca_cert="/etc/wpa_supplicant/ca.pem" 579# domain="example.com" 580# roaming_consortium=223344 581# eap=TTLS 582# phase2="auth=MSCHAPV2" 583#} 584 585# Hotspot 2.0 586# hs20=1 587 588# network block 589# 590# Each network (usually AP's sharing the same SSID) is configured as a separate 591# block in this configuration file. The network blocks are in preference order 592# (the first match is used). 593# 594# network block fields: 595# 596# disabled: 597# 0 = this network can be used (default) 598# 1 = this network block is disabled (can be enabled through ctrl_iface, 599# e.g., with wpa_cli or wpa_gui) 600# 601# id_str: Network identifier string for external scripts. This value is passed 602# to external action script through wpa_cli as WPA_ID_STR environment 603# variable to make it easier to do network specific configuration. 604# 605# ssid: SSID (mandatory); network name in one of the optional formats: 606# - an ASCII string with double quotation 607# - a hex string (two characters per octet of SSID) 608# - a printf-escaped ASCII string P"<escaped string>" 609# 610# scan_ssid: 611# 0 = do not scan this SSID with specific Probe Request frames (default) 612# 1 = scan with SSID-specific Probe Request frames (this can be used to 613# find APs that hide (do not broadcast) SSID or use multiple SSIDs; 614# this will add latency to scanning, so enable this only when needed) 615# 616# bssid: BSSID (optional); if set, this network block is used only when 617# associating with the AP using the configured BSSID 618# 619# priority: priority group (integer) 620# By default, all networks will get same priority group (0). If some of the 621# networks are more desirable, this field can be used to change the order in 622# which wpa_supplicant goes through the networks when selecting a BSS. The 623# priority groups will be iterated in decreasing priority (i.e., the larger the 624# priority value, the sooner the network is matched against the scan results). 625# Within each priority group, networks will be selected based on security 626# policy, signal strength, etc. 627# Please note that AP scanning with scan_ssid=1 and ap_scan=2 mode are not 628# using this priority to select the order for scanning. Instead, they try the 629# networks in the order that they are listed in the configuration file. 630# 631# mode: IEEE 802.11 operation mode 632# 0 = infrastructure (Managed) mode, i.e., associate with an AP (default) 633# 1 = IBSS (ad-hoc, peer-to-peer) 634# 2 = AP (access point) 635# Note: IBSS can only be used with key_mgmt NONE (plaintext and static WEP) and 636# WPA-PSK (with proto=RSN). In addition, key_mgmt=WPA-NONE (fixed group key 637# TKIP/CCMP) is available for backwards compatibility, but its use is 638# deprecated. WPA-None requires following network block options: 639# proto=WPA, key_mgmt=WPA-NONE, pairwise=NONE, group=TKIP (or CCMP, but not 640# both), and psk must also be set. 641# 642# frequency: Channel frequency in megahertz (MHz) for IBSS, e.g., 643# 2412 = IEEE 802.11b/g channel 1. This value is used to configure the initial 644# channel for IBSS (adhoc) networks. It is ignored in the infrastructure mode. 645# In addition, this value is only used by the station that creates the IBSS. If 646# an IBSS network with the configured SSID is already present, the frequency of 647# the network will be used instead of this configured value. 648# 649# scan_freq: List of frequencies to scan 650# Space-separated list of frequencies in MHz to scan when searching for this 651# BSS. If the subset of channels used by the network is known, this option can 652# be used to optimize scanning to not occur on channels that the network does 653# not use. Example: scan_freq=2412 2437 2462 654# 655# freq_list: Array of allowed frequencies 656# Space-separated list of frequencies in MHz to allow for selecting the BSS. If 657# set, scan results that do not match any of the specified frequencies are not 658# considered when selecting a BSS. 659# 660# This can also be set on the outside of the network block. In this case, 661# it limits the frequencies that will be scanned. 662# 663# bgscan: Background scanning 664# wpa_supplicant behavior for background scanning can be specified by 665# configuring a bgscan module. These modules are responsible for requesting 666# background scans for the purpose of roaming within an ESS (i.e., within a 667# single network block with all the APs using the same SSID). The bgscan 668# parameter uses following format: "<bgscan module name>:<module parameters>" 669# Following bgscan modules are available: 670# simple - Periodic background scans based on signal strength 671# bgscan="simple:<short bgscan interval in seconds>:<signal strength threshold>: 672# <long interval>" 673# bgscan="simple:30:-45:300" 674# learn - Learn channels used by the network and try to avoid bgscans on other 675# channels (experimental) 676# bgscan="learn:<short bgscan interval in seconds>:<signal strength threshold>: 677# <long interval>[:<database file name>]" 678# bgscan="learn:30:-45:300:/etc/wpa_supplicant/network1.bgscan" 679# Explicitly disable bgscan by setting 680# bgscan="" 681# 682# This option can also be set outside of all network blocks for the bgscan 683# parameter to apply for all the networks that have no specific bgscan 684# parameter. 685# 686# proto: list of accepted protocols 687# WPA = WPA/IEEE 802.11i/D3.0 688# RSN = WPA2/IEEE 802.11i (also WPA2 can be used as an alias for RSN) 689# If not set, this defaults to: WPA RSN 690# 691# key_mgmt: list of accepted authenticated key management protocols 692# WPA-PSK = WPA pre-shared key (this requires 'psk' field) 693# WPA-EAP = WPA using EAP authentication 694# IEEE8021X = IEEE 802.1X using EAP authentication and (optionally) dynamically 695# generated WEP keys 696# NONE = WPA is not used; plaintext or static WEP could be used 697# WPA-PSK-SHA256 = Like WPA-PSK but using stronger SHA256-based algorithms 698# WPA-EAP-SHA256 = Like WPA-EAP but using stronger SHA256-based algorithms 699# If not set, this defaults to: WPA-PSK WPA-EAP 700# 701# ieee80211w: whether management frame protection is enabled 702# 0 = disabled (default unless changed with the global pmf parameter) 703# 1 = optional 704# 2 = required 705# The most common configuration options for this based on the PMF (protected 706# management frames) certification program are: 707# PMF enabled: ieee80211w=1 and key_mgmt=WPA-EAP WPA-EAP-SHA256 708# PMF required: ieee80211w=2 and key_mgmt=WPA-EAP-SHA256 709# (and similarly for WPA-PSK and WPA-WPSK-SHA256 if WPA2-Personal is used) 710# 711# auth_alg: list of allowed IEEE 802.11 authentication algorithms 712# OPEN = Open System authentication (required for WPA/WPA2) 713# SHARED = Shared Key authentication (requires static WEP keys) 714# LEAP = LEAP/Network EAP (only used with LEAP) 715# If not set, automatic selection is used (Open System with LEAP enabled if 716# LEAP is allowed as one of the EAP methods). 717# 718# pairwise: list of accepted pairwise (unicast) ciphers for WPA 719# CCMP = AES in Counter mode with CBC-MAC [RFC 3610, IEEE 802.11i/D7.0] 720# TKIP = Temporal Key Integrity Protocol [IEEE 802.11i/D7.0] 721# NONE = Use only Group Keys (deprecated, should not be included if APs support 722# pairwise keys) 723# If not set, this defaults to: CCMP TKIP 724# 725# group: list of accepted group (broadcast/multicast) ciphers for WPA 726# CCMP = AES in Counter mode with CBC-MAC [RFC 3610, IEEE 802.11i/D7.0] 727# TKIP = Temporal Key Integrity Protocol [IEEE 802.11i/D7.0] 728# WEP104 = WEP (Wired Equivalent Privacy) with 104-bit key 729# WEP40 = WEP (Wired Equivalent Privacy) with 40-bit key [IEEE 802.11] 730# If not set, this defaults to: CCMP TKIP WEP104 WEP40 731# 732# psk: WPA preshared key; 256-bit pre-shared key 733# The key used in WPA-PSK mode can be entered either as 64 hex-digits, i.e., 734# 32 bytes or as an ASCII passphrase (in which case, the real PSK will be 735# generated using the passphrase and SSID). ASCII passphrase must be between 736# 8 and 63 characters (inclusive). ext:<name of external PSK field> format can 737# be used to indicate that the PSK/passphrase is stored in external storage. 738# This field is not needed, if WPA-EAP is used. 739# Note: Separate tool, wpa_passphrase, can be used to generate 256-bit keys 740# from ASCII passphrase. This process uses lot of CPU and wpa_supplicant 741# startup and reconfiguration time can be optimized by generating the PSK only 742# only when the passphrase or SSID has actually changed. 743# 744# mem_only_psk: Whether to keep PSK/passphrase only in memory 745# 0 = allow psk/passphrase to be stored to the configuration file 746# 1 = do not store psk/passphrase to the configuration file 747#mem_only_psk=0 748# 749# eapol_flags: IEEE 802.1X/EAPOL options (bit field) 750# Dynamic WEP key required for non-WPA mode 751# bit0 (1): require dynamically generated unicast WEP key 752# bit1 (2): require dynamically generated broadcast WEP key 753# (3 = require both keys; default) 754# Note: When using wired authentication (including macsec_qca driver), 755# eapol_flags must be set to 0 for the authentication to be completed 756# successfully. 757# 758# macsec_policy: IEEE 802.1X/MACsec options 759# This determines how sessions are secured with MACsec. It is currently 760# applicable only when using the macsec_qca driver interface. 761# 0: MACsec not in use (default) 762# 1: MACsec enabled - Should secure, accept key server's advice to 763# determine whether to use a secure session or not. 764# 765# mixed_cell: This option can be used to configure whether so called mixed 766# cells, i.e., networks that use both plaintext and encryption in the same 767# SSID, are allowed when selecting a BSS from scan results. 768# 0 = disabled (default) 769# 1 = enabled 770# 771# proactive_key_caching: 772# Enable/disable opportunistic PMKSA caching for WPA2. 773# 0 = disabled (default unless changed with the global okc parameter) 774# 1 = enabled 775# 776# wep_key0..3: Static WEP key (ASCII in double quotation, e.g. "abcde" or 777# hex without quotation, e.g., 0102030405) 778# wep_tx_keyidx: Default WEP key index (TX) (0..3) 779# 780# peerkey: Whether PeerKey negotiation for direct links (IEEE 802.11e DLS) is 781# allowed. This is only used with RSN/WPA2. 782# 0 = disabled (default) 783# 1 = enabled 784#peerkey=1 785# 786# wpa_ptk_rekey: Maximum lifetime for PTK in seconds. This can be used to 787# enforce rekeying of PTK to mitigate some attacks against TKIP deficiencies. 788# 789# Following fields are only used with internal EAP implementation. 790# eap: space-separated list of accepted EAP methods 791# MD5 = EAP-MD5 (unsecure and does not generate keying material -> 792# cannot be used with WPA; to be used as a Phase 2 method 793# with EAP-PEAP or EAP-TTLS) 794# MSCHAPV2 = EAP-MSCHAPv2 (cannot be used separately with WPA; to be used 795# as a Phase 2 method with EAP-PEAP or EAP-TTLS) 796# OTP = EAP-OTP (cannot be used separately with WPA; to be used 797# as a Phase 2 method with EAP-PEAP or EAP-TTLS) 798# GTC = EAP-GTC (cannot be used separately with WPA; to be used 799# as a Phase 2 method with EAP-PEAP or EAP-TTLS) 800# TLS = EAP-TLS (client and server certificate) 801# PEAP = EAP-PEAP (with tunnelled EAP authentication) 802# TTLS = EAP-TTLS (with tunnelled EAP or PAP/CHAP/MSCHAP/MSCHAPV2 803# authentication) 804# If not set, all compiled in methods are allowed. 805# 806# identity: Identity string for EAP 807# This field is also used to configure user NAI for 808# EAP-PSK/PAX/SAKE/GPSK. 809# anonymous_identity: Anonymous identity string for EAP (to be used as the 810# unencrypted identity with EAP types that support different tunnelled 811# identity, e.g., EAP-TTLS). This field can also be used with 812# EAP-SIM/AKA/AKA' to store the pseudonym identity. 813# password: Password string for EAP. This field can include either the 814# plaintext password (using ASCII or hex string) or a NtPasswordHash 815# (16-byte MD4 hash of password) in hash:<32 hex digits> format. 816# NtPasswordHash can only be used when the password is for MSCHAPv2 or 817# MSCHAP (EAP-MSCHAPv2, EAP-TTLS/MSCHAPv2, EAP-TTLS/MSCHAP, LEAP). 818# EAP-PSK (128-bit PSK), EAP-PAX (128-bit PSK), and EAP-SAKE (256-bit 819# PSK) is also configured using this field. For EAP-GPSK, this is a 820# variable length PSK. ext:<name of external password field> format can 821# be used to indicate that the password is stored in external storage. 822# ca_cert: File path to CA certificate file (PEM/DER). This file can have one 823# or more trusted CA certificates. If ca_cert and ca_path are not 824# included, server certificate will not be verified. This is insecure and 825# a trusted CA certificate should always be configured when using 826# EAP-TLS/TTLS/PEAP. Full path should be used since working directory may 827# change when wpa_supplicant is run in the background. 828# 829# Alternatively, this can be used to only perform matching of the server 830# certificate (SHA-256 hash of the DER encoded X.509 certificate). In 831# this case, the possible CA certificates in the server certificate chain 832# are ignored and only the server certificate is verified. This is 833# configured with the following format: 834# hash:://server/sha256/cert_hash_in_hex 835# For example: "hash://server/sha256/ 836# 5a1bc1296205e6fdbe3979728efe3920798885c1c4590b5f90f43222d239ca6a" 837# 838# On Windows, trusted CA certificates can be loaded from the system 839# certificate store by setting this to cert_store://<name>, e.g., 840# ca_cert="cert_store://CA" or ca_cert="cert_store://ROOT". 841# Note that when running wpa_supplicant as an application, the user 842# certificate store (My user account) is used, whereas computer store 843# (Computer account) is used when running wpasvc as a service. 844# ca_path: Directory path for CA certificate files (PEM). This path may 845# contain multiple CA certificates in OpenSSL format. Common use for this 846# is to point to system trusted CA list which is often installed into 847# directory like /etc/ssl/certs. If configured, these certificates are 848# added to the list of trusted CAs. ca_cert may also be included in that 849# case, but it is not required. 850# client_cert: File path to client certificate file (PEM/DER) 851# Full path should be used since working directory may change when 852# wpa_supplicant is run in the background. 853# Alternatively, a named configuration blob can be used by setting this 854# to blob://<blob name>. 855# private_key: File path to client private key file (PEM/DER/PFX) 856# When PKCS#12/PFX file (.p12/.pfx) is used, client_cert should be 857# commented out. Both the private key and certificate will be read from 858# the PKCS#12 file in this case. Full path should be used since working 859# directory may change when wpa_supplicant is run in the background. 860# Windows certificate store can be used by leaving client_cert out and 861# configuring private_key in one of the following formats: 862# cert://substring_to_match 863# hash://certificate_thumbprint_in_hex 864# for example: private_key="hash://63093aa9c47f56ae88334c7b65a4" 865# Note that when running wpa_supplicant as an application, the user 866# certificate store (My user account) is used, whereas computer store 867# (Computer account) is used when running wpasvc as a service. 868# Alternatively, a named configuration blob can be used by setting this 869# to blob://<blob name>. 870# private_key_passwd: Password for private key file (if left out, this will be 871# asked through control interface) 872# dh_file: File path to DH/DSA parameters file (in PEM format) 873# This is an optional configuration file for setting parameters for an 874# ephemeral DH key exchange. In most cases, the default RSA 875# authentication does not use this configuration. However, it is possible 876# setup RSA to use ephemeral DH key exchange. In addition, ciphers with 877# DSA keys always use ephemeral DH keys. This can be used to achieve 878# forward secrecy. If the file is in DSA parameters format, it will be 879# automatically converted into DH params. 880# subject_match: Substring to be matched against the subject of the 881# authentication server certificate. If this string is set, the server 882# sertificate is only accepted if it contains this string in the subject. 883# The subject string is in following format: 884# /C=US/ST=CA/L=San Francisco/CN=Test AS/emailAddress=as@example.com 885# Note: Since this is a substring match, this cannot be used securily to 886# do a suffix match against a possible domain name in the CN entry. For 887# such a use case, domain_suffix_match or domain_match should be used 888# instead. 889# altsubject_match: Semicolon separated string of entries to be matched against 890# the alternative subject name of the authentication server certificate. 891# If this string is set, the server sertificate is only accepted if it 892# contains one of the entries in an alternative subject name extension. 893# altSubjectName string is in following format: TYPE:VALUE 894# Example: EMAIL:server@example.com 895# Example: DNS:server.example.com;DNS:server2.example.com 896# Following types are supported: EMAIL, DNS, URI 897# domain_suffix_match: Constraint for server domain name. If set, this FQDN is 898# used as a suffix match requirement for the AAAserver certificate in 899# SubjectAltName dNSName element(s). If a matching dNSName is found, this 900# constraint is met. If no dNSName values are present, this constraint is 901# matched against SubjectName CN using same suffix match comparison. 902# 903# Suffix match here means that the host/domain name is compared one label 904# at a time starting from the top-level domain and all the labels in 905# domain_suffix_match shall be included in the certificate. The 906# certificate may include additional sub-level labels in addition to the 907# required labels. 908# 909# For example, domain_suffix_match=example.com would match 910# test.example.com but would not match test-example.com. 911# domain_match: Constraint for server domain name 912# If set, this FQDN is used as a full match requirement for the 913# server certificate in SubjectAltName dNSName element(s). If a 914# matching dNSName is found, this constraint is met. If no dNSName 915# values are present, this constraint is matched against SubjectName CN 916# using same full match comparison. This behavior is similar to 917# domain_suffix_match, but has the requirement of a full match, i.e., 918# no subdomains or wildcard matches are allowed. Case-insensitive 919# comparison is used, so "Example.com" matches "example.com", but would 920# not match "test.Example.com". 921# phase1: Phase1 (outer authentication, i.e., TLS tunnel) parameters 922# (string with field-value pairs, e.g., "peapver=0" or 923# "peapver=1 peaplabel=1") 924# 'peapver' can be used to force which PEAP version (0 or 1) is used. 925# 'peaplabel=1' can be used to force new label, "client PEAP encryption", 926# to be used during key derivation when PEAPv1 or newer. Most existing 927# PEAPv1 implementation seem to be using the old label, "client EAP 928# encryption", and wpa_supplicant is now using that as the default value. 929# Some servers, e.g., Radiator, may require peaplabel=1 configuration to 930# interoperate with PEAPv1; see eap_testing.txt for more details. 931# 'peap_outer_success=0' can be used to terminate PEAP authentication on 932# tunneled EAP-Success. This is required with some RADIUS servers that 933# implement draft-josefsson-pppext-eap-tls-eap-05.txt (e.g., 934# Lucent NavisRadius v4.4.0 with PEAP in "IETF Draft 5" mode) 935# include_tls_length=1 can be used to force wpa_supplicant to include 936# TLS Message Length field in all TLS messages even if they are not 937# fragmented. 938# sim_min_num_chal=3 can be used to configure EAP-SIM to require three 939# challenges (by default, it accepts 2 or 3) 940# result_ind=1 can be used to enable EAP-SIM and EAP-AKA to use 941# protected result indication. 942# 'crypto_binding' option can be used to control PEAPv0 cryptobinding 943# behavior: 944# * 0 = do not use cryptobinding (default) 945# * 1 = use cryptobinding if server supports it 946# * 2 = require cryptobinding 947# EAP-WSC (WPS) uses following options: pin=<Device Password> or 948# pbc=1. 949# 950# For wired IEEE 802.1X authentication, "allow_canned_success=1" can be 951# used to configure a mode that allows EAP-Success (and EAP-Failure) 952# without going through authentication step. Some switches use such 953# sequence when forcing the port to be authorized/unauthorized or as a 954# fallback option if the authentication server is unreachable. By default, 955# wpa_supplicant discards such frames to protect against potential attacks 956# by rogue devices, but this option can be used to disable that protection 957# for cases where the server/authenticator does not need to be 958# authenticated. 959# phase2: Phase2 (inner authentication with TLS tunnel) parameters 960# (string with field-value pairs, e.g., "auth=MSCHAPV2" for EAP-PEAP or 961# "autheap=MSCHAPV2 autheap=MD5" for EAP-TTLS). "mschapv2_retry=0" can be 962# used to disable MSCHAPv2 password retry in authentication failure cases. 963# 964# TLS-based methods can use the following parameters to control TLS behavior 965# (these are normally in the phase1 parameter, but can be used also in the 966# phase2 parameter when EAP-TLS is used within the inner tunnel): 967# tls_allow_md5=1 - allow MD5-based certificate signatures (depending on the 968# TLS library, these may be disabled by default to enforce stronger 969# security) 970# tls_disable_time_checks=1 - ignore certificate validity time (this requests 971# the TLS library to accept certificates even if they are not currently 972# valid, i.e., have expired or have not yet become valid; this should be 973# used only for testing purposes) 974# tls_disable_session_ticket=1 - disable TLS Session Ticket extension 975# tls_disable_session_ticket=0 - allow TLS Session Ticket extension to be used 976# Note: If not set, this is automatically set to 1 for EAP-TLS/PEAP/TTLS 977# as a workaround for broken authentication server implementations unless 978# EAP workarounds are disabled with eap_workaround=0. 979# For EAP-FAST, this must be set to 0 (or left unconfigured for the 980# default value to be used automatically). 981# tls_disable_tlsv1_0=1 - disable use of TLSv1.0 982# tls_disable_tlsv1_1=1 - disable use of TLSv1.1 (a workaround for AAA servers 983# that have issues interoperating with updated TLS version) 984# tls_disable_tlsv1_2=1 - disable use of TLSv1.2 (a workaround for AAA servers 985# that have issues interoperating with updated TLS version) 986# 987# Following certificate/private key fields are used in inner Phase2 988# authentication when using EAP-TTLS or EAP-PEAP. 989# ca_cert2: File path to CA certificate file. This file can have one or more 990# trusted CA certificates. If ca_cert2 and ca_path2 are not included, 991# server certificate will not be verified. This is insecure and a trusted 992# CA certificate should always be configured. 993# ca_path2: Directory path for CA certificate files (PEM) 994# client_cert2: File path to client certificate file 995# private_key2: File path to client private key file 996# private_key2_passwd: Password for private key file 997# dh_file2: File path to DH/DSA parameters file (in PEM format) 998# subject_match2: Substring to be matched against the subject of the 999# authentication server certificate. See subject_match for more details. 1000# altsubject_match2: Semicolon separated string of entries to be matched 1001# against the alternative subject name of the authentication server 1002# certificate. See altsubject_match documentation for more details. 1003# domain_suffix_match2: Constraint for server domain name. See 1004# domain_suffix_match for more details. 1005# 1006# fragment_size: Maximum EAP fragment size in bytes (default 1398). 1007# This value limits the fragment size for EAP methods that support 1008# fragmentation (e.g., EAP-TLS and EAP-PEAP). This value should be set 1009# small enough to make the EAP messages fit in MTU of the network 1010# interface used for EAPOL. The default value is suitable for most 1011# cases. 1012# 1013# ocsp: Whether to use/require OCSP to check server certificate 1014# 0 = do not use OCSP stapling (TLS certificate status extension) 1015# 1 = try to use OCSP stapling, but not require response 1016# 2 = require valid OCSP stapling response 1017# 1018# openssl_ciphers: OpenSSL specific cipher configuration 1019# This can be used to override the global openssl_ciphers configuration 1020# parameter (see above). 1021# 1022# erp: Whether EAP Re-authentication Protocol (ERP) is enabled 1023# 1024# EAP-FAST variables: 1025# pac_file: File path for the PAC entries. wpa_supplicant will need to be able 1026# to create this file and write updates to it when PAC is being 1027# provisioned or refreshed. Full path to the file should be used since 1028# working directory may change when wpa_supplicant is run in the 1029# background. Alternatively, a named configuration blob can be used by 1030# setting this to blob://<blob name> 1031# phase1: fast_provisioning option can be used to enable in-line provisioning 1032# of EAP-FAST credentials (PAC): 1033# 0 = disabled, 1034# 1 = allow unauthenticated provisioning, 1035# 2 = allow authenticated provisioning, 1036# 3 = allow both unauthenticated and authenticated provisioning 1037# fast_max_pac_list_len=<num> option can be used to set the maximum 1038# number of PAC entries to store in a PAC list (default: 10) 1039# fast_pac_format=binary option can be used to select binary format for 1040# storing PAC entries in order to save some space (the default 1041# text format uses about 2.5 times the size of minimal binary 1042# format) 1043# 1044# wpa_supplicant supports number of "EAP workarounds" to work around 1045# interoperability issues with incorrectly behaving authentication servers. 1046# These are enabled by default because some of the issues are present in large 1047# number of authentication servers. Strict EAP conformance mode can be 1048# configured by disabling workarounds with eap_workaround=0. 1049 1050# Station inactivity limit 1051# 1052# If a station does not send anything in ap_max_inactivity seconds, an 1053# empty data frame is sent to it in order to verify whether it is 1054# still in range. If this frame is not ACKed, the station will be 1055# disassociated and then deauthenticated. This feature is used to 1056# clear station table of old entries when the STAs move out of the 1057# range. 1058# 1059# The station can associate again with the AP if it is still in range; 1060# this inactivity poll is just used as a nicer way of verifying 1061# inactivity; i.e., client will not report broken connection because 1062# disassociation frame is not sent immediately without first polling 1063# the STA with a data frame. 1064# default: 300 (i.e., 5 minutes) 1065#ap_max_inactivity=300 1066 1067# DTIM period in Beacon intervals for AP mode (default: 2) 1068#dtim_period=2 1069 1070# Beacon interval (default: 100 TU) 1071#beacon_int=100 1072 1073# MAC address policy 1074# 0 = use permanent MAC address 1075# 1 = use random MAC address for each ESS connection 1076# 2 = like 1, but maintain OUI (with local admin bit set) 1077#mac_addr=0 1078 1079# disable_ht: Whether HT (802.11n) should be disabled. 1080# 0 = HT enabled (if AP supports it) 1081# 1 = HT disabled 1082# 1083# disable_ht40: Whether HT-40 (802.11n) should be disabled. 1084# 0 = HT-40 enabled (if AP supports it) 1085# 1 = HT-40 disabled 1086# 1087# disable_sgi: Whether SGI (short guard interval) should be disabled. 1088# 0 = SGI enabled (if AP supports it) 1089# 1 = SGI disabled 1090# 1091# disable_ldpc: Whether LDPC should be disabled. 1092# 0 = LDPC enabled (if AP supports it) 1093# 1 = LDPC disabled 1094# 1095# ht40_intolerant: Whether 40 MHz intolerant should be indicated. 1096# 0 = 40 MHz tolerant (default) 1097# 1 = 40 MHz intolerant 1098# 1099# ht_mcs: Configure allowed MCS rates. 1100# Parsed as an array of bytes, in base-16 (ascii-hex) 1101# ht_mcs="" // Use all available (default) 1102# ht_mcs="0xff 00 00 00 00 00 00 00 00 00 " // Use MCS 0-7 only 1103# ht_mcs="0xff ff 00 00 00 00 00 00 00 00 " // Use MCS 0-15 only 1104# 1105# disable_max_amsdu: Whether MAX_AMSDU should be disabled. 1106# -1 = Do not make any changes. 1107# 0 = Enable MAX-AMSDU if hardware supports it. 1108# 1 = Disable AMSDU 1109# 1110# ampdu_factor: Maximum A-MPDU Length Exponent 1111# Value: 0-3, see 7.3.2.56.3 in IEEE Std 802.11n-2009. 1112# 1113# ampdu_density: Allow overriding AMPDU density configuration. 1114# Treated as hint by the kernel. 1115# -1 = Do not make any changes. 1116# 0-3 = Set AMPDU density (aka factor) to specified value. 1117 1118# disable_vht: Whether VHT should be disabled. 1119# 0 = VHT enabled (if AP supports it) 1120# 1 = VHT disabled 1121# 1122# vht_capa: VHT capabilities to set in the override 1123# vht_capa_mask: mask of VHT capabilities 1124# 1125# vht_rx_mcs_nss_1/2/3/4/5/6/7/8: override the MCS set for RX NSS 1-8 1126# vht_tx_mcs_nss_1/2/3/4/5/6/7/8: override the MCS set for TX NSS 1-8 1127# 0: MCS 0-7 1128# 1: MCS 0-8 1129# 2: MCS 0-9 1130# 3: not supported 1131 1132##### Fast Session Transfer (FST) support ##################################### 1133# 1134# The options in this section are only available when the build configuration 1135# option CONFIG_FST is set while compiling hostapd. They allow this interface 1136# to be a part of FST setup. 1137# 1138# FST is the transfer of a session from a channel to another channel, in the 1139# same or different frequency bands. 1140# 1141# For detals, see IEEE Std 802.11ad-2012. 1142 1143# Identifier of an FST Group the interface belongs to. 1144#fst_group_id=bond0 1145 1146# Interface priority within the FST Group. 1147# Announcing a higher priority for an interface means declaring it more 1148# preferable for FST switch. 1149# fst_priority is in 1..255 range with 1 being the lowest priority. 1150#fst_priority=100 1151 1152# Default LLT value for this interface in milliseconds. The value used in case 1153# no value provided during session setup. Default is 50 msec. 1154# fst_llt is in 1..4294967 range (due to spec limitation, see 10.32.2.2 1155# Transitioning between states). 1156#fst_llt=100 1157 1158# Example blocks: 1159 1160# Simple case: WPA-PSK, PSK as an ASCII passphrase, allow all valid ciphers 1161network={ 1162 ssid="simple" 1163 psk="very secret passphrase" 1164 priority=5 1165} 1166 1167# Same as previous, but request SSID-specific scanning (for APs that reject 1168# broadcast SSID) 1169network={ 1170 ssid="second ssid" 1171 scan_ssid=1 1172 psk="very secret passphrase" 1173 priority=2 1174} 1175 1176# Only WPA-PSK is used. Any valid cipher combination is accepted. 1177network={ 1178 ssid="example" 1179 proto=WPA 1180 key_mgmt=WPA-PSK 1181 pairwise=CCMP TKIP 1182 group=CCMP TKIP WEP104 WEP40 1183 psk=06b4be19da289f475aa46a33cb793029d4ab3db7a23ee92382eb0106c72ac7bb 1184 priority=2 1185} 1186 1187# WPA-Personal(PSK) with TKIP and enforcement for frequent PTK rekeying 1188network={ 1189 ssid="example" 1190 proto=WPA 1191 key_mgmt=WPA-PSK 1192 pairwise=TKIP 1193 group=TKIP 1194 psk="not so secure passphrase" 1195 wpa_ptk_rekey=600 1196} 1197 1198# Only WPA-EAP is used. Both CCMP and TKIP is accepted. An AP that used WEP104 1199# or WEP40 as the group cipher will not be accepted. 1200network={ 1201 ssid="example" 1202 proto=RSN 1203 key_mgmt=WPA-EAP 1204 pairwise=CCMP TKIP 1205 group=CCMP TKIP 1206 eap=TLS 1207 identity="user@example.com" 1208 ca_cert="/etc/cert/ca.pem" 1209 client_cert="/etc/cert/user.pem" 1210 private_key="/etc/cert/user.prv" 1211 private_key_passwd="password" 1212 priority=1 1213} 1214 1215# EAP-PEAP/MSCHAPv2 configuration for RADIUS servers that use the new peaplabel 1216# (e.g., Radiator) 1217network={ 1218 ssid="example" 1219 key_mgmt=WPA-EAP 1220 eap=PEAP 1221 identity="user@example.com" 1222 password="foobar" 1223 ca_cert="/etc/cert/ca.pem" 1224 phase1="peaplabel=1" 1225 phase2="auth=MSCHAPV2" 1226 priority=10 1227} 1228 1229# EAP-TTLS/EAP-MD5-Challenge configuration with anonymous identity for the 1230# unencrypted use. Real identity is sent only within an encrypted TLS tunnel. 1231network={ 1232 ssid="example" 1233 key_mgmt=WPA-EAP 1234 eap=TTLS 1235 identity="user@example.com" 1236 anonymous_identity="anonymous@example.com" 1237 password="foobar" 1238 ca_cert="/etc/cert/ca.pem" 1239 priority=2 1240} 1241 1242# EAP-TTLS/MSCHAPv2 configuration with anonymous identity for the unencrypted 1243# use. Real identity is sent only within an encrypted TLS tunnel. 1244network={ 1245 ssid="example" 1246 key_mgmt=WPA-EAP 1247 eap=TTLS 1248 identity="user@example.com" 1249 anonymous_identity="anonymous@example.com" 1250 password="foobar" 1251 ca_cert="/etc/cert/ca.pem" 1252 phase2="auth=MSCHAPV2" 1253} 1254 1255# WPA-EAP, EAP-TTLS with different CA certificate used for outer and inner 1256# authentication. 1257network={ 1258 ssid="example" 1259 key_mgmt=WPA-EAP 1260 eap=TTLS 1261 # Phase1 / outer authentication 1262 anonymous_identity="anonymous@example.com" 1263 ca_cert="/etc/cert/ca.pem" 1264 # Phase 2 / inner authentication 1265 phase2="autheap=TLS" 1266 ca_cert2="/etc/cert/ca2.pem" 1267 client_cert2="/etc/cer/user.pem" 1268 private_key2="/etc/cer/user.prv" 1269 private_key2_passwd="password" 1270 priority=2 1271} 1272 1273# Both WPA-PSK and WPA-EAP is accepted. Only CCMP is accepted as pairwise and 1274# group cipher. 1275network={ 1276 ssid="example" 1277 bssid=00:11:22:33:44:55 1278 proto=WPA RSN 1279 key_mgmt=WPA-PSK WPA-EAP 1280 pairwise=CCMP 1281 group=CCMP 1282 psk=06b4be19da289f475aa46a33cb793029d4ab3db7a23ee92382eb0106c72ac7bb 1283} 1284 1285# Special characters in SSID, so use hex string. Default to WPA-PSK, WPA-EAP 1286# and all valid ciphers. 1287network={ 1288 ssid=00010203 1289 psk=000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f 1290} 1291 1292 1293# EAP-SIM with a GSM SIM or USIM 1294network={ 1295 ssid="eap-sim-test" 1296 key_mgmt=WPA-EAP 1297 eap=SIM 1298 pin="1234" 1299 pcsc="" 1300} 1301 1302 1303# EAP-PSK 1304network={ 1305 ssid="eap-psk-test" 1306 key_mgmt=WPA-EAP 1307 eap=PSK 1308 anonymous_identity="eap_psk_user" 1309 password=06b4be19da289f475aa46a33cb793029 1310 identity="eap_psk_user@example.com" 1311} 1312 1313 1314# IEEE 802.1X/EAPOL with dynamically generated WEP keys (i.e., no WPA) using 1315# EAP-TLS for authentication and key generation; require both unicast and 1316# broadcast WEP keys. 1317network={ 1318 ssid="1x-test" 1319 key_mgmt=IEEE8021X 1320 eap=TLS 1321 identity="user@example.com" 1322 ca_cert="/etc/cert/ca.pem" 1323 client_cert="/etc/cert/user.pem" 1324 private_key="/etc/cert/user.prv" 1325 private_key_passwd="password" 1326 eapol_flags=3 1327} 1328 1329 1330# LEAP with dynamic WEP keys 1331network={ 1332 ssid="leap-example" 1333 key_mgmt=IEEE8021X 1334 eap=LEAP 1335 identity="user" 1336 password="foobar" 1337} 1338 1339# EAP-IKEv2 using shared secrets for both server and peer authentication 1340network={ 1341 ssid="ikev2-example" 1342 key_mgmt=WPA-EAP 1343 eap=IKEV2 1344 identity="user" 1345 password="foobar" 1346} 1347 1348# EAP-FAST with WPA (WPA or WPA2) 1349network={ 1350 ssid="eap-fast-test" 1351 key_mgmt=WPA-EAP 1352 eap=FAST 1353 anonymous_identity="FAST-000102030405" 1354 identity="username" 1355 password="password" 1356 phase1="fast_provisioning=1" 1357 pac_file="/etc/wpa_supplicant.eap-fast-pac" 1358} 1359 1360network={ 1361 ssid="eap-fast-test" 1362 key_mgmt=WPA-EAP 1363 eap=FAST 1364 anonymous_identity="FAST-000102030405" 1365 identity="username" 1366 password="password" 1367 phase1="fast_provisioning=1" 1368 pac_file="blob://eap-fast-pac" 1369} 1370 1371# Plaintext connection (no WPA, no IEEE 802.1X) 1372network={ 1373 ssid="plaintext-test" 1374 key_mgmt=NONE 1375} 1376 1377 1378# Shared WEP key connection (no WPA, no IEEE 802.1X) 1379network={ 1380 ssid="static-wep-test" 1381 key_mgmt=NONE 1382 wep_key0="abcde" 1383 wep_key1=0102030405 1384 wep_key2="1234567890123" 1385 wep_tx_keyidx=0 1386 priority=5 1387} 1388 1389 1390# Shared WEP key connection (no WPA, no IEEE 802.1X) using Shared Key 1391# IEEE 802.11 authentication 1392network={ 1393 ssid="static-wep-test2" 1394 key_mgmt=NONE 1395 wep_key0="abcde" 1396 wep_key1=0102030405 1397 wep_key2="1234567890123" 1398 wep_tx_keyidx=0 1399 priority=5 1400 auth_alg=SHARED 1401} 1402 1403 1404# IBSS/ad-hoc network with RSN 1405network={ 1406 ssid="ibss-rsn" 1407 key_mgmt=WPA-PSK 1408 proto=RSN 1409 psk="12345678" 1410 mode=1 1411 frequency=2412 1412 pairwise=CCMP 1413 group=CCMP 1414} 1415 1416# IBSS/ad-hoc network with WPA-None/TKIP (deprecated) 1417network={ 1418 ssid="test adhoc" 1419 mode=1 1420 frequency=2412 1421 proto=WPA 1422 key_mgmt=WPA-NONE 1423 pairwise=NONE 1424 group=TKIP 1425 psk="secret passphrase" 1426} 1427 1428# open mesh network 1429network={ 1430 ssid="test mesh" 1431 mode=5 1432 frequency=2437 1433 key_mgmt=NONE 1434} 1435 1436# secure (SAE + AMPE) network 1437network={ 1438 ssid="secure mesh" 1439 mode=5 1440 frequency=2437 1441 key_mgmt=SAE 1442 psk="very secret passphrase" 1443} 1444 1445 1446# Catch all example that allows more or less all configuration modes 1447network={ 1448 ssid="example" 1449 scan_ssid=1 1450 key_mgmt=WPA-EAP WPA-PSK IEEE8021X NONE 1451 pairwise=CCMP TKIP 1452 group=CCMP TKIP WEP104 WEP40 1453 psk="very secret passphrase" 1454 eap=TTLS PEAP TLS 1455 identity="user@example.com" 1456 password="foobar" 1457 ca_cert="/etc/cert/ca.pem" 1458 client_cert="/etc/cert/user.pem" 1459 private_key="/etc/cert/user.prv" 1460 private_key_passwd="password" 1461 phase1="peaplabel=0" 1462} 1463 1464# Example of EAP-TLS with smartcard (openssl engine) 1465network={ 1466 ssid="example" 1467 key_mgmt=WPA-EAP 1468 eap=TLS 1469 proto=RSN 1470 pairwise=CCMP TKIP 1471 group=CCMP TKIP 1472 identity="user@example.com" 1473 ca_cert="/etc/cert/ca.pem" 1474 client_cert="/etc/cert/user.pem" 1475 1476 engine=1 1477 1478 # The engine configured here must be available. Look at 1479 # OpenSSL engine support in the global section. 1480 # The key available through the engine must be the private key 1481 # matching the client certificate configured above. 1482 1483 # use the opensc engine 1484 #engine_id="opensc" 1485 #key_id="45" 1486 1487 # use the pkcs11 engine 1488 engine_id="pkcs11" 1489 key_id="id_45" 1490 1491 # Optional PIN configuration; this can be left out and PIN will be 1492 # asked through the control interface 1493 pin="1234" 1494} 1495 1496# Example configuration showing how to use an inlined blob as a CA certificate 1497# data instead of using external file 1498network={ 1499 ssid="example" 1500 key_mgmt=WPA-EAP 1501 eap=TTLS 1502 identity="user@example.com" 1503 anonymous_identity="anonymous@example.com" 1504 password="foobar" 1505 ca_cert="blob://exampleblob" 1506 priority=20 1507} 1508 1509blob-base64-exampleblob={ 1510SGVsbG8gV29ybGQhCg== 1511} 1512 1513 1514# Wildcard match for SSID (plaintext APs only). This example select any 1515# open AP regardless of its SSID. 1516network={ 1517 key_mgmt=NONE 1518} 1519 1520# Example configuration blacklisting two APs - these will be ignored 1521# for this network. 1522network={ 1523 ssid="example" 1524 psk="very secret passphrase" 1525 bssid_blacklist=02:11:22:33:44:55 02:22:aa:44:55:66 1526} 1527 1528# Example configuration limiting AP selection to a specific set of APs; 1529# any other AP not matching the masked address will be ignored. 1530network={ 1531 ssid="example" 1532 psk="very secret passphrase" 1533 bssid_whitelist=02:55:ae:bc:00:00/ff:ff:ff:ff:00:00 00:00:77:66:55:44/00:00:ff:ff:ff:ff 1534} 1535 1536# Example config file that will only scan on channel 36. 1537freq_list=5180 1538network={ 1539 key_mgmt=NONE 1540} 1541 1542 1543# Example MACsec configuration 1544#network={ 1545# key_mgmt=IEEE8021X 1546# eap=TTLS 1547# phase2="auth=PAP" 1548# anonymous_identity="anonymous@example.com" 1549# identity="user@example.com" 1550# password="secretr" 1551# ca_cert="/etc/cert/ca.pem" 1552# eapol_flags=0 1553# macsec_policy=1 1554#} 1555