Aplikasi mobile masuk ke akun kampus Anda lewat REST API. Ia tidak pernah meminta password di dalam aplikasinya sendiri: login selalu berlangsung di halaman kampus yang dibuka di peramban, lalu aplikasi menerima token yang terikat ke satu perangkat dan satu peran.
Dua syarat dari admin kampus
- Sakelar REST API di Pengaturan Aplikasi → Fitur — bawaannya MATI. Bila tertulis Diblokir oleh pengelola layanan, sakelarnya terkunci dari pihak pengelola layanan dan tidak bisa dinyalakan dari kampus.
- Izin UseApi pada peran yang boleh memakai aplikasi, dicentang di 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 UseApi hanya membuka pintunya. Data dan aksi yang 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 kampus.
- Di aplikasi, pilih Tambah kampus, lalu pindai kode QR tersebut.
- Aplikasi membuka halaman login kampus di peramban. Masuk seperti biasa — password, Google, dan verifikasi dua langkah semuanya 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.
Bagian Perangkat & Token API hanya muncul bila REST API menyala dan akun Anda punya peran ber-izin UseApi (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.
- Masuk lewat validasi data alumni, tanpa password — pilih Ganti akun, lalu masuk dengan password akun Anda.
- Tidak ada peran yang diizinkan memakai aplikasi — admin kampus perlu mencentang UseApi 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 — termasuk reset password massal oleh admin. Semua aplikasi yang terhubung harus login ulang.
- Mematikan sakelar REST API tidak menghapus token, tetapi memblokir semuanya sampai sakelarnya dinyalakan lagi.
[Gambar — bagian Perangkat & Token API di Profil dengan kode QR Hubungkan aplikasi mobile]