Use the CLI commands in this topic to add a domain to a custom whitelist or to delete a domain from a custom whitelist for URL Dynamic Analysis. A domain whitelist allows you to bypass URL Dynamic Analysis. The appliance will not analyze a URL within an email message body if it contains a whitelisted domain. You can add up to 100 domain whitelist entries to the appliance database. You can add or delete each custom domain separately.
Administrator or Operator access to the Email Security - Server appliance.
Enable URL Dynamic Analysis. For details about how to enable URL Dynamic Analysis, see Enabling or disabling URL dynamic analysis using the Web UI or Enabling or disabling URL dynamic analysis using the CLI.
Go to CLI configuration mode.
hostname > enable hostname # configure terminal
You can use any one of the 3 CLI commands mentioned below. Specify the domain or the domain pattern to add to a custom whitelist.
hostname (config) # email-analysis url-dynamic-analysis domain-whitelist <domain_name>
hostname (config) # analysis adv-url-defense domain-whitelist strict <domain_name>
hostname (config) # analysis adv-url-defense domain-whitelist regex <domain_pattern>
An error is displayed if the domain is already whitelisted.
Verify that the domains are added to the custom whitelist.
hostname (config) # show email-analysis url-dynamic-analysis domain-whitelist
Save your changes.
hostname (config) # write memory
Examples
The following examples show the various ways to add one or more domains to a custom whitelist for URL Dynamic Analysis:
hostname (config) # email-analysis adv-url-defense domain-whitelist strict mydomain3.com Domain mydomain3.com added successfully
hostname (config) # analysis adv-url-defense domain-whitelist strict mydomain.*com Domain mydomain.*com added successfully
hostname (config) # analysis adv-url-defense domain-whitelist regex mydomain*.com Domain mydomain*.com added successfully
This example shows that multiple domains are added to a custom whitelist for URL Dynamic Analysis:
hostname (config) # show email-analysis url-dynamic-analysis domain-whitelist mydomain3.com mydomain4.com mydomain1.com mydomain2.com mydomainn.com mydomain.com mydomainabc.com
------------------------------------- Total number of domains = 4
Go to CLI configuration mode.
hostname > enable hostname # configure terminal
You can use any one of the 3 CLI commands mentioned below. Specify the domain or the domain pattern to add to a custom whitelist
hostname (config) # no email-analysis url-dynamic-analysis domain-whitelist <domain_name>
hostname (config) # no analysis adv-url-defense domain-whitelist strict <domain_name>
hostname (config) # no analysis adv-url-defense domain-whitelist regex <domain_pattern>
Verify that the domains are deleted from the custom whitelist.
hostname (config) # show email-analysis url-dynamic-analysis domain-whitelistSave your changes.
hostname (config) # write memory
Examples
The following examples show the various ways to delete a domain from a custom whitelist:
hostname (config) # no email-analysis adv-url-defense domain-whitelist strict mydomain1.com Domain(mydomain1.com) removed successfully
This example deletes all the domains from a custom whitelist:
hostname (config) # no email-analysis adv-url-defense domain-whitelist regex All domains removed successfully
This example shows that all the domains are deleted from a custom whitelist for URL Dynamic Analysis:
hostname (config) # show email-analysis url-dynamic-analysis domain-whitelist ------------------------------------- Total number of domains = 0