# サーバーで起きるすべての セキュリティイベント をスマホへ。

> SSH ログイン、sudo の使用、fail2ban による遮断をプッシュ通知でお知らせ。ログインスクリプトから curl を 1 回実行するだけで、ユーザー、接続元 IP、ルールを 1 秒以内にスマホへ届けます。

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

最終更新日:2026-08-11

サーバーに何か起きたとき — SSH ログイン、fail2ban の BAN、CrowdSec や auditd のルール — ユーザー、送信元 IP、ルールが 1 秒以内にスマホへ届きます。入力し終わる前に、誰がログインしたかを把握できます。

## ログインアラートまでの 3 ステップ

1. **API キーを取得** — API キーを作成し、ホストごとのアプリケーションを作ってから、キーをサーバー上の環境変数に保存します。
2. **イベントに接続** — ログインスクリプト、fail2ban のアクション、IDS のルールに、ユーザーと送信元 IP を送信する curl を追加します。
3. **サーバーを監視** — ログインや BAN は 1 秒以内にスマホへ届きます。タイトルにイベントを入れておけば、新しい IP からの root ログインと定期デプロイを明確に区別できます。

## ログインから、プッシュ通知まで

どのログイン、BAN、ルールのトリガーも curl 1 行で接続すれば、そのイベントがプッシュ通知としてスマホに届きます。

- **SSH ログインのプッシュ通知** — /etc/profile.d のログインスクリプトまたは sshrc から、対話型セッションのたびにユーザーと送信元 IP を付けて Pocket Alert に curl で送信します。
- **fail2ban の BAN 通知** — fail2ban の actionban で curl を実行し、BAN された IP を検知した jail とともにスマホに表示します。
- **sudo と管理者ログイン** — PAM フックや sudo のトリガーが権限昇格時に発火し、新しい管理者ログインも同じように通知されます。
- **IDS と監査のトリガー** — CrowdSec、Wazuh、OSSEC、auditd がルールに一致した際に curl を実行します。
- **フィールドマッピング** — GJSON のフィールドマッピングで、SIEM のペイロードからユーザー、送信元 IP、ルールを抽出し、タイトルとメッセージに入れます。
- **1 秒未満の配信** — 1 秒を大きく下回る速さで届くため、セッションがまだ開いているうちに気づけます。

## ログインのたびに通知

### 1. API キーを取得

Pocket Alert でアプリケーションを作成し、API キーをコピーします。`Token` ヘッダーで送信してください。本番、踏み台、個人用のサーバーが別々のチャネルに分かれるよう、ホストごとにアプリケーションを作成します。

### 2. SSH ログイン(sshrc または /etc/profile.d)

`/etc/profile.d` にスクリプトを置くと、対話型ログインのたびに `$SSH_CONNECTION` のユーザーと送信元 IP を付けて、メッセージ API に curl で送信されます:

```
# /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 の BAN(カスタムアクション)

`/etc/fail2ban/action.d/pocketalert.conf` にアクションを追加し、jail から参照します。fail2ban は BAN のたびに `<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(Webhook)

JSON を出力する SIEM や IDS(Wazuh、CrowdSec など)の場合は、ペイロードをマッピングする GJSON の `message` テンプレートを使って Webhook を作成し、ツール側の送信先に受信 URL を設定します:

```
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` が発行されます。

メッセージ API と GJSON のフィールドマッピングについては、[Webhook 設定のドキュメント](https://info.pocketalert.app/api/webhooks/settings.html)をご覧ください。

## よくある質問

### SSH ログインのたびに通知を受け取るには?

/etc/profile.d に小さなスクリプトを置き、$USER と $SSH_CONNECTION の IP を使って Pocket Alert に curl で送信します。以降、対話型のログインがすべてスマホにプッシュ通知されます。

### fail2ban からプッシュ通知を送れますか?

fail2ban は actionban で curl を実行できます。BAN された IP と jail をメッセージ本文に含めれば、BAN が発生するたびに通知が届きます。

### 緊急のログインと通常のログインを見分けるには?

タイトルにイベントを入れると一目で内容がわかります。新しい IP からの root ログインと、定期デプロイ用ユーザーのログインは、明確に異なるアラートとして届きます。重要なホストは専用のアプリケーションにまとめると、通知を分けられます。

### CrowdSec、Wazuh、auditd でも使えますか?

はい。CrowdSec、Wazuh、OSSEC、auditd はいずれもトリガー時に curl を実行できます。GJSON のフィールドマッピングで、ユーザー、送信元 IP、ルールをタイトルとメッセージに取り込めます。

### サーバーごとにアラートを分けるには?

ホストごとにアプリケーションを作成してください(例: prod、bastion、personal)。アプリケーションごとにチャネルを分けると、どのサーバーで検知されたかがわかります。Pocket Alert はイベントを中継するだけで、IDS ではありません。

### 深夜 3 時の root ログインはサイレントモードを貫通できますか?

はい。curl に "level":"critical" を追加すると、Android ではおやすみモードを貫通する専用の通知チャネルに届きます(おやすみモードへのアクセスは一度許可するだけです)。iPhone では high と critical が集中モードも貫通する時間的重要度の高い通知として届きます。定期デプロイ用ユーザーのログインは level を silent にしておくと、音やバイブレーションは鳴りませんが、履歴には残るので監査ログとして確認できます。無料プランでは critical は high として配信されます。即時に届く点は同じですが、おやすみモードの貫通はありません。
