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

Sync settings: sumber Performance Hub staff, Integrations, dan Performance Hub features, lalu jadwal sinkronisasi, penyelesaian duplikat, dan undangan aplikasiSync settings: sumber Performance Hub staff, Integrations, dan Performance Hub features, lalu jadwal sinkronisasi, penyelesaian duplikat, dan undangan aplikasi

Gambar 1: Sync settings

SumberYang dicerminkanLencana sumber pengguna yang dihasilkan
Performance Hub staffPengguna Performance Hub yang perannya mencakup fasilitas iniPerformance Hub staff
IntegrationsAnggota dan, jika didukung, Access Time Windows milik sumber dari integrasi yang terhubungIntegration / nama mitra
Performance Hub features (CCTV/Computer Vision)Orang yang teridentifikasi dari modul CCTVCCTV/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:

OpsiCatatan yang disinkronkan
Email OR phone (default)Memiliki email atau nomor telepon
Email requiredMemiliki email
Phone requiredMemiliki nomor telepon
Both requiredMemiliki 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

Sinkronisasi staf Performance Hub: status, kebijakan, dan peranSinkronisasi staf Performance Hub: status, kebijakan, dan peran

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

PemicuKapan
ContinuousPerubahan 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 nowTombol 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 sinkronisasiDipertahankan (milik admin)
Nama depan, nama belakangSakelar Access enabled
Ponsel, emailAdditional permanent access
Jenis orang, status keanggotaanCustom tags
Tag yang disinkronkanNotes
Stempel waktu sinkronisasi terakhirStatus terlepas, pesan aplikasi
Access Time Windows milik sumber untuk sumber tersebutPemberian 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

Penyelesaian duplikat: utamakan orang yang aktif, lalu penentu seriPenyelesaian duplikat: utamakan orang yang aktif, lalu penentu seri

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:

HasilArti
AddedBaris Users baru telah dibuat
UpdatedBaris yang ada telah diperbarui dari sumbernya
SkippedCatatan tidak disinkronkan — entri menunjukkan alasannya (di bawah)
DisabledOrang tersebut dihapus di sumber, sehingga aksesnya dinonaktifkan
ProcessedCatatan telah ditangani tanpa perubahan yang terlihat
Stale snapshotRevisi Access Time Window yang lebih lama diabaikan agar tidak dapat menimpa status yang lebih baru

Alasan dilewati yang mungkin Anda lihat:

Alasan dilewatiPerbaikan
Integration sync is turned off for this facilityAktifkan tombol sumber di halaman ini
This integration is turned off in sync settingsAktifkan 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 manuallySesuai harapan — tautkan kembali melalui tombol Track source updates pengguna jika Anda ingin sinkronisasi kembali
No facility on the source recordCatatan sumber tidak dikaitkan dengan fasilitas ini di sistem sumber
No matching Users recordPerubahan merujuk pada orang yang tidak memiliki baris di sini (mis. dihapus sebelum sinkronisasi pertama)
Unknown or unmapped scope keyKonfigurasikan pemetaan scope_key integrasi; jendela yang terdampak tidak memberikan akses
Access Time Window source is stalePulihkan 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.

  1. Di Bulk delete synced users, klik Bulk delete…
  2. Pilih cakupannya: All integration-synced users atau satu integrasi. Klik Preview.
  3. 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.
  4. 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).
  5. 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.