Adding or deleting a custom whitelist rule using the CLI

Use the CLI commands in this topic to add a rule to a custom whitelist or to delete a rule from a custom whitelist. You can add up to 10,000 whitelist entries to the appliance database.

To add rules to a custom whitelist:

Go to CLI configuration mode.

hostname > enable
hostname # configure terminal

Specify the type of rule to add to a custom whitelist.
- To add the whitelist rule based on an eight-digit signature ID:
```
hostname (config) # analysis custom whitelist signature-id <id>
```
- To add the whitelist rule based on the URL:
```
hostname (config) # analysis custom whitelist url <URL>
```
- To add the whitelist rule based on the RegEx URL:
```
hostname (config) # analysis custom whitelist regex url <URL>
```
- To add the whitelist rule based on the SHA-256 hash file:
```
hostname (config) # analysis custom whitelist sha256 <sha256>
```
- To add the whitelist rule based on the MD5 hash file:
```
hostname (config) # analysis custom whitelist md5sum <md5sum>
```
Verify that the specified signature ID and SHA-256 hash file are added to the custom whitelist.
```
hostname (config) # show analysis custom whitelist
```
Verify that the specified URLs are added to the custom whitelist.
```
hostname (config) # show analysis custom whitelist urls
```
Verify that the specified RegEx URLs are added to the custom whitelist.
```
hostname (config) # show analysis custom whitelist regex urls
```
Save your changes.
```
hostname (config) # write memory
```

Examples

This example adds the URL "trackeragain.keymedia.com/?id=124375" to a custom whitelist:

hostname (config) # analysis custom whitelist url trackeragain.keymedia.com/?id=124375
hostname (config) # show analysis custom whitelist urls
Successfully fetched url whitelist
Custom Whitelist URLs:
  http://hsych.com/channel-9.html1491201030.73.7242
  http://trackeragain.keymedia.com/?id=124375

This example adds the SHA-256 hash file "2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881" to the whitelist:

hostname (config) # analysis custom whitelist sha256 2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881

This example adds the signature ID "13456789" to the whitelist:

hostname (config) # analysis custom whitelist signature-id 13456789

This example shows that the specified SHA-256 hash file and signature ID are added to the custom whitelist:

hostname # show analysis custom whitelist
Custom Whitelists:
  2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881
Signature ID Whitelist:
  13456789

To delete rules from a custom whitelist:

Go to CLI configuration mode.

hostname > enable
hostname # configure terminal

Specify the type of rule to delete from a custom whitelist.
- To delete the whitelist rule based on the URL:
```
hostname (config) # no analysis custom whitelist url <URL>
```
- To delete the whitelist rule based on the RegEx URL:
```
hostname (config) # no analysis custom whitelist regex url <URL>
```
- To delete the whitelist rule based on the SHA-256 hash file:
```
hostname (config) # no analysis custom whitelist sha256 <sha256>
```
- To delete the whitelist rule based on the MD5 hash file:
```
hostname (config) # no analysis custom whitelist md5sum <md5sum>
```
- To delete the whitelist rule based on an eight-digit signature ID:
```
hostname (config) # no analysis custom whitelist signature-id <id>
```
Verify that the specified signature ID and SHA-256 hash file are deleted from the custom whitelist.
```
hostname (config) # show analysis custom whitelist
```
Verify that the specified URLs are deleted from the custom whitelist.
```
hostname (config) # show analysis custom whitelist urls
```
Verify that the specified RegEx URLs are deleted from the custom whitelist.
```
hostname (config) # show analysis custom whitelist regex urls
```
Save your changes.
```
hostname (config) # write memory
```

Examples

This example deletes the URL "trackeragain.keymedia.com/?id=124375" from a custom whitelist:

hostname (config) # no analysis custom whitelist url trackeragain.keymedia.com/?id=124375

hostname # show analysis custom whitelist urls
Successfully fetched url whitelist
Custom Whitelist URLs:
  http://hsych.com/channel-9.html1491201030.73.7242

This example confirms that the URL no longer exists:

hostname (config) # no analysis custom whitelist url trackeragain.keymedia.com/?id=124375 % Unable to delete: url not found

This example deletes the signature ID "13456789" from the whitelist:

hostname (config) # no analysis custom whitelist signature-id 13456789

This example deletes the SHA-256 hash file "2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881" from the whitelist:

hostname (config) # no analysis custom whitelist sha256 2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881

This example shows that the SHA-256 hash file and signature ID are deleted from the custom whitelist:

hostname (config) # show analysis custom whitelist
No whitelisted signature-ids.