Sinkronisasi & Integrasi
Di halaman ini
Sinkronisasi mencerminkan orang dari sistem Anda yang lain ke Users secara otomatis, sehingga akses pintu mengikuti data sumber eksternal tanpa entri manual. Halaman ini membahas tiga sumber sinkronisasi, sinkronisasi staf Performance Hub, pengenal, Access Time Windows milik sumber, kesegaran data dan pemetaan cakupan, penghapusan, penyelesaian duplikat, panel aktivitas sinkronisasi, undangan, dan penghapusan massal. Konfigurasikan semuanya di Settings → Sync settings.
Sinkronisasi Performance Hub staff aktif secara default. Sinkronisasi integrasi dan Computer Vision nonaktif secara default agar fasilitas yang sudah ada tetap mempertahankan daftar yang dikelola secara manual; tidak ada yang disinkronkan dari sumber tersebut hingga Anda mengaktifkannya.
Sumber sinkronisasi


Gambar 1: Sync settings
| Sumber | Yang dicerminkan | Lencana sumber pengguna yang dihasilkan |
|---|---|---|
| Performance Hub staff | Pengguna Performance Hub yang perannya mencakup fasilitas ini | Performance Hub staff |
| Integrations | Anggota dan, jika didukung, Access Time Windows milik sumber dari integrasi yang terhubung | Integration / nama mitra |
| Performance Hub features (CCTV/Computer Vision) | Orang yang teridentifikasi dari modul CCTV | CCTV/Computer Vision |
Setiap blok memiliki tombol pengaktifnya sendiri dan menampilkan waktu proses terakhir serta jumlahnya (atau Never run).
Untuk sumber Integrations, Anda juga dapat menyertakan atau mengecualikan integrasi satu per satu di Sync from these integrations — "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations menampilkan daftar lengkapnya.
Mewajibkan pengenal
Orang masuk ke aplikasi seluler dengan kode sekali pakai yang dikirim ke ponsel atau email mereka, sehingga catatan tanpa keduanya tidak berguna untuk akses pintu. Dropdown Require identifier mengontrol catatan mana yang disinkronkan:
| Opsi | Catatan yang disinkronkan |
|---|---|
| Email OR phone (default) | Memiliki email atau nomor telepon |
| Email required | Memiliki email |
| Phone required | Memiliki nomor telepon |
| Both required | Memiliki keduanya |
Catatan yang tidak memenuhi persyaratan akan dilewati (dan muncul di panel aktivitas sinkronisasi sebagai dilewati karena pengenal tidak ada).
Pemetaan Access Time Window dan kesegaran sumber
Setiap integrasi yang menyediakan Access Time Windows memiliki pengaturannya sendiri:
- Access Time Window mapping — "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Setiap integrasi dapat memiliki hingga 50 pemetaan, termasuk kunci
default. Tambahkan kunci di Add partner scope key. - Source freshness policy — pengaturan keamanan: "Choose how old a partner snapshot may be before all of its windows fail closed." Sesuaikan dengan seberapa sering integrasi berjanji mengirim pembaruan, sehingga jendela dari integrasi yang telah berhenti memperbarui tidak terus memberikan akses.
Lihat Snapshot Access Time Window untuk cara jendela integrasi diperbarui.
Staf Performance Hub


