whitelist

Creates a whitelist rule. A whitelist is a list of Websites and URLs allowed access by clients. URL filtering is based on the classification of Websites into pre-defined category-types. Some of the category-types are further divided into multiple categories. Currently available are 12 built-in category types, and 64 categories. These built-in category-types and categories cannot be modified.

Use the available options to identify the category-types and categories to include in the whitelist.

Supported on the following devices:

Syntax

whitelist [category-type|url-list]
whitelist category-type [adult-content|all|business|communication|entertainment|
file-sharing-backup|gaming|news-sports-general|p2p|questionable|security-risk|
social-photo-sharing|software-updates] precedence <1-500> {description <LINE>}


    


    
Parameters

      
      
whitelist category-type [adult-content|all|business|communication|entertainment|
file-sharing-backup|gaming|news-sports-general|p2p|questionable|security-risk|
social-photo-sharing|software-updates] precedence <1-500> {description <LINE>}


      

            

              whitelist category-type
                <SELECT-CATEGORY-TYPE>
              Selects the category-type to add to this whitelist. A
                category is a pre-defined URL list available in the WiNG software. Categories are
                based on an external database, and cannot be modified or removed. Custom categories
                can created with the URL List and added to the database.
Websites have been
                  classified into the following 12 category types: adult-content, business,
                  communication, entertainment, file-sharing-backup, gaming, news-sports-general,
                  p2p, questionable, security-risk, social-photo-sharing, and
                  software-updates.


Select ‘all‘ to whitelist all category-types.


Some
                  of the category-types are further classified into categories. For example, the
                  ‘adult-content‘ category-type is differentiated into the following categories:
    
                    
  • alcohol-tobacco, dating-personals, gambling, nudity,
                      pornography-sexually-explicit, sex-education, and weapons.
    • 
                  


The system allows all categories (URLs falling within their limits)
                  within the selected category-type.


            

            

              precedence <1-500>
              Configures the precedence value for this whitelist rule.
                Rules are applied in the increasing order of their precedence. Therefore, rules with
                lower precedence are applied first.
            

            

              description <LINE>
              Optional. Configures a description (not exceeding 80
                characters) for this whitelist rule. Enter a description that allows you to identify
                the purpose of the rule.
            

          

      
whitelist url-list <URL-LIST-NAME> precedence <1-500> {description <LINE>}


      

            

              whitelist url-list <URL-LIST-NAME>
              Associates a URL list with this URL filter. When associated with a whitelist
                rule, all URLs listed in the specified URL list are allowed access.
URL lists are
                  customized categories included in the custom filter-level setting. URL lists
                  enable an administrator to blacklist or whitelist URLs in addition to the built-in
                  categories. For more information on configuring a URL list, see url-list.
    
                    
  • <URL-LIST-NAME> – Enter
                      URL list name (should be existing and configured)
    • 
                  


            

            

              precedence <1-500>
              Configures the precedence value for this whitelist rule. Rules are applied in
                the increasing order of their precedence. Therefore, rules with lower  precedence
                are applied first.
            

            

              description <LINE>
              Optional. Configures a description (not exceeding 80
                characters) for this whitelist rule. Enter a description that allows you to identify
                the purpose of the rule.
            

          

    


    
Examples

      
      
nx9500-6C8809(config-url-filter-test)#whitelist category-type communication category chat precedence 7


      
nx9500-6C8809(config-url-filter-test)#show context
url-filter test
 description "Blacklists sites inappropriate for children and are security risks."
 blacklist level medium-high precedence 10
 whitelist category-type communication category chat precedence 7
 blacklist category-type security-risk category botnets precedence 3
 blacklist category-type adult-content category alcohol-tobacco precedence 1
 blockpage internal content "The requested Web page is blocked and cannot be displayed for viewing"
nx9500-6C8809(config-url-filter-test)#


    


    
Related Commands

      
      

            

              no (url-filter-config-mode-commands)
              Removes a whitelist rule from this URL filter. Specify the category-type,
                category, and precedence to identify the blacklist rule. The identified rule is
                removed form the URL filter.
            

          

    


  

 9037762-04 Rev AB