Use the IP Allowlist 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 allowlisted IPs, or to exempt messages being delivered by those IPs. You can add IP addresses to this allowlist 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 Allowlist also has an export feature, which allows you to save the contents of the allowlist to a CSV file.
Adding IPs to the Allowlist
To add an IP address to the IP Allowlist, click New on the toolbar at the top of the page. This will open the Allowlist Entry page for adding the IP address (see below).
Editing an Allowlisted IP Address
To edit one of the allowlisted 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 Allowlist Entry page.
Deletin an Allowlisted IP Address
To delete one or more of the allowlisted 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 Allowlist
To import a list of IPs to the IP 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 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 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 IP addresses to the Global Allowlist:
The Value column is for the IP address that you wish to allowlist (CIDR notation and *, ?, and # wildcards are all supported), the Type column should say, "AllowListIPGlobal", 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","AllowListIPGlobal","This is a comment about the address."
"1.1.1.1","AllowListIPGlobal",""
"192.168.*.*","AllowListIPGlobal","This is another comment."
Importing IP addresses to a specific domain's IP Allowlist:
The Domain column is for the domain to which this allowlist belongs. For example, if you are wanting to add IP addresses to example.com's IP Allowlist, then use "example.com" in the Domain column. The Value column is for the IP address that you wish to allowlist (CIDR notation and *, ?, and # wildcards are all supported), the Type column should say, "AllowListIPDomain", 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","AllowListIPDomain","This is a comment about the address."
"example.com","1.1.1.1","AllowListIPDomain",""
"example.com","192.168.*.*","AllowListIPDomain","This is another comment."
Exporting IP Addresses from the Allowlist
To export an IP 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 IP addresses to the allowlist and for editing existing entries. It will be opened whenever you click New or Edit on the IP Allowlist.
List Entry
For Domain:
Use this drop-down list box to add an IP address to a specific domain's allowlist, 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 "allowlisted senders" or "allowlisted IP addresses." CIDR notation is permitted, and you can use the wildcards: *, ?, and # to allowlist 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 allowlist.
Close
Click this button if you wish to close the Allowlist Entry page without saving it.
