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

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/profilehanya berjalan untuk shell login. Dalam pengujian kami,ssh host cmd,scp,sftp,rsync, danssh -Nsemuanya berhasil login tanpa menjalankannya.~/.bashrcdimiliki oleh pengguna. Siapa pun yang punya akun itu bisa mengubahnya, danssh host bash --norcmelewatinya./etc/ssh/sshrclebih 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 dansshrctidak 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_execmenunggu perintah selesai, dan login ikut menunggu.curlyang lambat di sini berarti login yang lambat.- Outputnya dialihkan ke
/dev/nullkecuali Anda menambahkan opsistdout, sehingga tidak ada yang bisa bocor ke sesi. - Lingkungannya adalah lingkungan PAM, bukan milik root. Tidak ada
PATHdi Debian maupun Rocky.
Ini variabel yang dipakai skrip:
| Variabel | Contoh | Asalnya |
|---|---|---|
PAM_TYPE | open_session | Juga close_session saat logout |
PAM_SERVICE | sshd | File PAM yang digunakan |
PAM_USER | root | Akun yang login |
PAM_RHOST | 198.51.100.23 | Alamat klien (berupa IP, dengan UseDNS no bawaan sshd) |
SSH_AUTH_INFO_0 | publickey ssh-ed25519 AAAA... | Diatur oleh sshd: metode dan kunci publik yang diterima |
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 usepamseharusnya menampilkanusepam yes. curldanjq:sudo apt install curl jq, atausudo dnf install jqdi Rocky, Alma, dan RHEL (curl sudah terpasang di sana).- Aplikasi Pocket Alert di iPhone atau Android dan kunci API dari Kunci API. Buat kunci terpisah untuk setiap server, supaya Anda bisa mencabut satu tanpa mengganggu yang lain.
Skripnya
#!/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
Apa yang dilakukan skrip ini, dan alasannya:
- Pemanggilan HTTP berjalan di latar belakang. Skrip memulai
curldan langsung keluar, sehinggapam_execberhenti menunggu. Dengan API yang merespons normal, setelah 4 detik, atau tidak sama sekali (alamat yang menjatuhkan paket),ssh host truememerlukan 0,15 sampai 0,36 detik setiap kali di Debian 12 dan Rocky 9.curlyang tidak bisa terhubung menyerah paling lama 15 detik, dan kegagalannya dicatat ke syslog sebagaipa-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 cmdsama persis dengan atau tanpa hook, kecuali waktu pada baris "Last login". - Kunci tidak pernah muncul di baris perintah.
curlmembaca headerTokendari standard input-nya (-K -). Argumen terlihat oleh setiap pengguna lokal lewatps. Saat permintaan sedang menggantung, kunci tidak ada di/proc/<pid>/cmdlineproses 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
400jika tombolviewtidak berisi URL yang valid.PAM_RHOSTyang aneh tetap seharusnya menghasilkan notifikasi, hanya tanpa tombol. - Pola dicocokkan per bagian.
user@addressdipisah pada@terakhir, dan setiap sisinya dibandingkan sendiri. Jika digabung menjadi satu string, akun bernama[email protected]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:
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 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 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.
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_execsama sekali tidak menjalankan skrip saat logout. Ini penting dengan alasan yang sama seperti posisinya: saat logout,pam_envsudah berjalan, dan dalam pengujian kamiLD_PRELOADdari~/.pam_environmentkembali ada di lingkungan.quiet: jika perintah gagal,pam_exectidak 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:
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:
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: 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.