# Каждое событие безопасности на ваш телефон.

> Push-уведомления о входах по SSH, использовании sudo и банах fail2ban. Один curl из скрипта входа отправит на телефон пользователя, IP-адрес источника и правило меньше чем за секунду.

<!-- source: https://pocketalert.app/ru/use-cases/security-alerts -->

Обновлено: 2026-08-11

Когда что-то затрагивает ваш сервер — вход по SSH, блокировка fail2ban, правило CrowdSec или auditd, — пользователь, IP источника и правило попадают на телефон меньше чем за секунду. Узнайте, кто вошёл, раньше, чем он закончит печатать.

## Три шага до уведомлений о входе

1. **Получите API-ключ** — Создайте API-ключ и приложение для каждого сервера, затем храните ключ в переменной окружения на машине.
2. **Подключите событие** — Добавьте curl в скрипт входа, действие fail2ban или правило IDS, который передаёт пользователя и IP источника.
3. **Следите за серверами** — Входы и блокировки доходят до телефона в течение секунды. Указывайте событие в заголовке, чтобы root-вход с нового IP явно отличался от планового деплоя.

## От входа до push-уведомления

Подключите любой вход, блокировку или правило к одному curl-запросу, и событие придёт на телефон как push-уведомление.

- **Push-уведомление о входе по SSH** — Скрипт входа в /etc/profile.d или sshrc отправляет curl-запрос в Pocket Alert с пользователем и IP источника при каждой интерактивной сессии.
- **Блокировки fail2ban** — fail2ban запускает curl в actionban, поэтому каждый заблокированный IP появляется на телефоне вместе с jail, который его поймал.
- **sudo и входы администраторов** — Перехватчик PAM или триггер sudo срабатывает, когда кто-то повышает привилегии, и вход нового администратора приходит так же.
- **Триггеры IDS и аудита** — CrowdSec, Wazuh, OSSEC и auditd вызывают curl при срабатывании правила.
- **Маппинг полей** — Маппинг полей GJSON извлекает пользователя, IP источника и правило из полезной нагрузки SIEM и подставляет их в заголовок и текст.
- **Доставка за доли секунды** — Push-уведомления приходят значительно быстрее секунды, так что вы успеваете увидеть сессию, пока она ещё открыта.

## Уведомление о каждом входе

### 1. Получите API-ключ

Создайте приложение в Pocket Alert и скопируйте свой API-ключ. Передавайте его в заголовке `Token`. Для каждого сервера создайте отдельное приложение, чтобы prod, bastion и personal работали в разных каналах.

### 2. Вход по SSH (sshrc или /etc/profile.d)

Положите скрипт в `/etc/profile.d`, чтобы каждый интерактивный вход отправлял запрос к API сообщений с пользователем и IP источника из `$SSH_CONNECTION`:

```
# /etc/profile.d/pocketalert-login.sh
[ -n "$SSH_CONNECTION" ] && curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"SSH login\",\"message\":\"$USER from ${SSH_CONNECTION%% *} on $(hostname)\"}"
```

### 3. Блокировка fail2ban (пользовательское действие)

Добавьте действие в `/etc/fail2ban/action.d/pocketalert.conf` и укажите его в jail. fail2ban подставляет `<ip>` и `<name>` при каждой блокировке:

```
[Definition]
actionban = curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"fail2ban: banned <ip>","level":"critical","message":"jail <name> banned <ip>"}'
```

### 4. SIEM (вебхук)

Для SIEM или IDS, которые выдают JSON (Wazuh, CrowdSec), создайте вебхук с шаблоном GJSON в `message`, который сопоставит поля их полезной нагрузки, а затем укажите адрес получения в настройках инструмента:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Wazuh alerts","message":"%rule.description% from %data.srcip%","application_id":"qm47b9pzxzxg"}'
```

Вы получите адрес `https://p4a.me/wh/1234abcd`, который нужно вставить в настройки интеграции инструмента.

См. [документацию по настройкам вебхуков](https://info.pocketalert.app/api/webhooks/settings.html) о API сообщений и маппинге полей GJSON.

## Частые вопросы

### Как получать уведомление о каждом входе по SSH?

Положите небольшой скрипт в /etc/profile.d, который отправляет curl-запрос в Pocket Alert с $USER и IP из $SSH_CONNECTION. После этого каждый интерактивный вход будет присылать push-уведомление на телефон.

### Может ли fail2ban присылать push-уведомления?

fail2ban запускает curl в actionban. Добавьте заблокированный IP и jail в текст сообщения, и каждая блокировка будет видна сразу, как только происходит.

### Как отличить срочные входы от обычных?

Указывайте событие в заголовке, чтобы его было видно с первого взгляда: вход root с нового IP и плановый вход пользователя deploy придут как явно разные уведомления. Для чувствительных серверов создайте отдельное приложение, чтобы не смешивать их с остальными.

### Работает ли это с CrowdSec, Wazuh или auditd?

Да. CrowdSec, Wazuh, OSSEC и auditd могут вызвать curl по срабатыванию правила. Маппинг полей GJSON подставляет пользователя, IP-адрес источника и правило в заголовок и текст.

### Как разделить уведомления по серверам?

Создайте отдельное приложение для каждого сервера: prod, bastion, personal. Отдельные каналы для каждого приложения не дают смешивать уведомления, и вы сразу видите, с какого сервера пришёл сигнал. Pocket Alert только передаёт событие и не является IDS.

### Может ли вход root пробиться сквозь беззвучный режим в 3 часа ночи?

Да. Добавьте "level":"critical" в curl-запрос, и на Android уведомление уйдёт в отдельный канал, который обходит режим «Не беспокоить», — доступ к этому режиму нужно выдать один раз. На iPhone уведомления с уровнем high и critical приходят как срочные и пробиваются через режимы «Фокусирование». Обычные входы пользователя deploy отправляйте с уровнем silent: без звука и вибрации, но они останутся в истории, когда понадобится журнал аудита. На бесплатном тарифе critical доставляется как high: это по-прежнему мгновенно, но без обхода «Не беспокоить».
