ログインから、プッシュ通知まで
どのログイン、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 秒を大きく下回る速さで届くため、セッションがまだ開いているうちに気づけます。
ログインアラートまでの 3 ステップ
API キーを取得
API キーを作成し、ホストごとのアプリケーションを作ってから、キーをサーバー上の環境変数に保存します。
イベントに接続
ログインスクリプト、fail2ban のアクション、IDS のルールに、ユーザーと送信元 IP を送信する curl を追加します。
サーバーを監視
ログインや BAN は 1 秒以内にスマホへ届きます。タイトルにイベントを入れておけば、新しい IP からの root ログインと定期デプロイを明確に区別できます。
ログインのたびに通知
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 設定のドキュメントをご覧ください。
よくある質問
/etc/profile.d に小さなスクリプトを置き、$USER と $SSH_CONNECTION の IP を使って Pocket Alert に curl で送信します。以降、対話型のログインがすべてスマホにプッシュ通知されます。
fail2ban は actionban で curl を実行できます。BAN された IP と jail をメッセージ本文に含めれば、BAN が発生するたびに通知が届きます。
タイトルにイベントを入れると一目で内容がわかります。新しい IP からの root ログインと、定期デプロイ用ユーザーのログインは、明確に異なるアラートとして届きます。重要なホストは専用のアプリケーションにまとめると、通知を分けられます。
はい。CrowdSec、Wazuh、OSSEC、auditd はいずれもトリガー時に curl を実行できます。GJSON のフィールドマッピングで、ユーザー、送信元 IP、ルールをタイトルとメッセージに取り込めます。
ホストごとにアプリケーションを作成してください(例: prod、bastion、personal)。アプリケーションごとにチャネルを分けると、どのサーバーで検知されたかがわかります。Pocket Alert はイベントを中継するだけで、IDS ではありません。
はい。curl に "level":"critical" を追加すると、Android ではおやすみモードを貫通する専用の通知チャネルに届きます(おやすみモードへのアクセスは一度許可するだけです)。iPhone では high と critical が集中モードも貫通する時間的重要度の高い通知として届きます。定期デプロイ用ユーザーのログインは level を silent にしておくと、音やバイブレーションは鳴りませんが、履歴には残るので監査ログとして確認できます。無料プランでは critical は high として配信されます。即時に届く点は同じですが、おやすみモードの貫通はありません。