Pemecahan masalah

Solusi berdasarkan gejala untuk masalah Door & Gate Access yang paling umum. Setiap entri mengikuti urutan gejala → penyebab → penyelesaian. Untuk arti status atau alasan penolakan apa pun, lihat Referensi; untuk logika keputusan yang mendasarinya, lihat Cara keputusan akses bekerja.

Mulailah dengan Access Logs. Hampir setiap laporan "tidak bisa masuk" memiliki peristiwa yang ditolak di Access Logs dengan alasan persisnya. Cari nama anggota, lihat peristiwa ditolak yang paling baru, lalu buka bagian yang sesuai di bawah ini.

Pintu menampilkan Luring

Gejala: Kartu pintu menampilkan Luring, anggota melihat "Door offline", dan perintah buka kunci tidak dapat dikirim.

Penyebab: Pengontrol pintu tidak melapor selama lebih dari 5 menit — daya atau jaringan di perangkat terputus.

Penyelesaian:

1. Periksa apakah pengontrol mendapat daya dan memiliki koneksi jaringan (kabel Ethernet / Wi-Fi) — halaman Pemecahan Masalah Perangkat Keras membahas pemeriksaan di lokasi (LED indikator, splitter PoE, kabel, SIM/antena pada model 4G).
2. Buka panel pintu → tab Overview untuk melihat Status (terakhir terlihat), IP address, dan waktu aktif — "terakhir terlihat" yang baru menunjukkan jaringan yang terputus-putus, bukan perangkat yang mati.
3. Matikan lalu nyalakan kembali pengontrol jika perlu.
4. Untuk diagnostik yang lebih mendalam, ikuti Open in Device Management for advanced configuration.
5. Jika beberapa pintu luring secara bersamaan, curigai jaringan/internet lokasi, bukan perangkatnya.

Selama pintu luring, anggota melihat detail kontak dukungan di dasbor mereka (dalam mode default Smart), sehingga mereka dapat menghubungi Anda.

Anggota ditolak — "You don't have access to this door"

Gejala: Peristiwa ditolak dengan alasan no_matching_policy_or_grant.

Penyebab: Tidak ada jalur tambahan yang mengizinkan mereka: tidak ada Access Policy aktif yang cocok dengan Who DAN Where DAN When, dan tidak ada pemberian akses permanen atau jendela administrator/integrasi aktif yang mencakup pintu tersebut.

Penyelesaian:

1. Buka anggota di Users dan bandingkan jenis orang, status keanggotaan, serta tag tersinkronisasi/khusus dengan Who pada kebijakan.
2. Periksa apakah Where mencakup pintu tersebut secara langsung, melalui Access Scope, atau melalui semua pintu fasilitas, dan tidak ada pengecualian yang menghapusnya.
3. Periksa When: Anytime, atau setidaknya satu jendela Weekly/One-time yang aktif. Waktu akhir bersifat eksklusif.
4. Ingat bahwa kebijakan digabungkan dengan OR, tetapi setiap kebijakan memerlukan Who DAN Where DAN When. Kecocokan sebagian tidak pernah memberikan akses.
5. Jika sesuai, gunakan pemberian akses permanen atau jendela administrator terpisah; keduanya tetap bersifat tambahan.

Anggota ditolak — "Your access has been suspended"

Gejala: Peristiwa ditolak dengan alasan access_disabled; pengguna menampilkan lencana Disabled.

Penyebab: Akses pengguna dinonaktifkan. Hal ini terjadi secara manual (admin menonaktifkan Access enabled) atau secara otomatis (anggota dihapus di integrasi dan panel menampilkan Removed by integration, atau mereka dihapus secara lunak).

Penyelesaian: Buka pengguna dan aktifkan kembali Access enabled — atau, jika mereka menampilkan Removed by integration, pulihkan mereka di sistem sumber (atau lepaskan baris tersebut dan aktifkan akses secara manual).

Kebijakan terjadwal tidak memberikan akses

Gejala: Aplikasi menampilkan ketersediaan di masa mendatang atau log berisi outside_access_time_window; jendela sumber tampak Stale atau Unmapped; atau akses berubah pada waktu yang tidak terduga.

