SSH ログイン通知をプッシュ通知で受け取る:scp、sftp、ポートフォワードも検知する PAM フック

サーバーに盗まれた鍵や推測されたパスワードでログインされた場合、そのログインの瞬間こそが気づける唯一のタイミングであることが多いです。その後は、侵入者も普通のユーザーと同じように見えます。SSH セッションごとにスマホへプッシュ通知が届くようにすると、その瞬間を逃しません。そのログインに心当たりがあるか、何か問題が起きているかを数秒以内に判断できます。
これは防止ではなく検知です。侵入そのものを止めるものではありません。ただし、何かができる段階で気づけるようになります。
このガイドでは、SSH ログインのすべてが通る PAM を使います。Debian 12 と 13、Ubuntu 24.04、Rocky Linux 9 で、すべてのリクエストを記録する偽の API に対してテストしました。
/etc/profile、.bashrc、sshrc を使わない理由
多くの人がコピーするのは、/etc/profile、~/.bashrc、/etc/ssh/sshrc のいずれかに書いた curl の呼び出しです。それぞれが実際に何を捉えるかをテストしました。
/etc/profileはログインシェルでしか実行されません。テストでは、ssh host cmd、scp、sftp、rsync、ssh -Nはいずれもフックを実行せずにログインできました。~/.bashrcはユーザーの所有物です。そのアカウントを持つ人なら誰でも編集でき、ssh host bash --norcでは読み込まれません。/etc/ssh/sshrcは比較的ましです。コマンド、scp、sftp、rsync のどれでも実行されました。ただしログインしたユーザーの権限で動くため、API キーはすべてのアカウントから読める必要があります。さらにユーザーが~/.ssh/rcを持っていると、sshd はそちらを実行し、sshrcは実行されません。- どれも
ssh -Nを捉えられません。 SSH 経由のポートフォワードや SOCKS プロキシはシェルを開かないため、何も実行されません。
これらはすべて、攻撃者がすでに侵入した後で、そのユーザーとしてセッション内で動きます。一方、PAM フックは sshd の内部で、root として、セッションが始まる前に動きます。
PAM から見た SSH ログイン
UsePAM yes(4 つのディストリビューションすべてでデフォルト)の場合、認証に成功した直後に sshd が PAM セッションを開きます。これはクライアントがシェル、コマンド、sftp を要求する前です。そのため、フックは認証されたすべての接続で実行され、ssh -N も含まれます。ただし、対話型シェルと rsync を区別することはできません。端末が割り当てられていても PAM_TTY は単に ssh です。多重化された接続(ControlMaster)は、その上でいくつのコマンドが動いても PAM セッションは 1 つだけ開きます。
pam_exec はその時点でコマンドを実行します。テストマシンで確認した内容は次のとおりです。
- sshd の場合、コマンドは root として実行されます。
pam_execはコマンドの終了を待ち、ログインもそれに合わせて待ちます。ここでcurlが遅いと、ログインも遅くなります。stdoutオプションを追加しない限り、出力は/dev/nullに送られるため、セッションに何も漏れません。- 環境は root の環境ではなく PAM の環境です。Debian と Rocky には
PATHがありません。
スクリプトが使う変数は次のとおりです。
| 変数 | 例 | 取得元 |
|---|---|---|
PAM_TYPE | open_session | ログアウト時は close_session も使われる |
PAM_SERVICE | sshd | 使用中の PAM ファイル |
PAM_USER | root | ログインしたアカウント |
PAM_RHOST | 198.51.100.23 | クライアントのアドレス(sshd のデフォルトの UseDNS no の場合は IP) |
SSH_AUTH_INFO_0 | publickey ssh-ed25519 AAAA... | sshd が設定する値。認証方式と受け入れられた公開鍵 |
SSH_AUTH_INFO_0 は、ExposeAuthInfo を設定しなくても、試したすべてのディストリビューションで存在しました。そのため、プッシュ通知にはアカウント名だけでなく、使われた鍵も表示できます。
必要なもの
- OpenSSH を使っている Linux サーバー。PAM が有効か確認してください。
sudo sshd -T | grep -i usepamでusepam yesと表示されるはずです。 curlとjq。sudo apt install curl jq、または Rocky、Alma、RHEL ではsudo dnf install jqです(curl はこれらにすでに入っています)。- iPhone または Android の Pocket Alert アプリと、API キー。サーバーごとに別々のキーを作成すると、他に影響を与えずに 1 つだけ無効化できます。
スクリプト
#!/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 秒後に応答した場合、または応答しない場合(パケットを破棄するアドレス)でも、Debian 12 と Rocky 9 ではssh host trueが毎回 0.15 秒から 0.36 秒で完了しました。接続できない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にも現れませんでした。 - 信頼できない値は
jq --argで JSON に入れます。 ユーザー名、アドレス、サービス、鍵の情報に引用符、バックスラッシュ、改行、$(id)、制御文字、不正な UTF-8 を含めてスクリプトを実行しました。すべてのリクエストボディは有効な JSON で、何も実行されませんでした。 - ボタンは IP アドレスの場合にだけ追加されます。
viewボタンの値が有効な URL でないと、API はメッセージ全体を400で拒否します。不審なPAM_RHOSTであっても通知は届くべきなので、その場合はボタンなしで送ります。 - パターンは両側ごとに照合されます。
user@addressは最後の@で分割され、それぞれを個別に比較します。1 つの文字列に結合すると、[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 を実行してください。同じフィンガープリントがコメント付きで表示されます。
設定ファイル
API キーは root だけが読めるファイルに置きます。スクリプトはこのファイルをシェルコードとして読み込むため、所有者が root でモードが 600 でない場合は読み込みを拒否します。キーは非表示のプロンプトで入力し、シェルの履歴に残らないようにします。
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 グロブパターンで並べます。この例では、203.0.113.10 にある VPN 出口からのどのアカウントも想定内で、CI サブネットからの deploy も同様です。これらは low で届きます。つまり、フィードには表示されますが、音は鳴りません。それ以外はすべて PA_UNKNOWN_LEVEL になります。有料プランでは、これを critical に設定できます。critical は消音スイッチやおやすみモードを無視して鳴ります。無料プランでは、critical は high として配信されます。各レベルが iOS と Android でどう動くかは、優先度レベルを参照してください。
パターンは CIDR ではなくグロブです。198.51.100.* は /24 をカバーしますが、それ以外の範囲は複数のパターンが必要です。想定内のログインについて何も送りたくない場合は、PA_KNOWN_LEVEL=none を設定してください。
low のままにする前に、ログインの回数を数えてください。無料プランは 1 日 50 件までで、SSH 接続ごとに 1 件を消費します。15 分ごとに rsync を実行する CI ジョブは、1 日 96 件を使います。そのような送信元には none を設定するか、有料プランに移行してください。1 日の上限に達すると、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 行の上に置かれます。多くのガイドがファイル末尾に追加するのとは異なります。理由は、Debian 12 と Ubuntu 24.04 の /etc/pam.d/sshd にあります。
session required pam_env.so user_readenv=1 envfile=/etc/default/locale
user_readenv=1 は、ユーザー自身の ~/.pam_environment から変数を PAM 環境に読み込みます。その下にある pam_exec の行は、実行するコマンドにそれらの変数を渡してしまいます。pam_exec のマニュアルページにも警告があります。「pam_exec から呼び出されるコマンドは、ユーザーが環境を制御できることを意識する必要がある」。
Ubuntu 24.04 でこれが何を意味するかを確認しました。フックをファイル末尾に置いた状態で、一般ユーザーが ~/.pam_environment に LD_PRELOAD /tmp/x.so を書いてログインしました。するとそのライブラリが root のスクリプトと、そのスクリプトが実行したすべてのプログラムに、uid 0 として読み込まれました。SSH でログインできる誰もが root シェルを得られる状態です。フックを先頭に置いた場合、その変数は存在しませんでした。Debian 13 と Rocky 9 では user_readenv は設定されていませんが、そこでもフックを先頭に置いて損はありません。pam_env の下にすでにある pam_exec の行にも同じことが当てはまります。
行のオプションは次のとおりです。
optional: スクリプトが存在しない、または失敗しても、ログインは続行されます。スクリプトの名前を変更してログインしてみましたが、何も表示されず、ログインは成功しました。type=open_session:pam_execはログアウト時にスクリプトを一切実行しません。これは位置の理由と同じ理由で重要です。ログアウト時にはpam_envがすでに実行されており、テストでは~/.pam_environmentのLD_PRELOADが環境に戻っていました。quiet: コマンドが失敗しても、pam_execは終了ステータスをユーザーに表示しません。
RHEL 系のシステムでは、この行は pam_selinux.so close の上に置かれるため、sshd の SELinux コンテキストで実行されます。テストはSELinux が強制されていないコンテナで行いました。SELinux が強制されているシステムでプッシュ通知が届かない場合は、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
実際の SSH ログインはなかったため、数秒以内に SSH login: test@<hostname> というタイトルで、Method: unknown と表示されたプッシュ通知が届くはずです。リクエストの内容を先に確認したい場合は、設定ファイルに POCKETALERT_API_URL=http://<your test endpoint> を追加してください。確認が終わったら削除してください。
次に、PA_KNOWN に含まれていない場所からログインしてみてください。テストマシンでは、対話型シェル、ssh host cmd、scp、sftp、rsync、パスワードログイン、ssh -N のそれぞれで、プッシュ通知が 1 件ずつ届きました。
任意:su と sudo
同じスクリプトで、それぞれの PAM ファイルを通じて su と sudo を報告することもできます。これには、もう 1 つオプションが必要です。
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 として実行され、プッシュ通知は sudo on web-1: alice as root のように表示されます。
これらのサービスでは、スクリプトはコマンドを実行したユーザーに対して PA_KNOWN を照合し、アドレスとして local を使います。alice@local は Alice 自身の sudo を静かにします。root@local は、root として動くスクリプトや、su で別のユーザーに切り替えるスクリプトを静かにします。ただし後者も通知は送られます。
sudo を追加する前に、通知の量を考えてください。sudo を実行するたびにセッションが開くため、そのたびにプッシュ通知が届きます。一日中 sudo を使う人がいるサーバーでは、通常は su だけを対象にすれば十分です。
ボタン
有料プランでは、SSH のプッシュ通知ごとに 2 つのアクションボタンが表示されます。Copy IP はアドレスをクリップボードにコピーし、ファイアウォールのルールやログ検索に使えます。Look up IP は ipinfo.io でアドレスを開き、プロバイダーのものか、遠く離れた国のホスティングネットワークからのものかを確認できます。無料プランでは、サーバーがボタンを取り除き、プッシュ通知本体は通常どおり配信されます。
このガイドの対象外
- ログインの失敗。 PAM セッションは認証に成功したあとにしか開きません。パスワードの総当たりは fail2ban の仕事か、journal の sshd のログを確認する作業です。
- ログイン後の出来事。 root を取得した人は、
/etc/pam.d/sshdからその行を削除できます。ただし、侵入に使われたログインのプッシュ通知を取り消すことはできません。そのリクエストは、攻撃者のシェルが始まる前にすでに送信されているからです。 - sshd の PAM スタックを通らないログイン。 ローカルコンソール、他のリモートアクセスサービス、
UsePAM noの sshd などが含まれます。 - シェルとファイル転送の区別。 前述のとおり、PAM はまだそれを知りません。アドレスと鍵があれば、通常は CI ジョブと人を区別するのに十分です。
ここまでで、誰かが侵入した瞬間をカバーできます。プッシュ通知を送る価値のあるその他のサーバーイベントについては、セキュリティアラートを参照してください。