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

> Linux サーバーへの SSH セッションが開かれるたびに、iPhone や Android にプッシュ通知を送ります。pam_exec フックはログインを遅らせず、API キーは root だけが読める状態に保ち、自分のログインは静かにします。さらに Debian 12 と Ubuntu で一般的な構成に残る root 権限昇格の穴も避けます。

*31.10.2026*

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

サーバーに盗まれた鍵や推測されたパスワードでログインされた場合、そのログインの瞬間こそが気づける唯一のタイミングであることが多いです。その後は、侵入者も普通のユーザーと同じように見えます。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` がありません。

スクリプトが使う変数は次のとおりです。

<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>クライアントのアドレス（sshd のデフォルトの <code>UseDNS no</code> の場合は IP）</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` を設定しなくても、試したすべてのディストリビューションで存在しました。そのため、プッシュ通知にはアカウント名だけでなく、使われた鍵も表示できます。

## 必要なもの

- 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](/get-app) の Pocket Alert アプリと、[API キー](/account/apikeys)。サーバーごとに別々のキーを作成すると、他に影響を与えずに 1 つだけ無効化できます。

## スクリプト

```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 秒後に応答した場合、または応答しない場合（パケットを破棄するアドレス）でも、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 つの文字列に結合すると、`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` を実行してください。同じフィンガープリントがコメント付きで表示されます。

## 設定ファイル

API キーは root だけが読めるファイルに置きます。スクリプトはこのファイルをシェルコードとして読み込むため、所有者が root でモードが `600` でない場合は読み込みを拒否します。キーは非表示のプロンプトで入力し、シェルの履歴に残らないようにします。

```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` グロブパターンで並べます。この例では、`203.0.113.10` にある VPN 出口からのどのアカウントも想定内で、CI サブネットからの `deploy` も同様です。これらは `low` で届きます。つまり、フィードには表示されますが、音は鳴りません。それ以外はすべて `PA_UNKNOWN_LEVEL` になります。有料プランでは、これを `critical` に設定できます。`critical` は消音スイッチやおやすみモードを無視して鳴ります。無料プランでは、`critical` は `high` として配信されます。各レベルが iOS と Android でどう動くかは、[優先度レベル](https://info.pocketalert.app/features/priority-levels.html)を参照してください。

パターンは 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 ファイルを読み込むため、再起動は不要です。

```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` 行の上に置かれます。多くのガイドがファイル末尾に追加するのとは異なります。理由は、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` と同じ方法で、スクリプトを手動で呼び出せます。

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

実際の 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 つオプションが必要です。

```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 として実行され、プッシュ通知は `sudo on web-1: alice as root` のように表示されます。

これらのサービスでは、スクリプトはコマンドを実行したユーザーに対して `PA_KNOWN` を照合し、アドレスとして `local` を使います。`alice@local` は Alice 自身の `sudo` を静かにします。`root@local` は、root として動くスクリプトや、`su` で別のユーザーに切り替えるスクリプトを静かにします。ただし後者も通知は送られます。

`sudo` を追加する前に、通知の量を考えてください。`sudo` を実行するたびにセッションが開くため、そのたびにプッシュ通知が届きます。一日中 `sudo` を使う人がいるサーバーでは、通常は `su` だけを対象にすれば十分です。

## ボタン

有料プランでは、SSH のプッシュ通知ごとに 2 つの[アクションボタン](/features/action-buttons)が表示されます。**Copy IP** はアドレスをクリップボードにコピーし、ファイアウォールのルールやログ検索に使えます。**Look up IP** は ipinfo.io でアドレスを開き、プロバイダーのものか、遠く離れた国のホスティングネットワークからのものかを確認できます。無料プランでは、サーバーがボタンを取り除き、プッシュ通知本体は通常どおり配信されます。

## このガイドの対象外

- **ログインの失敗。** PAM セッションは認証に成功したあとにしか開きません。パスワードの総当たりは fail2ban の仕事か、journal の sshd のログを確認する作業です。
- **ログイン後の出来事。** root を取得した人は、`/etc/pam.d/sshd` からその行を削除できます。ただし、侵入に使われたログインのプッシュ通知を取り消すことはできません。そのリクエストは、攻撃者のシェルが始まる前にすでに送信されているからです。
- **sshd の PAM スタックを通らないログイン。** ローカルコンソール、他のリモートアクセスサービス、`UsePAM no` の sshd などが含まれます。
- **シェルとファイル転送の区別。** 前述のとおり、PAM はまだそれを知りません。アドレスと鍵があれば、通常は CI ジョブと人を区別するのに十分です。

ここまでで、誰かが侵入した瞬間をカバーできます。プッシュ通知を送る価値のあるその他のサーバーイベントについては、[セキュリティアラート](/use-cases/security-alerts)を参照してください。
