Example for Configuring Guests to Access the WLAN (MAC Address-prioritized Portal Authentication)

Procedure

1. Configure the network devices.
   # Add GE0/0/1 and GE0/0/2 on SwitchA to VLAN 100. The default VLAN of GE0/0/1 is VLAN 100.

   <HUAWEI> system-view
   [HUAWEI] sysname SwitchA
   [SwitchA] vlan batch 100
   [SwitchA] interface gigabitethernet 0/0/1
   [SwitchA-GigabitEthernet0/0/1] port link-type trunk
   [SwitchA-GigabitEthernet0/0/1] port trunk pvid vlan 100
   [SwitchA-GigabitEthernet0/0/1] port trunk allow-pass vlan 100
   [SwitchA-GigabitEthernet0/0/1] port-isolate enable
   [SwitchA-GigabitEthernet0/0/1] quit
   [SwitchA] interface gigabitethernet 0/0/2
   [SwitchA-GigabitEthernet0/0/2] port link-type trunk
   [SwitchA-GigabitEthernet0/0/2] port trunk allow-pass vlan 100
   [SwitchA-GigabitEthernet0/0/2] quit

   # Add GE0/0/1 and GE0/0/2 on SwitchB (aggregation switch) to VLAN 100, and GE0/0/2 and GE0/0/3 to VLAN 101.

   <HUAWEI> system-view
   [HUAWEI] sysname SwitchB
   [SwitchB] vlan batch 100 101
   [SwitchB] interface gigabitethernet 0/0/1
   [SwitchB-GigabitEthernet0/0/1] port link-type trunk
   [SwitchB-GigabitEthernet0/0/1] port trunk allow-pass vlan 100
   [SwitchB-GigabitEthernet0/0/1] quit
   [SwitchB] interface gigabitethernet 0/0/2
   [SwitchB-GigabitEthernet0/0/2] port link-type trunk
   [SwitchB-GigabitEthernet0/0/2] port trunk allow-pass vlan 100 101
   [SwitchB-GigabitEthernet0/0/2] quit
   [SwitchB] interface gigabitethernet 0/0/3
   [SwitchB-GigabitEthernet0/0/3] port link-type trunk
   [SwitchB-GigabitEthernet0/0/3] port trunk allow-pass vlan 101
   [SwitchB-GigabitEthernet0/0/3] quit

   # Add GE1/0/0 on Router to VLAN 101. Create VLANIF 101 and set its IP address to 10.23.101.2/24.

   <Huawei> system-view
   [Huawei] sysname Router
   [Router] vlan batch 101
   [Router] interface gigabitethernet 1/0/0
   [Router-GigabitEthernet1/0/0] port link-type trunk
   [Router-GigabitEthernet1/0/0] port trunk allow-pass vlan 101
   [Router-GigabitEthernet1/0/0] quit
   [Router] interface vlanif 101
   [Router-Vlanif101] ip address 10.23.101.2 24
   [Router-Vlanif101] quit

2. Configure the AC to communicate with the network devices.

   If the AC and APs are directly connected, set the default VLAN of the interfaces connected to the APs to management VLAN 100.

   # Add GE0/0/1 on the AC to VLAN 100 and VLAN 101.

   <HUAWEI> system-view
   [HUAWEI] sysname AC
   [AC] vlan batch 100 101
   [AC] interface gigabitethernet 0/0/1
   [AC-GigabitEthernet0/0/1] port link-type trunk
   [AC-GigabitEthernet0/0/1] port trunk allow-pass vlan 100 101
   [AC-GigabitEthernet0/0/1] quit

3. Configure the DHCP servers to assign IP addresses to APs and STAs.
   # On the AC, configure VLANIF 100 to assign IP addresses to APs.

   [AC] dhcp enable
   [AC] interface vlanif 100
   [AC-Vlanif100] ip address 10.23.100.1 24
   [AC-Vlanif100] dhcp select interface
   [AC-Vlanif100] quit

   # On SwitchB, configure VLANIF 101 to assign IP addresses to STAs and set the default gateway address of STAs to 10.23.101.2.

   [SwitchB] dhcp enable
   [SwitchB] interface vlanif 101
   [SwitchB-Vlanif101] ip address 10.23.101.1 24
   [SwitchB-Vlanif101] dhcp select interface
   [SwitchB-Vlanif101] dhcp server gateway-list 10.23.101.2
   [SwitchB-Vlanif101] dhcp server dns-list 8.8.8.8
   [SwitchB-Vlanif101] dhcp server excluded-ip-address 10.23.101.3
   [SwitchB-Vlanif101] quit

