LANforge WiFi AP and Stations with HS20 and EAP-AKA

1. Go to the Port Manager tab, select wiphy0 on proper resource, click Create, fill out appropriate information and create basic Virtual AP interface.
2. The new VAP should appear in the Port-Mgr table. Double-click to modify. Configure IP Address information, SSID and select WPA2:
3. Select the Advanced Configuration tab in the Port-Modify window and configure the 802.1x, 802.11u, HotSpot 2.0, RADIUS and other information. Note that the 3GPP Cell Net entry must correspond to the IMSI we enter as the station's identity and the IMSI information in the hlr_auc_gw config file:
4. Use Netsmith to create Virtual-Router. Add the vapX interface to the Virtual router, configure the Virtual Router port object to serve DHCP. Optionally, add external Ethernet interface to virtual router so that it can route to upstream networks. You could also set up the VAP in bridge mode and use external DHCP server if preferred.
5. For those doing this manually, the hostapd.conf file looks like this:
   

   interface=vap0
   driver=nl80211
   logger_syslog=-1
   logger_syslog_level=2
   logger_stdout=-1
   logger_stdout_level=2
   dump_file=/home/lanforge/wifi/hostapd_vap0.dump
   ctrl_interface=/var/run/hostapd
   ctrl_interface_group=0
   ssid=ben-138
   bssid=80:01:02:03:04:05
   country_code=US
   ieee80211d=1
   hw_mode=a
   ieee80211n=1
   beacon_int=240
   dtim_period=2
   max_num_sta=2007
   rts_threshold=2347
   fragm_threshold=2346
   preamble=0
   macaddr_acl=0
   auth_algs=1
   ignore_broadcast_ssid=0
   # Enable HT modes if you want 300Mbps+ throughput.
   #ht_capab=[HT20][HT40-][HT40+][GF][SHORT-GI-20][SHORT-GI-40]
   #      [TX-STBC][RX-STBC123][MAX-AMSDU-7935][DSSS_CCK-40][PSMP][LSIG-TXOP-PROT]
   ht_capab=[HT20][HT40+][SHORT-GI-40][SHORT-GI-20]
   #vht_capab=[HT20][HT80+][HT80-][SHORT-GI-80]
   wmm_enabled=1
   wmm_ac_bk_cwmin=4
   wmm_ac_bk_cwmax=10
   wmm_ac_bk_aifs=7
   wmm_ac_bk_txop_limit=0
   wmm_ac_bk_acm=0
   wmm_ac_be_aifs=3
   wmm_ac_be_cwmin=4
   wmm_ac_be_cwmax=10
   wmm_ac_be_txop_limit=0
   wmm_ac_be_acm=0
   wmm_ac_vi_aifs=2
   wmm_ac_vi_cwmin=3
   wmm_ac_vi_cwmax=4
   wmm_ac_vi_txop_limit=94
   wmm_ac_vi_acm=0
   wmm_ac_vo_aifs=2
   wmm_ac_vo_cwmin=2
   wmm_ac_vo_cwmax=3
   wmm_ac_vo_txop_limit=47
   wmm_ac_vo_acm=0
   channel=36
   ieee8021x=1
   own_ip_addr=127.0.0.1
   auth_server_addr=127.0.0.1
   auth_server_port=1812
   auth_server_shared_secret=lanforge
   wpa=2
   wpa_pairwise=CCMP
   wpa_key_mgmt=WPA-EAP
   # 802.11u configuration
   interworking=1
   access_network_type=4
   internet=1
   asra=1
   esr=1
   uesa=1
   venue_group=2
   venue_type=1
   hessid=00:00:00:00:00:01
   roaming_consortium=01010101
   venue_name=eng:LANforge Test Venue
   network_auth_type=00
   ipaddr_type_availability=04
   domain_name=lanforge.org
   anqp_3gpp_cell_net=055,54
   nai_realm=0,lanforge.org,13[5:6],21[2:4][5:7]
   # HotSpot 2.0 configuration
   hs20=1
   hs20_oper_friendly_name=eng:LANforge HotSpot 2.0
   hs20_wan_metrics=01:8000:1000:80:240:3000
   hs20_operating_class=517C

For more information see LANforge User's Guide: Ports (Interfaces)

