Első lépések

A Spam Scannerhez Node.js 18 vagy újabb szükséges, az önálló bináris fájlhoz pedig semmi.

Telepítés#

Parancssori eszközként:

npm install --global spamscanner
spamscanner version

Könyvtárként egy Node.js-projektben:

npm install spamscanner

Önálló bináris fájlként Linuxra vagy macOS-re, beépített Node.js-szel és modellel:

curl -fsSL https://github.com/spamscanner/spamscanner/releases/latest/download/install.sh | bash

A Linuxra (x64 és arm64), macOS-re (Intel és Apple silicon) és Windowsra készült bináris fájlok minden kiadáshoz csatolva vannak.

Levél vizsgálata#

Mentsen el egy levelet fájlként (a legtöbb levelezőprogramban ez a „Mentés másként” vagy az „Eredeti megjelenítése” menüpont), és vizsgálja meg:

spamscanner scan message.eml

SPAM  score 16.3 (spam at 5.0, reject at 15.0)  action: reject  language: en
     +6.3  BAYES_999                    Classifier spam probability 99.9%
     +5.0  PHISHING_LOOKALIKE_DOMAIN    "paypa1-secure.top" imitates paypal by swapping characters
     +3.0  DECEPTIVE_LINK               A link shows "https://www.paypal.com/signin" but goes to paypa1-secure.top
     +2.0  FROM_NAME_BRAND              Display name says "paypal" but the message is from paypa1-secure.top

A kilépési kód hamKért levél: a spam ellentéte. (kért levél) esetén 0, spam esetén 1, hiba esetén 2, így a szkriptek közvetlenül használhatják. A --json a teljes eredményt írja ki, a --headers pedig a levelet a hozzáadott X-Spam-* fejlécekkel.

A levelek a szabványos bemenetről is érkezhetnek:

cat message.eml | spamscanner scan -

Használat Node.js-ből#

import SpamScanner from 'spamscanner';
import {readFile} from 'node:fs/promises';

const scanner = new SpamScanner();
const result = await scanner.scan(await readFile('message.eml'));

console.log(result.isSpam, result.score, result.action);
for (const test of result.tests) {
  console.log(test.name, test.score, test.description);
}

CommonJS-szel is működik:

const SpamScanner = require('spamscanner');

A scan() a nyers levelet Bufferként, karakterláncként, Uint8Array-ként vagy olvasható streamként fogadja. A karakterlánc mindig a levél szövege: a Spam Scanner soha nem olvas be fájlt csak azért, mert egy karakterlánc elérési útnak tűnik. Fájlokhoz a scanner.scanFile(path) használható.

Az SMTP-munkamenet adatainak átadása#

A kliens IP-címe, ellenőrzött gépneve, a HELO név és a boríték pontosabbá teszi az eredményt: a hitelesítéshez szükség van az IP-címre, az önhamisítási szabályhoz pedig a címzettekre.

const result = await scanner.scan(raw, {
  session: {
    remoteAddress: '203.0.113.5',
    resolvedClientHostname: 'mail.example.com',
    helo: 'mail.example.com',
    envelope: {
      mailFrom: {address: 'alice@example.com'},
      rcptTo: [{address: 'bob@example.org'}],
    },
  },
});

Ugyanez a parancssorból:

spamscanner scan message.eml --ip 203.0.113.5 --helo mail.example.com \
  --from alice@example.com --to bob@example.org --auth

További ellenőrzések bekapcsolása#

Ezek közül egyik sincs alapértelmezetten bekapcsolva, mert mindegyikhez szolgáltatás vagy döntés kell:

A Cloudflare szűrő DNS-feloldóit (1.1.1.2 a kártevőkhöz, 1.1.1.3 a felnőtt tartalomhoz) alapértelmezetten megkérdezi a hivatkozások gépneveiről. Ez a phishing: {cloudflare: false} vagy a --no-cloudflare beállítással kapcsolható ki. Mi hagyja el a gépet

A Spamhaus és néhány más tiltólista nem válaszol a nyilvános DNS-feloldókon, például a 8.8.8.8-on vagy az 1.1.1.1-en keresztül küldött lekérdezésekre. Ezeket helyi, gyorsítótárazó DNS-feloldóval érdemes használni, és a forgalomnak megfelelően ellenőrizni kell a felhasználási feltételeiket.

Következő lépések#

• Levelezőszerver elé helyezés: Postfix és Sendmail, más szerverek.
• Tanítás a saját leveleken: tanítás.
• Nyelvi modell hozzáadása a kétes esetekhez: nyelvi modellek.