# Notifikasi login SSH ke ponsel: hook PAM yang juga menangkap scp, sftp dan port forward

> Dapatkan push notification di iPhone atau Android setiap kali ada yang membuka sesi SSH di server Linux Anda. Hook pam_exec yang tidak pernah memperlambat login, menjaga kunci API hanya bisa dibaca root, membisukan login Anda sendiri, dan menghindari eskalasi root yang tetap terbuka di pengaturan umum pada Debian 12 dan Ubuntu.

*31.10.2026*

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

Jika seseorang masuk ke server Anda dengan kunci curian atau kata sandi tebakan, momen login itu sering kali menjadi satu-satunya kesempatan Anda untuk menyadarinya. Setelah itu, mereka terlihat seperti pengguna lain. Push notification di ponsel untuk setiap sesi SSH memberi Anda momen itu: Anda either mengenali login tersebut, atau dalam hitungan detik Anda tahu ada yang tidak beres.

Ini adalah deteksi, bukan pencegahan. Ini tidak akan menghentikan siapa pun untuk masuk. Ini memastikan Anda mengetahuinya selagi Anda masih bisa bertindak.

Panduan ini memakai PAM, lapisan yang dilalui setiap login SSH. Panduan ini diuji di Debian 12 dan 13, Ubuntu 24.04, dan Rocky Linux 9, dengan API palsu yang mencatat setiap permintaan.

## Mengapa bukan /etc/profile, .bashrc, atau sshrc

Cuplikan yang paling sering disalin orang adalah pemanggilan `curl` di `/etc/profile`, `~/.bashrc`, atau `/etc/ssh/sshrc`. Kami menguji apa yang sebenarnya terlihat oleh masing-masing:

- **`/etc/profile`** hanya berjalan untuk shell login. Dalam pengujian kami, `ssh host cmd`, `scp`, `sftp`, `rsync`, dan `ssh -N` semuanya berhasil login tanpa menjalankannya.
- **`~/.bashrc`** dimiliki oleh pengguna. Siapa pun yang punya akun itu bisa mengubahnya, dan `ssh host bash --norc` melewatinya.
- **`/etc/ssh/sshrc`** lebih baik: ia berjalan untuk perintah, scp, sftp, dan rsync. Tetapi ia berjalan sebagai pengguna yang login, jadi kunci API harus bisa dibaca oleh setiap akun. Dan jika pengguna punya `~/.ssh/rc`, sshd menjalankan file itu sebagai gantinya dan `sshrc` tidak pernah dijalankan.
- **Tidak satu pun dari ketiganya melihat `ssh -N`.** Port forward atau proxy SOCKS lewat SSH tidak membuka shell, jadi tidak ada yang dijalankan.

Semua ini berjalan di dalam sesi, sebagai pengguna, setelah penyerang sudah berada di dalam. Hook PAM berjalan di dalam sshd, sebagai root, sebelum sesi dimulai.

## Bagaimana PAM melihat login SSH

Dengan `UsePAM yes` (default di keempat distribusi), sshd membuka sesi PAM tepat setelah autentikasi berhasil. Itu terjadi sebelum klien meminta shell, perintah, atau sftp. Jadi hook ini aktif untuk setiap koneksi yang terautentikasi, termasuk `ssh -N`, dan ia tidak bisa membedakan shell interaktif dari `rsync`: `PAM_TTY` hanya bernilai `ssh` meskipun Anda mendapat terminal. Koneksi multiplexed (`ControlMaster`) membuka satu sesi PAM, berapa pun perintah yang dijalankan lewatnya.

`pam_exec` menjalankan perintah pada titik itu. Berikut yang kami konfirmasi di mesin uji:

- Untuk sshd, perintah berjalan sebagai root.
- `pam_exec` menunggu perintah selesai, dan login ikut menunggu. `curl` yang lambat di sini berarti login yang lambat.
- Outputnya dialihkan ke `/dev/null` kecuali Anda menambahkan opsi `stdout`, sehingga tidak ada yang bisa bocor ke sesi.
- Lingkungannya adalah lingkungan PAM, bukan milik root. Tidak ada `PATH` di Debian maupun Rocky.

