Importing or exporting an allowed list

Prev Next

On the Allowed List page, you can import the rules that you defined on an allowed list to your appliance from a single ASCII text or CSV file.

The ASCII text or CSV file must start with the value of 1, which identifies an allowed list as the policy type.

Each rule type is identified by a value from 0 to 5, and the rule information must not contain spaces.

The rule information follows the rule type.

Enter rules in the following CSV file format:

Policy_Type,Rule_Type,Rule_Information,Rule_Type,Rule_Information,Rule_Type,Rule_Information,Rule_Type,Rule_Information
,Rule_Type,Rule_Information,Rule_Type,Rule_Information,Rule_Type,Rule_Information

Rule types are described in the following table.

Value

Rule type

Rule information

0

Sender Email Address

The email address of the sender.

1

Sender Domain

The domain of the sender.

2

Sender IP Address

The IP address of the sender.

3

Recipient Email Address

The email address of the recipient.

4

URL

The URL.

5

MD5sum

The MD5 checksum of the attachment.

Note

When you import the URL rule on an allowed list from a CSV file, you must use a backslash (\) to escape a comma (,) in the URL rule. For example, if the URL is https://www.google.com.pk/?gws_rd=cr,ssl&ei=08hBVaHUBMr9aIbugKgp you would enter https://www.google.com.pk/?gws_rd=cr\,ssl&ei=08hBVaHUBMr9aIbugKgp in the URL rule.

The following text is an example of a valid allowed_list.txt file:

1,0,abc@benign\.com,1,somedomain\.net,2,11\.22\.33\.44,3,somebody@fireeye\.com,4,http://www.benignsite.com,5,85303dc14afd9e0030dafed14aa41ba9

You can export a copy of the allowed list from the appliance. When you import or export an allowed list, all previous rules that you defined for an allowed list will be overwritten by the new rules.

Note

You can import or export an allowed list file only using the Web UI. You are permitted to enter any characters using the Web UI; no error checking occurs. However, unsupported characters that are entered will result in an invalid data rule error.

Prerequisites

  • Create an ASCII text or CSV file that contains the rules on an allowed list. The file must be accessible from your local machine from which you access the Web UI.

  • Administrator or Operator access to the Email Security - Server appliance

  • Perform export and import of allowed lists only between the EX 3400, EX 5400, EX 8400, EX 8420 appliances and the EX 3500, EX 5500, EX 8500 appliances. Import into the EX 3300, EX 5300, and EX 8300 appliances is not supported.