LANforge WiFi AP and Stations with HS20 and EAP-SIM

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. Also, note that the Realm must contain the EAP Method Type 18 (EAP-SIM) as described in http://www.iana.org/assignments/eap-numbers/eap-numbers.xhtml#eap-numbers-4:
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=vap1
   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=ABCD-1234
   bssid=00:0e:8e:c3:19:79
   country_code=US
   ieee80211d=1
   ieee80211h=0
   ieee80211w=0
   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=149
   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 WPA-EAP-SHA256
   # 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:33
   venue_name=eng:LANforge Test Venue
   network_auth_type=00
   ipaddr_type_availability=04
   domain_name=mytest.com
   anqp_3gpp_cell_net=123,20
   nai_realm=0,mytest.com,13:[5:6],18:[5:1][5:2],21:[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 eth1 on the proper resource, click Create, fill out appropriate information and create a basic MAC-VLAN interface.
2. The new interface should appear in the Port-Mgr table. Double-click to modify. Configure IP Address information and select the RADIUS checkbox which will allow a hostapd based RADIUS server on the interface using the config file /home/lanforge/wifi/hostapd_eth1#0.conf :
3. We are just using LANforge to start/stop the hostapd process associated with the MAC-VLAN interface. All interesting configuration is in the custom config file, which should appear similar to this:

   
   interface=eth1#0
   driver=wired
   logger_syslog=-1
   logger_syslog_level=2
   logger_stdout=-1
   logger_stdout_level=2
   #dump_file=/home/lanforge/wifi/hostapd_eth1#0.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=lf0301.mytest.com
   eap_sim_db=unix:/tmp/hlr_auc_gw.sock
   radius_server_auth_port=1812
   radius_server_clients=/etc/hostapd.radius_clients
   
   ca_cert=/etc/raddb/certs/ca.pem
   server_cert=/etc/raddb/certs/server.pem
   private_key=/etc/raddb/certs/server.key
   private_key_passwd=lanforge
   

4. Create RADIUS client authentication file on the LANforge machine called /etc/hostapd.radius_clients with contents similar to:

   192.168.100.0/24 lanforge
   127.0.0.1/24 lanforge
   

5. Create the /etc/hostap.eap_user file, with contents similar to this:

   "*@mytest.com" TLS
   "0"* SIM,TTLS,TLS,PEAP,AKA
   "1"* SIM,TTLS,TLS,PEAP,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 &

   NOTE: If the hlr_auc_gw does not start, you may have to remove the file /tmp/hlr_auc_gw.sock first.
3. In the LANforge-GUI, select the MAC-VLAN interface (eth1#0 in our example) and click Reset to restart the hostapd 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
   concurrent_assoc_ok=1
   scan_cur_freq=1
   min_scan_gap=5
   p2p_disabled=1
   
   # 802.11u / Interworking configuration.
   interworking=1
   hessid=00:00:00:00:00:33
   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="1232010000000000@mytest.com"
       password="90dca4eda45b53cf0f12d7c9c3bc6a89:cb9cccc4b9258e6dca4760379fb82581"
       realm="mytest.com"
       domain="mytest.com"
       eap=SIM
   }

For more information see WiFi Station Cookbook