Senkronizasyon ve entegrasyonlar
Bu sayfada
Senkronizasyon, diğer sistemlerinizdeki kişileri Users listesine otomatik olarak yansıtır; böylece kapı erişimi, elle giriş gerekmeden dış kaynak verilerini izler. Bu sayfada üç senkronizasyon kaynağı, Performance Hub personel senkronizasyonu, tanımlayıcılar, kaynağa ait Access Time Windows, güncellik ve kapsam eşlemesi, kaldırmalar, yinelenen kayıtların çözümü, senkronizasyon etkinliği paneli, davetler ve toplu silme ele alınır. Her şeyi Settings → Sync settings altında yapılandırın.
Performance Hub staff senkronizasyonu varsayılan olarak açıktır. Entegrasyon ve Computer Vision senkronizasyonu varsayılan olarak kapalıdır; böylece mevcut tesisler elle yönetilen listelerini korur. Kaynağı etkinleştirene kadar bu kaynaklardan hiçbir şey senkronize edilmez.
Senkronizasyon kaynakları


Şekil 1: Sync settings
| Kaynak | Neyi yansıtır | Kullanıcıya verilen kaynak rozeti |
|---|---|---|
| Performance Hub staff | Rolleri bu tesisi kapsayan Performance Hub kullanıcıları | Performance Hub staff |
| Integrations | Bağlı entegrasyonlardaki üyeler ve destekleniyorsa kaynağa ait Access Time Windows | Integration / iş ortağının adı |
| Performance Hub features (CCTV/Computer Vision) | Güvenlik kamerası modülünde tanımlanan kişiler | CCTV/Computer Vision |
Her bloğun kendi etkinleştirme anahtarı vardır ve son çalışma zamanını ve sayılarını (veya Never run) gösterir.
Integrations kaynağı için ayrıca Sync from these integrations altında entegrasyonları tek tek dahil edebilir veya hariç tutabilirsiniz: "Turn off an integration to stop mirroring its people. People already synced stay until you remove them." Show all integrations tam listeyi genişletir.
Tanımlayıcı zorunluluğu
Kişiler mobil uygulamada telefonlarına veya e-posta adreslerine gönderilen tek kullanımlık bir kodla oturum açar; bu nedenle ikisinden de yoksun bir kayıt kapı erişimi için işe yaramaz. Require identifier açılır listesi hangi kayıtların senkronize edileceğini belirler:
| Seçenek | Senkronize edilen kayıtlar |
|---|---|
| Email OR phone (varsayılan) | E-postası veya telefonu olanlar |
| Email required | E-postası olanlar |
| Phone required | Telefonu olanlar |
| Both required | Her ikisi de olanlar |
Gereksinimi karşılamayan kayıtlar atlanır (ve senkronizasyon etkinliği panelinde eksik tanımlayıcı nedeniyle atlandı olarak görünür).
Access Time Window eşlemesi ve kaynak güncelliği
Access Time Windows sağlayan her entegrasyonun kendi ayarları vardır:
- Access Time Window mapping: "Map each partner scope key to facility doors or Access Scopes. Unknown and unmapped keys fail closed." Her entegrasyonun
defaultanahtarı dahil en fazla 50 eşlemesi olabilir. Add partner scope key altında bir anahtar ekleyin. - Source freshness policy: bir güvenlik ayarı: "Choose how old a partner snapshot may be before all of its windows fail closed." Bunu entegrasyonun güncelleme göndermeyi taahhüt ettiği sıklığa göre ayarlayın; böylece güncellemeyi bırakmış bir entegrasyonun pencereleri erişim vermeye devam etmez.
Entegrasyon pencerelerinin nasıl güncellendiği için bkz. Access Time Window anlık görüntüleri.
Performance Hub personeli