Ini variabel yang dipakai skrip:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Variabel</th><th>Contoh</th><th>Asalnya</th></tr></thead>
<tbody>
<tr><th><code>PAM_TYPE</code></th><td><code>open_session</code></td><td>Juga <code>close_session</code> saat logout</td></tr>
<tr><th><code>PAM_SERVICE</code></th><td><code>sshd</code></td><td>File PAM yang digunakan</td></tr>
<tr><th><code>PAM_USER</code></th><td><code>root</code></td><td>Akun yang login</td></tr>
<tr><th><code>PAM_RHOST</code></th><td><code>198.51.100.23</code></td><td>Alamat klien (berupa IP, dengan <code>UseDNS no</code> bawaan sshd)</td></tr>
<tr><th><code>SSH_AUTH_INFO_0</code></th><td><code>publickey ssh-ed25519 AAAA...</code></td><td>Diatur oleh sshd: metode dan kunci publik yang diterima</td></tr>
</tbody>
</table>
</div>

`SSH_AUTH_INFO_0` tersedia di setiap distribusi yang kami coba, tanpa `ExposeAuthInfo`. Artinya push notification bisa menyebut kunci yang dipakai, bukan hanya akunnya.

## Yang Anda butuhkan

- Server Linux yang menjalankan OpenSSH. Pastikan PAM aktif: `sudo sshd -T | grep -i usepam` seharusnya menampilkan `usepam yes`.
- `curl` dan `jq`: `sudo apt install curl jq`, atau `sudo dnf install jq` di Rocky, Alma, dan RHEL (curl sudah terpasang di sana).
- Aplikasi Pocket Alert di [iPhone atau Android](/get-app) dan kunci API dari [Kunci API](/account/apikeys). Buat kunci terpisah untuk setiap server, supaya Anda bisa mencabut satu tanpa mengganggu yang lain.

## Skripnya

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

Apa yang dilakukan skrip ini, dan alasannya:

- **Pemanggilan HTTP berjalan di latar belakang.** Skrip memulai `curl` dan langsung keluar, sehingga `pam_exec` berhenti menunggu. Dengan API yang merespons normal, setelah 4 detik, atau tidak sama sekali (alamat yang menjatuhkan paket), `ssh host true` memerlukan 0,15 sampai 0,36 detik setiap kali di Debian 12 dan Rocky 9. `curl` yang tidak bisa terhubung menyerah paling lama 15 detik, dan kegagalannya dicatat ke syslog sebagai `pa-ssh-login: push failed, curl exit code 7`.
- **Skrip selalu keluar dengan kode 0**, dan semua output dialihkan, sehingga sesi tidak melihat apa pun. Output login interaktif dan `ssh host cmd` sama persis dengan atau tanpa hook, kecuali waktu pada baris "Last login".
- **Kunci tidak pernah muncul di baris perintah.** `curl` membaca header `Token` dari standard input-nya (`-K -`). Argumen terlihat oleh setiap pengguna lokal lewat `ps`. Saat permintaan sedang menggantung, kunci tidak ada di `/proc/<pid>/cmdline` proses mana pun.
- **Nilai yang tidak tepercaya masuk ke JSON lewat `jq --arg`.** Kami menjalankan skrip dengan nama pengguna, alamat, layanan, dan info kunci yang penuh tanda kutip, backslash, baris baru, `$(id)`, karakter kontrol, dan UTF-8 yang tidak valid. Setiap body permintaan adalah JSON yang valid, dan tidak ada yang dieksekusi.
- **Tombol hanya ditambahkan untuk alamat IP.** API menolak seluruh pesan dengan `400` jika tombol `view` tidak berisi URL yang valid. `PAM_RHOST` yang aneh tetap seharusnya menghasilkan notifikasi, hanya tanpa tombol.
- **Pola dicocokkan per bagian.** `user@address` dipisah pada `@` terakhir, dan setiap sisinya dibandingkan sendiri. Jika digabung menjadi satu string, akun bernama `x@10.8.0.5` bisa cocok dengan `*@10.8.0.*` padahal terhubung dari mana saja.

Login dari alamat yang tidak dikenal akan masuk seperti ini, dengan prioritas `high`, sehingga tetap lolos dari Fokus di iPhone:

```
SSH login: root@web-1
From 198.51.100.23
Key: SHA256:iZtVU4EwMulogUeoneZkIXA9eeQfCvpyRB66QrrxBRA (ED25519)
```

