CDRouter Support

How do I configure CDRouter to use a wireless LAN interface?

knowledge-base version 11.3

Overview

To configure a wireless LAN for CDRouter, the following three testvars must be configured, at a minimum:

  • lanInterface: this testvar specifies which physical interface CDRouter should use on the LAN; CDRouter will automatically detect whether the configured interface is wireless or Ethernet

  • lanSecurity: this testvar specifies the security type used by the device under test (DUT) on the LAN; for wireless LAN interfaces this can be one of four values - NONE. WEP, WPA-PSK, or WPA-802.1X,

  • lanSSID: this testvar specifies the wireless SSID of the DUT

Additional testvars may be required based on the DUT’s wireless security settings. Configuration examples for some common wireless security modes are provided below.

Note that many of the testvars in these examples utilize default values which do not need to be explicitly uncommented in the config file. Detailed descriptions of all of the testvars used in these example configurations can be found on the Documentation tab of CDRouter’s web interface or in the LAN Configuration section of the CDRouter User’s Guide.

Example Configurations

Basic wireless with no security

testvar lanInterface          wlan0
testvar lanSecurity           NONE

# -- Wireless Configuration
testvar lanSSID               my-network

WEP with 64 bit static key

testvar lanInterface          wlan0
testvar lanSecurity           WEP

# -- Wireless Configuration
testvar lanSSID               my-network
testvar lanWEPKey             0102030405
testvar lanWEPKeyIndex        0

WEP with 128 bit static key and key index of 3

testvar lanInterface          wlan0
testvar lanSecurity           WEP

# -- Wireless Configuration
testvar lanSSID               my-network
testvar lanWEPKey             0102030405060708090a010203
testvar lanWEPKeyIndex        3

WPA Personal (aka WPA with Pre-shared Key)

This configuration makes use of the WPA auto mode feature. When auto mode is used for WPA, CDRouter will automatically use the strongest encryption combination supported by the DUT.

Please see this Knowledge Base article for information on which EAP types are supported for each LAN security mode.

testvar lanInterface          wlan0
testvar lanSecurity           WPA-PSK

# -- Wireless Configuration
testvar lanSSID               my-network

# -- WPA Encryption Configuration
testvar wpaMode               auto
testvar wpaCipher             auto
testvar wpaGroupCipher        auto
testvar wpaKey                qacafe123

WPA Enterprise (aka WPA with 802.1X/RADIUS)

This configuration makes use of the WPA auto mode feature. When auto mode is used for WPA, CDRouter will automatically use the strongest encryption combination supported by the DUT. Specific values can be set for each testvar as well to test a single mode of operation.

Please see this Knowledge Base article for information on which EAP types are supported for each LAN security mode.

testvar lanInterface          wlan0
testvar lanSecurity           WPA-802.1X

# -- Wireless Configuration
testvar lanSSID               my-network

# -- WPA Encryption Configuration
testvar wpaMode               auto
testvar wpaCipher             auto
testvar wpaGroupCipher        auto
testvar wpaKey                qacafe123

# -- LAN 802.1X and RADIUS Configuration
testvar enableRADIUSserver    yes
testvar radiusHost            remoteHost
testvar radiusSecret          qacafe123

# -- LAN EAP Type and Credentials
testvar eapType               eap-tls
testvar eapIdentity1          user1
testvar eapPassword1          qacafe123
testvar eapUserCertPath1      /usr/share/doc/cdrouter/user1.pem
testvar eapUserCertPassword1  qacafe123
testvar eapUserPrivateKey1    ""

Wireless mesh topologies

CDRouter can be used to test LAN networks comprised of multiple wireless extenders that form a distributed LAN or “mesh” topology. The lanBSSID testvar specifies the unique BSSID address of the access point node that CDRouter’s wireless interface will associate with.

Example config for mesh topology

testvar lanInterface          wlan0
testvar lanSecurity           NONE

# -- Wireless Configuration
testvar lanSSID               my-network

# -- Advanced Wireless Configuration
testvar lanBSSID              00:01:02:00:00:01

Multiple Wireless Networks

For devices that support both 2.4GHz & 5.0GHz frequency bands under the same SSID, CDRouter can be configured to connect to a specific band using the device’s BSSID address.

CDRouter Multiport Add-on users can connect multiple LAN interfaces to the DUT simultaneously. Each physical wireless interface can be configured to connect to the DUT with its own independent security settings, SSID and BSSID

Exaple Multiport config using SSID

# -- Base LAN Interface Config ("lan")
testvar lanInterface          wlan0
testvar lanSecurity           WPA-PSK
testvar lanSSID               "my-network 2.4GHz"
testvar wpaMode               auto
testvar wpaCipher             auto
testvar wpaGroupCipher        auto
testvar wpaKey                qacafe123

# -- Multiport LAN Interface Config ("lan2")
testvar_group lan2 {
    testvar lanInterface          wlan1
    testvar lanSecurity           NONE
    testvar lanSSID               "my-network 5.0GHz"
}

Exaple Multiport config using BSSID

# -- Base LAN Interface Config ("lan")
testvar lanInterface          wlan0
testvar lanSecurity           WPA-PSK
testvar lanSSID               "my-network 5.0GHz"
testvar wpaMode               auto
testvar wpaCipher             auto
testvar wpaGroupCipher        auto
testvar wpaKey                qacafe123
testvar lanBSSID              00:01:02:00:00:AA

# -- Multiport LAN Interface Config ("lan2")
testvar_group lan2 {
    testvar lanInterface          wlan1
    testvar lanSecurity           NONE
    testvar lanSSID               "my-network 5.0GHz"
    testvar lanBSSID              00:01:02:00:00:BB
}

Contents

×

About CDRouter

CDRouter is made by QA Cafe, a technology company based in Portsmouth, NH.

Get in touch via our Contact page or by following us on your favorite service: