Назад в блог

Push-уведомления о входе по SSH на телефон: PAM-хук, который ловит также scp, sftp и проброс портов

Push-уведомления о входе по SSH на телефон: PAM-хук, который ловит также scp, sftp и проброс портов

Если кто-то входит на ваш сервер с украденным ключом или подобранным паролем, сам вход часто оказывается единственным моментом, когда это можно заметить. Дальше эта сессия выглядит как любая другая. Push-уведомление на телефон для каждой SSH-сессии даёт вам этот момент: вы либо узнаёте вход, либо за считаные секунды понимаете, что что-то не так.

Это обнаружение, а не предотвращение. Оно никого не остановит. Зато вы узнаете о входе, пока ещё можно что-то сделать.

В руководстве используется PAM, через который проходит каждый SSH-вход. Всё проверено на Debian 12 и 13, Ubuntu 24.04 и Rocky Linux 9 с поддельным API, который записывал каждый запрос.

Почему не /etc/profile, .bashrc или sshrc

Чаще всего копируют вызов curl в /etc/profile, ~/.bashrc или /etc/ssh/sshrc. Мы проверили, что каждый из этих вариантов реально видит:

  • /etc/profile выполняется только для login-оболочек. В наших тестах ssh host cmd, scp, sftp, rsync и ssh -N выполнялись без его запуска.
  • ~/.bashrc принадлежит пользователю. Любой, кто имеет доступ к этой учётной записи, может его изменить, а ssh host bash --norc его пропускает.
  • /etc/ssh/sshrc лучше: он срабатывал для команд, scp, sftp и rsync. Но запускается он от имени вошедшего пользователя, поэтому API-ключ должен быть читаем для каждой учётной записи. Кроме того, если у пользователя есть ~/.ssh/rc, sshd запускает его вместо sshrc, и sshrc не выполняется.
  • Ни один из них не видит ssh -N. Проброс портов или SOCKS-прокси через SSH не открывает оболочку, поэтому ничего не запускается.

Все эти варианты работают внутри сессии, от имени пользователя, уже после того как злоумышленник оказался внутри. PAM-хук работает внутри sshd, от имени root, до начала сессии.

Как PAM видит SSH-вход

При UsePAM yes (значение по умолчанию во всех четырёх дистрибутивах) sshd открывает сессию PAM сразу после успешной аутентификации. Это происходит до того, как клиент запросит оболочку, команду или sftp. Поэтому хук срабатывает для каждого аутентифицированного соединения, включая ssh -N, и не может отличить интерактивную оболочку от rsync: PAM_TTY равен ssh даже тогда, когда вы получили терминал. Мультиплексированное соединение (ControlMaster) открывает одну сессию PAM, сколько бы команд через него ни выполнялось.

pam_exec запускает команду в этот момент. Вот что мы подтвердили на тестовых машинах:

  • Для sshd команда выполняется от имени root.
  • pam_exec ждёт завершения команды, и вход ждёт вместе с ней. Медленный curl здесь означает медленный вход.
  • Его вывод уходит в /dev/null, если не указана опция stdout, поэтому ничто не просочится в сессию.
  • Его окружение — это окружение PAM, а не root. В Debian и Rocky переменной PATH нет.

Скрипт использует следующие переменные:

ПеременнаяПримерОткуда берётся
PAM_TYPEopen_sessionТакже close_session при выходе из системы
PAM_SERVICEsshdФайл PAM, который используется
PAM_USERrootУчётная запись, под которой выполнен вход
PAM_RHOST198.51.100.23Адрес клиента (IP-адрес, при значении по умолчанию UseDNS no в sshd)
SSH_AUTH_INFO_0publickey ssh-ed25519 AAAA...Задаёт sshd: метод и принятый открытый ключ

SSH_AUTH_INFO_0 присутствовала в каждом дистрибутиве, который мы проверили, без ExposeAuthInfo. Это значит, что push может указать, какой ключ был использован, а не только учётную запись.

Что понадобится

  • Linux-сервер с OpenSSH. Проверьте, что PAM включён: sudo sshd -T | grep -i usepam должна вывести usepam yes.
  • curl и jq: sudo apt install curl jq, или sudo dnf install jq в Rocky, Alma и RHEL (curl там уже установлен).
  • Приложение Pocket Alert для iPhone или Android и API-ключ из раздела API Keys. Создайте отдельный ключ для каждого сервера, чтобы можно было отозвать один, не затрагивая остальные.

Скрипт

#!/bin/bash
# /usr/local/sbin/pa-ssh-login
# Run by pam_exec when a session opens. It must never slow down or break a login.
PATH=/usr/sbin:/usr/bin:/sbin:/bin
CONF=/etc/pa-ssh-login.conf