4. Configure a default route on AC with the outbound interface as the router's VLANIF 101.

   [AC] interface vlanif 101 
   [AC-Vlanif101] ip address 10.23.101.3 24 
   [AC-Vlanif101] quit
   [AC] ip route-static 0.0.0.0 0.0.0.0 10.23.101.2

5. Configure an AP to go online.
   # Create an AP group to which the APs with the same configuration can be added.

   [AC] wlan
   [AC-wlan-view] ap-group name ap-group1
   [AC-wlan-ap-group-ap-group1] quit

   # Create a regulatory domain profile, configure the AC country code in the profile, and apply the profile to the AP group.

   [AC-wlan-view] regulatory-domain-profile name default
   [AC-wlan-regulate-domain-default] country-code cn
   [AC-wlan-regulate-domain-default] quit
   [AC-wlan-view] ap-group name ap-group1
   [AC-wlan-ap-group-ap-group1] regulatory-domain-profile default
   Warning: Modifying the country code will clear channel, power and antenna gain configurations of the radio and reset the AP. Continue?[Y/N]:y  
   [AC-wlan-ap-group-ap-group1] quit
   [AC-wlan-view] quit

   # Configure the AC's source interface.

   In V200R021C00 and later versions, when the CAPWAP source interface or source address is configured, the system checks whether security-related configurations exist, including the PSK for DTLS encryption, PSK for DTLS encryption between ACs, user name and password for logging in to the AP, and password for logging in to the global offline management VAP, the configuration can be successful only when both of them exist. Otherwise, the system prompts you to complete the configuration first.

   [AC] capwap source interface vlanif 100
   Set the DTLS PSK(contains 6-32 plain-text characters, or 48 or 68 cipher-text characters that must be a combination of at least two of the following: lowercase letters a to z, uppercase letters A to Z, digits, and special characters):******
   
   Set the DTLS inter-controller PSK(contains 6-32 plain-text characters, or 48 or 68 cipher-text characters that must be a combination of at least two of the following: lowercase letters a to z, uppercase letters A to Z, digits, and special characters):******
   
   Set the user name for FIT APs(contains 4-31 plain-text characters, which can only include letters, digits and underlines. And the first character must be a letter):admin
   
   Set the password for FIT APs(plain-text password of 8-128 characters or cipher-text password of 48-188 characters that must be a combination of at least three of the following: lowercase letters a to z, uppercase letters A to Z, digits, and special characters):********
   
   Set the global temporary-management psk(contains 8-63 plain-text characters, or 48-108 cipher-text characters that must be a combination of at least two of the following: lowercase letters a to z, uppercase letters A to Z, digits, and special characters):********

   # Enable the function of establishing CAPWAP DTLS sessions in none authentication mode. (V200R021C00 and later versions)

   [AC] capwap dtls no-auth enable

   From V200R021C00, DTLS encryption is enabled for CAPWAP control tunnels on the AC by default. After this function is enabled, an AP will fail to go online when it is added. In this case, you need to enable CAPWAP DTLS non-authentication for the AP so that the AP can obtain a security credential. After the AP goes online, disable this function to prevent unauthorized APs from going online.

   # Import the AP offline on the AC and add the AP to AP group ap-group1. Assume that the AP's MAC address is 60de-4476-e360. Configure a name for the AP based on the AP's deployment location, so that you can know where the AP is deployed from its name. For example, name the AP area_1 if it is deployed in Area 1.

   The default AP authentication mode is MAC address authentication. If the default settings are retained, you do not need to run the ap auth-mode mac-auth command.

   In this example, the AP5030DN is used and has two radios: radio 0 and radio 1. Radio 0 of the AP5030DN works on the 2.4 GHz frequency band and radio 1 works on the 5 GHz frequency band.

   [AC] wlan
   [AC-wlan-view] ap auth-mode mac-auth
   [AC-wlan-view] ap-id 0 ap-mac 60de-4476-e360
   [AC-wlan-ap-0] ap-name area_1
   Warning: This operation may cause AP reset. Continue? [Y/N]:y  
   [AC-wlan-ap-0] ap-group ap-group1
   Warning: This operation may cause AP reset. If the country code changes, it will clear channel, power and antenna gain configuration s of the radio, Whether to continue? [Y/N]:y  
   [AC-wlan-ap-0] quit

   # After the AP is powered on, run the display ap all command to check the AP state. If the State field is displayed as nor, the AP goes online successfully.

   [AC-wlan-view] display ap all
   Total AP information:
   nor  : normal          [1]
   Extra information:
   P  : insufficient power supply
   --------------------------------------------------------------------------------------------------
   ID   MAC            Name   Group     IP            Type            State STA Uptime      ExtraInfo
   --------------------------------------------------------------------------------------------------
   0    60de-4476-e360 area_1 ap-group1 10.23.100.254 AP5030DN        nor   0   10S         -
   --------------------------------------------------------------------------------------------------
   Total: 1

   # Disable the function of establishing CAPWAP DTLS sessions in non-authentication mode. (V200R021C00 and later versions)

   [AC-wlan-view] quit
   [AC] undo capwap dtls no-auth enable
   [AC] wlan