Penyelesaian:

1. Pastikan kebijakan diaktifkan.
2. Periksa Who dan Where pada kebijakan yang sama sebelum menyelidiki jadwal When-nya.
3. Untuk jendela One-time, bandingkan upaya dengan [from, to). Zona waktu yang ditampilkan tidak dapat menggeser waktu yang disimpan.
4. Untuk jendela Weekly, periksa zona waktu IANA, hari/blok lokal, batas aktif opsional, dan peralihan waktu musim panas. Waktu akhir bersifat eksklusif dan blok semalam harus dipisah.
5. Gunakan policyId dan policyName di Access Log untuk memverifikasi kebijakan bernama mana yang dievaluasi.
6. Pastikan blockAllAccess, Force closed, penonaktifan pengguna, geofence, dan status pengontrol tidak lebih diutamakan.

Untuk jendela integrasi terpisah, verifikasi juga pemetaan cakupan logis, revisi sumber, usia sumber, dan kesehatan pengiriman. Jendela sumber yang tidak dikenal, tidak dipetakan, atau usang tidak memberikan akses, tanpa menghapus jalur Access Policy atau pemberian akses permanen.

Klien lama dapat menampilkan Outside hours karena alasan kompatibilitasnya adalah outside_access_hours; Access Log dan klien yang lebih baru menggunakan detail outside_access_time_window.

Penolakan geofence — "Move closer" dan sejenisnya

Gejala: Peristiwa ditolak dengan alasan outside_geofence, gps_too_imprecise, atau location_unavailable.

Dialog detail peristiwa yang ditolak menampilkan koordinat, akurasi, dan jarak yang dilaporkan — sangat berguna untuk menilai apakah anggota benar-benar berada di lokasi.

Perintah buka kunci terkirim tetapi pintu tidak terbuka (Timed out / Failed)

Gejala: Peristiwa berakhir dengan Timed out atau Failed, bukan Confirmed unlocked.

Penyebab: Perintah mencapai server tetapi pengontrol tidak mengonfirmasi — konektivitas di pintu tidak stabil, atau ada kerusakan perangkat.

Penyelesaian:

1. Periksa status daring dan info perangkat pintu (tab Overview). Pola waktu habis yang berulang pada satu pintu menunjukkan masalah pada jaringannya.
2. Coba Unlock door sebagai admin dari panel sambil mengamati pintu.
3. Gunakan Identify device (tiga bunyi bip) untuk memastikan Anda secara fisik berada di pengontrol yang benar.
4. Jika relai berbunyi klik tetapi pintu tidak terlepas, kerusakannya ada di sirkuit kunci — jalankan pengujian jumper dan multimeter di Pemecahan Masalah Perangkat Keras.
5. Eskalasikan melalui diagnostik Manajemen Perangkat jika perangkat daring tetapi tidak bekerja.

Periksa juga Maintenance mode — pintu dengan Force closed memang tetap terkunci bagi anggota. Block all access at this door menetapkan blockAllAccess secara eksplisit dan menolak setiap kebijakan anggota, pemberian akses permanen, dan Access Time Window.

Jika pengontrol daring tetapi berhenti merespons secara normal, Remotely reboot device (panel pintu → Configuration → Advanced) akan memulai ulang perangkat. Pintu mempertahankan status kuncinya saat ini dan luring selama satu atau dua menit saat perangkat menyala.

Anggota tidak dapat masuk ke aplikasi

Gejala: "No record found" pada langkah Send code.

Penyebab: Nomor telepon/email yang mereka ketik tidak cocok dengan catatan Users mana pun.

Penyelesaian: Temukan baris mereka di Users dan bandingkan pengenal secara persis — format nomor yang berbeda, email lama, atau pengenal yang tidak ada adalah penyebab yang biasa. Perbarui baris tersebut (atau minta anggota menggunakan pengenal yang tercatat). Ingat bahwa setiap baris memerlukan setidaknya satu nomor telepon/email.

Gejala: "Too many attempts."

Penyebab: Pembatasan laju — 5 permintaan kode per jam per kontak, ditambah batas di tingkat jaringan.

