Use the Host Whitelist to exempt specific hosts (e.g. "mail.example.com") from a number of security restrictions. Heuristics and Bayesian, DNSBL, and many other Security features in SecurityGateway have the option to exempt whitelisted hosts, or to exempt messages being delivered by those hosts. You can add hosts to this whitelist both globally and for specific domains, and even though hosts 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 hosts at once. Finally, the Host Whitelist also has an export feature, which allows you to save the contents of the whitelist to a CSV file.
Adding Hosts to the Whitelist
To add a host to the Host Whitelist, click New on the toolbar at the top of the page. This will open the Whitelist Entry page for adding the host (see below).
Editing a Whitelisted Host
To edit one of the whitelisted hosts, 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 Host
To delete one or more of the whitelisted hosts, 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 Hosts to the Whitelist
To import a list of hosts to the Host 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 hosts 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 hosts 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 hosts to the Global Whitelist:
The Value column is for the host that you wish to whitelist (e.g. mail.example.com, domain.com, and the like), the Type column should say, "WhiteListHostGlobal", 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"
"example.net","WhiteListHostGlobal","This is a comment about the address."
"mail.domain.com","WhiteListHostGlobal",""
"smtp.company.mail","WhiteListHostGlobal","This is another comment."
Importing hosts to a specific domain's Host Whitelist:
The Domain column is for the domain to which this whitelist belongs. For example, if you are wanting to add hosts to example.com's Host Whitelist, then use "example.com" in the Domain column. The Value column is for the host that you wish to whitelist (e.g. mail.example.com, domain.com, and the like), the Type column should say, "WhiteListHostDomain", 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","example.net","WhiteListHostDomain","This is a comment about the address."
"example.com","mail.domain.com","WhiteListHostDomain",""
"example.com","smtp.company.mail","WhiteListHostDomain","This is another comment."
Exporting Hosts from the Whitelist
To export a Host 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 hosts to the whitelist and for editing existing entries. It will be opened whenever you click New or Edit on the Host Whitelist.
List Entry
For Domain:
Use this drop-down list box to add a host to a specific domain's whitelist, or choose Global if you wish to add the host to the global list.
Host:
Enter the host here whose messages you wish to exempt from whatever security feature you have set to exempt "whitelisted senders" or "whitelisted hosts." You can use an asterisk in the host name if you wish to whitelist all hosts of a particular domain. For example, "*.example.org" would whitelist all messages coming from any sub-domain of example.org, such as mail.example.org, smtp.example.org, and so on.
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.
