Mail::SpamAssassin::Plugin::ASN(3pm)

1Mail::SpamAssassin::PluUgsienr::CAoSnNt(r3i)buted Perl DMoaciulm:e:nStpaatmiAosnsassin::Plugin::ASN(3)
2
3
4

NAME

6       Mail::SpamAssassin::Plugin::ASN - SpamAssassin plugin to look up the
7       Autonomous System Number (ASN) of the connecting IP address.
8

SYNOPSIS

10        loadplugin Mail::SpamAssassin::Plugin::ASN
11
12        asn_lookup asn.routeviews.org _ASN_ _ASNCIDR_
13
14        add_header all ASN _ASN_ _ASNCIDR_
15

DESCRIPTION

17       This plugin uses DNS lookups to the services of
18       "http://www.routeviews.org/" to do the actual work. Please make sure
19       that your use of the plugin does not overload their infrastructure -
20       this generally means that you should not use this plugin in a high-
21       volume environment or that you should use a local mirror of the zone
22       (see "ftp://ftp.routeviews.org/dnszones/").
23

TEMPLATE TAGS

25       This plugin allows you to create template tags containing the
26       connecting IP's AS number and route info for that AS number.
27
28       The default config will add a header that looks like this:
29
30        X-Spam-ASN: AS24940 213.239.192.0/18
31
32       where "AS24940" is the ASN and "213.239.192.0/18" is the route
33       announced by that ASN where the connecting IP address came from. If the
34       AS announces multiple networks (more/less specific), they will all be
35       added to the "_ASNCIDR_" tag, separated by spaces, eg:
36
37        X-Spam-ASN: AS1680 89.138.0.0/15 89.139.0.0/16
38

CONFIGURATION

40       The standard ruleset contains a configuration that will add a header
41       containing ASN data to scanned messages.  The bayes tokenizer will use
42       the added header for bayes calculations, and thus affect which BAYES_*
43       rule will trigger for a particular message.
44
45       Note that in most cases you should not score on the ASN data directly.
46       Bayes learning will probably trigger on the _ASNCIDR_ tag, but probably
47       not very well on the _ASN_ tag alone.
48

STATUS

56       No in-depth analysis of the usefulness of bayes tokenization of ASN
57       data has been performed.
58

ADMINISTRATOR SETTINGS

60       asn_lookup asn-zone.example.com [ _ASNTAG_ _ASNCIDRTAG_ ]
61           Use this to lookup the ASN info in the specified zone for the first
62           external IP address and add the AS number to the first specified
63           tag and routing info to the second specified tag.
64
65           If no tags are specified the AS number will be added to the _ASN_
66           tag and the routing info will be added to the _ASNCIDR_ tag.  You
67           must specify either none or both of the tags.  Tags must start and
68           end with an underscore.
69
70           If two or more asn_lookups use the same set of template tags, the
71           results of their lookups will be appended to each other in the
72           template tag values in no particular order.  Duplicate results will
73           be omitted when combining results.  In a similar fashion, you can
74           also use the same template tag for both the AS number tag and the
75           routing info tag.
76
77           Examples:
78
79             asn_lookup asn.routeviews.org
80
81             asn_lookup asn.routeviews.org _ASN_ _ASNCIDR_
82             asn_lookup myview.example.com _MYASN_ _MYASNCIDR_
83
84             asn_lookup asn.routeviews.org _COMBINEDASN_ _COMBINEDASNCIDR_
85             asn_lookup myview.example.com _COMBINEDASN_ _COMBINEDASNCIDR_
86
87             asn_lookup in1tag.example.net _ASNDATA_ _ASNDATA_
88
89
90
91perl v5.12.4                      2011-06-06Mail::SpamAssassin::Plugin::ASN(3)