Web System Login Configuration
AR routers support the web system. You can run commands to configure a device's management IP address, upload and load the web page file, create a web system account, and configure web system parameters. After the configuration is complete, you can log in to and maintain the device through the web system.
You can also use the default factory settings to directly log in to the web system for device management and maintenance. For details, see Logging In to the Device.
Overview of Web System Login
Definition
The web system is a built-in web server on the device and provides a graphical user interface (GUI) for users. Before using the web system to manage and maintain a device, you need to log in to the device from a terminal using Hypertext Transfer Protocol Secure (HTTPS).
Purpose
- The CLI mode requires you to use commands to manage and maintain the device. This mode realizes fine-grained device management, but requires you to be familiar with the commands.
- The web system mode allows you to easily manage and maintain the device on a GUI. However, you can only use this mode to manage and maintain some functions on the device.
To use the CLI, you must log in to the device through the console port or MiniUSB port, or using Telnet or STelnet. To use the web system, you must log in to the device using HTTPS.
For details about how to log in to a device through the console port or MiniUSB port, or using Telnet or STelnet, see CLI Login Configuration.
Licensing Requirements and Limitations for Web System Login
Involved Network Elements
None
Licensing Requirements
Web System Login is a basic feature of a router and is not under license control.
Hardware Requirements
This section is applicable to all models. For details about differences for specific models, see the description in the corresponding section.
Feature Limitations
None
Default Settings for Web System Login
This section describes the default settings for web system login.
Table 11-1 lists the default settings for web system login.
Parameter |
Default Setting |
---|---|
Web page file integrated into system software |
Supported |
Default SSL policy |
Supported |
HTTPS service |
Enabled |
Port number of the HTTPS server |
443 |
HTTPS session timeout interval |
10 minutes |
Web user |
The default username and password are available in AR Router Default Usernames and Passwords (Enterprise Network or Carrier). If you have not obtained the access permission of the document, see Help on the website to find out how to obtain it. |
Access control on web users |
None |
Configuring Device Login Through the Web System
This section describes how to configure device login through the web system.
Pre-configuration Tasks
Before configuring device login through the web system, complete the following task:
Log in to the device using the CLI mode. For details, see CLI Login Configuration.
Configuring a Management IP Address for the Device
Procedure
- Run system-view
The system view is displayed.
- Run interface interface-type interface-number
The interface view is displayed.
- Runip address ip-address { mask | mask-length }
A management IP address is configured.
The factory settings of the device include the IP address 192.168.1.1 and subnet mask 255.255.255.0. The access interface is the management interface under which the silkscreen Management or MGMT is printed.
(Optional) Uploading and Loading the Web Page File
Context
The system software contains the web page file. The web page file is loaded on the device when the system software is loaded. If new system software is uploaded to the device, you do not need to perform the following operations.
Under special circumstances, Huawei releases independent web page files matching some system software versions. After obtaining these web page files, you can upload the files to devices using SFTP and other modes, and then load the files on the devices.
Procedure
- Upload the web page file.
You can upload the web page file using SFTP or other modes. For details, see Local File Management.
After uploading the web page file, run the dir command in the user view to check whether the web page file on the device has the same size as that on the file server. If not, an exception may occur during file upload. Upload the file again.
- Load the web page file.
Configuring Web System Parameters
Context
The device can function as an HTTPS server and use the data encryption, identity authentication, and message integrity check mechanisms of the SSL protocol to ensure secure data transmission between the device and users. Users can securely access a remote device on web pages.
The device has the web system function enabled before delivery and provides a default SSL policy. The web page file contains the SSL certificate. Therefore, you do not need to perform the following operations.
Procedure
- Run system-view
The system view is displayed.
- (Optional) Run set insecure-protocol enable
Insecure management protocols HTTP and Telnet are allowed to be used.
By default, insecure management protocols HTTP and Telnet can be used.
V300R019C00:
Only the AR651C and AR651F-Lite support this function.
V300R019C10 and later versions:
Only the AR651K, AR651, AR651-X8, AR651C, AR651F-Lite, AR651U-A4, AR651W-X4, AR651W-8P, AR651W, AR657W, AR6120, AR6121K, AR6121E, AR6121, AR6120-VW, AR6140K-9G-2AC, AR6140E-9G-2AC, and AR6140-9G-2AC support this function.
Only the AR6120-S, AR6140-S, AR6121-S, and AR6121C-S support this function.
- (Optional) Run http server permit interface { { interface-type interface-number } &<1-5> | all }
An interface is configured to allow clients to access the web system.
By default, users can access the web system only through the management interface on a device.
To prevent unauthorized clients from accessing the web system through an interface, you can run this command to specify an interface that allows clients to access the web system.
This command does not take effect on the MEth management port. The device always allows you to access the web system through the MEth management port. In the factory default settings of the device, you are allowed to access the web system through the WLAN-radio interface and management port of the device.
In the factory default settings of the device running V300R019C00, users are not allowed to access the web system through the WLAN-radio interface on the AR651W, AR657W, or AR6120-VW.
The all parameter is supported in V300R019C11SPC100 and later versions.
In V300R019C11SPC100 and later versions, this step is mandatory. If you do not perform this step, the HTTP/HTTPS service cannot be enabled.
- Run http server enable
The HTTP/HTTPS server function is enabled.
By default, the HTTP server function is disabled and the HTTPS server function is enabled.
- (Optional) Run http server-source { -a source-ip-address | -i interface-type interface-number }
The source IP address of the web system is configured.
By default, the source IP address of the web system is not configured.
If the source IP address is not specified for the web system, the device selects a source IP address according to routing entries to send packets. Specify an interface in stable state, such as a loopback interface, as the source interface. Before specifying a source interface, ensure that clients have reachable routes to the source interface. Otherwise, the configuration will fail.
- (Optional) Run http secure-server port port-number
The port number of the HTTPS server is configured.
The default port number of the HTTPS server is 443.
If the default port number is used, attackers may access this port continuously, consuming bandwidth resources and degrading security performance of the server. As a result, authorized users cannot access the device. If the default port number is used by another service, users cannot log in to the device through the web system.
- (Optional) Run http secure-server manager-port port-number
The management port of the HTTPS server is enabled and the management port number is set.
By default, the management port of the HTTPS server is disabled.
You can run this command to enable the management port of the HTTPS server and set the management port number, and then can manage the router.
Only users at level 3 and higher levels can log in to the web platform through the management port.
- (Optional) Run http server max-online-users max-online-users
The maximum number of concurrent online users in the web system is set.
By default, the maximum number of concurrent online users in the web system is 5.
You can configure the maximum number of concurrent online users in the web system to restrict the number of users who access the web system at the same time.
- (Optional) Run http timeout timeout
The HTTPS session timeout interval is set.
By default, the HTTPS session timeout interval is 10 minutes.
By default, only five users can concurrently log in to the device through the web system. If a web user logs in to the device but does not perform any operations for a long time, the user occupies web channel resources and other users may fail to log in to the device. You can set a proper HTTPS session timeout interval so that web channel resources can be released in a timely manner.
- (Optional) Configure ACL-based access control for the web system.
- (Optional) Run set web login-style { professional | simple }
The edition for web platform login to the router is set.
By default, the EasyOperation edition is used for web platform login to a router.
Only the models that support the web system of the EasyOperation edition support this function. For details, see EasyOperation Edition.
V300R019C10 and later versions, the device does not support this function.
(Optional) Setting the Storage Directory of the Logo Image on the Web Page
Context
The device supports customization of the logo image on the web page. You can change the logo image based on actual requirements so that the logo image on the web page is more beautiful.
The logo image must be stored using the required file name and size in the subdirectory for storing the logo image. After the storage directory of the logo image on the web page is set, the device automatically reads the file under the directory and changes the logo image on the web page.
Store three files with different pixel sizes of the required logo image in the created subdirectory, and name them as required. Name the image with the pixel size 16x16 logo1.png, the image with the pixel size 21x22 logo2.png, and the image with the pixel size 44x44 logo3.png.
Procedure
- Run mkdir directory
A subdirectory is created for storing the logo image under the directory logo-path of the default working directory on the device.
- Run system-view
The system view is displayed.
- Run set logo-path subpathname
The storage directory of the logo image on the web page is set.
By default, the storage directory of the Huawei logo image is used.
Creating a Web System Account
Context
You can log in to the web system only after entering the correct user name and password. The network administrator can configure the user name, password, level, and service type to create a web system user. After the configuration is complete, you can log in to the web system using the configured web system account.
Procedure
- Run system-view
The system view is displayed.
- Run aaa
The AAA view is displayed.
- Run local-user user-name password irreversible-cipher password
A web system user name and password are configured.
The default username and password are available in AR Router Default Usernames and Passwords (Enterprise Network or Carrier). If you have not obtained the access permission of the document, see Help on the website to find out how to obtain it.
- Run local-user user-name service-type http
The service type is set to HTTP.
By default, the service type of the local user admin is HTTP.
- Run local-user user-name privilege level level
The user level is configured.
By default, the level of the local user admin is 15, that is, the local user is a super administrator.
If the level of a user is 0 or no level is configured for the user, the user does not have the right to log in to the web system. The mapping between user levels and users is as follows:
- If the user level is 1, the user is a common administrator.
- If the user level is 2, the user is an enterprise administrator.
- If the user level is 3 to 15, the user is a super administrator.
- Run quit
Return to the system view.
Logging In to the Web System
Context
As shown in Figure 11-1, a PC connects to a router through an IP network. After configuring the router's IP address, web system parameters, and a web system account, you can configure and manage the router on the PC through the web system.
Procedure
- Open the browser on the PC. Windows IE10.0 is used in this example. Enter https://ip address in the address box and press Enter. The web system login page is displayed, as shown in Figure 11-2.
- Enter login information.
Select a language.
Currently, the web system supports English and Chinese, and automatically uses a language based on the browser.
Enter the user name and password.
The default username and password are available in AR Router Default Usernames and Passwords (Enterprise Network or Carrier). If you have not obtained the access permission of the document, see Help on the website to find out how to obtain it.
- Click Login.
The system displays a message about login failure in situations shown in Figure 11-3.
Check the cause of the login failure based on the prompt message. If the number of incorrect password attempts reaches the upper limit, the current account will be locked. By default, a locked account is automatically unlocked after 5 minutes.
After a user logs in, the web system automatically displays the last login time, IP address, and login mode of the user.
- Change the login password.
The system asks you to change the password in the following situations, as shown in Figure 11-4.
V300R019C00 version:- When you use the default account and password to login to the system for the first time, you need to change the password.
- After the password expires, you need to change the password.
- At your first login to the system after your password is changed by another user, you need to change your password.
- If your password is about to expire, the system notifies you the password expiration time and asks you to change the password.
V300R019C10 and V300R019C11 versions:When the system user created in factory settings uses the default password to log in to the device for the first time, the system requires the user to change the password.
When the new user configured by the system administrator logs in to the device for the first time or uses the initial password or the default password to log in to the device, the system prompts the user to change the password.
After the password expires, you need to change the password.
At your first login to the system after your password is changed by another user, you need to change your password.
If your password is about to expire, the system notifies you the password expiration time and asks you to change the password.
V300R019C11SPC100 and later versions:
- When you use the default account and password to login to the system for the first time, you need to change the password.
- After the password expires, you need to change the password.
- At your first login to the system after your password is changed by another user, you need to change your password.
- If your password is about to expire, the system notifies you the password expiration time and asks you to change the password.
- When you must change the password, after you change the password, click OK. If the password is changed successfully, a message indicating successful password change is displayed. Click OK. The login page is displayed. Click Cancel to access the login page without changing the password, and you cannot enter the web platform.
- When the system asks you to change the password, after you change the password, click OK. If the password is changed successfully, a message indicating successful password change is displayed. Click OK. The login page is displayed. Click Cancel to access the Device Information page.
- Click
in the upper right corner of the page to return to the login page.
- If you do not perform any operations within a period (10 minutes by default) after logging in to the web system, the system automatically logs you out. Click OK to return to the login page.
Configuration Examples for Web System Login
This section provides an example for configuring device login through the web system.
Example for Configuring Device Login Through the Web System
Networking Requirements
As shown in Figure 11-5, there are reachable routes between the device and PC. It is required that the device be managed and maintained through the web system.
Configuration Roadmap
The configuration roadmap is as follows:
- Log in to the device through the console port.
- Configure a management IP address for the device.
- Create a web system account.
- Enable the web system function.
- Log in to the web system.
Procedure
- Log in to the device through the console port. For details, see Example for Configuring First Login Through the Console Port.
- Configure a management IP address for the device.
<Huawei> system-view [Huawei] interface gigabitethernet 0/0/0 [Huawei-GigabitEthernet0/0/0] ip address 10.1.1.1 24 [Huawei-GigabitEthernet0/0/0] quit
- Configure a web user.
[Huawei] aaa [Huawei-aaa] local-user admin password irreversible-cipher YsHsjx_202206 [Huawei-aaa] local-user admin privilege level 15 [Huawei-aaa] local-user admin service-type http [Huawei-aaa] quit
Before configuring a web user, you can run the display this command in the AAA view to check user names of local users. Ensure that the user name of the configured web user does not conflict with that of an existing local user; otherwise, the new web user may overwrite the existing local user.
- Configure the web system.
# Enable the web system function.
[Huawei] http server permit interface gigabitethernet 0/0/0 [Huawei] http server enable This operation will take several minutes, please wait......................................................... Info: Succeeded in starting the HTTP server [Huawei] quit
- Log in to the web system.
Open a browser on the PC, enter https://192.168.1.1 in the address bar, and press Enter. The login page web system is displayed, as shown in Figure 11-6.
Enter the web user name and password, and click Login or press Enter. The web system homepage is displayed.
- Verify the configuration.
# After the configuration is complete, you can successfully log in to the device through the web system.
# Run the display http server command on the device to check the SSL policy name and HTTPS server status.
<Huawei> display http server HTTP server status : Enabled (default: disable) HTTP server port : 80 (default: 80) HTTP timeout interval : 10 (default: 10 minutes) Current online users : 0 Maximum users allowed : 5 HTTPS server status : Enabled (default: enable) HTTPS server port : 443 (default: 443) HTTPS server manager port : HTTPS SSL Policy : default_policy
Configuration Files
Configuration file of the device
# aaa local-user admin password irreversible-cipher %^%#R!d3>ji-.u1+N2gSK>3&2P1AM6jfU:"x/3g[5U,lvqP+sf=70+%^E7,,SF7+%^%# local-user admin privilege level 15 local-user admin service-type http # interface GigabitEthernet0/0/0 ip address 10.1.1.1 255.255.255.0 # http server permit interface GigabitEthernet0/0/0 http server enable # return
Troubleshooting Web System Login
This section describes common faults caused by incorrect configurations and provides the troubleshooting procedure.
Failed to Log In to the Device Through the Web System
Procedure
- Check whether the device and client can ping each other.
Access the Windows command prompt and run the ping command to check whether the PC and device are reachable to each other. If the system displays "Request time out", the target device is unreachable.
Check whether the physical port that receives ping packets is blocked. If the physical port is not blocked, check whether the correct gateway address is configured on the device, and whether the device and PC are on the same network segment. If they are on different network segments, run the ip address ip-address { mask | mask-length } command in the interface view to reconfigure the management IP address of the device in the target network segment.
- Check whether the login address is correct.
Check whether IP address in https://IP address:port entered in the address box of the browser is correct. If the IP address is incorrect, enter the correct one to log in to the web system.
- Check whether the HTTPS service is enabled.
Run the display this command in the system view to check whether the http secure-server enable configuration exists. If not, the HTTPS service is disabled. Run the http secure-server enable command in the system view to enable the HTTPS service.
- Check whether the number of online web users reaches the upper limit.
Run the display http server command in any view to check the maximum number of access users allowed by the HTTP server. Run the display http user command in any view to check the number of online web users. If the number of online web users reaches the maximum number of access users allowed by the HTTP server, you can log in to the device only after other users go offline.
- Check whether the management IP address is correctly configured.
Run the display this command in the interface view to check whether the configured IP address is correct. If not, run the ip address ip-address { mask | mask-length } command in the interface view to reconfigure the management IP address of the device.
- Check whether the web user is correctly configured.Run the display this command in the AAA view to check whether the web user is correctly configured.
- If the local-user user-name password irreversible-cipher password command configuration exists, an AAA user named user-name is configured.
- If the local-user user-name privilege level level command configuration exists, the privilege level of the user user-name is the one specified by level.
- If the local-user user-name service-type http command configuration exists, the service type of the user user-name is HTTP.
If any of the preceding configurations does not exist, run the following commands in the AAA view as required:- Run the local-user user-name password irreversible-cipher password command to configure the web user name and password.
- Run the local-user user-name privilege level level command to set the privilege level of the web user.
- Run the local-user user-name service-type http command to set the service type of the web user to HTTP.
- Check whether access control on web users is configured on the device.
Run the display this command in the system view to check whether the http acl acl-number command configuration exists. If so, record the value of acl-number.
Run the display acl acl-number command in any view to check whether the web user's client IP address is denied in the ACL. If so, run the undo rule rule-id command in the ACL view to delete the deny rule, and run the corresponding command to modify the ACL so that the web user's client IP address is allowed.
- Check whether a server SSL policy is associated with the HTTPS server.
If you cannot access the web page and the error message "ERR_SSL_SERVER_CERT_BAD_FORMAT" is displayed, run the undo http secure-server ssl-policy command to disassociate the HTTPS server from the server SSL policy.
The Web System Page Is Not Completely Displayed After Successful Device Login Through the Web System
Symptom
After successful device login through the web system, the web system page is not completely displayed, or only several options are displayed.
Procedure
- Check whether the web user level is too low.
If the user level is 1, the user is a common administrator and can only access Device Information and change the password in User Management. If the user level is 2, the user is an enterprise administrator and has most operating rights in the web system. If the user level is 3 to 15, the user is a super administrator and has all operating rights in the web system.
Run the display this command in the AAA view to check the web user level. If the value of level is too small in the local-user user-name privilege level level configuration, some functions cannot be displayed in the web system. Run the local-user user-name privilege level level command in the AAA view to set the web user level to 3 or higher so that the web user has all operating rights in the web system.
- Check whether the device version is correct.
Run the display version command in any view to check the device version. If the value of Version is too small in the VRP (R) software, Version Version configuration, the device does not support some functions in the web system. Upgrade the device to a proper version.
FAQ About Web System Login
This section describes common problems you may encounter during the configuration and provides the solutions to these problems.