Memulai
Panduan login, navigasi sidebar, role bawaan, dan pengaturan awal sebelum memakai Lenz.
Pengenalan
Halaman ini memandu Anda dari pertama kali membuka Lenz hingga siap menggunakan fitur-fiturnya. Anda akan mempelajari cara login, struktur navigasi sidebar berdasarkan grup fungsi, role bawaan yang menentukan apa yang Anda lihat, dan pengaturan awal yang biasanya perlu dicek admin sebelum sistem siap dipakai sehari-hari.
Anda perlu akun yang sudah di-provision oleh administrator untuk login. Hubungi admin sistem Anda jika belum punya kredensial. Lenz tidak menyediakan alur self-signup dari halaman login.
Login
Buka URL Lenz
Buka peramban dan akses URL Lenz Anda — misalnya https://lenz.example.com untuk deployment produksi, atau http://localhost:5173 untuk lingkungan pengembangan. Jika Anda dialihkan ke /login dengan parameter ?redirect_to=..., Lenz akan otomatis kembali ke halaman tersebut setelah login berhasil.
Pilih bahasa (opsional)
Tombol pemilih bahasa tersedia di pojok kanan atas halaman login. Bahasa yang dipilih juga ikut dipakai untuk dashboard setelah Anda masuk.
Masukkan kredensial
Isi field Username dan Password. Username dapat berupa username atau alamat email yang sudah didaftarkan admin.
Klik "Masuk"
Sistem memvalidasi kredensial via POST /api/auth/token, lalu mengambil profil dan role Anda. Jika berhasil, Lenz mengarahkan Anda ke halaman pertama yang bisa Anda akses berdasarkan permission role — bukan selalu Home.
Jika sebelumnya Anda dikeluarkan otomatis (idle timeout, sesi kedaluwarsa, atau security logout), halaman login menampilkan Logout Banner yang menjelaskan alasannya dan halaman terakhir Anda. Setelah login ulang, Lenz mencoba mengarahkan Anda kembali ke halaman tersebut.
Login via API key cocok untuk service-to-service, skrip otomatis, atau pengujian cepat tanpa sesi interaktif. Token yang dihasilkan mengikuti hak akses API key yang dipakai.
curl -X POST "${VITE_API_URL}/api/auth/token" \
-H "x-api-key: <YOUR_API_KEY>"Ganti <YOUR_API_KEY> dengan API key yang sudah di-generate di Administration → Configuration → API Key. Respons berisi access_token yang dipakai untuk request berikutnya. Detail lengkap ada di halaman Otentikasi.
Sesi & Auto-logout
Lenz memantau aktivitas Anda untuk menjaga keamanan. Default-nya:
| Kondisi | Default | Catatan |
|---|---|---|
| Idle timeout | 30 menit tanpa interaksi | Mouse, keyboard, scroll, dan tab focus dianggap aktivitas |
| Absolute timeout | 8 jam sejak login | Untuk membatasi sesi yang terlalu panjang |
| Warning sebelum logout | 2 menit terakhir | Dialog "Sesi Akan Berakhir" muncul dengan tombol Perpanjang Sesi |
Jika Anda tidak merespons saat dialog peringatan, Lenz otomatis logout dan menampilkan alasannya saat Anda kembali ke halaman login.
Ketiga durasi di atas dapat dikonfigurasi oleh admin. Jika Anda merasa terlalu sering keluar otomatis, hubungi admin untuk menyesuaikan kebijakan idle/absolute timeout di Preferences.
Navigasi Sidebar
Sidebar di sisi kiri layar adalah titik masuk utama ke semua fitur Lenz. Menu dikelompokkan ke dalam beberapa section berdasarkan fungsi. Menu yang tidak muncul di sidebar Anda berarti role Anda tidak punya permission untuk resource tersebut, atau feature flag-nya dimatikan oleh admin di Preferences — bukan berarti fitur tersebut tidak ada di sistem.
Kelompok Menu
Home
Halaman beranda. Untuk client tertentu (Lippo) diarahkan ke Video Analysis.
Streams
Streams Tag berbasis hierarki Site (federation only). Manajemen stream per node berada di halaman Streams.
Sites
Site Management — pengelompokan stream berdasarkan lokasi fisik. Untuk client divtik diberi label 'Units'.
Media
Media Servers (NVR), Video Management (rekaman), Video Analysis (analitik offline), dan Recording Playback.
Investigation
Face Investigation (Search, Database, Tracking, Logs), Plate Investigation, Event History, dan Alert Management.
Analytics
Statistics — agregasi event Face Recognition, LPR, People, Vehicle, dan Crowd.
Automation
Workflows — otomasi multi-langkah berbasis trigger event.
CES
Centralized Enrollment Service — Monitoring (master only) dan Configuration.
Gateway
Access Management (whitelisted IPs) dan Log History.
Administration
Configuration (User, API Key, Model API Key, License, Remotes, Notification, Credentials, Preferences, Retention, Extensions), Audit Logs, dan Monitoring → Resource.
Submenu Streams Tag dan Remotes hanya tampil saat Federation Mode aktif. Submenu License hanya tampil untuk superadmin atau client pack nodeflux. Submenu khusus client (VPN Account, Auto Search, Face Database — Interpol/Cekal) muncul sesuai feature flag dan client pack yang aktif.
Smart Navigation
Saat feature flag Smart Navigation aktif, sidebar memunculkan dua kemampuan tambahan:
- Search Trigger di bagian atas sidebar — buka command palette untuk lompat cepat ke halaman, stream, atau site dengan keyboard.
- Pinned & Recent — sematkan halaman favorit ke bagian atas sidebar; halaman yang baru diakses muncul di section Terbaru.
Role Bawaan & Permission
Setiap akun terikat ke satu Role. Role adalah kumpulan permission (read/create/update/delete) terhadap Resource seperti streams, events, enrollment_face, alert_rules, dan seterusnya. Role dibuat dan dikelola admin di Administration → Configuration → User Management.
Superadmin
Akses penuh ke semua resource, termasuk halaman License. Ditandai is_superadmin=true di database — tidak bisa dihapus.
Admin / Default Role
Role bawaan sistem (is_default=true) — tidak bisa dihapus, hanya bisa diedit. Biasanya punya akses CRUD penuh kecuali permission yang dibatasi superadmin.
Operator
Role custom umum: read pada streams, events, alert-history, search. Tidak bisa membuat alert rule atau enrollment. Aman untuk staff monitoring.
Custom Role
Dibuat sesuai kebutuhan. Admin bisa import/export role via CSV dan mengatur default homepage per role.
Lenz menerapkan default deny: aksi yang tidak secara eksplisit diizinkan akan ditolak dengan 403 Forbidden. Jika sebuah menu tidak muncul atau tombol tidak aktif, periksa permission role Anda.
Default Homepage
Setiap role dapat memiliki default homepage sendiri. Saat Anda login tanpa parameter redirect_to, Lenz mencoba urutan berikut:
- Halaman terakhir yang dicatat sebelum logout (
_vd_prev_url) default_homepagedari role Anda- Halaman pertama di sidebar yang punya permission
read
Pengaturan Awal yang Penting
Setelah login pertama, periksa beberapa hal berikut agar pengalaman Anda optimal.
Cek profil akun
Klik avatar di pojok kanan bawah sidebar, lalu pilih Account. Pastikan nama, email, dan avatar sudah benar. Halaman ini juga jadi tempat ganti password.
Atur tema & bahasa
Buka Administration → Configuration → Preference atau menu cepat di sidebar. Anda bisa memilih dark/light mode dan bahasa (Indonesian / English). Pilihan ini disimpan per akun.
Periksa Federation Mode (admin)
Toggle ada di Preferences → Feature → Federation Mode. Aktifkan jika Lenz Anda akan mengelola lebih dari satu instance backend. Nyalanya mengubah navigasi (memunculkan Streams Tag dan Remotes) dan menambahkan parameter instance ke setiap request API.
Verifikasi feature flag (admin)
Halaman Preferences punya banyak feature flag — Workflows, Notification, Media Server, Playback, Face/Plate Tracking, Extensions, dll. Aktifkan sesuai kebutuhan deployment.
Logout
Untuk keluar dari sesi:
- Klik avatar atau nama akun di pojok kanan bawah sidebar.
- Pilih Logout.
- Sistem merevoke token aktif via
POST /api/auth/logout— sesi tidak bisa dilanjutkan tanpa login ulang.
Selalu logout dari perangkat bersama. Lenz menyimpan token di encrypted localStorage, tetapi siapa pun yang akses fisik perangkat saat sesi aktif tetap bisa memakai dashboard.