Uploading a allowlist or blocklist

If you have permission to modify configurations, you can populate a allowlist or blocklist in a policy or exception by uploading an address list in a comma-separated value (CSV) file.

The header of the file must be this string exactly, “Address, Description” and every line must contain the following 2 fields separated by a comma:

  • An email address or domain name (wildcards permitted), or an IP address (wildcard not permitted).
  • A description (free text, up to 255 characters).

The fields can be quoted or not. If a field contains a comma, it must be quoted. If 1 field is quoted, the rest of the line must be quoted. If a field contains a quotation mark, this character must be surrounded by additional quotation marks. If a line contains only 1 field, it is interpreted as the email address and the description is omitted. If a line contains more than 2 fields, the file is rejected and an error message is displayed.

For example:

Address, Description

“address1@domain1.com”, “Description of address1, containing comma”

address1@domain1.com, Description of address1 without comma

“address1@domain1.com”, “Description of address1, containing ““quotes””

“domain2.com”, “Description of domain2”

To upload the file:

Steps

  1. Click the link, Upload addresses from a CSV file.
  2. Browse to the name of the file to upload.
  3. Select an action:
    Action Description
    Append to current list

    Elements imported from the file are added to the existing elements. The resulting list is a union of all elements.

    If any of the entries in the file is already included in the list, it is not added again and a warning message is displayed. This does not stop the processing of the file.
    Replace current list Elements already existing in the list are deleted and replaced by the elements in the file. You are asked to confirm this action.
  4. Click Upload. Note that large files take a while to transfer to the server. If the file is empty, too large, or cannot be opened, an error results. An error also results if any of the elements are invalid.
    You can also download the current addresses into a CSV file for viewing in a spreadsheet, or you can delete entries from the allowlist or blocklist by checking the box next to the address and clicking Delete.