1. Go to the Port Manager tab, select wiphy0 on proper resource, click Create, fill out appropriate information and create basic Virtual AP interface.
2. The new VAP should appear in the Port-Mgr table. Double-click to modify. Configure IP Address information, SSID and select WPA2:
3. Select the Misc Configuration tab in the Port-Modify window and select Custom WPA Cfg and specify the WPA Cfg file name:
4. We are just using LANforge to start/stop the hostapd process associated with the dummy AP. All interesting configuration is in the custom config file, which should appear similar to this:

   
   interface=eth0
   driver=wired
   logger_syslog=-1
   logger_syslog_level=2
   logger_stdout=-1
   logger_stdout_level=2
   dump_file=/home/lanforge/wifi/hostapd_vap2.dump
   ctrl_interface=/var/run/hostapd
   ctrl_interface_group=0
   #ieee8021x=1
   eapol_key_index_workaround=0
   eap_server=1
   eap_user_file=/etc/hostapd.eap_user
   server_id=lf138.lanforge.com
   eap_sim_db=unix:/tmp/hlr_auc_gw.sock
   radius_server_auth_port=1812
   radius_server_clients=/etc/hostapd.radius_clients

5. Create RADIUS client authentication file named /etc/hostapd.radius_clients with contents similar to:

   192.168.100.0/24 lanforge
   127.0.0.1/24 lanforge
   

6. Create RADIUS eap user file named /etc/hostapd.eap_user file, with contents similar to this:

   "*@lanforge.com" TLS
   "0"* AKA
   "2"* AKA
   "4"* AKA

1. On the LANforge machine, use your favorite editor to create the file /etc/hlr_auc_gw.milenage_db
   It should have contents similar to:

   
   # Parameters for Milenage (Example algorithms for AKA).
   # The example Ki, OPc, and AMF values here are from 3GPP TS 35.208 v6.0.0
   # 4.3.20 Test Set 20. SQN is the last used SQN value.
   # These values can be used for both UMTS (EAP-AKA) and GSM (EAP-SIM)
   # authentication. In case of GSM/EAP-SIM, AMF and SQN values are not used, but
   # dummy values will need to be included in this file.
   # IMSI Ki OPc AMF SQN
   232010000000000 90dca4eda45b53cf0f12d7c9c3bc6a89 cb9cccc4b9258e6dca4760379fb82581 61df 000000000000
   
   # These values are from Test Set 19 which has the AMF separation bit set to 1
   # and as such, is suitable for EAP-AKA' test.
   555444333222111 5122250214c33e723a5dd523fc145fc0 981d464c7c52eb6e5036234984ad0bcf c3ab 16f3b3f70fc1
   

2. As root user, start the hlr_auc_gw tool:
   

   cd /home/lanforge
   . lanforge.profile
   hlr_auc_gw -m /etc/hlr_auc_gw.milenage_db > /tmp/hlr_auc_gw.log&

3. In the LANforge-GUI, select the dummy vap (vap2 in our example) and click Reset to restart the RADIUS process now that the hlr_auc_gw program is running.

1. Go to the Port Manager tab, select wiphyX on proper resource, click Create, fill out appropriate information and create a basic Virtual Station interface.
2. The new Station should appear in the Port-Mgr table. Double-click to modify. Set the SSID to [BLANK], and Select WPA2. The SSID and Key/Password do not need to be configured when using HotSpot 2.0:
3. Select the Advanced Configuration tab in the Port-Modify window and configure the 802.1x, 802.11u, HotSpot 2.0 and other information. The EAP Identity and EAP Password must match the configuration on your RADIUS server, and in this case, that means it must match the hlr_auc_gw configuration we entered earlier. The HS20 Realm and Domain should be configured to match the HS20 AP.
4. Verify Station connects to the AP and obtains DHCP IP Address configuration. If it does not work, look at the Station's supplicant logs, the AP logs, the RADIUS server logs, and the hlr_auc_gw logs.
5. For those doing this manually, the wpa_supplicant.conf file looks like this:
   

   ctrl_interface=/var/run/wpa_supplicant
   fast_reauth=1
   can_scan_one=1
   # 802.11u / Interworking configuration.
   interworking=1
   auto_interworking=1
   access_network_type=0
   # HotSpot 2.0 configuration
   hs20=1
   bss_max_count=2000
   network={
       interworking_defaults=1
       disable_ht=0
       disable_vht=1
       disable_ht40=0
       disable_sgi=0
       ht_mcs=""
       disable_max_amsdu=-1
       ampdu_factor=-1
       ampdu_density=-1
   }
   cred={
       username="0555444333222111@wlan.org"
       password="5122250214c33e723a5dd523fc145fc0:981d464c7c52eb6e5036234984ad0bcf:16f3b3f70fc1"
       realm="lanforge.org"
       domain="lanforge.org"
       eap=AKA
   }

For more information see WiFi Station Cookbook