6. Configure a RADIUS server template, a RADIUS authentication scheme and a RADIUS accounting scheme.

   Ensure that the RADIUS server IP address, port number, and shared key are configured correctly and are the same as those on the RADIUS server.

   # Configure a RADIUS server template.

   [AC] radius-server template wlan-net
   [AC-radius-wlan-net] radius-server authentication 10.23.102.1 1812
   [AC-radius-wlan-net] radius-server shared-key cipher Huawei123
   [AC-radius-wlan-net] quit

   # Create an authentication scheme and configure the RADIUS authentication mode.

   [AC] aaa
   [AC-aaa] authentication-scheme wlan-net
   [AC-aaa-authen-wlan-net] authentication-mode radius
   [AC-aaa-authen-wlan-net] quit

   # Create an authentication scheme and configure the RADIUS authentication mode.

   [AC-aaa] accounting-scheme wlan-net
   [AC-aaa-accounting-wlan-net] accounting-mode radius
   [AC-aaa-accounting-wlan-net] accounting realtime 15
   [AC-aaa-accounting-wlan-net] quit
   [AC-aaa] quit

   • In this example, the device is connected to the Agile Controller-Campus. The accounting function is not implemented for accounting purposes, and is used to maintain terminal online information through accounting packets.

   • The accounting realtime command sets the real-time accounting interval. A shorter real-time accounting interval requires higher performance of the device and RADIUS server. Set the real-time accounting interval based on the user quantity.

   User Quantity	Real-Time Accounting Interval
   1-99	3 minutes
   100-499	6 minutes
   500-999	12 minutes
   ≥ 1000	≥ 15 minutes

7. Configure the URL of the Portal authentication page. When a user attempts to access a website before authentication, the AC redirects the website to the Portal server.

   You are advised to configure the URL using a domain name to ensure secure and fast page pushing. Before configuring the URL using a domain name, you must first configure the mapping between the domain name and IP address of the Portal server on the DNS server.

   Configure parameters carried in the URL, which must be the same as those on the authentication server.

   [AC] url-template name wlan-net
   [AC-url-template-wlan-net] url http://portal.com:8080/portal
   [AC-url-template-wlan-net] url-parameter ssid ssid redirect-url url 
   [AC-url-template-wlan-net] quit