Gambar 2: Sumber Performance Hub staff
"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Misalnya, staf toko di jaringan ritel mendapatkan akses ke pintu area belakang tanpa ada yang menambahkan mereka secara manual.
- Staf (pengguna Performance Hub) disinkronkan dengan tag Performance Hub staff, Role: … (satu per peran) dan, untuk admin organisasi, Organisation admin.
- Access Policy Performance Hub staff yang dapat diedit dibuat satu kali per fasilitas dan mengizinkan tag tersebut melewati setiap pintu kapan saja. Kartunya menunjukkan apakah kebijakan aktif, dengan Edit policy. Edit atau nonaktifkan seperti Access Policy lainnya.
- Roles menunjukkan peran mana yang disertakan. Peran yang disertakan atau dikecualikan diatur oleh admin organisasi di Organisation Settings; admin lain melihat "Ask an organisation admin to change this in Organisation Settings."
- Menonaktifkan sinkronisasi memerlukan konfirmasi ("Turn off Performance Hub staff sync?").
Detail staf dikelola di IAM Performance Hub dan bersifat hanya-baca di Users. Untuk menghentikan akses pintu seorang anggota staf, lihat Users → Staf Performance Hub.
Kapan sinkronisasi berjalan
| Pemicu | Kapan |
|---|---|
| Continuous | Perubahan staf Performance Hub dan perubahan yang dikirim dari integrasi yang terhubung biasanya disinkronkan secara real-time |
| Daily full sync | "A full reconcile also runs automatically every day to catch any inconsistencies." Next full sync menunjukkan kapan sinkronisasi berikutnya berjalan |
| Sync now | Tombol di halaman ini menarik data terbaru dari integrasi Anda, lalu merekonsiliasinya ke Users — tombol menampilkan Running… lalu Sync complete (atau Sync failed) |
Apa yang diperbarui sinkronisasi — dan apa yang tidak pernah disentuhnya
Pada setiap proses, baris yang disinkronkan diperbarui dari sumbernya:
| Ditimpa setiap sinkronisasi | Dipertahankan (milik admin) |
|---|---|
| Nama depan, nama belakang | Sakelar Access enabled |
| Ponsel, email | Additional permanent access |
| Jenis orang, status keanggotaan | Custom tags |
| Tag yang disinkronkan | Notes |
| Stempel waktu sinkronisasi terakhir | Status terlepas, pesan aplikasi |
| Access Time Windows milik sumber untuk sumber tersebut | Pemberian akses permanen dan Access Time Windows milik administrator |
Jadi Anda dapat dengan aman menonaktifkan pengguna yang disinkronkan, memberikan akses kepada mereka, atau memberi mereka tag — sinkronisasi tidak akan membatalkannya.
Pelepasan: menonaktifkan Track source updates pada panel pengguna membuat sinkronisasi melewati baris tersebut sepenuhnya — perubahan pada nama/detail kontak tetap berlaku, dan penghapusan di sumber tidak lagi memengaruhinya. Lihat Users.
Untuk sumber yang menyediakan Access Time Windows, pelepasan juga menghapus jendela dari sumber tersebut setelah konfirmasi eksplisit. Menautkan kembali akan memulihkannya pada snapshot lengkap berikutnya yang berhasil; tindakan ini tidak memulihkan jendela yang di-cache dari pengambilan yang gagal.
Penghapusan
Saat seorang anggota dihapus di integrasi, akses pintunya dicabut (Removed by integration). Baris Users-nya tidak dihapus, sehingga riwayatnya tetap tersimpan.
Jika sinkronisasi akan menghapus orang dalam jumlah yang luar biasa besar sekaligus, penghapusan tersebut ditahan untuk ditinjau (N removals held back for review). Penghapusan yang dipicu integrasi di atas batas keamanan menunggu tinjauan admin sebelum diterapkan, sehingga penarikan data yang salah dari integrasi tidak dapat mencabut akses semua orang sekaligus.
Snapshot Access Time Window
Setiap integrasi hanya memperbarui partisi sumbernya sendiri. Pembaruan anggotanya adalah snapshot jendela yang lengkap dengan revisi yang meningkat secara monoton:
- Data jendela yang tidak disertakan membuat snapshot sumber saat ini tidak berubah.
- Snapshot yang lebih baru menggantikan seluruh daftar sumber tersebut.
- Revisi yang sama dengan payload ternormalisasi yang sama merupakan pemutaran ulang yang idempoten.
- Revisi yang sama dengan data yang berbeda merupakan konflik; revisi yang lebih lama dilewati karena usang.
- Snapshot kosong yang lebih baru secara eksplisit mencabut jendela sumber tersebut.
- Pengambilan upstream yang gagal atau tidak lengkap tidak boleh mengirim snapshot apa pun, dan tidak pernah snapshot kosong atau parsial.
Setiap scope_key sumber yang stabil (termasuk default) dipetakan ke target seluruh fasilitas, pintu, atau Access Scope di Pemetaan Access Time Window. Untuk pemetaan yang tidak dikenal atau dinonaktifkan, akses ditolak. Pengaturan ini juga menampilkan usia sumber dan kebijakan kesegaran sumber dari integrasi.
Penyelesaian duplikat


