force-push

Function

The force-push command enables a pushed URL template or pushed URL.

The undo force-push command disables a pushed URL template or pushed URL.

By default, no pushed URL template or pushed URL is enabled.

Format

force-push { url-template template-name | url url-address }

undo force-push

Parameters

Parameter	Description	Value
url-template template-name	Specifies the name of a pushed URL template.	The value must be the name of an existing URL template.
url url-address	Specifies a pushed URL.	The value is a string of 1 to 247 case-sensitive characters without spaces and question marks (?). If the string is enclosed in double quotation marks (" "), the string can contain spaces.

Views

AAA domain view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When a user sends an HTTP or HTTPS packet to access a web page for the first time after the user is successfully authenticated, the device forcibly redirects the user to a specified web page. In addition to pushing advertisement pages, the device obtains user terminal information through the HTTP or HTTPS packets sent by users, and applies the information to other services. There are two ways to push web pages:

URL: pushes the URL of the specified web page.
URL template: pushes a URL template. The URL template must have been created and contains the URL of the pushed web page and URL parameters.

Prerequisites

The URL configured using the url command in the URL template view cannot be a redirect URL; otherwise, the force-push command does not take effect.

Precautions

For the S5730-HI, S5731-H, S5731S-H, S5731-S, S5731S-S, S5732-H, S6730-H, S6730S-H, S6730-S, S6730S-S, S6720-HI, and S5720-HI, the forcible web page push function takes effect only for the first HTTP or HTTPS packet sent from users. If an application that actively sends HTTP or HTTPS packets is installed on a user terminal and the terminal has sent HTTP or HTTPS packets before the user accesses a web page, the user is unaware of the web page push process.

The forcible web page push function takes effect only when it is used together with a redirect ACL for switches excluding S5730-HI, S5731-H, S5731S-H, S5731-S, S5731S-S, S5732-H, S6730-H, S6730S-H, S6730-S, S6730S-S, S6720-HI, and S5720-HI. If a redirect ACL exists in the user table, a web page is forcibly pushed when HTTP packets from users match the redirect ACL rule. Usually, you can configure the RADIUS server to authorize the Huawei extended RADIUS attribute HW-Redirect-ACL or HW-IPv6-Redirect-ACL to users for redirect ACL implementation, or run the redirect-acl command to configure a redirect ACL.

For HTTPS packets, the forcible web page push function takes effect only when it is used together with a redirect ACL. If a redirection ACL exists in the user table, a web page is forcibly pushed when HTTPS packets from users match the redirect ACL rule.

If the switch functions as an AC and the direct forwarding mode is used in a wireless scenario, the forcible web page push function is not supported.

Example

# Enable the pushed URL template abc in the domain huawei.

<HUAWEI> system-view
[HUAWEI] url-template name abc
[HUAWEI-url-template-abc] quit
[HUAWEI] aaa
[HUAWEI-aaa] domain huawei
[HUAWEI-aaa-domain-huawei] force-push url-template abc