NetEngine AR5700, AR6700, and AR8000 V600R022C10 Command Reference

URL Filtering Configuration Commands

URL Filtering Configuration Commands

add (URL filtering profile view)

Function

The add command adds blacklist and whitelist rules to the URL filtering profile.

The undo add command removes blacklist and whitelist rules from the URL filtering profile.

By default, there is no configuration.

Format

add { blacklist | whitelist } { url url-text | host host-text }

undo add { blacklist | whitelist } { url { url-text | all } | host { host-text | all } }

Parameters

Parameter Description Value
blacklist

Add blacklist rules.

-

whitelist

Add whitelist rules.

-

url url-text

Adds a URL rule.

The value is a string of 4 to 255 case-sensitive characters without question marks (?).

During preprocessing, the system removes the prefix http:// or https:// from the entered character string.

The value cannot start with a backslash (\) or slash (/).

The asterisk (*) can appear at the beginning, middle, or end of a rule. There must be three character strings that are not asterisks (*) before and after the asterisk (*), and the last character of the character string must not be a period (.). For example, ab.* or *ab. is not supported.

There must be at least three consecutive character strings that are not asterisks (*) before the number sign (#). If the length of the character string before the number sign (#) is three characters (excluding asterisks (*)), the last character cannot be a period (.).

If the rule contains spaces, use double quotation marks ("") to enclose the rule, for example, "abc def". Ensure that the double quotation marks are used in pairs.

If the value contains double quotation marks, escape them to %22, for example, abc %22def.

host host-text

Adds a domain name rule.

The value is a string of 4 to 255 case-insensitive characters and cannot contain spaces and special characters such as /\ # "?.

During preprocessing, the system removes the prefix http:// or https:// from the entered character string.

The asterisk (*) can appear at the beginning, middle, or end of a rule. There must be three character strings that are not asterisks (*) before and after the asterisk (*), and the last character of the character string must not be a period (.). For example, ab.* or *ab. is not supported.

all

Removes all the rules.

-

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Blacklist

Enterprises can define a blacklist to block the access to specified websites, improve work efficiency, and optimize network resource usage.

If a requested URL matches the blacklist, the device blocks the access to the requested website.

Whitelist

Enterprises can define a whitelist to allow uncontrolled access to URLs on the whitelist.

If a requested URL matches the whitelist, the device grants access to the requested website.

Precautions

The same URL or host rule configured in different URL filtering profiles is counted in the configured URL blacklist and whitelist, but does not occupy additional user-defined URL resources. Therefore, the number of used exact URLs (user-defined url) and fuzzy URLs (user-defined rule) displayed in the display engine resource information command output may be different from the number of configured URL blacklists and whitelists.

Example

# Create a URL filtering profile profile_development, and add www.example.com to the blacklist.
<> system-view
[] profile type url-filter name profile_development
[-profile-url-filter-profile_development] add blacklist url www.example.com

category action

Function

The category action command specifies the action for a URL category.

The undo category action command restores the action for a URL category to allow.

By default, the action of URL pre-defined category filter is allow.

Format

category pre-defined [ category-id category-id-value | subcategory-id subcategory-id-value ] action { allow | block | alert }

undo category pre-defined [ category-id category-id-value | subcategory-id subcategory-id-value ] action

Parameters

Parameter Description Value
category-id category-id-value

Specifies the ID of a predefined URL category.

The value is an integer that ranges from 1 to 100.

subcategory-id subcategory-id-value

Specifies the ID of a predefined URL subcategory.

The value is an integer that ranges from 101 to 60000.

allow

The category action is allow.

-

block

The category action is block.

-

alert

The category action is alert.

-

pre-defined

Indicates the pre-defined URL category.

-

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

Run the display url-filter category pre-defined command to display the category-id and subcategory-id of the specified predefined URL category.

Example

# Set the action for the predefined category P2P to block in the URL filtering profile view.
<> system-view
[] profile type url-filter name profile_development
[-profile-url-filter-profile_development] category pre-defined subcategory-id 101 action block

category pre-defined control-level

Function

The category pre-defined control-level command sets the control level for predefined URL categories.

The undo category pre-defined control-level command sets the control level for predefined URL categories to user-defined.

By default, the control level for predefined URL categories is user-defined.

Format

category pre-defined control-level { low | medium | high }

undo category pre-defined control-level

Parameters

Parameter Description Value
low

Sets the control level to low.

-

medium

Sets the control level to medium.

-

high

Sets the control level to high.

-

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

The device performs different actions on different types of websites at different control levels. To view the category control information at a specified level, run the display url-filter category pre-defined control-level [ high | low | medium ] command.

Example

# Set the control level for predefined URL categories to medium.
<> system-view
[] profile type url-filter name profile_development
[-profile-url-filter-profile_development] category pre-defined control-level medium

default action

Function

The default action command sets the default action for a URL filtering profile.

The undo default action command sets the default action for a URL filtering profile to allow.

By default, the default action for a URL filtering profile is allow.

Format

default action { allow | block | alert }

undo default action

Parameters

Parameter Description Value
allow

Sets the default action to allow.

-

block

Sets the default action to block.

-

alert

Sets the default action to alert.

-

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

When the URLs do not match any filtering mode, the default action is taken.

Example

# Set the default action for the URL filtering profile profile_development to block in the URL filtering profile view.
<> system-view
[] profile type url-filter name profile_development
[-profile-url-filter-profile_development] default action block

display cloud-query configuration

Function

The display cloud-query configuration command displays the global configurations of remote query.

Format

display cloud-query configuration

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After completing remote query-related configurations, you can run the display cloud-query configuration command to check whether the configurations are correct and whether the status of connections established for remote query is normal.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the global configurations of remote query.
<> display cloud-query configuration
--------------------------------------------------------------------------------
  Cloud Query Global Configuration Information:                                 
--------------------------------------------------------------------------------
  Country                                  : -                                  
--------------------------------------------------------------------------------
  URL Query Method                         : Remote                             
  URL Server Address                       : 10.1.0.1                            
  URL Switch Status                        : On                                 
  URL Server Port                          : 0                                  
  URL Server Status                        : No connect                         
--------------------------------------------------------------------------------
Table 2-845 Description of the display cloud-query configuration command output
Item Description
Cloud Query Global Configuration Information

Global configurations of remote query.

Country

Country/Region where the device resides.

If the parameter is displayed as NULL, the country or region where the device resides is not set. In this case, remote query is unavailable.

Run the country country-code command in the system view to set the country or region where the device resides.

URL Query Method

URL query mode of remote query. Remote indicates remote query.

URL Server Address

IP address of the URL remote query scheduling server.

URL Switch Status

Status of URL remote query.

URL Server Port

Port number of the URL remote query scheduling server.

URL Server Status

Status of the dispatch server for URL remote query.

display profile type url-filter

Function

The display profile type url-filter command displays information about URL filtering profiles.

Format

display profile type url-filter { name name }

display profile type url-filter name name [ blacklist [ url url-text | host host-text ] | whitelist [ url url-text | host host-text ] | pre-defined [ category-id category-id | subcategory-id subcategory-id ] ]

Parameters

Parameter Description Value
name name

Displays the information about the specified url-filter profile.

The value is a string of 1 to 32 case-sensitive characters without spaces.

blacklist

Indicates the blacklist.

-

url url-text

Specifies a URL rule.

The value is a string of 4 to 255 and 6 to 255 case-sensitive characters, spaces not supported.

host host-text

Specifies a HOST rule.

The value is a string of 4 to 255 and 6 to 255 case-sensitive characters, spaces not supported.

whitelist

Indicates the whitelist.

-

pre-defined

Indicates a predefined category.

-

category-id category-id

Specifies a category ID.

The value is an integer ranging from 1 to 100, in percentage.

subcategory-id subcategory-id

Specifies a sub-category ID.

The value is an integer ranging from 101 to 60000.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To display information about URL filtering profiles, run the display profile type url-filter command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display configuration information about all URL filtering profiles.
<> display profile type url-filter
2021-11-24 09:33:27.623                                                                                                             
--------------------------------------------------------------------------------                                                    
  URL Filtering Profile Configurations:                                                                                             
  Total Profiles: 1                                                                                                                 
--------------------------------------------------------------------------------                                                    
  Name        : default                                                                                                             
  Description : This is the default profile.                                                                                        
  Referenced  : 0                                                                                                                   
--------------------------------------------------------------------------------                                                    
  Default Action : Allow                                                                                                            
--------------------------------------------------------------------------------                                                    
  Action Mode    : Strict                                                                                                           
--------------------------------------------------------------------------------                                                    
  Https-Filter   : Disable                                                                                                          
--------------------------------------------------------------------------------                                                    
  Whitelist Only : Disable                                                                                                          
--------------------------------------------------------------------------------                                                    
  Blacklist Configurations:                                                                                                         
--------------------------------------------------------------------------------                                                    
  Type                Blacklist                                                                                                     
--------------------------------------------------------------------------------                                                    
--------------------------------------------------------------------------------                                                    
  Whitelist Configurations:                                                                                                         
--------------------------------------------------------------------------------                                                    
  Type                Whitelist                                                                                                     
--------------------------------------------------------------------------------                                                    
--------------------------------------------------------------------------------                                                    
  URL Pre-defined Category Configurations:                                                                                          
  Codes: CID(Category ID), CN(CategoryName), SID(Subcategory ID),                                                                   
         SN(Subcategory Name)                                                                                                       
--------------------------------------------------------------------------------                                                    
  CID CN                 SID   SN                                         Action                                                    
--------------------------------------------------------------------------------                                                    
  1   P2P                                                                                                                           
                         101   P2P                                        Allow                                                     
  2   Download                                                                                                                      
                         102   e-Books                                    Allow                                                     
                         162   Software Download                          Allow                                                     
                         163   Picture Download                           Allow                                                     
                         164   Music/Film Download                        Allow                                                     
                         165   General Download                           Allow                                                     
  3   Humanity                                                                                                                      
                         103   History/Culture                            Allow                                                     
                         166   Literature                                 Allow                                                     
                         167   Arts                                       Allow                                                     
                         168   Music                                      Allow                                                     
  4   Sports                                                                                                                        
                         104   Competitive Sports                         Allow                                                     
                         169   Leisure Sports                             Allow                                                     
                         170   Sports Equipment                           Allow                                                     
  5   Social Focus                                                                                                                  
                         105   Charity/Public Welfare                     Allow                                                     
                         171   Ecology/Development/Energy                 Allow                                                     
                         172   Anti-Terrorism/Criminal Issue Discussion   Allow                                                     
                         173   Social Issue/Life Style                    Allow                                                     
                         174   Human Rights/Racial Issue                  Allow                                                     
  6   Military                                                                                                                      
                         106   Military                                   Allow                                                     
  7   Social Network                                                                                                                
                         108   Blogs/Community                            Allow                                                     
                         251   Micro Blog                                 Allow                                                     
                         177   Online Photo/Network Albums                Allow                                                     
  8   Lottery                                                                                                                       
                         109   Lottery                                    Allow                                                     
  9   Recreation                                                                                                                    
                         110   Dating/Personals                           Allow                                                     
                         248   Gay/Lesbian Dating                         Allow                                                     
                         178   Chat                                       Allow                                                     
                         111   Cartoon/Animation                          Allow                                                     
                         112   Adult Recreational Places                  Allow                                                     
                         179   Recreational Place_Others                  Allow                                                     
                         114   Recreation                                 Allow                                                     
                         115   Video Games                                Allow                                                     
                         180   Board and Card Games                       Allow                                                     
                         181   Other Games                                Allow                                                     
                         117   Toys                                       Allow                                                     
  10  Religion/Supernatural                                                                                                         
                         118   Religion                                   Allow                                                     
                         119   Divining/Supernatural                      Allow                                                     
  12  Sexual Subject                                                                                                                
                         122   Adult Suppliers                            Allow                                                     
                         182   Sexual Health/Tips                         Allow                                                     
                         183   Nudity                                     Allow                                                     
                         184   Homosexual Subjects                        Allow                                                     
  13  Real Estate/Household                                                                                                         
                         123   Gardens/Yards                              Allow                                                     
                         186   Household Appliances                       Allow                                                     
                         187   Furniture/Daily Necessities                Allow                                                     
                         188   Housekeeping                               Allow                                                     
                         189   Decoration                                 Allow                                                     
                         124   Real Estate Information                    Allow                                                     
  14  Job Search                                                                                                                    
                         125   Job Search                                 Allow                                                     
  15  Search Engines/Portals                                                                                                        
                         126   Search Engines                             Allow                                                     
                         190   Portals                                    Allow                                                     
  16  Government/Politics                                                                                                           
                         127   Governments/Governmental Departments       Allow                                                     
                         128   Politics                                   Allow                                                     
  17  Education/Science                                                                                                             
                         191   Higher Education                           Allow                                                     
                         192   Skill Training/Examinations                Allow                                                     
                         193   Science/Research                           Allow                                                     
                         194   Pre-School                                 Allow                                                     
                         195   General Education                          Allow                                                     
                         196   Enrollment                                 Allow                                                     
                         129   Primary/Middle School Education            Allow                                                     
  18  News/Media                                                                                                                    
                         130   News/Media                                 Allow                                                     
  19  Travel                                                                                                                        
                         131   Travel                                     Allow                                                     
  20  Fashion                                                                                                                       
                         197   Clothes                                    Allow                                                     
                         198   Jewelry                                    Allow                                                     
                         199   Clothing Accessories                       Allow                                                     
                         132   Make-up/Cosmetics                          Allow                                                     
                         227   Lingerie                                   Allow                                                     
                         228   Tattoos/Body Painting                      Allow                                                     
                         200   General Fashion                            Allow                                                     
  21  Transportation Vehicle                                                                                                        
                         133   Automobiles                                Allow                                                     
                         201   Ships                                      Allow                                                     
                         202   Airplanes                                  Allow                                                     
                         204   Motorcycles/Bicycles                       Allow                                                     
                         205   Vehicle Renting                            Allow                                                     
  22  Laws                                                                                                                          
                         134   Laws                                       Allow                                                     
  23  Streaming Media                                                                                                               
                         135   Streaming Media                            Allow                                                     
  24  Life                                                                                                                          
                         136   Disease/Medical Care                       Allow                                                     
                         206   Mental Health                              Allow                                                     
                         207   Health Care                                Allow                                                     
                         208   Medicine                                   Allow                                                     
                         137   Transportation Guide                       Allow                                                     
                         209   Ticket                                     Allow                                                     
                         210   Reference Information                      Allow                                                     
                         138   Family/Marriage                            Allow                                                     
                         139   Pregnancy/Birth                            Allow                                                     
                         229   Children/Teenagers                         Allow                                                     
                         140   Animals/Pets                               Allow                                                     
                         141   Going Abroad/Emigration                    Allow                                                     
  25  Information Technology                                                                                                        
                         142   Software Technologies                      Allow                                                     
                         211   Network/Communication                      Allow                                                     
                         212   Hardware/Electron                          Allow                                                     
                         143   Hacker                                     Allow                                                     
                         144   Email                                      Allow                                                     
                         145   Web Communication                          Allow                                                     
                         240   VoIP                                       Allow                                                     
                         146   HTTP Proxy                                 Allow                                                     
                         213   Domain Name/IDC Services                   Allow                                                     
                         147   Online Storage                             Allow                                                     
                         253   Software Update                            Allow                                                     
  26  Forum                                                                                                                         
                         149   Forum                                      Allow                                                     
  27  Shopping                                                                                                                      
                         150   Shopping Guide                             Allow                                                     
                         214   Online Bookstore                           Allow                                                     
                         215   Flowers/Gifts                              Allow                                                     
                         216   Audio/Video Products                       Allow                                                     
                         217   General Shopping                           Allow                                                     
  28  Business/Economy/Finance                                                                                                      
                         218   Insurance                                  Allow                                                     
                         219   Service                                    Allow                                                     
                         220   Industry/Agriculture                       Allow                                                     
                         221   Transportation/Logistics                   Allow                                                     
                         222   Special Industries                         Allow                                                     
                         223   Investment/Business                        Allow                                                     
                         252   Online Payment                             Allow                                                     
                         151   Bank                                       Allow                                                     
                         230   Advertisement                              Allow                                                     
  29  Food/Alcohol/Tobacco                                                                                                          
                         152   Tobacco                                    Allow                                                     
                         238   Alcohol                                    Allow                                                     
                         153   Food                                       Allow                                                     
  30  Societies                                                                                                                     
                         154   Societies                                  Allow                                                     
  31  Vulgar/Gruesome                                                                                                               
                         155   Disgusting/Horrible/Violence               Allow                                                     
                         224   Alternative                                Allow                                                     
                         225   Mixed_Adult                                Allow                                                     
  32  Gambling                                                                                                                      
                         156   Gambling                                   Allow                                                     
  33  Drugs                                                                                                                         
                         157   Drugs                                      Allow                                                     
  34  Malicious Web Sites                                                                                                           
                         158   Malicious Web Sites                        Block                                                     
                         231   Phishing Sites                             Block                                                     
                         232   Malware Sites                              Block                                                     
  35  Pornography Web Sites                                                                                                         
                         159   Pornography                                Allow                                                     
                         254   Worst of List                              Allow                                                     
  36  Crime                                                                                                                         
                         160   Crime                                      Allow                                                     
  37  Vacancy Web Sites                                                                                                             
                         161   Vacancy Web Sites                          Allow                                                     
  38  Weapon                                                                                                                        
                         176   Weapon                                     Allow                                                     
  39  Fraud                                                                                                                         
                         226   Fraud                                      Allow                                                     
  40  Abortion                                                                                                                      
                         234   Abortion                                   Allow                                                     
  41  Suicide                                                                                                                       
                         235   Suicide                                    Allow                                                     
  42  Storage Server                                                                                                                
                         236   Storage Server                             Allow                                                     
  43  Hatred Speech                                                                                                                 
                         237   Hatred Speech                              Allow                                                     
  44  Cult                                                                                                                          
                         239   Cult                                       Allow                                                     
  45  General Sites                                                                                                                 
                         241   General Sites                              Allow                                                     
  99  Others                                                                                                                        
                         233   Others                                     Allow
Table 2-846 Description of the display profile type url-filter command output
Item Description
URL Filtering Profile Configurations

Configuration of URL filtering profiles.

URL Pre-defined Category Configurations

Configuration of the predefined URL category.

Total Profiles

Total number of profiles.

Name

Name of the profile.

Description

Configuration file description.

Referenced

Number of times a profile is referenced by a security policy.

Default Action

Default action of the URL filtering profile.

Action Mode

Action mode.

Action

Subclass action.

Https-Filter

HTTPS traffic filtering.

Whitelist Only

Configuring the filtering mode of allowing only the whitelist.

Whitelist Configurations

Whitelist configurations.

Whitelist

URL whitelist.

Blacklist Configurations

Blacklist configurations.

Blacklist

URL blacklist.

Type

Match type.

CID

Category ID.

CN

Category name.

SID

Subcategory ID.

SN

Subcategory name.

display url-filter category pre-defined

Function

The display url-filter category pre-defined command displays the URL category list.

Format

display url-filter category pre-defined [ category-id category-id-value | subcategory-id subcategory-id-value ]

Parameters

Parameter Description Value
category-id category-id-value

Specifies the ID of a predefined URL category.

The value is an integer that ranges from 1 to 100.

subcategory-id subcategory-id-value

Specifies the ID of a predefined URL subcategory.

The value is an integer that ranges from 101 to 60000.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view the URL category list, run the display url-filter category pre-defined command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the URL category list.
<> display url-filter category pre-defined
2021-11-24 09:47:58.952                                                                                                             
--------------------------------------------------------------------------------                                                    
  URL Pre-defined Category Count: 137                                                                                               
  URL Pre-defined Category List:                                                                                                    
  Codes: CID(Category ID), CN(CategoryName), SID(Subcategory ID),                                                                   
         SN(Subcategory Name)                                                                                                       
--------------------------------------------------------------------------------                                                    
  CID   CN                       SID   SN                                                                                           
--------------------------------------------------------------------------------                                                    
  1     P2P                                                                                                                         
                                 101   P2P                                                                                          
  2     Download                                                                                                                    
                                 102   e-Books                                                                                      
                                 162   Software Download                                                                            
                                 163   Picture Download                                                                             
                                 164   Music/Film Download                                                                          
                                 165   General Download                                                                             
  3     Humanity                                                                                                                    
                                 103   History/Culture                                                                              
                                 166   Literature                                                                                   
                                 167   Arts                                                                                         
                                 168   Music                                                                                        
  4     Sports                                                                                                                      
                                 104   Competitive Sports                                                                           
                                 169   Leisure Sports                                                                               
                                 170   Sports Equipment                                                                             
  5     Social Focus                                                                                                                
                                 105   Charity/Public Welfare                                                                       
                                 171   Ecology/Development/Energy                                                                   
                                 172   Anti-Terrorism/Criminal Issue Discussion                                                     
                                 173   Social Issue/Life Style                                                                      
                                 174   Human Rights/Racial Issue                                                                    
  6     Military                                                                                                                    
                                 106   Military                                                                                     
  7     Social Network                                                                                                              
                                 108   Blogs/Community                                                                              
                                 251   Micro Blog                                                                                   
                                 177   Online Photo/Network Albums                                                                  
  8     Lottery                                                                                                                     
                                 109   Lottery                                                                                      
  9     Recreation                                                                                                                  
                                 110   Dating/Personals                                                                             
                                 248   Gay/Lesbian Dating                                                                           
                                 178   Chat                                                                                         
                                 111   Cartoon/Animation                                                                            
                                 112   Adult Recreational Places                                                                    
                                 179   Recreational Place_Others                                                                    
                                 114   Recreation                                                                                   
                                 115   Video Games                                                                                  
                                 180   Board and Card Games                                                                         
                                 181   Other Games                                                                                  
                                 117   Toys                                                                                         
  10    Religion/Supernatural                                                                                                       
                                 118   Religion                                                                                     
                                 119   Divining/Supernatural                                                                        
  12    Sexual Subject                                                                                                              
                                 122   Adult Suppliers                                                                              
                                 182   Sexual Health/Tips                                                                           
                                 183   Nudity                                                                                       
                                 184   Homosexual Subjects                                                                          
  13    Real Estate/Household                                                                                                       
                                 123   Gardens/Yards                                                                                
                                 186   Household Appliances                                                                         
                                 187   Furniture/Daily Necessities                                                                  
                                 188   Housekeeping                                                                                 
                                 189   Decoration                                                                                   
                                 124   Real Estate Information                                                                      
  14    Job Search                                                                                                                  
                                 125   Job Search                                                                                   
  15    Search Engines/Portals                                                                                                      
                                 126   Search Engines                                                                               
                                 190   Portals                                                                                      
  16    Government/Politics                                                                                                         
                                 127   Governments/Governmental Departments                                                         
                                 128   Politics                                                                                     
  17    Education/Science                                                                                                           
                                 191   Higher Education                                                                             
                                 192   Skill Training/Examinations                                                                  
                                 193   Science/Research                                                                             
                                 194   Pre-School                                                                                   
                                 195   General Education                                                                            
                                 196   Enrollment                                                                                   
                                 129   Primary/Middle School Education                                                              
  18    News/Media                                                                                                                  
                                 130   News/Media                                                                                   
  19    Travel                                                                                                                      
                                 131   Travel                                                                                       
  20    Fashion                                                                                                                     
                                 197   Clothes                                                                                      
                                 198   Jewelry                                                                                      
                                 199   Clothing Accessories                                                                         
                                 132   Make-up/Cosmetics                                                                            
                                 227   Lingerie                                                                                     
                                 228   Tattoos/Body Painting                                                                        
                                 200   General Fashion                                                                              
  21    Transportation Vehicle                                                                                                      
                                 133   Automobiles                                                                                  
                                 201   Ships                                                                                        
                                 202   Airplanes                                                                                    
                                 204   Motorcycles/Bicycles                                                                         
                                 205   Vehicle Renting                                                                              
  22    Laws                                                                                                                        
                                 134   Laws                                                                                         
  23    Streaming Media                                                                                                             
                                 135   Streaming Media                                                                              
  24    Life                                                                                                                        
                                 136   Disease/Medical Care                                                                         
                                 206   Mental Health                                                                                
                                 207   Health Care                                                                                  
                                 208   Medicine                                                                                     
                                 137   Transportation Guide                                                                         
                                 209   Ticket                                                                                       
                                 210   Reference Information                                                                        
                                 138   Family/Marriage                                                                              
                                 139   Pregnancy/Birth                                                                              
                                 229   Children/Teenagers                                                                           
                                 140   Animals/Pets                                                                                 
                                 141   Going Abroad/Emigration                                                                      
  25    Information Technology                                                                                                      
                                 142   Software Technologies                                                                        
                                 211   Network/Communication                                                                        
                                 212   Hardware/Electron                                                                            
                                 143   Hacker                                                                                       
                                 144   Email                                                                                        
                                 145   Web Communication                                                                            
                                 240   VoIP                                                                                         
                                 146   HTTP Proxy                                                                                   
                                 213   Domain Name/IDC Services                                                                     
                                 147   Online Storage                                                                               
                                 253   Software Update                                                                              
  26    Forum                                                                                                                       
                                 149   Forum                                                                                        
  27    Shopping                                                                                                                    
                                 150   Shopping Guide                                                                               
                                 214   Online Bookstore                                                                             
                                 215   Flowers/Gifts                                                                                
                                 216   Audio/Video Products                                                                         
                                 217   General Shopping                                                                             
  28    Business/Economy/Finance                                                                                                    
                                 218   Insurance                                                                                    
                                 219   Service                                                                                      
                                 220   Industry/Agriculture                                                                         
                                 221   Transportation/Logistics                                                                     
                                 222   Special Industries                                                                           
                                 223   Investment/Business                                                                          
                                 252   Online Payment                                                                               
                                 151   Bank                                                                                         
                                 230   Advertisement                                                                                
  29    Food/Alcohol/Tobacco                                                                                                        
                                 152   Tobacco                                                                                      
                                 238   Alcohol                                                                                      
                                 153   Food                                                                                         
  30    Societies                                                                                                                   
                                 154   Societies                                                                                    
  31    Vulgar/Gruesome                                                                                                             
                                 155   Disgusting/Horrible/Violence                                                                 
                                 224   Alternative                                                                                  
                                 225   Mixed_Adult                                                                                  
  32    Gambling                                                                                                                    
                                 156   Gambling                                                                                     
  33    Drugs                                                                                                                       
                                 157   Drugs                                                                                        
  34    Malicious Web Sites                                                                                                         
                                 158   Malicious Web Sites                                                                          
                                 231   Phishing Sites                                                                               
                                 232   Malware Sites                                                                                
  35    Pornography Web Sites                                                                                                       
                                 159   Pornography                                                                                  
                                 254   Worst of List                                                                                
  36    Crime                                                                                                                       
                                 160   Crime                                                                                        
  37    Vacancy Web Sites                                                                                                           
                                 161   Vacancy Web Sites                                                                            
  38    Weapon                                                                                                                      
                                 176   Weapon                                                                                       
  39    Fraud                                                                                                                       
                                 226   Fraud                                                                                        
  40    Abortion                                                                                                                    
                                 234   Abortion                                                                                     
  41    Suicide                                                                                                                     
                                 235   Suicide                                                                                      
  42    Storage Server                                                                                                              
                                 236   Storage Server                                                                               
  43    Hatred Speech                                                                                                               
                                 237   Hatred Speech                                                                                
  44    Cult                                                                                                                        
                                 239   Cult                                                                                         
  45    General Sites                                                                                                               
                                 241   General Sites                                                                                
  99    Others                                                                                                                      
                                 233   Others                                                                                       
--------------------------------------------------------------------------------
Table 2-847 Description of the display url-filter category pre-defined command output
Item Description
URL Pre-defined Category Count

Number of predefined URL categories.

URL Pre-defined Category List

List of predefined URL categories.

CID

Category ID.

CN

Category name.

SID

Subcategory ID.

SN

Subcategory name.

display url-filter category pre-defined control-level

Function

The display url-filter category pre-defined control-level command displays information about all the predefined categories of a specific control level.

Format

display url-filter category pre-defined control-level [ low | medium | high ]

Parameters

Parameter Description Value
low

Displays information about all the predefined categories whose control level is low.

-

medium

Displays information about all the predefined categories whose control level is medium.

-

high

Displays information about all the predefined categories whose control level is high.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To display information about all the predefined categories of a specific control level, run the display url-filter category pre-defined control-level command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the information about all the predefined categories whose control level is low.
<> display url-filter category pre-defined control-level low
--------------------------------------------------------------------------------
  Control Level: Low                                                            
  URL Pre-defined Category Configurations:                                      
  Codes: CID(Category ID), CN(CategoryName), SID(Subcategory ID)               
         SN(Subcategory Name)                                                   
--------------------------------------------------------------------------------
  CID CN                   SID   SN                                       Action
--------------------------------------------------------------------------------
  1   P2P                                                                       
                         101   P2P                                        Allow 
  2   Download                                                                  
                         102   e-Books                                    Allow 
                         162   Software Download                          Allow 
                         163   Picture Download                           Allow 
                         164   Music/Film Download                        Allow 
                         165   General Download                           Allow 
  3   Humanity                                                                  
                         103   History/Culture                            Allow 
                         166   Literature                                 Allow 
                         167   Arts                                       Allow 
                         168   Music                                      Allow 
  4   Sports                                                                    
                         104   Competitive Sports                         Allow 
                         169   Leisure Sports                             Allow 
                         170   Sports Equipment                           Allow
Table 2-848 Description of the display url-filter category pre-defined control-level command output
Item Description
Control Level

Control level of a predefined category.

CID

ID of a predefined URL category.

CN

Name of a predefined URL category.

SID

ID of a predefined URL subcategory.

SN

Name of a predefined URL subcategory.

Action

Available actions:

  • Allow.
  • Block.
  • Alert.

display url-filter category pre-defined statistics

Function

The display url-filter category pre-defined statistics command displays URL category statistics.

Format

display url-filter category pre-defined [ subcategory-id subcategory-id-value ] statistics

Parameters

Parameter Description Value
subcategory-id subcategory-id-value

Specify the sub-category ID.

The value is an integer ranging from 101 to 60000.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After you run the display url-filter category statistics command to view the URL category statistics, you can run the reset url-filter category statistics command to clear the original statistics and collect statistics again. Cleared statistics cannot be restored. Exercise caution when you run this command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display statistics on predefined URL categories.
<> display url-filter category pre-defined statistics
  Statistics Information on slot 11 cpu 0:                                                                                          
--------------------------------------------------------------------------------                                                    
  Category Statistics Information:                                                                                                  
  Codes: SID(Subcategory ID), SN(Subcategory Name), SMN(Subcategory Matched Num)                                                    
--------------------------------------------------------------------------------                                                    
  SID   SN                                           SMN                                                                            
--------------------------------------------------------------------------------                                                    
  101   P2P                                          0                                                                              
  102   e-Books                                      0                                                                              
  103   History/Culture                              0                                                                              
  104   Competitive Sports                           0                                                                              
  105   Charity/Public Welfare                       0                                                                              
  106   Military                                     0                                                                              
  108   Blogs/Community                              0                                                                              
  109   Lottery                                      0                                                                              
  110   Dating/Personals                             0                                                                              
  111   Cartoon/Animation                            0                                                                              
  112   Adult Recreational Places                    0                                                                              
  114   Recreation                                   0                                                                              
  115   Video Games                                  0                                                                              
  117   Toys                                         0                                                                              
  118   Religion                                     0                                                                              
  119   Divining/Supernatural                        0                                                                              
  122   Adult Suppliers                              0                                                                              
  123   Gardens/Yards                                0
Table 2-849 Description of the display url-filter category pre-defined statistics command output
Item Description
Statistics Information on slot 11 cpu 0

Statistics of CPU 0 in slot 11.

SID

URL subcategory ID.

SN

URL subcategory name.

SMN

URL subcategory match count.

display url-filter statistics

Function

The display url-filter statistics command displays statistics on URL filtering.

Format

display url-filter statistics slot slot-id cpu cpu-id

Parameters

Parameter Description Value
cpu cpu-id

Specify the CPU ID.

The value is an integer that ranges from 0 to 4.

slot slot-id

Specify the slot ID.

The value is an integer that ranges from 0 to 16.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To display statistics on URL filtering, run the display url-filter statistics command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Displays statistics on URL filtering.
<> display url-filter statistics

-----------------------------------------------------------

  Statistics Information:

-----------------------------------------------------------

   Total HTTP Requests            : 0

   Total Permitted HTTP Requests  : 0

   Total Denied HTTP Requests     : 0

   Total HTTPS Requests           : 0

   Total Permitted HTTPS Requests : 0

   Total Denied HTTPS Requests    : 0

   Matched Blacklist              : 0

   Matched Whitelist              : 0
   
   Matched Pre-defined Category   : 0
   
   Matched Timeout Action         : 0
   
   Matched Default Action         : 0

   Exception Packets Numbers      : 0
   
   Pre-defined Cache Hit Rate(%)  : -    
   
   Pre-defined URL Numbers        : 0  

-----------------------------------------------------------
Table 2-850 Description of the display url-filter statistics command output
Item Description
Statistics Information

Statistics on URL filtering.

Total HTTP Requests

Total number of HTTP requests.

Total Permitted HTTP Requests

Total number of permitted HTTP requests.

Total Denied HTTP Requests

Total number of blocked HTTP requests.

Total HTTPS Requests

Total HTTPS requests.

Total Permitted HTTPS Requests

Total number of allowed HTTPS requests.

Total Denied HTTPS Requests

Total number of blocked HTTPS requests.

Matched Blacklist

Number of times the blacklist is matched.

Matched Whitelist

Number of times the whitelist is matched.

Matched Pre-defined Category

Number of times that the predefined category is matched.

Matched Timeout Action

Number of times the timeout action is matched.

Matched Default Action

Number of times the default action is matched.

Pre-defined Cache Hit Rate(%)

The hit rate of the predefined cache.

Pre-defined URL Numbers

Number of pre-defined URLs.

Exception Packets Numbers

Number of exception packets.

https-filter enable

Function

The https-filter enable command enables the encrypted traffic filtering function.

The undo https-filter enable command disables the function.

By default, the encrypted traffic filtering function is disabled.

Format

https-filter enable

undo https-filter enable

Parameters

None

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

The URL requests sent by users to access desired websites are transmitted using HTTP or HTTPS. For HTTP traffic, the device can properly implement URL filtering. For HTTPS traffic, the device can implement URL filtering only after encrypted traffic filtering or SSL-encrypted traffic detection is configured.

Encrypted traffic filtering takes effect only when it is enabled in the URL filtering profile. If encrypted traffic filtering is disabled in the URL filtering profile, the URL filtering profile does not take effect for HTTPS traffic.

Example

# Enable the encrypted traffic filtering function.
<> system-view
[] profile type url-filter name profile_url
[-profile-url-filter-profile_url] https-filter enable

import url-sdb file

Function

The import url-sdb file command loads the initial URL category database.

Format

import url-sdb file file-name

Parameters

Parameter Description Value
file file-name

Specifies an initial database file name that contains the absolute path.

The value is a string of 10 to 63 case-sensitive characters, spaces not supported.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

If no initial URL category database is loaded on the device or the initial URL category database needs to be updated, you can manually load the initial URL category database .

If there is no initial URL category database on the local device, log in to the security center platform (isecurity.huawei.com) to download it. On the home page of the website, choose Signature Update > Signature Update. Select information, such as the product model and version number. On the Initial URL tab, download the latest initial URL category database. Upload the initial URL category database to the device.

If the initial URL category database cannot be loaded. In this case, contact technical support personnel.

Example

# Load an initial URL category database.
<> system-view
[] import url-sdb file flash:/url.sdb

profile type url-filter

Function

The profile type url-filter command creates a url-filter profile and displays the profile view.

The undo profile type url-filter command deletes all or the specified url-filter profiles.

By default, there is a URL filtering profile named default on the device.

Format

profile type url-filter name name

undo profile type url-filter { name name | all }

Parameters

Parameter Description Value
name name

Specify the name of a profile; the length of the name is 1 to 32 characters; if the name contains spaces, the name must be enclosed with double quotation marks, for example, "user for test".

The value is a string of 1 to 32 case-sensitive characters, spaces supported.

all

Indicate all profiles of the specified type.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You need to create a URL filtering profile and reference the profile in the security policy before you are able to use the URL filtering function.

After you create a URL filtering profile, configure the blacklist, whitelist to specify the URLs that need to be filtered.

Example

# Create URL filter profile profile1.
<> system-view
[] profile type url-filter name profile1
[-profile-url-filter-profile1]

push-info module url-filter template

Function

The push-info module url-filter template command sets the language of the pushed URL filtering page.

The undo push-info module url-filter template command restores the language of the URL filtering push page.

By default, the language of the URL filtering push page is English.

Format

push-info module url-filter template { english | hindi | spanish | french | arabic | bengali | russian | portuguese | indonesian | german }

undo push-info module url-filter template

Parameters

Parameter Description Value
english

Indicates that the language of the pushed page is English.

-

hindi

Indicates that the language of the pushed page is Hindi.

-

spanish

Indicates that the language of the pushed page is Spanish.

-

french

Indicates that the language of the pushed page is French.

-

arabic

Indicates that the language of the pushed page is Arabic.

-

bengali

Indicates that the language of the pushed page is Bengali.

-

russian

Indicates that the language of the pushed page is Russian.

-

portuguese

Indicates that the language of the pushed page is Portuguese.

-

indonesian

Indicates that the language of the pushed page is Indonesian.

-

german

Indicates that the language of the pushed page is German.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The device has 10 built-in language templates. To change the language of the pushed URL filtering page, run the push-info module url-filter template command.

Example

# In the system view, set the language of the URL filtering push page to Spanish.
<> system-view
[] push-info module url-filter template spanish

reset url-filter category pre-defined statistics

Function

The reset url-filter category pre-defined statistics command clears category statistics on URL filtering.

Format

reset url-filter category pre-defined [ subcategory-id subcategory-id ] statistics

Parameters

Parameter Description Value
subcategory-id subcategory-id

Specify the sub-category ID.

The range of values is from 101 to 60000.

Views

User view

Default Level

3: Management level

Usage Guidelines

After executing this command, the previous URL filtering classification statistics will not be recovered. Please confirm it carefully. This command will only clear the information displayed in display url-ilter category pre-defined statistics command.

Example

# Clear all category statistics of the URL filter.
<> reset url-filter category pre-defined statistics

reset url-filter statistics

Function

The reset url-filter statistics command clears statistics on URL filtering.

Format

reset url-filter statistics { blacklist | whitelist | all }

Parameters

Parameter Description Value
blacklist

Clears statistics of the blacklists.

-

whitelist

Clears statistics of the whitelists.

-

all

Clears all URL filtering statistics.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

Exercise caution when running this command. URL filtering statistics cannot be restored after being cleared.

Example

# Clear url-filter statistics.
<> reset url-filter statistics all

url-filter query timeout

Function

The url-filter query timeout command specifies the timeout time of a URL remote query and the timeout action (action to be taken when a URL remote query times out).

The undo url-filter query timeout command restores the default timeout time and action of a URL remote query.

By default, the URL remote query timeout is 3 seconds.

Format

url-filter query timeout { time time-value | action { allow | block | alert } } *

undo url-filter query timeout [ time | action ] *

Parameters

Parameter Description Value
time time-value

Indicates the timeout time of a URL remote query.

The value is an integer that ranges from 1 to 5.

action

Sets the timeout action of a URL remote query.

-

allow

Sets the timeout action of a URL remote query to allow.

-

block

Sets the timeout action of a URL remote query to block.

-

alert

Sets the timeout action of a URL remote query to alert.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The function takes effect only after the URL remote query license is valid.

Example

# Set the timeout duration for URL remote query to 2 seconds, and the timeout action to block.
<> system-view
[] url-filter query timeout time 2 action block

whitelist-only enable

Function

The whitelist-only enable command enables URL filtering that supports the whitelist mode only.

The undo whitelist-only enable command disables URL filtering that supports the whitelist mode only.

By default, URL filtering that supports the whitelist mode only is disabled.

Format

whitelist-only enable

undo whitelist-only enable

Parameters

None

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

To enable URL filtering in the whitelist mode without other complex configurations, you can run the whitelist-only enable command.

After the function is enabled, the data flow that matches the whitelist is allowed, and the data flow that does not match the whitelist is blocked.

Example

# Enable URL filtering that supports the whitelist mode only.
<> system-view
[] profile type url-filter name profile_development
[-profile-url-filter-profile_development] whitelist-only enable
Translation
Favorite
Download
Update Date:2023-10-19
Document ID:EDOC1100301592
Views:52381
Downloads:116
Average rating:0.0Points

Digital Signature File

digtal sigature tool