Untuk melihat kunci mana itu, jalankan `ssh-keygen -lf ~/.ssh/authorized_keys` di server. Perintah ini menampilkan sidik jari yang sama, beserta komentarnya.

## File konfigurasi

Kunci disimpan dalam file yang hanya bisa dibaca root. Skrip menolak memuatnya kecuali file itu dimiliki root dengan mode `600`, karena skrip membacanya sebagai kode shell. Ketik kunci di prompt tersembunyi, agar tidak masuk ke riwayat shell Anda:

```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` berisi login yang Anda harapkan, dalam bentuk pola glob `user@address` yang dipisahkan spasi. Dalam contoh, setiap akun dari gerbang VPN Anda di `203.0.113.10` dianggap wajar, begitu juga `deploy` dari subnet CI. Notifikasinya masuk sebagai `low`: di feed, tanpa suara. Selebihnya memakai `PA_UNKNOWN_LEVEL`. Pada paket berbayar, Anda bisa mengaturnya ke `critical`, yang tetap berbunyi melewati saklar senyap dan Jangan Ganggu. Pada paket gratis, `critical` dikirim sebagai `high`. Lihat [tingkat prioritas](https://info.pocketalert.app/features/priority-levels.html) untuk perilaku setiap tingkat di iOS dan Android.

Pola berupa glob, bukan CIDR: `198.51.100.*` mencakup /24, dan rentang lain memerlukan lebih dari satu pola. Atur `PA_KNOWN_LEVEL=none` untuk tidak mengirim apa pun sama sekali untuk login yang diharapkan.

Hitung login Anda sebelum membiarkannya di `low`. Paket gratis mengizinkan 50 pesan per hari, dan setiap koneksi SSH adalah satu pesan. Job CI yang menjalankan `rsync` setiap 15 menit memakai 96 pesan. Berikan sumber seperti itu `none`, atau pindah ke paket berbayar. Setelah batas harian tercapai, API menolak pesan sampai pukul 00:00 UTC, dan itu termasuk login yang paling Anda perhatikan.

## Pasang ke PAM, di bagian atas

Bagian ini lebih penting daripada skripnya. Biarkan shell root terbuka di terminal lain selagi Anda mengubah PAM, supaya salah ketik tidak membuat Anda terkunci. sshd membaca file PAM-nya di setiap koneksi, jadi tidak ada yang perlu di-restart.

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

Di Debian, perintah terakhir menampilkan:

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

Itu menempatkan baris di atas baris `session` pertama, bukan di akhir file seperti yang dilakukan kebanyakan panduan. Alasannya ada di `/etc/pam.d/sshd` milik Debian 12 dan Ubuntu 24.04:

```
session    required     pam_env.so user_readenv=1 envfile=/etc/default/locale
```

`user_readenv=1` memuat variabel dari `~/.pam_environment` milik pengguna ke lingkungan PAM. Setiap baris `pam_exec` di bawahnya meneruskan variabel tersebut ke perintah yang dijalankannya. Halaman man `pam_exec` memberi peringatan tentang hal ini: "Commands called by pam_exec need to be aware of that the user can have control over the environment."

Kami memeriksa apa artinya di Ubuntu 24.04. Dengan hook di akhir file, pengguna biasa menulis `LD_PRELOAD /tmp/x.so` ke `~/.pam_environment` lalu login. Library itu dimuat ke dalam skrip root, dan ke setiap program yang dijalankan skrip itu, sebagai uid 0. Itu berarti shell root bagi siapa pun yang bisa login lewat SSH. Dengan hook di atas, variabel itu tidak ada. Debian 13 dan Rocky 9 tidak mengatur `user_readenv`, tetapi menempatkan hook di awal juga tidak merugikan di sana. Hal yang sama berlaku untuk baris `pam_exec` mana pun yang sudah Anda punya di bawah `pam_env`.

Opsi pada baris ini:

- **`optional`**: jika skrip hilang atau gagal, login tetap dilanjutkan. Kami mengganti nama skrip lalu login. Login berhasil, tanpa ada yang ditampilkan.
- **`type=open_session`**: `pam_exec` sama sekali tidak menjalankan skrip saat logout. Ini penting dengan alasan yang sama seperti posisinya: saat logout, `pam_env` sudah berjalan, dan dalam pengujian kami `LD_PRELOAD` dari `~/.pam_environment` kembali ada di lingkungan.
- **`quiet`**: jika perintah gagal, `pam_exec` tidak menampilkan kode keluarnya kepada pengguna.

Pada sistem keluarga RHEL, baris ini berakhir di atas `pam_selinux.so close`, sehingga berjalan dalam konteks SELinux milik sshd. Pengujian kami dilakukan di kontainer tanpa SELinux enforcing. Jika push tidak sampai di sistem dengan enforcing, periksa dengan `sudo ausearch -m avc -ts recent`.

Pembaruan paket bisa menggantikan `/etc/pam.d/sshd`, atau meninggalkan salinan `.dpkg-dist` atau `.rpmnew` di sebelahnya. Setelah memperbarui OpenSSH, pastikan baris itu masih ada.

## Uji

Anda bisa memanggil skrip secara manual, dengan cara yang sama seperti `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
```

Push dengan judul `SSH login: test@<hostname>` seharusnya sampai dalam beberapa detik, dengan `Method: unknown`, karena tidak ada login SSH sungguhan. Jika ingin melihat permintaannya terlebih dahulu, tambahkan `POCKETALERT_API_URL=http://<your test endpoint>` ke konfigurasi, dan hapus setelah selesai.

Lalu login dari tempat yang tidak ada di `PA_KNOWN`. Di mesin uji, masing-masing menghasilkan satu push: shell interaktif, `ssh host cmd`, `scp`, `sftp`, `rsync`, login dengan kata sandi, dan `ssh -N`.

## Opsional: su dan sudo

Skrip yang sama bisa melaporkan `su` dan `sudo`, lewat file PAM mereka masing-masing. Keduanya memerlukan satu opsi tambahan:

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

Tanpa `seteuid`, `pam_exec` menjalankan perintah dengan ID pengguna asli dari proses pemanggil. Untuk `su` dan `sudo`, itu adalah pengguna yang mengetik perintah, bukan root. Di mesin uji kami, skrip berjalan sebagai uid 1000, tidak bisa membaca file konfigurasi, dan tidak mengirim apa pun. Dengan `seteuid`, skrip berjalan sebagai root, dan push-nya terlihat seperti `sudo on web-1: alice as root`.

Untuk layanan ini, skrip mencocokkan `PA_KNOWN` dengan pengguna yang menjalankan perintah, dengan `local` sebagai alamatnya. `alice@local` membisukan `sudo` milik Alice sendiri. `root@local` membisukan skrip yang berjalan sebagai root dan berpindah ke pengguna lain dengan `su`, yang juga menghasilkan push.

Pikirkan volumenya sebelum menambahkan `sudo`. Setiap perintah `sudo` membuka sesi, sehingga setiap perintah menjadi satu push. Pada server tempat orang memakai `sudo` sepanjang hari, biasanya cukup memasang hook hanya pada `su`.

## Tombol

Pada paket berbayar, setiap push SSH memiliki dua [tombol aksi](/features/action-buttons): **Salin IP** menyalin alamat ke clipboard untuk aturan firewall atau pencarian log, dan **Cari IP** membukanya di ipinfo.io, sehingga Anda bisa melihat apakah itu provider Anda atau jaringan hosting di benua lain. Pada paket gratis, server menghapus tombol-tombol itu, dan push-nya tetap dikirim seperti biasa.

## Yang tidak tercakup

- **Login yang gagal.** Sesi PAM hanya dibuka setelah autentikasi berhasil. Penebakan kata sandi adalah tugas fail2ban, atau pemeriksaan log sshd di journal.
- **Apa pun setelah login.** Seseorang yang mendapatkan root bisa menghapus baris dari `/etc/pam.d/sshd`. Mereka tidak bisa membatalkan push untuk login yang membuat mereka masuk: permintaannya sudah dikirim sebelum shell mereka dimulai.
- **Login yang tidak melewati tumpukan PAM sshd.** Itu termasuk konsol lokal, layanan akses jarak jauh lainnya, dan sshd dengan `UsePAM no`.
- **Membedakan shell dari transfer file.** Seperti dijelaskan di atas, PAM belum mengetahuinya. Alamat dan kunci biasanya sudah cukup untuk membedakan job CI Anda dari orang sungguhan.

Itu mencakup momen ketika seseorang berhasil masuk. Untuk peristiwa server lain yang layak mendapat push, lihat [notifikasi keamanan](/use-cases/security-alerts).
