PDMSC · live test service

See what PDMSC would say about your own mail.

A module for your rspamd sends each message to live.pdmsc.com in one secure request and gets back three opinions: the PDMSC cascade and the two INTENT classifiers. It starts in observe-only mode, scoring at zero, so nothing about how your mail is handled changes until you decide it should.

Please read before you try it. This is a live test service, for individuals and for evaluation and testing at low volume. It is not for production mail flow. To score a message the module sends the whole message, headers and body, off your system to live.pdmsc.com, which we operate. Only use it with mail that is allowed to leave your network and that you have the right to share. Nothing is stored, and our staff do not intercept or read it; if you would like that in writing, we are happy to sign a general-purpose NDA covering your test data (ask us). See the terms.

01What you get

PDMSC

The cascade

PDMSC_SPAM_0..5 and PDMSC_HAM_0..5: the staged classifier's verdict and how sure it is, or undecided when it cannot say.

INTENT/S1

Class of mail

PDMSC_S1_<CLASS>: fraud, spam, bulk, transactional, list, personal or system, with its confidence.

INTENT/S1/2

Side by side

PDMSC_S2_<CLASS>: a similar model on a second engine, so you can compare the two on your own traffic.

02Download

Version 1.0.0. Needs rspamd 3.x or newer. Check a download against its SHA-256 below, or with SHA256SUMS.

FileForSizeSHA-256
rspamd-pdmsc-live_1.0.0-1_all.debDebian, Ubuntu and derivatives21.6 KBae590840e5ca719b239a8afe458a92085bf51f34455f6661c65a91681815734a
rspamd-pdmsc-live-1.0.0-1.noarch.rpmRHEL, Rocky, Alma, Fedora, SUSE29.8 KB736757d681ec730de5822927b1df6fe22989838b88a0e7e5fcdaab22cb6005a5
rspamd-pdmsc-live-1.0.0.pkgFreeBSD (config in /usr/local/etc/rspamd)20.4 KB4c0adc6f04ead06ed2e5fb103b9fbcc6b5de4323d4911d1f78edbf42fbb214a8
rspamd-pdmsc-live-1.0.0.tar.gzAny other system (BSD, Solaris, Linux); also the RPM source22.1 KB033780cae716aa80f6fefd12fad78fdc8477ac2099131081ca9a308ceed77aff

Read first: TERMS.txt (the terms), README.txt (install and options) and LICENSING.txt (your key).

03Get a licence and an API key

The live service uses the same licence system as the PDMSC daemon: a message is scored for you only if your key belongs to an active licence. It takes about five minutes.

  1. Ask for access. Accounts are created by invitation. Email enquiries@misullivan.com and say you would like to try the live service. We create your company and a licence, and send you an invitation to confirm your email address and choose a password.
  2. Check your licence. Sign in at license.pdmsc.com. Under Licences your entry should say active.
  3. Create an API key. On your company page, under API keys, give the key a label, choose your active licence, and click Create API key. The key starts with pdl_ and is shown once, so copy it. Make one key per server so you can revoke them separately.
  4. Give it to rspamd with the setup tool below. The key is stored in a single file that only root and rspamd can read, never in rspamd's configuration.

04Install and configure

sudo apt install ./rspamd-pdmsc-live_1.0.0-1_all.deb                     # Debian / Ubuntu
sudo rpm -i rspamd-pdmsc-live-1.0.0-1.noarch.rpm       # RHEL / Rocky / Fedora / SUSE
sudo pkg add ./rspamd-pdmsc-live-1.0.0.pkg     # FreeBSD
sudo ./install.sh                                         # tarball: any other system
sudo pdmsc-live-setup --key pdl_YOUR_KEY --reload   # store the key, configure rspamd, reload it
sudo pdmsc-live-setup --test                        # check your key and licence in plain words

pdmsc-live-setup checks the configuration with rspamadm configtest and restores your previous files unchanged if rspamd rejects it. It only ever writes its own files and one clearly marked block, which pdmsc-live-setup --remove-config takes out again. Then look at some mail:

rspamc < some-message.eml | grep PDMSC
PDMSC_SPAM_3   (0.00) [english x0.30 LL0|-1.117 LL1|-1.170 (would +9)]
PDMSC_S1_FRAUD (0.00) [p=0.85 147ms (would +10)]
PDMSC_S2_FRAUD (0.00) [p=0.85 51ms (would +10)]

When you are happy with what you see, sudo pdmsc-live-setup --scored --reload switches on the production scores, and any individual score can be set in local.d/pdmsc_live_extra.inc. Each engine is its own rspamd external_services rule (or one standalone section, if you prefer), and the one reply is also available to your own Lua code.

05Terms, limits and privacy

Your mail leaves your system. The whole message (headers, body and attachments, up to 2 MiB) is sent to live.pdmsc.com over HTTPS, along with your rspamd's SPF/DKIM/DMARC result. It contains other people's personal data, and you are the one deciding to send it. Do not use the service for confidential, privileged, regulated or restricted mail, or mail you have no right to share.
Live test

Ask for a key.

Tell us a little about your mail setup and we will arrange a licence and an invitation.

enquiries@misullivan.com