Şekil 2: Performance Hub staff kaynağı
"Anyone whose Performance Hub roles cover this facility is added to Users automatically and kept in step with Performance Hub IAM." Örneğin bir perakende zincirinin mağaza personeli, kimse onları elle eklemeden depo kapısına erişim kazanır.
- Personel (Performance Hub kullanıcıları) Performance Hub staff, Role: … (her rol için bir tane) ve organizasyon yöneticileri için Organisation admin etiketleriyle senkronize edilir.
- Her tesis için bir kez düzenlenebilir bir Performance Hub staff Access Policy oluşturulur ve bu etiketin her kapıdan her zaman geçmesine izin verir. Kart, politikanın etkin olup olmadığını Edit policy ile birlikte gösterir. Bunu herhangi bir Access Policy gibi düzenleyin veya devre dışı bırakın.
- Roller, hangi rollerin dahil edildiğini gösterir. Dahil edilecek veya hariç tutulacak roller bir organizasyon yöneticisi tarafından Organisation Settings içinde ayarlanır; diğer yöneticiler "Ask an organisation admin to change this in Organisation Settings." mesajını görür.
- Senkronizasyonu kapatmak onay ister ("Turn off Performance Hub staff sync?").
Personel ayrıntıları Performance Hub IAM içinde yönetilir ve Users listesinde salt okunurdur. Bir personelin kapı erişimini durdurmak için bkz. Users → Performance Hub staff.
Senkronizasyon ne zaman çalışır
| Tetikleyici | Ne zaman |
|---|---|
| Continuous | Performance Hub personel değişiklikleri ve bağlı entegrasyonlardan gönderilen değişiklikler normalde gerçek zamanlı olarak senkronize edilir |
| Daily full sync | "A full reconcile also runs automatically every day to catch any inconsistencies." Next full sync bir sonrakinin ne zaman çalışacağını gösterir |
| Sync now | Bu sayfadaki düğme, entegrasyonlarınızdan en son verileri çeker ve ardından Users listesiyle uzlaştırır; önce Running…, sonra Sync complete (veya Sync failed) gösterir |
Senkronizasyon neyi günceller ve neye asla dokunmaz
Her geçişte senkronize edilen satırlar kaynaktan yenilenir:
| Her senkronizasyonda üzerine yazılır | Korunur (yöneticiye ait) |
|---|---|
| Ad, soyad | Access enabled anahtarı |
| Cep telefonu, e-posta | Additional permanent access |
| Kişi türü, üyelik durumu | Custom tags |
| Senkronize edilen etiketler | Notes |
| Son senkronizasyon zaman damgası | Ayrılmış durum, uygulama mesajı |
| O kaynağa ait Access Time Windows | Kalıcı izinler ve yöneticiye ait Access Time Windows |
Bu nedenle senkronize edilen bir kullanıcıyı güvenle devre dışı bırakabilir, ona izin verebilir veya etiketleyebilirsiniz; senkronizasyon bunu geri almaz.
Ayırma: Bir kullanıcının panelinde Track source updates seçeneğini kapatmak, senkronizasyonun o satırı tamamen atlamasını sağlar; ad ve iletişim bilgilerinde yapılan düzenlemeler kalıcı olur ve kaynaktaki kaldırmalar artık kullanıcıyı etkilemez. Bkz. Users.
Access Time Windows sağlayan bir kaynak için ayırma, açık bir onaydan sonra o kaynağın pencerelerini de temizler. Yeniden bağlama, pencereleri bir sonraki başarılı ve eksiksiz anlık görüntüde geri yükler; başarısız bir çekmeden kalan önbelleğe alınmış pencereleri geri yüklemez.
Kaldırmalar
Bir üye entegrasyonda silindiğinde kapı erişimi kaldırılır (Removed by integration). Users satırı silinmez, böylece geçmişi korunur.
Bir senkronizasyon aynı anda olağandışı sayıda kişiyi kaldıracaksa bu kaldırmalar bunun yerine inceleme için bekletilir (N removals held back for review). Bir güvenlik sınırının üzerindeki entegrasyon kaynaklı kaldırmalar, uygulanmadan önce bir yöneticinin incelemesini bekler; böylece bir entegrasyondan yapılan hatalı bir çekme herkesin erişimini bir anda kaldıramaz.
Access Time Window anlık görüntüleri
Her entegrasyon yalnızca kendi kaynak bölümünü günceller. Üye güncellemesi, eksiksiz ve monoton biçimde revizyon numarası artan bir pencere anlık görüntüsüdür:
- Gönderilmeyen pencere verileri mevcut kaynak anlık görüntüsünü değiştirmez.
- Daha yeni bir anlık görüntü o kaynağın tüm listesinin yerini alır.
- Aynı revizyon ve aynı normalleştirilmiş içerik, idempotent bir yeniden oynatmadır.
- Farklı verilere sahip aynı revizyon bir çakışmadır; daha eski bir revizyon eskimiş olarak atlanır.
- Daha yeni ve boş bir anlık görüntü, o kaynağın pencerelerini açıkça iptal eder.
- Başarısız veya eksik bir kaynak çekmesi hiçbir anlık görüntü göndermemelidir; asla boş veya kısmi bir anlık görüntü göndermemelidir.
Her kararlı kaynak scope_key (default dahil), Access Time Window mapping altında tesis genelindeki, kapı veya Access Scope hedeflerine eşlenir. Bilinmeyen veya devre dışı bırakılmış eşlemeler erişim vermez. Ayarlar ayrıca kaynak yaşını ve entegrasyonun kaynak güncellik politikasını gösterir.
Yinelenen kayıtların çözümü


