< Home

Configuring the Web Push Function

Context

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:
  1. URL: pushes the URL of the specified web page.
  2. 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.

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.

Built-in Portal authentication does not support the web page push function.

Procedure

  • URL mode

    1. Run system-view

      The system view is displayed.

    2. Run aaa

      The AAA view is displayed.

    3. Run domain domain-name

      An AAA domain is created and the AAA domain view is displayed.

      The device has two default domains: default and default_admin. Common access users use the default domain and the administrator uses the default_admin domain.

    4. Run force-push url url-address

      The URL push function is enabled.

      By default, the URL push function is disabled.

  • URL template mode

    1. Create and configure a URL template.
      1. Run system-view

        The system view is displayed.

      2. Run url-template name template-name

        A URL template is created and the URL template view is displayed.

        By default, no URL template is created on the device.

      3. Run url [ push-only ] url-string [ ssid ssid ]

        A pushed URL is configured.

        By default, no pushed URL is configured.

        The SSID that users associate with must be the same as that configured on the device; otherwise, the device cannot push URLs to users.

      4. Run url-parameter { device-ip device-ip-value | device-mac device-mac-value | ap-ip ap-ip-value | ap-mac ap-mac-value | ssid ssid-value | login-url url-key url | redirect-url redirect-url-value | sysname sysname-value | user-ipaddress user-ipaddress-value | user-mac user-mac-value | user-vlan user-vlan-value | ap-group-name ap-group-name-value | ap-location ap-location-value | ap-name ap-name-value } *

        Parameters carried in the URL are configured.

        By default, a URL does not carry parameters.

      5. Run url-parameter mac-address format delimiter delimiter { normal | compact }

        The MAC address format in the URL is configured.

        By default, the MAC address format in a URL is XXXXXXXXXXXX.

      6. Run parameter { start-mark parameter-value | assignment-mark parameter-value | isolate-mark parameter-value } *

        Characters in the URL are configured.

        By default, the start character in a URL is a question mark (?), the assignment character is an equal sign (=), and the delimiter between parameters is an ampersand (&).

      7. Run quit

        Return to the system view.

    2. Run aaa

      The AAA view is displayed.

    3. Run domain domain-name

      An AAA domain is created and the AAA domain view is displayed.

      The device has two default domains: default and default_admin. Common access users use the default domain and the administrator uses the default_admin domain.

    4. Run force-push url-template template-name

      The URL template push function is enabled.

      By default, the URL template push function is disabled.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >