1PERL-NOCEM(8) InterNetNews Documentation PERL-NOCEM(8)
2
3
4
6 perl-nocem - A NoCeM-on-spool implementation for INN 2.x
7
9 perl-nocem
10
12 NoCeM, which is pronounced No See 'Em, is a protocol enabling
13 authenticated third-parties to issue notices which can be used to
14 cancel unwanted articles (like spam and articles in moderated
15 newsgroups which were not approved by their moderators). It can also
16 be used by readers as a third-party killfile. It is intended to
17 eventually replace the protocol for third-party cancel messages.
18
19 perl-nocem processes third-party, PGP-signed article cancellation
20 notices. It is possible not to honour all NoCeM notices but only those
21 which are sent by people whom you trust (that is to say if you trust
22 the PGP key they use to sign their NoCeM notices). Indeed, it is up to
23 you to decide whether you wish to honour their notices, depending on
24 the criteria they use.
25
26 Processing NoCeM notices is easy to set up:
27
28 1. Import the keys of the NoCeM issuers you trust in order to check
29 the authenticity of their notices. You can do:
30
31 gpg1 --no-default-keyring --primary-keyring <pathetc>/pgp/ncmring.gpg \
32 --no-options --allow-non-selfsigned-uid --no-permission-warning \
33 --batch --import <key-file>
34 chmod 644 <pathetc>/pgp/ncmring.gpg
35
36 where <pathetc> is the value of the pathetc parameter set in
37 inn.conf and <key-file> the file containing the key(s) to import.
38 The keyring must be located in <pathetc>/pgp/ncmring.gpg; you only
39 have to create the directory <pathetc>/pgp before using gpg (it
40 will automatically generate the ncmring.gpg file) and make sure the
41 news user can read this file, once generated.
42
43 As a few NoCeM issuers are still using old PGP-generated keys, you
44 may have to use gpg1 with various legacy options in command-line
45 (like in the example above) instead of more recent versions of gpg
46 that no longer accept such keys.
47
48 The keys of NoCeM issuers can be found in the web site of The NoCeM
49 Registry: <http://rosalind.home.xs4all.nl/nocemreg/nocemreg.html>.
50 You can even download there a unique file which contains all the
51 keys.
52
53 2. Create a nocem.ctl config file in pathetc indicating the NoCeM
54 issuers and notices you want to follow. This permission file
55 contains lines like:
56
57 bleachbot@httrack.com:spam,site
58 pgpmoose@killfile.org:pgpmoose-forged-moderation
59
60 This will remove all articles for which the issuer (first part of
61 the line, before the colon ":") has issued NoCeM notices
62 corresponding to the criteria specified after the colon.
63
64 You will also find information about that on the web site of The
65 NoCeM Registry.
66
67 3. Add to the newsfeeds file an entry like this one in order to feed
68 perl-nocem the NoCeM notices posted to alt.nocem.misc and
69 news.lists.filters:
70
71 nocem!\
72 :!*,alt.nocem.misc,news.lists.filters\
73 :Tc,Wf,Ap:<pathbin>/perl-nocem
74
75 with the correct path to perl-nocem, located in <pathbin>. Then,
76 reload the newsfeeds file ("ctlinnd reload newsfeeds 'NoCeM channel
77 feed'").
78
79 Note that you should at least carry news.lists.filters on your news
80 server (or other newsgroups where NoCeM notices are sent) if you
81 wish to process them.
82
83 4. Everything should now work. However, do not hesitate to manually
84 test perl-nocem with a NoCeM notice, using:
85
86 grephistory '<Message-ID>' | perl-nocem
87
88 Indeed, perl-nocem expects tokens on its standard input, and
89 grephistory can easily give it the token of a known article, thanks
90 to its Message-ID.
91
92 When you have verified that everything works, you can eventually turn
93 off regular spam cancels, if you want, not processing any longer
94 cancels containing "cyberspam" in the Path: header (see the
95 refusecybercancels parameter in inn.conf).
96
98 pathbin/perl-nocem
99 The Perl script itself used to process NoCeM notices.
100
101 pathetc/nocem.ctl
102 The configuration file which specifies the NoCeM notices to be
103 processed.
104
105 pathetc/pgp/ncmring.gpg
106 The keyring which contains the public keys of trusted NoCeM
107 issuers.
108
110 The Subject: header is not checked for the @@NCM string and there is no
111 check for the presence of the References: header.
112
113 The Newsgroups: pseudo header is not checked, but this can be done in
114 local_want_cancel_id().
115
116 The Hierarchies: header is ignored.
117
119 Copyright 2000 by Miquel van Smoorenburg <miquels@cistron.nl>.
120
121 Copyright 2001 by Marco d'Itri <md@linux.it>.
122
123 $Id: perl-nocem.in 10399 2020-11-12 20:24:35Z iulius $
124
126 gpg(1), gpgv(1), grephistory(1), inn.conf(5), newsfeeds(5), pgp(1).
127
128
129
130INN 2.6.4 2020-11-22 PERL-NOCEM(8)