Gambar 3: Penyelesaian duplikat
"Saat dua orang berbagi alamat email atau nomor telepon, hanya satu yang dapat disinkronkan ke Pengguna. Pilih siapa yang mempertahankan slot; yang lainnya ditandai sebagai konflik dan tidak disinkronkan."
- Prefer the active person — "A person with an active status always wins over an expired one. Turn off to apply the tiebreaker regardless of status."
- Tiebreaker — digunakan saat status tidak menentukan pemenang, misalnya Oldest By Date Of Birth, Then Earliest Start Date.
Catatan lainnya menampilkan Not synced – duplicate di Users dan dihitung dalam ubin Not synced. Misalnya, klinik kesehatan dapat mempertahankan satu catatan saat seorang klinisi merupakan staf sekaligus anggota pasien.
Undangan aplikasi otomatis
Di App invitations, Auto-send app invitations mengirim email kepada pengguna tersinkronisasi yang memenuhi syarat dan belum menerima undangan, dan Advanced recipient rules dapat membatasi siapa yang menerimanya. Send invitations… mengirim secara massal ke pengguna yang ada setelah Anda meninjau daftar penerima. Detail lengkap ada di Undangan.
Aktivitas sinkronisasi & pemecahan masalah
Perluas Sync activity & troubleshooting untuk "see why recent records did or did not sync." Anda dapat mencari berdasarkan nama, ID, atau alasan, dan Refresh daftarnya. Setiap entri memiliki lencana hasil:
| Hasil | Arti |
|---|---|
| Added | Baris Users baru telah dibuat |
| Updated | Baris yang ada telah diperbarui dari sumbernya |
| Skipped | Catatan tidak disinkronkan — entri menunjukkan alasannya (di bawah) |
| Disabled | Orang tersebut dihapus di sumber, sehingga aksesnya dinonaktifkan |
| Processed | Catatan telah ditangani tanpa perubahan yang terlihat |
| Stale snapshot | Revisi Access Time Window yang lebih lama diabaikan agar tidak dapat menimpa status yang lebih baru |
Alasan dilewati yang mungkin Anda lihat:
| Alasan dilewati | Perbaikan |
|---|---|
| Integration sync is turned off for this facility | Aktifkan tombol sumber di halaman ini |
| This integration is turned off in sync settings | Aktifkan integrasi tersebut di "Sync from these integrations" |
| No phone or email on the record (a phone or email is required to log in) | Tambahkan detail kontak di sistem sumber, atau longgarkan Require identifier |
| Record is decoupled and managed manually | Sesuai harapan — tautkan kembali melalui tombol Track source updates pengguna jika Anda ingin sinkronisasi kembali |
| No facility on the source record | Catatan sumber tidak dikaitkan dengan fasilitas ini di sistem sumber |
| No matching Users record | Perubahan merujuk pada orang yang tidak memiliki baris di sini (mis. dihapus sebelum sinkronisasi pertama) |
| Unknown or unmapped scope key | Konfigurasikan pemetaan scope_key integrasi; jendela yang terdampak tidak memberikan akses |
| Access Time Window source is stale | Pulihkan pengiriman sumber yang berhasil dan tinjau ambang kesegaran yang dikonfigurasi; jangan menghapus berdasarkan pengambilan yang belum terverifikasi |
Mengklik sebuah entri akan membuka Sync activity detail dengan catatan lengkap: nama, ID eksternal, sumber, integrasi, alasan, dan ID untuk eskalasi dukungan.
Menghapus pengguna tersinkronisasi secara massal
Untuk membersihkan pengguna yang berasal dari integrasi (mis. setelah memutuskannya), gunakan Bulk delete synced users. Anda meninjau daftar persisnya sebelum apa pun dihapus.
- Di Bulk delete synced users, klik Bulk delete…
- Pilih cakupannya: All integration-synced users atau satu integrasi. Klik Preview.
- Tinjau: dialog menunjukkan secara tepat berapa banyak pengguna yang akan dihapus (dengan daftar contoh). Perhatikan peringatannya — This cannot be undone, dan setiap kustomisasi admin pada baris tersebut (pemberian akses, tag khusus, catatan) akan hilang. Riwayat log akses pengguna tetap disimpan.
- Also turn off syncing from this integration (recommended) dicentang secara default — biarkan aktif, karena jika tidak, pengguna yang sama akan dibuat ulang pada proses sinkronisasi berikutnya (tanpa kustomisasi lama mereka).
- Centang I understand this is permanent and customisations will be lost, lalu klik Delete N.
Jika kumpulan pengguna yang mendasarinya berubah antara pratinjau dan konfirmasi, Anda akan diminta menjalankan ulang pratinjau — ini menjamin Anda menghapus persis apa yang telah Anda tinjau.
Halaman terkait
- Users — sumber, pelepasan, panel pengguna
- Jadwal Access Policy — jadwal dan pengaturan Access Time Windows
- Undangan
- Pemecahan masalah — panduan "pengguna tidak ada / tidak mutakhir"