Use the Host Allowlist 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 allowlisted hosts, or to exempt messages being delivered by those hosts. You can add hosts to this allowlist 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 Allowlist also has an export feature, which allows you to save the contents of the allowlist to a CSV file.
Adding Hosts to the Allowlist
To add a host to the Host Allowlist, click New on the toolbar at the top of the page. This will open the Allowlist Entry page for adding the host (see below).
Editing an Allowlisted Host
To edit one of the allowlisted 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 Allowlist Entry page.
Deleting an Allowlisted Host
To delete one or more of the allowlisted 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 Allowlist
To import a list of hosts to the Host Allowlist, 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 allowlists. 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 Allowlist:
The Value column is for the host that you wish to allowlist (e.g. mail.example.com, domain.com, and the like), the Type column should say, "AllowListHostGlobal", 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","AllowListHostGlobal","This is a comment about the address."
"mail.domain.com","AllowListHostGlobal",""
"smtp.company.mail","AllowListHostGlobal","This is another comment."
Importing hosts to a specific domain's Host Allowlist:
The Domain column is for the domain to which this allowlist belongs. For example, if you are wanting to add hosts to example.com's Host Allowlist, then use "example.com" in the Domain column. The Value column is for the host that you wish to allowlist (e.g. mail.example.com, domain.com, and the like), the Type column should say, "AllowListHostDomain", 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","AllowListHostDomain","This is a comment about the address."
"example.com","mail.domain.com","AllowListHostDomain",""
"example.com","smtp.company.mail","AllowListHostDomain","This is another comment."
Exporting Hosts from the Allowlist
To export a Host Allowlist:
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.
Allowlist Entry
This page is used for adding new hosts to the allowlist and for editing existing entries. It will be opened whenever you click New or Edit on the Host Allowlist.
List Entry
For Domain:
Use this drop-down list box to add a host to a specific domain's allowlist, 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 "allowlisted senders" or "allowlisted hosts." You can use an asterisk in the host name if you wish to allowlist all hosts of a particular domain. For example, "*.example.org" would allowlist 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 allowlist.
Close
Click this button if you wish to close the Allowlist Entry page without saving it.