Penyelesaian: Tunggu hingga batas berakhir; batas per kontak merupakan langkah keamanan dan tidak dapat dicabut.

Masalah undangan

Lihat tabel khusus di Undangan → Pemecahan masalah. Ringkasan cepat: Send failed → periksa alamat dan kirim ulang; tidak disertakan dalam pengiriman massal → mereka sudah diundang, sudah menggunakan aplikasi, tidak memiliki email, atau tidak memiliki akses.

Pengguna tersinkronisasi tidak ada atau tidak mutakhir

Gejala: Seseorang ada di sistem anggota Anda tetapi tidak ada di Users; atau detailnya sudah usang.

Penyelesaian:

1. Periksa Settings → Sync settings — apakah sumbernya diaktifkan? Apakah integrasi tertentu tersebut diaktifkan? Jika kartu menampilkan N removals held back for review, ada penghapusan besar yang menunggu tinjauan admin.
2. Perluas Sync activity & troubleshooting dan cari orang tersebut — alasan dilewati memberi tahu Anda secara persis penyebabnya (pengenal tidak ada, terlepas, integrasi nonaktif, dll.). Lihat tabel alasan dilewati.
3. Periksa tombol Track source updates pengguna — baris yang terlepas tidak pernah diperbarui dari sumber.
4. Jika baris menampilkan Not synced – duplicate, ada catatan lain yang memiliki email atau nomor telepon yang sama. Lihat Penyelesaian duplikat.
5. Gunakan Sync now untuk memaksa proses sinkronisasi alih-alih menunggu sinkronisasi penuh harian.
6. Untuk Access Time Windows, periksa juga usia sumber, hasil revisi (updated/idempotent/stale/conflict), dan pemetaan scope_key. Pengambilan yang gagal harus membiarkan snapshot sebelumnya tidak berubah, bukan menghapusnya.

Jadwal buka kunci otomatis tidak membuka pintu

Gejala: Pintu tidak tetap terbuka selama jendela terjadwalnya.

Penyelesaian:

1. Buka tab Schedule pintu dan pastikan Auto-unlock aktif. Periksa pratinjau Next 14 days untuk mengetahui kapan pintu seharusnya terbuka.
2. Dengan Jam Kehadiran Staf Fasilitas, periksa jam berstaf dan jam libur fasilitas di Konfigurasi Fasilitas & Sistem. Pada hari libur nasional, On public holidays menentukan apakah pintu mengikuti jam libur, tetap terkunci, atau mengabaikan hari libur tersebut.
3. Dengan Custom schedule, periksa apakah hari tersebut benar-benar memiliki blok waktu.
4. Periksa apakah staf menggunakan Lock now: kartu menampilkan Locked by staff until HH:MM. Resume schedule mengembalikan jadwal.
5. Ingat bahwa perubahan jadwal baru berlaku setelah disimpan, yang memuat ulang pengontrol (biasanya 10–15 detik).
6. Maintenance mode lebih diutamakan — pintu dengan Force closed tidak akan terbuka otomatis.
7. Waktu menggunakan zona waktu fasilitas — verifikasi pengaturan zona waktu fasilitas jika jendela aktif pada jam yang aneh.

Admin mengubah pengaturan tetapi tidak terjadi apa-apa

Gejala: Kebijakan/geofence/pesan telah diedit tetapi tidak berpengaruh.

Penyebab: Perubahan di tab Settings tidak diterapkan hingga Save changes diklik di bilah simpan; keluar dari halaman akan menawarkan untuk membuang perubahan tersebut.

Penyelesaian: Terapkan ulang lalu simpan. Perubahan kebijakan dan geofence digunakan oleh upaya otorisasi berikutnya; pengaturan di sisi aplikasi muncul saat aplikasi anggota dimuat ulang berikutnya.

Halaman terkait

• Pemecahan Masalah Perangkat Keras — diagnostik daya, relai, dan pengkabelan kunci
• Access Logs
• Jadwal Access Policy
• Referensi — semua alasan penolakan dan nilai default
• Pertanyaan umum