FILTER-SENDERSCORE(8)

💖 FILTER-SENDERSCORE 💖

okay bestie, so this is the filter-senderscore page from section 8 of the manual (system manager's stuff, admin girlie territory) and honestly? it's giving gatekeeper energy in the best way. it's a SenderScore filter for OpenSMTPD and we're gonna get you fluent in it, no cap. 🎀

---

✨ NAME ✨

filter-senderscore — SenderScore filter for OpenSMTPD 💅

---

🦋 SYNOPSIS 🦋

filter-senderscore [-blockBelow score] [-blockPhase phase]
                   [-junkBelow score] [-slowFactor factor]
                   [-scoreHeader]

like, that's the whole vibe. five little flags. slay. ✨

---

🌸 DESCRIPTION 🌸

so the filter-senderscore filter is for the OpenSMTPD server — that's smtpd(8) if you wanna be formal about it — and what it does is filter sessions based on their SenderScores reputation score. reputation check but make it a filter. iconic.

its options are, and I'm listing every single one because we do not skip: 👑

• -blockBelow score — shows an error banner for sessions whose reputation score is below score, and then disconnects. bye bestie 💀
• -blockPhase phase — decides at which phase -blockBelow gets triggered. the default is connect. valid choices are connect, helo, ehlo, starttls, auth, mail-from, rcpt-to, and quit. heads up though: quit will result in a message at the end of a session and may only be used to warn the sender that its reputation is degrading, because it will not prevent transactions from succeeding. it's a vibe check, not a bouncer. 🫶
• -junkBelow score — prepends a ‘X-Spam: yes’ header to messages for sessions with a reputation score below score. marking the mail as sus, respectfully. 🙈
• -slowFactor factor — delays all answers by this many milliseconds, where ‘score’ is the reputation score:

factor − ((factor ÷ 100) ∗ score)

so the lower your score, the longer you wait. it's the "we're not mad, we're just disappointed" of rate limiting. 😭

• -scoreHeader — adds an ‘X-SenderScore’ header with the sender's reputation score, if known. receipts, basically. ⭐

---

💀 EXIT STATUS 💀

the filter-senderscore utility exits 0 on success, and >0 if an error occurs. zero means we ate, anything above zero means something went wrong. periodt.

---

🌈 EXAMPLES 🌈

adding the following to smtpd.conf enables filter-senderscore for all incoming connections. all of them. no exceptions. 💅

filter "senderscore" proc-exec \
       "/usr/local/bin/filter-senderscore -blockBelow 50 \
                                          -junkBelow  80 \
                                          -slowFactor 1000"

listen on all filter "senderscore"

---

👑 SEE ALSO 👑

• smtpd.conf(5)

---

🎀 AUTHORS 🎀

filter-senderscore is Copyright © 2019 Gilles Chehade <gilles@poolp.org>. this man page is Copyright © 2020 Ryan Kavanagh <rak@debian.org>. both are distributed under the ISC license. give them their flowers, they earned them. 🌸

---

🧚 BUGS 🧚

None known. not a single one. flawless behavior, main character energy, zero notes. ✨

---

k so that's the whole page bestie — every flag, every phase, every header, every formula, all of it. you're basically a SenderScore sommelier now. go forth and filter. 🦋

that's the Debian build, dated April 12, 2020, and the page lives at FILTER-SENDERSCORE(8) — mwah, take care of her 💖