Um e-mail para cada login SSH: um tripwire de dois minutos com wtmp e systemd

Um e-mail para cada login SSH interativo em até dois minutos: um timer systemd lendo o wtmp, silencioso para backups e Ansible, e o que ele não consegue ver.

Ilustração do artigo sobre um e-mail para cada login SSH

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Esta é uma continuação do post longo de ontem, Defesa em profundidade: nove camadas entre a internet e meus servidores. Lá, o alarme de login ganhou uma frase. Aqui está como ele funciona, por que foi construído assim – e o que um atacante aprende lendo isto.

A ideia é antiga e simples: se alguém fizer login num dos meus servidores, quero saber – em minutos, não quando por acaso eu olhar um log uma semana depois. Cada login me manda um e-mail. Como sei quando eu mesmo entrei, todo e-mail que eu não esperava merece ser olhado na hora. É um tripwire: não impede ninguém, garante que uma invasão não passe despercebida.

Havia três requisitos. Ele nunca pode atrapalhar um login – um recurso de segurança que me tranca fora do meu próprio servidor é pior do que nenhum. Ele precisa ficar quieto para tudo que é automatizado, senão me treina a ignorá-lo. E precisa funcionar do mesmo jeito nos três servidores, implantado pelo Ansible como todo o resto.

Índice

🔍 De onde vêm os logins: wtmp

O Linux registra toda sessão de login que recebe um terminal em /var/log/wtmp. O comando last lê esse arquivo, e com timestamps ISO fica fácil de fazer parsing:

$ 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)

O detalhe importante é o que não está lá: sessões sem terminal. Quando minha máquina de backup puxa os backups noturnos, ela executa um comando via SSH, não recebe terminal e não deixa entrada no wtmp. É exatamente o filtro que eu quero – shells interativos são reportados, comandos automatizados simples não.

🧩 O script

A cada dois minutos um pequeno script lê o last, compara com o login mais novo que já reportou e manda um e-mail para tudo que é novo naquela janela – vários logins viram um e-mail, não cinco. O estado é um único timestamp em /var/lib/ssh-login-alert/last-seen. Na primeiríssima execução num host ele só guarda a posição atual, para não me mandar o histórico inteiro de uma vez. E o estado só avança depois que o e-mail saiu: se o envio falhar, a próxima execução tenta de novo.

#!/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"

O e-mail sai pelo mesmo pequeno relay SMTP (msmtp) que já envia os outros relatórios dos servidores. Fica assim:

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

⏱️ Um timer, não um hook do PAM

O jeito óbvio de reagir a um login é um módulo PAM: pam_exec na pilha PAM do SSH executa um script a cada sessão. Decidi contra isso por dois motivos.

  • Risco de ficar trancado fora. O PAM é o próprio login. Um erro de digitação ou um script travado na pilha PAM do SSH pode fazer o servidor recusar todo login – exatamente a situação em que eu preciso do console do provedor de hospedagem.
  • SELinux. Um script iniciado pelo PAM roda no contexto de segurança do sshd. Enviar e-mail de lá significa conexões de rede a partir de um domínio que o SELinux, com razão, não deixa fazer isso.

Um timer do systemd não tem nenhum dos dois problemas. Ele roda completamente separado do sshd, na sua própria unit, e o pior que um bug pode fazer é não enviar um e-mail. O preço é um atraso de até dois minutos – aceitável para um 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

🤖 Mantendo o Ansible quieto

O primeiro teste trouxe uma surpresa: toda execução do Ansible aparecia no wtmp como algumas sessões curtas. O plugin SSH do Ansible pede um terminal para alguns passos por padrão. Nenhum dos meus playbooks precisa de um – pipelining está ligado, e nada nunca pede senha –, então uma linha no ansible.cfg desliga isso:

[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

Depois disso, uma execução completa do playbook não deixou rastro no wtmp, e o alarme só dispara para sessões interativas de verdade. No próprio Ansible a coisa toda são três pequenas tasks – script a partir de um template, dois arquivos de unit, habilitar o timer:

- 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)

🕵️ Isso ajuda um atacante?

Este post descreve exatamente o que dispara o alarme e o que não dispara. Então a pergunta honesta: ele entrega a um atacante uma receita para ficar invisível?

Em parte, sim – e tudo bem. Quem tiver uma chave roubada e ler isto sabe que ssh host 'command' sem terminal não dispara e-mail. Mas isso não é uma brecha secreta, é como o wtmp funciona, e qualquer um que conheça Linux sabe disso. Mais importante: o alarme é uma camada entre várias. Para entrar é preciso primeiro uma chave válida – senhas estão desligadas, o SSH só escuta as faixas de endereços de um país, e tentativas falhas são banidas. E o que alguém fizer lá dentro sem terminal ainda precisa passar pelos outros tripwires: mudanças em contas de usuário, sudo, na configuração do SSH, em módulos do kernel ou nos secrets do cluster são registradas e reportadas por outros meios, e arquivos de sistema alterados são encontrados na noite seguinte.

Quem conseguir root também pode desligar o timer. Mas o login interativo que o levou até lá já terá sido enviado por e-mail – em até dois minutos, muito antes de alguém normalmente começar a apagar rastros. O que nos traz de volta ao princípio de ontem: o design pode ser público; a proteção vem das chaves e de ter mais de uma camada.

✅ Resultado

  • Um e-mail por login SSH interativo, em até dois minutos, nos três servidores.
  • Silêncio para backups e para o Ansible.
  • Nenhuma mudança no sshd ou no PAM, então não tem como trancar ninguém fora.
  • Um limite deliberado (comandos sem terminal), coberto por outras camadas.

O primeiro e-mail de verdade chegou durante os testes, poucos minutos depois do deploy – um login de teste que eu disparei de propósito. É exatamente essa a sensação que deve dar: entediante quando foi você, impossível de ignorar quando não foi.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes