Aplikasi mobile masuk ke akun LSP Anda lewat REST API. Ia tidak pernah meminta password di dalam aplikasinya sendiri: login selalu berlangsung di halaman NeoSerti yang dibuka di peramban, lalu aplikasi menerima token yang terikat ke satu perangkat dan satu peran.
Yang sudah tersedia pada versi ini
REST API NeoSerti baru menyediakan fondasinya: login aplikasi, memilih peran, memperbarui token, dan mencabut perangkat. Data LSP — skema, asesmen, jadwal — belum bisa dibuka lewat aplikasi. Bagian ini menjelaskan cara menyiapkan dan mengamankan sambungannya.
Dua syarat dari admin LSP
- Saklar Feature Api di Pengaturan → Pengaturan Aplikasi, tab Fitur — bawaannya MATI. Bila keterangannya menyebut Diblokir oleh pengelola layanan, saklarnya terkunci dari pihak pengelola layanan dan tidak bisa dinyalakan dari LSP.
- Izin Use Api pada peran yang boleh memakai aplikasi, dicentang di Pengaturan → Role & Hak Akses, tab Custom. Tidak ada peran yang mendapatkannya secara bawaan. Token terikat ke SATU peran: hanya peran bercentang yang bisa dipilih saat menghubungkan aplikasi, dan mencabut centangnya langsung mematikan semua token peran itu.
Izin Use Api hanya membuka pintunya. Apa yang kelak terjangkau lewat aplikasi tetap ditentukan izin lain milik peran itu — sama seperti di panel.
Menghubungkan aplikasi
- Buka Profil dari menu akun, lalu bagian Perangkat & Token API. Di sana ada Hubungkan aplikasi mobile berisi kode QR dan alamat LSP Anda.
- Di aplikasi, pilih tombol untuk menambah lembaga, lalu pindai kode QR tersebut — atau ketik alamat yang tertera di bawahnya.
- Aplikasi membuka halaman login NeoSerti di peramban. Masuk seperti biasa — password, masuk dengan Google bila lembaga Anda memakainya, dan verifikasi dua langkah tetap berlaku.
- Pilih peran di bawah Masuk sebagai. Persetujuan ini selalu butuh satu klik, walau Anda hanya punya satu peran. Batal menolak permintaan aplikasi; Ganti akun keluar dari akun yang sedang terbuka di peramban.
Sesudah itu peramban mengembalikan Anda ke aplikasi lewat alamat app.neoserti.com. Alamat itu milik aplikasi NeoSerti, bukan alamat LSP Anda — yang Anda ketik saat menghubungkan tetap alamat yang tertera di Profil.
Bagian Perangkat & Token API hanya muncul bila REST API menyala dan akun Anda punya peran ber-izin Use Api (atau masih punya token).
Kalau login aplikasi ditolak
Halaman Login aplikasi tidak dapat dilanjutkan selalu menyebut sebabnya, dan tombol Kembali ke aplikasi mengembalikan Anda ke aplikasi. Sebab yang mungkin:
- Sedang impersonate — akhiri impersonate dulu, lalu login dengan akun Anda sendiri.
- Tidak ada peran yang diizinkan memakai aplikasi — admin LSP perlu mencentang Use Api pada peran Anda.
- Akun Super Admin dan akun nonaktif memang tidak bisa dipakai untuk login aplikasi.
Mencabut perangkat
Bagian Perangkat & Token API mendaftar setiap perangkat yang terhubung beserta perannya, kapan terakhir dipakai, dan kapan kedaluwarsa (token berumur sekitar 30 hari). Ponsel hilang? Tekan Cabut pada perangkat itu, atau Cabut semua perangkat. Perangkat yang dicabut harus login ulang. Mencabut tidak meminta password, dan tidak tersedia selama impersonate.
Dua hal yang mencabut token tanpa ditanya
- Setiap penggantian atau reset password mencabut SEMUA token akun itu. Semua aplikasi yang terhubung harus login ulang.
- Mematikan saklar Feature Api tidak menghapus token, tetapi memblokir semuanya sampai saklarnya dinyalakan lagi.
[Gambar — bagian Perangkat & Token API di Profil dengan kode QR Hubungkan aplikasi mobile]