Şekil 3: Yinelenen kayıtların çözümü
*"İki kişi aynı e-posta adresini veya telefon numarasını paylaştığında, yalnızca biri Users içine senkronize edilebilir. Yuvanın kimde kalacağını seçin; diğeri bir çakışma olarak işaretlenir ve senkronize edilmez."*j
- 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: durum bir kazanan belirlemediğinde kullanılır, örneğin Oldest By Date Of Birth, Then Earliest Start Date.
Diğer kayıt Users listesinde Not synced – duplicate olarak görünür ve Not synced kutucuğunda sayılır. Örneğin bir sağlık kliniği, bir klinisyen hem personel hem de hasta üye olduğunda tek bir kaydı tutabilir.
Otomatik uygulama davetleri
App invitations altında Auto-send app invitations, henüz davet almamış uygun senkronize kullanıcılara e-posta gönderir; Advanced recipient rules ise davetleri kimlerin alacağını sınırlayabilir. Send invitations…, alıcı listesini inceledikten sonra mevcut kullanıcılara toplu gönderim yapar. Tüm ayrıntılar için bkz. Davetler.
Senkronizasyon etkinliği ve sorun giderme
"see why recent records did or did not sync." için Sync activity & troubleshooting bölümünü genişletin. Ad, kimlik veya nedene göre arama yapabilir ve listeyi Refresh ile yenileyebilirsiniz. Her girişin bir sonuç rozeti vardır:
| Sonuç | Anlamı |
|---|---|
| Added | Yeni bir Users satırı oluşturuldu |
| Updated | Mevcut bir satır kaynaktan yenilendi |
| Skipped | Kayıt senkronize edilmedi; giriş nedenini gösterir (aşağıya bakın) |
| Disabled | Kişi kaynakta kaldırıldı, bu nedenle erişimi kapatıldı |
| Processed | Kayıt görünür bir değişiklik olmadan işlendi |
| Stale snapshot | Daha eski bir Access Time Window revizyonu, daha yeni durumun üzerine yazmaması için yok sayıldı |
Görebileceğiniz atlama nedenleri:
| Atlama nedeni | Çözüm |
|---|---|
| Integration sync is turned off for this facility | Bu sayfadaki kaynak anahtarını etkinleştirin |
| This integration is turned off in sync settings | Bu entegrasyonu "Sync from these integrations" altında etkinleştirin |
| No phone or email on the record (a phone or email is required to log in) | Kaynak sistemde iletişim bilgilerini ekleyin veya Require identifier gereksinimini gevşetin |
| Record is decoupled and managed manually | Beklenen durum; senkronizasyonu geri istiyorsanız kullanıcının Track source updates anahtarıyla yeniden bağlayın |
| No facility on the source record | Kaynak kayıt, kaynak sistemde bu tesisle ilişkilendirilmemiş |
| No matching Users record | Değişiklik, burada satırı olmayan bir kişiye atıfta bulundu (ör. ilk senkronizasyondan önce kaldırılmış) |
| Unknown or unmapped scope key | Entegrasyonun scope_key eşlemesini yapılandırın; etkilenen pencere erişim vermez |
| Access Time Window source is stale | Başarılı kaynak teslimini yeniden sağlayın ve yapılandırılmış güncellik eşiğini gözden geçirin; doğrulanmamış bir çekmeden temizlemeyin |
Bir girişe tıklamak tam kaydı içeren Sync activity detail görünümünü açar: ad, harici kimlik, kaynak, entegrasyon, neden ve destek talebinde kullanılacak kimlikler.
Senkronize kullanıcıları toplu silme
Bir entegrasyondan gelen kullanıcıları temizlemek için (ör. bağlantısını kestikten sonra) Bulk delete synced users seçeneğini kullanın. Herhangi bir şey silinmeden önce tam listeyi incelersiniz.
- Bulk delete synced users altında Bulk delete… seçeneğine tıklayın.
- Kapsamı seçin: All integration-synced users veya tek bir entegrasyon. Preview seçeneğine tıklayın.
- İnceleyin: iletişim kutusu tam olarak kaç kullanıcının kaldırılacağını (örnek bir listeyle) gösterir. Uyarıya dikkat edin: This cannot be undone ve bu satırlardaki tüm yönetici özelleştirmeleri (izinler, özel etiketler, notlar) kaybolur. Kullanıcıların erişim kaydı geçmişi korunur.
- Also turn off syncing from this integration (recommended) varsayılan olarak işaretlidir; açık bırakın, aksi takdirde aynı kullanıcılar bir sonraki senkronizasyon geçişinde (eski özelleştirmeleri olmadan) yeniden oluşturulur.
- I understand this is permanent and customisations will be lost kutusunu işaretleyin, ardından Delete N seçeneğine tıklayın.
Önizleme ile onay arasında temel kullanıcı kümesi değiştiyse önizlemeyi yeniden çalıştırmanız istenir; bu, tam olarak incelediğiniz kayıtları silmenizi garanti eder.
İlgili sayfalar
- Users: kaynaklar, ayırma, kullanıcı paneli
- Access Policy zamanlamaları: zamanlamalar ve Access Time Windows ayarları
- Davetler
- Sorun giderme: "kullanıcı eksik / güncel değil" adım adım çözümleri