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

> Получайте push-уведомление на iPhone или Android каждый раз, когда кто-то открывает SSH-сессию на вашем Linux-сервере. Хук pam_exec, который не замедляет вход, хранит API-ключ только для root, отключает уведомления о ваших собственных входах и закрывает повышение привилегий до root, которое обычная настройка оставляет открытым в Debian 12 и Ubuntu.

*31.10.2026*

<!-- source: https://pocketalert.app/ru/blog/ssh-login-alerts -->

Если кто-то входит на ваш сервер с украденным ключом или подобранным паролем, сам вход часто оказывается единственным моментом, когда это можно заметить. Дальше эта сессия выглядит как любая другая. 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` нет.

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

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Переменная</th><th>Пример</th><th>Откуда берётся</th></tr></thead>
<tbody>
<tr><th><code>PAM_TYPE</code></th><td><code>open_session</code></td><td>Также <code>close_session</code> при выходе из системы</td></tr>
<tr><th><code>PAM_SERVICE</code></th><td><code>sshd</code></td><td>Файл PAM, который используется</td></tr>
<tr><th><code>PAM_USER</code></th><td><code>root</code></td><td>Учётная запись, под которой выполнен вход</td></tr>
<tr><th><code>PAM_RHOST</code></th><td><code>198.51.100.23</code></td><td>Адрес клиента (IP-адрес, при значении по умолчанию <code>UseDNS no</code> в sshd)</td></tr>
<tr><th><code>SSH_AUTH_INFO_0</code></th><td><code>publickey ssh-ed25519 AAAA...</code></td><td>Задаёт sshd: метод и принятый открытый ключ</td></tr>
</tbody>
</table>
</div>

`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](/get-app) и API-ключ из раздела [API Keys](/account/apikeys). Создайте отдельный ключ для каждого сервера, чтобы можно было отозвать один, не затрагивая остальные.

## Скрипт

```bash
#!/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
```

```bash
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` делится по последнему `@`, и каждая часть сравнивается отдельно. Если объединить их в одну строку, учётная запись `x@10.8.0.5` совпадёт с `*@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-код. Введите ключ в скрытом запросе, чтобы он не попал в историю оболочки:

```bash
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 deploy@198.51.100.*"
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, описано в разделе [уровни приоритета](https://info.pocketalert.app/features/priority-levels.html).

Шаблоны — это глобы, а не 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 при каждом подключении, поэтому перезапускать ничего не нужно.

```bash
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`:

```bash
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. Для них нужна ещё одна опция:

```bash
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 есть две [кнопки действий](/features/action-buttons): **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, описаны в разделе [оповещения о безопасности](/use-cases/security-alerts).
