add { blacklist | whitelist } (URL filtering profile view)

Function

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

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

Format

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

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

Parameters

Parameter	Description	Value
blacklist	Indicates a blacklist rule.	-
whitelist	Indicates a whitelist rule.	-
url url-text	Specifies a URL rule.	The value is a character string. If the URL does not contain any space or question mark (?), the length is 4 to 255 characters. If the URL contains spaces or question marks (?) (not at the end), the URL must be enclosed by double quotation marks ("") and the length is 6 to 255 characters. Pre-processing removes http:// from the entered character string. If the URL contains double quotation marks (""), you need to replace them with escape characters "%22". For example, if the URL is www.example.com/abc/def?"gh, you need to enter www.example.com/abc/def?%22gh. * indicates wildcard, which appears at the beginning, middle, or end of a URL and indicates suffix matching, keyword matching, and prefix matching, respectively. For example: When the URL is configured as abc, all URLs ending with abc* are matched. When the URL is configured as **abcd*, all URLs containing a and bcd** in sequence are matched. When the URL is configured as bcd, all URLs starting with bcd* are matched. If a URL does not contain any wildcard, the URL must contain at least four consecutive characters, such as abcd. If the URL contains wildcard, it must contain at least three consecutive characters except the wildcard, such as abc, abc, abc, and abcd. If the entered URL ends with ., there must be at least three common characters before .. Take *..*** as an example. It ends with .. However, it does not contain three common characters before .. If the total length of the entered URL is 4, only one * exists at the beginning, and the length of the remaining common characters is 3, the last character cannot be .. Take ab. as an example. Its total length is 4 and begins with , and the length of the remaining common characters is 3. However, its last character is ..
url all	Indicates all URL rules.	-
host host-text	Specifies a domain name rule.	The value is a character string and the length is 4 to 255 characters, without special character slash (/), back slash (\), number sign (#), double quotation mark ("), question mark (?), or space. * indicates wildcard, which appears at the beginning, middle, or end of a domain name and indicates suffix matching, keyword matching, and prefix matching, respectively. For example: When a domain name is configured as abc, all domain names ending with abc* are matched. When a domain name is configured as **abcd*, all domain names containing a and bcd** in sequence are matched. When a domain name is configured as bcd, all domain names starting with bcd* are matched. If a domain name does not contain any wildcard, the domain name must contain at least four consecutive characters, such as abcd. If the domain name contains wildcard, it must contain at least three consecutive characters except the wildcard, such as abc, abc, abc, and abcd. If the entered domain name ends with ., there must be at least three common characters before .. Take *..*** as an example. It ends with .. However, it does not contain three common characters before .. If the total length of the entered domain name is 4, only one * exists at the beginning, and the length of the remaining common characters is 3, the last character cannot be .. Take ab. as an example. Its total length is 4 and begins with , and the length of the remaining common characters is 3. However, its last character is ..
host all	Indicates all domain name rules.	-
all	Indicates all URL and domain name rules.	-

Views

URL filtering profile view

Default Level

2: Configuration level

Usage Guidelines

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 FW 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 FW grants access to the requested website.

Example

# Create a URL filtering profile profile_development, and add www.example.com to the blacklist.

<sysname> system-view
[sysname] profile type url-filter name profile_development
[sysname-profile-url-filter-profile_development] add blacklist url www.example.com