8. Configure a Portal server template.

   Ensure that the Portal server IP address, URL address, port number, and shared key are configured correctly and are the same as those on the Portal server.

   [AC] web-auth-server wlan-net  //In V200R021C00 and later versions, you must use the web-auth-server server-source or server-source command to configure the local gateway address used by the device to receive and respond to the packets sent by the Portal server. Otherwise, the Portal interconnection function cannot be used.
   [AC-web-auth-server-wlan-net] server-ip 10.23.103.1
   [AC-web-auth-server-wlan-net] shared-key cipher Huawei123
   [AC-web-auth-server-wlan-net] port 50200
   [AC-web-auth-server-wlan-net] url-template wlan-net ciphered-parameter-name cpname iv-parameter-name iv-value key cipher Huawei123
   [AC-web-auth-server-wlan-net] quit

9. Configure the Portal access profile wlan-net and configure Layer 2 Portal authentication.

   [AC] portal-access-profile name wlan-net
   [AC-portal-access-profile-wlan-net] web-auth-server wlan-net direct
   [AC-portal-access-profile-wlan-net] quit

10. Configure a MAC access profile for MAC address-prioritized Portal authentication.

    [AC] mac-access-profile name wlan-net
    [AC-mac-access-profile-wlan-net] quit

11. Configure an authentication-free rule profile.

    [AC] free-rule-template name default_free_rule
    [AC-free-rule-default_free_rule] free-rule 1 destination ip 8.8.8.8 mask 32
    [AC-free-rule-default_free_rule] quit

12. Configure the authentication profile wlan-net and enable MAC address-prioritized Portal authentication.

    [AC] authentication-profile name wlan-net
    [AC-authentication-profile-wlan-net] portal-access-profile wlan-net
    [AC-authentication-profile-wlan-net] mac-access-profile wlan-net
    [AC-authentication-profile-wlan-net] free-rule-template default_free_rule
    [AC-authentication-profile-wlan-net] authentication-scheme wlan-net
    [AC-authentication-profile-wlan-net] radius-server wlan-net
    [AC-authentication-profile-wlan-net] quit

13. Configure WLAN service parameters.

    # Create security profile wlan-net and set the security policy in the profile.

    [AC] wlan
    [AC-wlan-view] security-profile name wlan-net
    [AC-wlan-sec-prof-wlan-net] security open
    [AC-wlan-sec-prof-wlan-net] quit

    # Create SSID profile wlan-net and set the SSID name to wlan-net.

    [AC-wlan-view] ssid-profile name wlan-net
    [AC-wlan-ssid-prof-wlan-net] ssid wlan-net
    [AC-wlan-ssid-prof-wlan-net] quit

    # Create VAP profile wlan-net, configure the data forwarding mode and service VLANs, and apply the security profile, SSID profile, and authentication profile to the VAP profile.

    [AC-wlan-view] vap-profile name wlan-net
    [AC-wlan-vap-prof-wlan-net] forward-mode tunnel
    [AC-wlan-vap-prof-wlan-net] service-vlan vlan-id 101
    [AC-wlan-vap-prof-wlan-net] security-profile wlan-net
    [AC-wlan-vap-prof-wlan-net] ssid-profile wlan-net
    [AC-wlan-vap-prof-wlan-net] authentication-profile wlan-net
    [AC-wlan-vap-prof-wlan-net] quit

    # Bind VAP profile wlan-net to the AP group and apply the profile to radio 0 and radio 1 of the AP.

    [AC-wlan-view] ap-group name ap-group1
    [AC-wlan-ap-group-ap-group1] vap-profile wlan-net wlan 1 radio 0
    [AC-wlan-ap-group-ap-group1] vap-profile wlan-net wlan 1 radio 1
    [AC-wlan-ap-group-ap-group1] quit
    [AC-wlan-view] quit

14. Configure third-party server interconnection parameters.

    For the detailed configuration, see the related product documentation.

15. Verify the configuration.

    • The WLAN with the SSID wlan-net is available for STAs after the configuration is complete.

    • The STAs obtain IP addresses when they successfully associate with the WLAN.
    • When a user opens the browser and attempts to access the network, the user is automatically redirected to the authentication page provided by the Portal server. After entering the correct user name and password on the page, the user can access the network.
    • Assume that the MAC address validity period configured on the server is 60 minutes. If a user is disconnected from the wireless network for 5 minutes and reconnects to the network, the user can directly access the network. If a user is disconnected from the wireless network for 65 minutes and reconnects to the network, the user will be redirected to the Portal authentication page.