Een mail voor elke SSH-login: een tripwire van twee minuten met wtmp en systemd

Een mail voor elke interactieve SSH-login binnen twee minuten: een systemd-timer die wtmp leest, stil bij backups en Ansible, en wat hij niet kan zien.

Illustratie bij het artikel over een mail voor elke SSH-login

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Dit is een vervolg op de lange post van gisteren, Defence in Depth: negen lagen tussen het internet en mijn servers. Daar kreeg het login-alarm één zin. Hier lees je hoe het werkt, waarom het zo gebouwd is – en wat een aanvaller leert als hij dit leest.

Het idee is oud en simpel: als iemand inlogt op een van mijn servers, wil ik dat weten – binnen minuten, niet pas als ik toevallig een week later in een log kijk. Elke login stuurt me een mail. Omdat ik weet wanneer ik zelf ingelogd heb, is elke mail die ik niet verwachtte meteen het bekijken waard. Het is een tripwire: het houdt niemand tegen, het zorgt ervoor dat een inbraak niet onopgemerkt blijft.

Er waren drie eisen. Het mag nooit een login in de weg zitten – een beveiligingsfunctie die mij buitensluit van mijn eigen server is erger dan geen. Het moet stil blijven bij alles wat geautomatiseerd is, anders leert het me om het te negeren. En het moet op alle drie de servers hetzelfde werken, uitgerold door Ansible zoals al het andere.

Inhoud

🔍 Waar de logins vandaan komen: wtmp

Linux legt elke loginsessie die een terminal krijgt vast in /var/log/wtmp. Het commando last leest dat, en met ISO-tijdstempels is het makkelijk te parsen:

$ last -w -i --time-format iso | head -3
root     pts/0        203.0.113.25   2026-10-14T05:56:45+00:00 - 2026-10-14T05:56:46+00:00  (00:00)
root     pts/0        203.0.113.25   2026-10-13T14:27:37+00:00 - 2026-10-13T16:23:34+00:00  (01:55)
root     pts/0        203.0.113.25   2026-10-13T07:53:55+00:00 - 2026-10-13T07:53:55+00:00  (00:00)

Het belangrijke detail is wat er niet in staat: sessies zonder terminal. Als mijn backupmachine ’s nachts de backups ophaalt, voert hij een commando uit via SSH, krijgt geen terminal en laat geen wtmp-regel achter. Dat is precies het filter dat ik wil – interactieve shells worden gemeld, gewone geautomatiseerde commando’s niet.

🧩 Het script

Elke twee minuten leest een klein script last, vergelijkt dat met de nieuwste login die het al gemeld heeft, en stuurt één mail voor alles wat nieuw is in dat venster – meerdere logins worden één mail, niet vijf. De state is één enkele tijdstempel in /var/lib/ssh-login-alert/last-seen. Bij de allereerste run op een host slaat het alleen de huidige positie op, zodat het me niet in één keer de hele geschiedenis mailt. En de state schuift pas op nadat de mail verstuurd is: als het versturen mislukt, probeert de volgende run het opnieuw.

#!/bin/bash
#
# Tripwire: mails every new interactive login since the previous run. Started
# every 2 minutes by ssh-login-alert.timer; all new logins of one window go
# out as ONE mail.
#
# Source is wtmp (read with "last"): only sessions that got a terminal are
# recorded there. The nightly backup pulls run plain commands without a
# terminal and never appear. Ansible requests a terminal for some steps, so a
# playbook run does show up (as short sessions) - you know when that was you.
set -u

MAILTO="you@example.com"
STATE_DIR=/var/lib/ssh-login-alert
STATE="$STATE_DIR/last-seen"
mkdir -p "$STATE_DIR"

# One line per login: start-time (ISO 8601 with the host's UTC offset) TAB
# user TAB tty TAB source IP. Sorted by time; the offset is the same for all
# entries of one host, so string comparison of the first field works.
logins=$(last -w -i --time-format iso 2>/dev/null \
    | awk '$1 != "reboot" && $1 != "wtmp" && NF >= 4 { print $4 "\t" $1 "\t" $2 "\t" $3 }' \
    | sort)

newest=$(printf '%s\n' "$logins" | tail -n 1 | cut -f 1)

# First run on this host: only remember the current position, so the alert
# does not mail the whole history at once.
if [ ! -s "$STATE" ]; then
    printf '%s\n' "${newest:-1970-01-01T00:00:00+00:00}" > "$STATE"
    exit 0
fi

seen=$(cat "$STATE")
new=$(printf '%s\n' "$logins" | awk -F '\t' -v seen="$seen" '$1 > seen')
[ -n "$new" ] || exit 0

count=$(printf '%s\n' "$new" | wc -l)
{
    echo "New interactive login(s) on $(hostname -f):"
    echo
    printf '%s\n' "$new" | awk -F '\t' '{ printf "  %s  %-8s %-7s from %s\n", $1, $2, $3, $4 }'
    echo
    echo "Times carry the host's UTC offset. If none of these were you, check: last -i | head"
} | /usr/bin/mail -s "[$(hostname -f)] SSH login: $count new" "$MAILTO" || exit 1

