Use the IP Whitelist to exempt specific IP addresses (IPs) from a number of security restrictions. Heuristics and Bayesian, DNSBL, DKIM Verification, and many other Security features in SecurityGateway have the option to exempt whitelisted IPs, or to exempt messages being delivered by those IPs. You can add IP addresses to this whitelist both globally and for specific domains, and even though IPs are typically added one at a time, there is also an import feature to allow you to use a comma separated values (CSV) file to add multiple IP addresses at once. Finally, the IP Whitelist also has an export feature, which allows you to save the contents of the whitelist to a CSV file.
Adding IPs to the Whitelist
To add an IP address to the IP Whitelist, click New on the toolbar at the top of the page. This will open the Whitelist Entry page for adding the IP address (see below).
Editing a Whitelisted IP Address
To edit one of the whitelisted IPs, double-click the entry you wish to edit, or select the desired entry and then click Edit on the toolbar at the top of the page. This will open that entry in the Whitelist Entry page.
Deleting a Whitelisted IP Address
To delete one or more of the whitelisted IP addresses, select the desired entries and then click Delete on the toolbar at the top of the page. You can select more than one entry by holding down the CTRL key while clicking each one. After clicking Delete, a confirmation box will pop up asking you if you are sure that you would like to delete the selected entries.
Importing IP Addresses to the Whitelist
To import a list of IPs to the IP Whitelist, click Import on the toolbar at the top of the page. This will open the Import List page. Use the Browse button on this page to navigate to the CSV file containing the IP addresses that you wish to import, and then click Import Lists.
CSV File Formats
You can use any text editor such as Notepad to create the CSV file for adding IP addresses to the whitelists. Simply create the file according to the format below and save it as filename.csv. The first line of each CSV file must be a mapping row, which allows the server to know in what order the data will appear. Each item in this file must be contained in quotes and separated by a comma.
Importing IP addresses to the Global Whitelist:
The Value column is for the IP address that you wish to whitelist (CIDR notation and *, ?, and # wildcards are all supported), the Type column should say, "WhiteListIPGlobal", and the Comments column is for any notes you may wish to add regarding an entry, for your own reference. The Comments column is optional, but if you include it then use empty quotes for any entry for which you do not include a comment.
Example CSV file:
"Value","Type","Comments"
"1.2.3.4","WhiteListIPGlobal","This is a comment about the address."
"1.1.1.1","WhiteListIPGlobal",""
"192.168.*.*","WhiteListIPGlobal","This is another comment."
Importing IP addresses to a specific domain's IP Whitelist:
The Domain column is for the domain to which this whitelist belongs. For example, if you are wanting to add IP addresses to example.com's IP Whitelist, then use "example.com" in the Domain column. The Value column is for the IP address that you wish to whitelist (CIDR notation and *, ?, and # wildcards are all supported), the Type column should say, "WhiteListIPDomain", and the Comments column is for any notes you may wish to add regarding an entry, for your own reference. The Comments column is optional, but if you include it then use empty quotes for any entry for which you do not include a comment.
Example CSV file:
"Domain","Value","Type","Comments"
"example.com","1.2.3.4","WhiteListIPDomain","This is a comment about the address."
"example.com","1.1.1.1","WhiteListIPDomain",""
"example.com","192.168.*.*","WhiteListIPDomain","This is another comment."
Exporting IP Addresses from the Whitelist
To export an IP Whitelist:
1.In the For Domain: drop-down list box, choose Global or a specific domain.
2.Click Export on the toolbar at the top of the page. This will open the File Download dialog.
3.Click Save.
4.Choose a file name and location for the file.
5.Click Save and then Close.
Whitelist Entry
This page is used for adding new IP addresses to the whitelist and for editing existing entries. It will be opened whenever you click New or Edit on the IP Whitelist.
List Entry
For Domain:
Use this drop-down list box to add an IP address to a specific domain's whitelist, or choose Global if you wish to add the IP address to the global list.
IP Address:
Enter the IP address here whose messages you wish to exempt from whatever security feature you have set to exempt "whitelisted senders" or "whitelisted IP addresses." CIDR notation is permitted, and you can use the wildcards: *, ?, and # to whitelist blocks of addresses with a single entry.
Comment:
Use this area for any comments or notes you wish to make about this entry, for your own reference.
Save and Close
When you are finished with the entry, click Save and Close to save the entry to the whitelist.
Close
Click this button if you wish to close the Whitelist Entry page without saving it.
