# Setiap kejadian keamanan ke ponsel Anda.

> Dapatkan push notification saat ada login SSH, penggunaan sudo, dan pemblokiran fail2ban. Satu curl dari skrip login mengirim pengguna, IP sumber, dan aturan ke HP Anda dalam kurang dari satu detik.

<!-- source: https://pocketalert.app/id/use-cases/security-alerts -->

Terakhir diperbarui: 2026-08-11

Ketika sesuatu menyentuh server Anda — login SSH, pemblokiran fail2ban, atau aturan CrowdSec maupun auditd — pengguna, IP sumber, dan aturan akan sampai ke ponsel Anda dalam waktu kurang dari satu detik. Ketahui siapa yang login sebelum mereka selesai mengetik.

## Tiga langkah menuju notifikasi login

1. **Dapatkan kunci API** — Buat kunci API dan aplikasi per host, lalu simpan kunci tersebut di variabel lingkungan pada server.
2. **Kaitkan kejadiannya** — Tambahkan curl ke skrip login, aksi fail2ban, atau aturan IDS Anda yang mengirim pengguna dan IP sumber.
3. **Pantau server Anda** — Login dan pemblokiran akan sampai ke ponsel Anda dalam satu detik. Letakkan kejadian di judul agar login root dari IP baru terlihat jelas berbeda dari deploy rutin.

## Dari login ke push notification

Hubungkan setiap pemicu login, pemblokiran, atau aturan ke satu curl dan kejadian akan sampai ke ponsel Anda sebagai push notification.

- **Push notification login SSH** — Skrip login di /etc/profile.d atau sshrc menjalankan curl ke Pocket Alert dengan pengguna dan IP sumber pada setiap sesi interaktif.
- **Pemblokiran fail2ban** — fail2ban menjalankan curl di actionban-nya, sehingga setiap IP yang diblokir muncul di ponsel Anda beserta jail yang menangkapnya.
- **sudo dan login admin** — Hook PAM atau pemicu sudo aktif saat seseorang meningkatkan hak akses, dan login admin baru akan masuk dengan cara yang sama.
- **Pemicu IDS dan audit** — CrowdSec, Wazuh, OSSEC, dan auditd menjalankan curl saat aturan cocok.
- **Pemetaan field** — Pemetaan field GJSON mengambil pengguna, IP sumber, dan aturan dari payload SIEM ke dalam judul dan pesan.
- **Pengiriman di bawah satu detik** — Notifikasi tiba dalam waktu jauh di bawah satu detik, cukup cepat untuk menangkap sesi saat masih terbuka.

## Notifikasi untuk setiap login

### 1. Dapatkan kunci API

Buat aplikasi di Pocket Alert dan salin kunci API Anda. Kirimkan di header `Token`. Berikan setiap host aplikasinya sendiri agar server prod, bastion, dan pribadi tetap berada di saluran terpisah.

### 2. Login SSH (sshrc atau /etc/profile.d)

Letakkan skrip di `/etc/profile.d` agar setiap login interaktif menjalankan curl ke API pesan dengan pengguna dan IP sumber dari `$SSH_CONNECTION`:

```
# /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. Pemblokiran fail2ban (aksi kustom)

Tambahkan aksi di `/etc/fail2ban/action.d/pocketalert.conf` dan rujuk dari jail. fail2ban akan mengganti `<ip>` dan `<name>` pada setiap pemblokiran:

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

Untuk SIEM atau IDS yang mengeluarkan JSON (Wazuh, CrowdSec), buat webhook dengan template `message` GJSON yang memetakan payload-nya, lalu arahkan alat ke URL penerima:

```
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"}'
```

Anda akan mendapatkan `https://p4a.me/wh/1234abcd` untuk ditempel ke pengaturan integrasi alat tersebut.

Lihat [dokumentasi pengaturan webhook](https://info.pocketalert.app/api/webhooks/settings.html) untuk API pesan dan pemetaan field GJSON.

## FAQ

### Bagaimana cara mendapatkan notifikasi untuk setiap login SSH?

Letakkan skrip kecil di /etc/profile.d yang menjalankan curl ke Pocket Alert dengan $USER dan IP dari $SSH_CONNECTION. Setiap login interaktif kemudian akan mengirim notifikasi push ke ponsel Anda.

### Bisakah fail2ban mengirim push notification ke saya?

fail2ban menjalankan curl di actionban-nya. Petakan IP yang diblokir dan jail ke dalam isi pesan, dan Anda akan melihat setiap pemblokiran saat terjadi.

### Bagaimana cara membedakan login yang mendesak dari yang rutin?

Letakkan kejadian di judul agar mudah dibaca sekilas: login root dari IP baru dan login rutin pengguna deploy akan muncul sebagai notifikasi yang jelas berbeda. Berikan host sensitif aplikasinya sendiri agar tetap terpisah.

### Apakah ini bisa dipakai dengan CrowdSec, Wazuh, atau auditd?

Bisa. CrowdSec, Wazuh, OSSEC, dan auditd semuanya dapat menjalankan curl saat terjadi pemicu. Pemetaan field GJSON akan memasukkan pengguna, IP sumber, dan aturan ke dalam judul dan pesan.

### Bagaimana cara memisahkan notifikasi per server?

Berikan setiap host aplikasinya sendiri: prod, bastion, pribadi. Saluran per aplikasi menjaga notifikasi tetap terpisah sehingga Anda tahu server mana yang memicu peringatan. Pocket Alert hanya meneruskan kejadian; ini bukan IDS.

### Bisakah login root menembus mode senyap pada pukul 3 pagi?

Bisa. Tambahkan "level":"critical" ke curl dan notifikasi Android akan dikirim ke saluran notifikasi khusus yang melewati Jangan Ganggu. Anda hanya perlu memberikan akses DND sekali. Di iPhone, level high dan critical akan datang sebagai notifikasi sensitif waktu yang tetap tembus mode Fokus. Untuk login rutin pengguna deploy, gunakan level silent: tanpa suara atau getaran, tetapi tetap tersimpan di riwayat saat Anda membutuhkan jejak audit. Di paket gratis, critical dikirim sebagai high: tetap instan, hanya tanpa penggantian DND.