# Only after the mail went out: a failed send is retried on the next run.
printf '%s\n' "$newest" > "$STATE"

De mail gaat via dezelfde kleine SMTP-relay (msmtp) die de andere rapporten van de servers al verstuurt. Hij ziet er zo uit:

Subject: [www.example.org] SSH login: 1 new

New interactive login(s) on www.example.org:

  2026-10-14T08:01:02+00:00  root     pts/1   from 203.0.113.25

Times carry the host's UTC offset. If none of these were you, check: last -i | head

⏱️ Een timer, geen PAM-hook

De voor de hand liggende manier om op een login te reageren is een PAM-module: pam_exec in de SSH-PAM-stack draait bij elke sessie een script. Daar heb ik om twee redenen van afgezien.

  • Risico op buitensluiten. PAM ís de login. Een typfout of een hangend script in de SSH-PAM-stack kan de server elke login laten weigeren – precies de situatie waarin ik dan de console van de hostingprovider nodig heb.
  • SELinux. Een script dat door PAM gestart wordt, draait in de securitycontext van sshd. Van daaruit mail versturen betekent netwerkverbindingen vanuit een domein dat SELinux dat terecht niet toestaat.

Een systemd-timer heeft geen van beide problemen. Hij draait volledig los van sshd, in zijn eigen unit, en het ergste wat een bug kan doen is geen mail versturen. De prijs is een vertraging van maximaal twee minuten – acceptabel voor een tripwire.

# /etc/systemd/system/ssh-login-alert.service
[Unit]
Description=Mail new interactive SSH logins

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/ssh-login-alert

# /etc/systemd/system/ssh-login-alert.timer
[Unit]
Description=Check for new interactive SSH logins every 2 minutes

[Timer]
OnBootSec=2min
OnUnitActiveSec=2min

[Install]
WantedBy=timers.target

🤖 Ansible stil houden

De eerste test bracht een verrassing: elke Ansible-run verscheen in wtmp als een paar korte sessies. De SSH-plugin van Ansible vraagt standaard voor sommige stappen een terminal aan. Geen van mijn playbooks heeft er een nodig – pipelining staat aan en niets vraagt ooit om een wachtwoord –, dus één regel in ansible.cfg zet het uit:

[ssh_connection]
pipelining = True
# No terminal for Ansible's own connections - nothing here needs one, and
# without it a playbook run leaves no entry in wtmp.
usetty     = False

Daarna liet een volledige playbook-run geen spoor meer na in wtmp, en het alarm gaat alleen nog af bij echte interactieve sessies. In Ansible zelf is het geheel drie kleine tasks – script uit een template, twee unit-bestanden, timer inschakelen:

- name: SSH | Deploy the login alert script
  ansible.builtin.template:
    src: ssh-login-alert.sh.j2
    dest: /usr/local/sbin/ssh-login-alert
    owner: root
    group: root
    mode: "0750"

- name: SSH | Enable the login alert timer
  ansible.builtin.systemd:
    name: ssh-login-alert.timer
    enabled: true
    state: started
    daemon_reload: "{{ _ssh_alert_units.changed }}"
  # in --check the units were not written yet on a fresh host
  when: not (ansible_check_mode and _ssh_alert_units.changed)

🕵️ Helpt dit een aanvaller?

Deze post beschrijft precies wat het alarm laat afgaan en wat niet. Dus de eerlijke vraag: geeft hij een aanvaller een recept om onzichtbaar te blijven?

Deels wel – en dat is prima. Wie met een gestolen sleutel dit leest, weet dat ssh host 'command' zonder terminal geen mail oplevert. Maar dat is geen geheim gat, zo werkt wtmp nu eenmaal, en iedereen die Linux kent weet dat. Belangrijker: het alarm is één laag van meerdere. Om binnen te komen is eerst een geldige sleutel nodig – wachtwoorden staan uit, SSH luistert alleen naar de adresbereiken van één land, en mislukte pogingen worden geband. En wat iemand binnen zonder terminal doet, moet nog langs de andere tripwires: wijzigingen aan gebruikersaccounts, sudo, de SSH-configuratie, kernelmodules of de secrets van het cluster worden op andere manieren vastgelegd en gemeld, en gewijzigde systeembestanden worden de volgende nacht gevonden.

Wie root krijgt, kan de timer ook uitzetten. Maar de interactieve login die hem daar bracht, is dan al gemaild – binnen twee minuten, lang voordat iemand doorgaans begint met sporen wissen. Wat ons terugbrengt bij het principe van gisteren: het ontwerp mag openbaar zijn; de bescherming komt van de sleutels en van meer dan één laag hebben.

✅ Resultaat

  • Eén mail per interactieve SSH-login, binnen twee minuten, op alle drie de servers.
  • Stil bij backups en bij Ansible.
  • Geen wijziging aan sshd of PAM, dus het kan niemand buitensluiten.
  • Een bewuste grens (commando’s zonder terminal), afgedekt door andere lagen.

De eerste echte mail kwam tijdens het testen binnen, een paar minuten na de uitrol – een testlogin die ik expres had uitgelokt. Precies zo moet het voelen: saai als jij het was, onmogelijk te missen als je het niet was.

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details