The Addresses Whitelist is list of sender email addresses whose messages you wish to exempt from a number of security restrictions. Heuristics and Bayesian, DNSBL, and many other Security features in SecurityGateway have the option to exempt messages based on the sender's email address. You can add addresses to this whitelist both globally and for specific domains, and even though addresses 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 addresses at once. Finally, the Addresses Whitelist also has an export feature, which allows you to save the contents of the whitelist to a CSV file.
Adding Addresses to the Whitelist
To add an address to the Addresses Whitelist, click New on the toolbar at the top of the page. This will open the Whitelist Entry page for adding the address (see below).
Editing a Whitelisted Address
To edit one of the whitelisted addresses, 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 Whitelisted Addresses
To delete one or more of the whitelisted 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 Addresses to the Whitelist
To import a list of addresses to the Addresses 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 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 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 addresses to the Global Whitelist:
The Value column is for the email addresses you wish to whitelist, the Type column should say, "WhiteListAddressGlobal", 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"
"address01@example.net","WhiteListAddressGlobal","This is a comment about the address."
"address01@example.org","WhiteListAddressGlobal",""
"address02@example.net","WhiteListAddressGlobal","This is another comment."
Importing addresses to a specific domain's Addresses Whitelist:
The Domain column is for the domain to which this whitelist belongs. For example, if you are wanting to add addresses to example.com's whitelist, then use "example.com" in the Domain column. The Value column is for the email addresses you wish to whitelist, the Type column should say, "WhiteListAddressDomain", 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","address01@example.net","WhiteListAddressDomain","This is a comment about the address."
"example.com","address01@example.org","WhiteListAddressDomain",""
"example.com","address02@example.net","WhiteListAddressDomain","This is another comment."
Exporting Addresses from the Whitelist
To export an Addresses 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 addresses to the whitelist and for editing existing entries. It will be opened whenever you click New or Edit on the Addresses Whitelist.
List Entry
For Domain:
Use this drop-down list box to add an address to a specific domain's whitelist, or choose Global if you wish to add the address to the global list.
Email Address:
Enter the email address here whose messages you wish to exempt from whatever security feature you have set to exempt "whitelisted senders." You can use an asterisk in the mailbox portion of the address to whitelist all addresses at that domain. For example, "*@example.org" would whitelist all messages from anyone at example.org.
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.
