Device Session Management
Demi menjaga keamanan akun pengguna dari aktivitas akses yang tidak sah, Frog Cloud mencatat semua sesi masuk (login sessions) dari berbagai perangkat (seperti Browser Web atau Mobile App). Pelanggan dapat memantau perangkat mana saja yang sedang aktif menggunakan akun mereka dan mengatur batas maksimal perangkat yang boleh terhubung secara bersamaan.
1. Memantau Sesi Aktif
Aplikasi Frontend dapat menampilkan tabel berisi histori perangkat yang saat ini masih memiliki akses (sesi JWT aktif) ke dalam akun pengguna.
GET /api/auth/device-session
Respons (200 OK):
{
"data": [
{
"id": 1,
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
"ip_address": "192.168.1.1",
"last_active": "2026-05-06T10:00:00Z"
}
],
"total": 1,
"max_session": 5
}
Informasi ini sangat berguna bagi Customer untuk mendeteksi apakah ada orang tak dikenal yang sedang menggunakan akun mereka.
2. Mengubah Batas Sesi Bersamaan (Max Session)
Secara bawaan (default), setiap pelanggan memiliki limit sesi bersamaan maksimal sebanyak 5 perangkat. Jika pelanggan mencoba login dari perangkat ke-6, sesi dari perangkat yang paling lama (tertua) akan otomatis diputus atau ditendang (force logout).
Namun, pelanggan memiliki kebebasan untuk mengubah limit perlindungan sesi ini, misalnya diatur menjadi 1 jika mereka ingin mode keamanan maksimal (hanya boleh login di satu layar/perangkat pada waktu tertentu).
PATCH /api/auth/device-session/update
Content-Type: application/json
{
"max_session": 3
}
Respons (200 OK): Batas maksimal perangkat yang diizinkan telah diperbarui menjadi 3. Jika saat ini pengguna memiliki 5 sesi aktif, maka 2 sesi paling tua akan langsung dihentikan oleh sistem.