Usage.

How to use DKIMwl.org

Below you will find information on the DKIMwl.org return codes as well as information on using the lists in your spam filter of choice.

As long as you abide by the TOU as laid out you are free to use the DKIMwl.org to filter your mail how you like, but we have the following recommendations:

  • Check the zone for the signing domain of DKIM signed emails only where signature verification has passed
  • Skip spam scoring for all listed domains where the Trust Level is High

How to query DKIMwl.org

Queries to DKIMwl.org go towards the zone lookup.dkimwl.org. The zone is primarily for querying domain names and a query should take the following format:

example.com.lookup.dkimwl.org

The zone contains the example.com domain for test lookups - an example lookup would look like the following:

shoop~$ host gmail.com.lookup.dkimwl.org
gmail.com.lookup.dkimwl.org has address 127.0.3.3

Trust Levels

  • Low
    • Occasional spam issue
    • Problems dealt with less promptly
  • Med
    • Occasional spam issue
    • Problems dealt with promptly
    • User opt in email
    • User opt out email
  • High
    • Rare spam issue
    • Problems dealt with promptly / proactively
    • 100% user opt in email
    • 100% user opt out
    • Mail from domains that should get to the inbox

Return Codes

Responses to queries are structured as 127.0.Y.Z - Y indicating the category and Z indicating the Trust Level:

Categories - Y

  2 - Bulkmailer
  3 - Freemail Provider
  4 - Service/Network Providers
  5 - Personal/Private Servers
  6 - Media & Technology Companies
  7 - Organisations
  8 - Public Sector & Governments
  9 - Travel & Leisure Industry
  10 - Financial services
  11 - Education & Academic
  12 - Manufacturing & Industrial
  13 - Retail/Wholesale/Services
  14 - Healthcare Services
  15 - News Outlet
  16 - Mailing Lists
  17 - Dating
  18 - Money Saving
  19 - Jobs & Careers
  20 - Social
  21 - Real Estate
  22 - Marketing
  23 - Tickets
  24 - Gambling
  25 - Food & Restaurants
  26 - Business
  27 - Faith & Religion
  28 - Stocks & Shares
  128 - Special / Other Service

Trust Level - Z

  0 - Blacklisted
  1 - Low
  2 - Low-Med
  3 - Med
  4 - Med-High
  5 - High

Spamassassin Examples

Because of the response codes spamassassin rules can be quite specific for different applications

These are just examples! Full rules should be built to desire by adjusting regexes.

Simple Whitelisting

# Whitelist all high trust domains
askdns     DKIMWL_WL _DKIMDOMAIN_.lookup.dkimwl.org A /^127\.\d+\.\d+\.5$/
tflags     DKIMWL_WL nice net
describe   DKIMWL_WL DKIMwl.org - Whitelisted sender
# You can adjust the score if you like
score      DKIMWL_WL -7.5

# OPTIONAL

#ifplugin Mail::SpamAssassin::Plugin::Shortcircuit
#  shortcircuit DKIMWL_WL ham
#endif # Mail::SpamAssassin::Plugin::Shortcircuit

Category Scoring

# Whitelist all high trust financial domains
askdns     DKIMWL_FINANCIAL_WL _DKIMDOMAIN_.lookup.dkimwl.org A /^127\.\d+\.10\.5$/
tflags     DKIMWL_FINANCIAL_WL nice net
describe   DKIMWL_FINANCIAL_WL DKIMwl.org - Known financial sender
score      DKIMWL_FINANCIAL_WL -1.0

# Add scoring to any low scoring bulkmailer
askdns     DKIMWL_BULKMAILER_LOW _DKIMDOMAIN_.lookup.dkimwl.org A /^127\.\d+\.2\.[0-2]$/
tflags     DKIMWL_BULKMAILER_LOW net
describe   DKIMWL_BULKMAILER_LOW DKIMwl.org - Low scoring bulkmailer
score      DKIMWL_BULKMAILER_LOW 1.0

Meta-rules

# This is from a freemailer, like Gmail
askdns     __DKIMWL_FREEMAILER _DKIMDOMAIN_.lookup.dkimwl.org A /^127\.0\.3\.\d+$/

# This is from gmail
askdns     __DKIMWL_FREEMAILER_GMAIL _DKIMDOMAIN_.lookup.dkimwl.org TXT /^gmail\.com$/

About

DKIMwl.org is a free to use whitelist for email classification. It is especially useful when combined with DKIM verified emails.

Links

Boring Stuff

We have some restrictions on the usage of our data. You can read all about it here.

Terms | © 2016 - 2018 DKIMwl.org