MX Guarddog provides the ability to upload CSV formatted blacklisting instructions, allowing a domain admin to manage their email and domain blacklist. In addition to adding to the blacklist there are a few additional actions that can be performed, this document will explain available commands and how to use them.

Adding To Your Blacklist

• Adding email addresses or domains can be done by uploading a list, with one entry per line. Adding to your blacklist is the default action so no additional command is required.
• Sample CSV format:

  ---

  [email protected]
  example.com
  *.example.com
  *.cn

  ---

• The above will add four new entries to your blacklist.
  • Block all email from email address [email protected]
  • Block all email coming from any email address at the domain example.com
  • Block all email coming from subdomain under example.com, such as mailing.example.com
  • Block all email coming from the China TLD. This would include any domain such as example.cn or example.gov.cn

Deleting From Your Blacklist

• If you already have items in your blacklist, you can remove them with the delete command.
• Sample CSV format:

  ---

  [email protected]
  example.com,delete
  *.example.com
  *.cn

  ---

• The above will add three new entries to your blacklist and delete example.com because the delete command has been included at the end of the domain name.

Marking A Domain To Be Vanished

• When you blacklist a domain name, you have the option to vanish any mail from the domain. A domain that has the vanish option will not appear in quarantine, it simply goes away never to be seen again.
• Sample CSV format:

  ---

  [email protected]
  example.com,vanish
  *.example.com
  *.cn

  ---

• The vanish command in the above CSV file will make all email coming from example.com vanish, it will not be saved to quarantine. The vanish option is available for domain names only, it does not apply to email addresses.

Removing The Vanish Option

• If you have a domain in your blacklist with the vanish option enabled, it is possible to remove the option with CSV as well.
• Sample CSV format:

  ---

  [email protected]
  example.com
  *.example.com
  *.cn

  ---

• We have previously blacklisted the domain example.com, with the vanish option. If we wanted to remove the vanish option but keep the domain blacklisted we can do that by including the domain in the CSV content but leaving out the vanish option.