Example for Configuring Built-in Portal Authentication for Local Users

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.

   Configure the DNS server as required. The common methods are as follows:

   • In interface address pool scenarios, run the dhcp server dns-list ip-address &<1-8> command in the VLANIF interface view.
   • In global address pool scenarios, run the dns-list ip-address &<1-8> command in the IP address pool view.

   [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] quit

4. Configure a route from the AC to DNS server.

   [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 local authentication.

   # Configure the local authentication scheme wlan-net.

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

   # Configure the user name, password, and service type of the local user.

   [AC-aaa] local-user guest password cipher guest@123
   [AC-aaa] local-user guest service-type web
   [AC-aaa] quit

7. Configure SSL policy sslserver and load a digital certificate.

   # Load certificates and the RSA key pair.

   The local certificate abc_local.pem, CA certificate abc_ca.pem, and RSA key pair privatekey.pem have been requested, obtained, and uploaded to the storage medium of the device. If multiple CA certificates are requested, perform the same operation to load the certificates to the memory of the device. When privatekey.pem is generated, the key is Huawei@123.

   [AC] pki realm abc
   [AC-pki-realm-abc] quit 
   [AC] pki import-certificate local realm abc pem filename abc_local.pem
   [AC] pki import-certificate ca realm abc pem filename abc_ca.pem
   [AC] pki import rsa-key-pair key1 pem privatekey.pem password Huawei@123

   # Configure the SSL policy sslserver and load the digital certificate.

   [AC] ssl policy sslserver type server
   [AC-ssl-policy-sslserver] pki-realm abc
   [AC-ssl-policy-sslserver] version tls1.2
   [AC-ssl-policy-sslserver] ciphersuite ecdhe_rsa_aes128_gcm_sha256 ecdhe_rsa_aes256_gcm_sha384
   [AC-ssl-policy-sslserver] quit

   # Check the configuration of the SSL policy. The status of the CA and local certificates must be loaded.

   [AC] display ssl policy sslserver
   ------------------------------------------------------------------------------
     Policy name                            :   sslserver                             
     Policy ID                              :   2                                
     Policy type                            :   Server                            
     Cipher suite                           :   ecdhe_rsa_aes128_gcm_sha256
                                                ecdhe_rsa_aes256_gcm_sha384 
     PKI realm                              :   abc
     Version                                :   tls1.2  
     Cache number                           :   128                                
     Time out(second)                       :   3600                              
     Server certificate load status         :   loaded                            
     CA certificate chain load status       :   loaded                            
     SSL renegotiation status               :   enable
     Bind number                            :   1                                 
     SSL connection number                  :   0                                 
     ------------------------------------------------------------------------------
   

8. Configure the Portal access profile wlan-net

   # Enable the built-in Portal server function.

   [AC] interface loopback 1
   [AC-LoopBack1] ip address 10.1.1.1 24
   [AC-LoopBack1] quit
   [AC] portal local-server ip 10.1.1.1
   [AC] portal local-server https ssl-policy sslserver port 20000

   # Create the Portal access profile wlan-net and configure it to use the built-in Portal server.

   [AC] portal-access-profile name wlan-net
   [AC-portal-access-profile-wlan-net] portal local-server enable
   [AC-portal-access-profile-wlan-net] quit

9. On the router (STAs' gateway), configure a route to the Portal server.

   [Router] ip route-static 10.1.1.1 32 10.23.101.3

10. Configure an authentication-free rule profile to allow users to access the DNS server before authentication.

    [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

11. Configure the authentication profile wlan-net.

    [AC] authentication-profile name wlan-net
    [AC-authentication-profile-wlan-net] portal-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] quit

12. 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

13. 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.