Más levelezőszerverek

A Spam Scanner négy protokollt ismer, így a legtöbb levelezőszoftver saját bővítmény nélkül is használhatja:

Protokoll	Parancs	Ki használja
Milter	`spamscanner milter`	Postfix, Sendmail, OpenSMTPD (filter-milterrel)
spamd	`spamscanner spamd`	spamc, Exim, Haraka és minden, amit SpamAssassinhoz írtak
HTTP	`spamscanner http`	Szkriptek, webhookok, egyedi MTA-k és szolgáltatások
Pipe	`spamscanner scan`, `spamscanner filter`	Postfix pipe-ok, procmail, maildrop, cron feladatok

A Postfix és a Sendmail külön oldalt kapott.

Közvetlen csere a SpamAssassin spamd-jére#

A spamscanner spamd a SpamAssassin spamd protokollján válaszol: CHECK, SYMBOLS, REPORT, REPORT_IFSPAM, PROCESS, HEADERS, PING és a --allow-tell kapcsolóval TELL. A SpamAssassinhoz írt szoftverek változatlanul működnek: le kell állítani a spamd szolgáltatást, és ugyanazon a porton el kell indítani a Spam Scannert.

Shell

sudo systemctl disable --now spamd    # or spamassassin, depending on the distribution
spamscanner spamd --port 783 --auth

A spamc-vel:

Shell

spamc -c < message.eml          # prints "16.3/5.0", exits 1 for spam
spamc -R < message.eml          # the report
spamc < message.eml > out.eml   # the message with X-Spam-* headers
spamc -L spam < message.eml     # learn (needs --allow-tell)

A tároló végpontok közötti tesztjei magát a SpamAssassin spamc-jét futtatják ellene.

Exim#

Az Exim spam ACL-feltétele a spamd-vel kommunikál. A fő konfigurációban:

Text

spamd_address = 127.0.0.1 783

A DATA ACL-ben (a Debian exim4 csomagjában acl_check_data):

Text

  warn    spam       = nobody:true
          add_header = X-Spam-Score: $spam_score
          add_header = X-Spam-Report: $spam_report

  # Refuse mail at the reject threshold: 15 points is 150 in $spam_score_int.
  defer   spam       = nobody:true
          condition  = ${if >={$spam_score_int}{150}}
          message    = Message rejected as spam ($spam_score points)

A defer ideiglenes 4xx hibával válaszol, így a feladók újra próbálkoznak, és a hiba javítható. Ha az eredmények megfelelőnek tűnnek, a végleges elutasításhoz cserélje deny-ra.

Haraka#

A Haraka spamassassin bővítménye a spamd-vel kommunikál. Kapcsolja be a config/plugins fájlban, és a config/spamassassin.ini fájlban állítsa be:

INI

spamd_socket=127.0.0.1:783
munge_subject_threshold=5
subject_prefix=[SPAM]
reject_threshold=15
old_headers_action=drop

Dovecot: Levélszemét mappa és tanulás#

Egy Sieve-szabály a megjelölt leveleket a Levélszemét mappába helyezi:

Text

require ["fileinto"];
if header :is "X-Spam-Flag" "YES" {
  fileinto "Junk";
  stop;
}

IMAPSieve-vel a levelek Levélszemét mappába vagy onnan kifelé mozgatása tanítja a modellt. Indítsa el a HTTP API-t egy tokennel és egy modellfájllal:

Shell

spamscanner http --port 7832 --token "$SPAMSCANNER_TOKEN" --out /var/lib/spamscanner/model.json

majd állítsa a miltert vagy a spamd szervert ugyanerre a modellre a --model /var/lib/spamscanner/model.json kapcsolóval (vagy a SPAMSCANNER_MODEL változóval). Időnként indítsa újra, hogy átvegye a tanultakat. A sieve_pipe által futtatott szkript elküldi a levelet:

Shell

#!/bin/sh
# /usr/local/lib/dovecot/report-spam.sh (report-ham.sh is the same with /learn/ham)
exec curl -fsS -X POST -H "Authorization: Bearer $SPAMSCANNER_TOKEN" \
  --data-binary @- http://127.0.0.1:7832/learn/spam

A Dovecot spamjelentési útmutatója bemutatja a beállítás többi részét, amely ugyanaz minden olyan spamszűrőnél, amely szkriptből tanul.

procmail és maildrop#

Text

# ~/.procmailrc
:0fw
| spamscanner scan - --headers

:0:
* ^X-Spam-Flag: YES
Junk/

maildrop:

Text

xfilter "spamscanner scan - --headers"
if (/^X-Spam-Flag: YES/)
{
  to "$HOME/Maildir/.Junk/"
}

A scan --headers spam esetén 1-es kóddal lép ki. A fenti szabályokkal a procmail és a maildrop a kimenetet használja, nem a kilépési kódot.

HTTP API#

Bármely program, amely HTTP-kérést tud küldeni, vizsgálhat leveleket:

Shell

spamscanner http --port 7832 --token "$SPAMSCANNER_TOKEN"

curl -s -X POST -H "Authorization: Bearer $SPAMSCANNER_TOKEN" \
  --data-binary @message.eml "http://127.0.0.1:7832/scan?ip=203.0.113.5&from=alice@example.com&to=bob@example.org"

A HTTP API oldal minden végpontot felsorol.

Node.js-levelezőszerveren belül#

Az smtp-server, a Haraka-bővítmények vagy bármely más Node.js-szerver közvetlenül hívhatja a könyvtárat:

JavaScript

import SpamScanner from 'spamscanner';

const scanner = new SpamScanner({authentication: true});

// smtp-server's onData handler
async function onData(stream, session, callback) {
  const result = await scanner.scan(stream, {
    session: {
      remoteAddress: session.remoteAddress,
      resolvedClientHostname: session.clientHostname,
      helo: session.hostNameAppearsAs,
      envelope: session.envelope,
    },
  });

  if (result.action === 'reject') {
    const error = new Error('Message rejected as spam');
    error.responseCode = 451;
    return callback(error);
  }

  // Deliver, with result.isSpam deciding the folder.
  callback();
}

Az smtp-server session.envelope objektuma már a Spam Scanner által olvasott mailFrom és rcptTo szerkezettel rendelkezik.