[ "$PAM_TYPE" = open_session ] || exit 0
[ "$(stat -c '%u %a' "$CONF" 2>/dev/null)" = "0 600" ] || exit 0
# shellcheck source=/dev/null
. "$CONF"
[ -n "$POCKETALERT_API_KEY" ] || exit 0

host=$(uname -n)
if [ "$PAM_SERVICE" = sshd ]; then
  who=${PAM_USER:-unknown}
  from=${PAM_RHOST:-unknown}
  title="SSH login: $who@$host"
  auth=${SSH_AUTH_INFO_0%%$'\n'*}
  case $auth in
    publickey\ *) auth="Key: $(ssh-keygen -lf - <<<"${auth#publickey }" 2>/dev/null | awk '{print $2, $NF}')" ;;
    '') auth="Method: unknown" ;;
    *) auth="Method: ${auth%% *}" ;;
  esac
  message="From $from"$'\n'"$auth"
else
  who=${PAM_RUSER:-unknown}
  from=local
  title="$PAM_SERVICE on $host: $who as ${PAM_USER:-unknown}"
  message="Terminal: ${PAM_TTY:-none}"
fi

level=${PA_UNKNOWN_LEVEL:-high}
read -ra rules <<<"${PA_KNOWN:-}"
for rule in "${rules[@]}"; do
  # shellcheck disable=SC2053 # user@address, both halves are glob patterns on purpose
  if [[ $who == ${rule%@*} && $from == ${rule##*@} ]]; then
    level=${PA_KNOWN_LEVEL:-low}
    break
  fi
done
[ "$level" = none ] && exit 0

ip=
[[ $from =~ ^[0-9A-Fa-f:.]+$ ]] && ip=$from

json=$(jq -n --arg title "$title" --arg message "$message" --arg level "$level" --arg ip "$ip" '
  {title: $title, message: $message, level: $level}
  + (if $ip == "" then {} else {actions: [
      {type: "copy", label: "Copy IP", value: $ip},
      {type: "view", label: "Look up IP", value: ("https://ipinfo.io/" + $ip)}
    ]} end)') || exit 0

{
  printf 'header = "Token: %s"\n' "$POCKETALERT_API_KEY" |
    curl -fsS -o /dev/null --connect-timeout 5 --max-time 15 -K - \
      -H 'Content-Type: application/json' --data-binary "$json" \
      "${POCKETALERT_API_URL:-https://api.pocketalert.app/v1/messages}" ||
    logger -t pa-ssh-login "push failed, curl exit code $?"
} </dev/null >/dev/null 2>&1 &

exit 0
sudo install -m 0755 -o root -g root pa-ssh-login /usr/local/sbin/pa-ssh-login

Что он делает и зачем:

  • HTTP-запрос выполняется в фоне. Скрипт запускает curl и сразу завершается, поэтому pam_exec перестаёт ждать. Когда API отвечает нормально, через 4 секунды или не отвечает вовсе (адрес, который отбрасывает пакеты), ssh host true каждый раз занимал от 0,15 до 0,36 секунды на Debian 12 и Rocky 9. Если curl не может подключиться, он сдаётся максимум через 15 секунд, а ошибка попадает в syslog как pa-ssh-login: push failed, curl exit code 7.
  • Скрипт всегда завершается с кодом 0, а весь вывод перенаправлен, поэтому сессия ничего не видит. Вывод интерактивного входа и ssh host cmd был одинаковым с хуком и без него, за исключением времени в строке «Last login».
  • Ключ никогда не попадает в командную строку. curl читает заголовок Token из стандартного ввода (-K -). Аргументы видны всем локальным пользователям в ps. Пока запрос висел, ключа не было ни в одном /proc/<pid>/cmdline.
  • Недоверенные значения попадают в JSON через jq --arg. Мы запускали скрипт с именем пользователя, адресом, именем службы и информацией о ключе, полными кавычек, обратных слэшей, переводов строк, $(id), управляющих символов и некорректного UTF-8. Каждое тело запроса было валидным JSON, и ничего не выполнялось.
  • Кнопки добавляются только для IP-адреса. API отклоняет всё сообщение с ответом 400, если кнопка view содержит некорректный URL. Странный PAM_RHOST всё равно даст уведомление, просто без кнопок.
  • Шаблоны сопоставляются по частям. user@address делится по последнему @, и каждая часть сравнивается отдельно. Если объединить их в одну строку, учётная запись [email protected] совпадёт с *@10.8.0.*, даже когда подключение идёт откуда угодно.

Вход с неизвестного адреса приходит так, с приоритетом high, поэтому он проходит через Фокусирование на iPhone:

SSH login: root@web-1
From 198.51.100.23
Key: SHA256:iZtVU4EwMulogUeoneZkIXA9eeQfCvpyRB66QrrxBRA (ED25519)

Чтобы узнать, какой это ключ, выполните ssh-keygen -lf ~/.ssh/authorized_keys на сервере. Команда выведет те же отпечатки вместе с комментариями.

Файл конфигурации

Ключ хранится в файле, который может читать только root. Скрипт не загружает его, если файл не принадлежит root и не имеет режима 600, потому что скрипт подключает его как shell-код. Введите ключ в скрытом запросе, чтобы он не попал в историю оболочки:

sudo bash -c 'umask 077; read -rsp "API key: " k; echo; printf "POCKETALERT_API_KEY=%s\n" "$k" > /etc/pa-ssh-login.conf'
sudo tee -a /etc/pa-ssh-login.conf >/dev/null <<'EOF'
PA_KNOWN="*@203.0.113.10 [email protected].*"
PA_KNOWN_LEVEL=low
PA_UNKNOWN_LEVEL=high
EOF
sudo stat -c '%U %a' /etc/pa-ssh-login.conf   # root 600

PA_KNOWN перечисляет ожидаемые входы в виде шаблонов user@address через пробел. В примере любая учётная запись с вашего VPN-выхода 203.0.113.10 считается ожидаемой, как и deploy из подсети CI. Такие входы приходят с приоритетом low: в ленте, без звука. Всё остальное получает значение PA_UNKNOWN_LEVEL. На платном тарифе его можно выставить в critical: такое уведомление проигрывается даже при включённом беззвучном режиме и режиме «Не беспокоить». На бесплатном тарифе critical доставляется как high. Что делает каждый уровень на iOS и Android, описано в разделе уровни приоритета.

Шаблоны — это глобы, а не CIDR: 198.51.100.* покрывает /24, а для других диапазонов нужно больше шаблонов. Чтобы не отправлять ничего для ожидаемых входов, задайте PA_KNOWN_LEVEL=none.

Прежде чем оставить low, посчитайте свои входы. На бесплатном тарифе доступно 50 сообщений в день, а каждое SSH-соединение — это одно сообщение. CI-задача, которая запускает rsync каждые 15 минут, расходует на это 96 сообщений. Для таких источников задайте none или перейдите на платный тариф. Когда дневной лимит исчерпан, API перестаёт принимать сообщения до 00:00 UTC, и это коснётся в том числе того единственного входа, который важен для вас.

Подключите к PAM, в начало файла

Эта часть важнее скрипта. Пока вы меняете PAM, держите открытой root-оболочку в другом терминале, чтобы опечатка не заблокировала вам доступ. sshd читает свой файл PAM при каждом подключении, поэтому перезапускать ничего не нужно.

sudo cp /etc/pam.d/sshd /root/pam.d-sshd.bak
sudo sed -i '0,/^session/s|^session|session    optional     pam_exec.so quiet type=open_session /usr/local/sbin/pa-ssh-login\n&|' /etc/pam.d/sshd
sudo grep -n -m2 '^session' /etc/pam.d/sshd

В Debian последняя команда выводит:

19:session    optional     pam_exec.so quiet type=open_session /usr/local/sbin/pa-ssh-login
20:session [success=ok ignore=ignore module_unknown=ignore default=bad]        pam_selinux.so close

Строка попадает над первой строкой session, а не в конец файла, куда её добавляют большинство руководств. Причина — в файле /etc/pam.d/sshd в Debian 12 и Ubuntu 24.04:

session    required     pam_env.so user_readenv=1 envfile=/etc/default/locale

user_readenv=1 загружает переменные из личного файла ~/.pam_environment пользователя в окружение PAM. Любая строка pam_exec ниже неё передаёт эти переменные запускаемой команде. Страница руководства pam_exec предупреждает об этом: «Commands called by pam_exec need to be aware of that the user can have control over the environment» (команды, вызываемые pam_exec, должны учитывать, что пользователь может контролировать окружение).

Мы проверили, что это значит на Ubuntu 24.04. Когда хук стоял в конце файла, обычный пользователь записал LD_PRELOAD /tmp/x.so в ~/.pam_environment и вошёл в систему. Библиотека загрузилась в root-скрипт и в каждую программу, которую он запускал, с uid 0. Это root-оболочка для любого, кто может войти по SSH. Когда хук стоял в начале, переменной не было. В Debian 13 и Rocky 9 user_readenv не задан, но постановка хука первым и там ничего не стоит. То же относится к любой строке pam_exec, которая у вас уже есть ниже pam_env.

Опции в этой строке:

  • optional: если скрипт отсутствует или завершается с ошибкой, вход всё равно выполняется. Мы переименовали скрипт и вошли в систему. Вход прошёл, ничего не выведя.
  • type=open_session: pam_exec вообще не запускает скрипт при выходе из системы. Это важно по той же причине, что и позиция строки: при выходе pam_env уже отработал, и в нашем тесте LD_PRELOAD из ~/.pam_environment снова оказался в окружении.
  • quiet: если команда завершилась с ошибкой, pam_exec не выводит её код возврата пользователю.

В системах семейства RHEL строка оказывается над pam_selinux.so close, поэтому выполняется в контексте SELinux для sshd. Наши тесты проходили в контейнерах без принудительного режима SELinux. Если на системе с принудительным режимом push-уведомления не приходят, проверьте sudo ausearch -m avc -ts recent.

Обновления пакетов могут заменить /etc/pam.d/sshd или оставить рядом копию .dpkg-dist или .rpmnew. После обновления OpenSSH проверьте, что строка на месте.

Проверка

Скрипт можно вызвать вручную так же, как это делает pam_exec:

sudo env PAM_TYPE=open_session PAM_SERVICE=sshd PAM_USER=test PAM_RHOST=203.0.113.9 /usr/local/sbin/pa-ssh-login

Push с заголовком SSH login: test@<hostname> должен прийти в течение нескольких секунд, с Method: unknown, поскольку реального SSH-входа не было. Если хотите сначала увидеть запрос, добавьте в конфигурацию POCKETALERT_API_URL=http://<your test endpoint> и удалите эту строку, когда закончите.

Затем войдите с адреса, которого нет в PA_KNOWN. На тестовых машинах каждое из следующих действий дало по одному push: интерактивная оболочка, ssh host cmd, scp, sftp, rsync, вход по паролю и ssh -N.

Дополнительно: su и sudo

Тот же скрипт может сообщать о su и sudo через их собственные файлы PAM. Для них нужна ещё одна опция:

for f in su sudo; do
  sudo sed -i '0,/^session/s|^session|session    optional     pam_exec.so quiet seteuid type=open_session /usr/local/sbin/pa-ssh-login\n&|' /etc/pam.d/$f
done

Без seteuid pam_exec запускает команду с реальным ID пользователя, вызвавшего процесс. Для su и sudo это пользователь, который ввёл команду, а не root. На наших тестовых машинах скрипт работал под uid 1000, не мог прочитать файл конфигурации и ничего не отправлял. С seteuid он работает от имени root, и push выглядит так: sudo on web-1: alice as root.

Для этих служб скрипт сопоставляет PA_KNOWN с пользователем, который выполнил команду, а в качестве адреса использует local. alice@local отключает уведомления о sudo для Alice. root@local отключает уведомления для скриптов, которые работают от root и переходят к другому пользователю через su, а такие переходы тоже дают push.

Прежде чем добавлять sudo, оцените объём. Каждая команда sudo открывает сессию, а значит, каждая даёт push. На сервере, где люди используют sudo весь день, обычно достаточно подключить только su.

Кнопки

На платных тарифах у каждого SSH-push есть две кнопки действий: Copy IP копирует адрес в буфер обмена для правила файервола или поиска по логам, а Look up IP открывает его на ipinfo.io, чтобы вы видели, это ваш провайдер или хостинг-сеть на другом континенте. На бесплатном тарифе сервер убирает кнопки, а сам push доставляется как обычно.

Что это не покрывает

  • Неудачные входы. Сессии PAM открываются только после успешной аутентификации. Подбор паролей — задача fail2ban или проверки журнала sshd в journal.
  • Всё, что происходит после входа. Тот, кто получил root, может удалить строку из /etc/pam.d/sshd. Но он не может отозвать push о входе, который ему открыл доступ: запрос уже отправлен до того, как начнётся его оболочка.
  • Входы, которые не проходят через стек PAM sshd. Сюда относятся локальная консоль, другие службы удалённого доступа и sshd с UsePAM no.
  • Различение оболочки и передачи файлов. Как объяснено выше, PAM пока не знает, что именно происходит. Адреса и ключа обычно достаточно, чтобы отличить CI-задачу от человека.

Это закрывает момент, когда кто-то получает доступ. Другие события сервера, о которых стоит получать push, описаны в разделе оповещения о безопасности.

Поделиться статьёй