동기화 및 통합

동기화는 다른 시스템의 사람을 Users로 자동 미러링하므로 수동으로 입력하지 않아도 출입문 액세스가 외부 소스 데이터를 따릅니다. 이 페이지에서는 세 가지 동기화 소스, Performance Hub 직원 동기화, 식별자, 소스 소유 Access Time Windows, 최신성 및 범위 매핑, 제거, 중복 해결, 동기화 활동 패널, 초대 및 일괄 삭제를 다룹니다. 모든 항목은 Settings → Sync settings에서 구성합니다.

Performance Hub staff 동기화는 기본적으로 켜져 있습니다. 통합 및 Computer Vision 동기화는 기본적으로 꺼져 있으므로 기존 시설은 수동으로 관리하던 목록을 그대로 유지합니다. 소스를 활성화하기 전까지는 해당 소스에서 아무것도 동기화되지 않습니다.

동기화 소스

그림 1: Sync settings

각 블록에는 자체 활성화 토글이 있으며 마지막 실행 시간과 개수(또는 Never run)가 표시됩니다.

Integrations 소스의 경우 Sync from these integrations에서 개별 통합을 포함하거나 제외할 수도 있습니다. "통합을 끄면 해당 통합의 사람 미러링이 중지됩니다. 이미 동기화된 사람은 제거할 때까지 유지됩니다." Show all integrations를 선택하면 전체 목록이 펼쳐집니다.

식별자 요구

사람들은 휴대폰이나 이메일로 전송된 일회용 코드로 모바일 앱에 로그인하므로, 둘 다 없는 레코드는 출입문 액세스에 쓸모가 없습니다. Require identifier 드롭다운은 동기화할 레코드를 제어합니다.

요구 사항을 충족하지 않는 레코드는 건너뜁니다(동기화 활동 패널에 식별자 누락으로 건너뜀으로 표시됨).

Access Time Window 매핑 및 소스 최신성

Access Time Windows를 제공하는 각 통합에는 자체 설정이 있습니다.

• Access Time Window mapping — "각 파트너 범위 키를 시설 출입문 또는 Access Scopes에 매핑합니다. 알 수 없거나 매핑되지 않은 키는 차단 상태로 실패합니다." 각 통합에는 default 키를 포함하여 최대 50개의 매핑이 있을 수 있습니다. Add partner scope key에서 키를 추가합니다.
• Source freshness policy — 안전 설정입니다. "파트너 스냅샷이 얼마나 오래되면 해당 스냅샷의 모든 기간이 차단 상태로 실패할지 선택합니다." 통합이 업데이트를 보내기로 약속한 빈도에 맞게 설정하면, 업데이트가 중단된 통합의 기간이 계속 액세스를 허용하지 않습니다.

통합 기간이 업데이트되는 방식은 Access Time Window 스냅샷을 참조하십시오.

Performance Hub 직원

그림 2: Performance Hub 직원 소스

"Performance Hub 역할에 이 시설이 포함된 모든 사람은 Users에 자동으로 추가되며 Performance Hub IAM과 동기화된 상태로 유지됩니다." 예를 들어 소매 체인의 매장 직원은 누군가 직접 추가하지 않아도 매장 후방 출입문을 사용할 수 있습니다.

• 직원(Performance Hub 사용자)은 Performance Hub staff, Role: …(역할당 하나) 태그와 함께 동기화되며, 조직 관리자는 Organisation admin 태그도 함께 동기화됩니다.
• 편집 가능한 Performance Hub staff Access Policy가 시설당 한 번 생성되며, 이 태그를 가진 사람이 언제든지 모든 출입문을 통과할 수 있게 합니다. 카드에는 정책의 활성 여부와 Edit policy가 표시됩니다. 다른 Access Policy와 마찬가지로 편집하거나 비활성화할 수 있습니다.
• 역할에는 포함된 역할이 표시됩니다. 포함하거나 제외할 역할은 조직 관리자가 Organisation Settings에서 설정하며, 다른 관리자에게는 *"Organisation Settings에서 이 설정을 변경하려면 조직 관리자에게 문의하십시오."*라는 메시지가 표시됩니다.
• 동기화를 끄면 확인을 요청합니다("Turn off Performance Hub staff sync?").

직원 세부 정보는 Performance Hub IAM에서 관리되며 Users에서는 읽기 전용입니다. 직원의 출입문 액세스를 중지하려면 Users → Performance Hub 직원을 참조하십시오.

동기화 실행 시점

동기화가 업데이트하는 항목과 절대 건드리지 않는 항목

매번 실행할 때마다 동기화된 행은 소스에서 새로 고쳐집니다.

따라서 동기화된 사용자를 비활성화하거나, 권한을 부여하거나, 태그를 지정해도 안전합니다. 동기화가 이를 되돌리지 않습니다.

분리: 사용자 패널에서 Track source updates를 끄면 동기화가 해당 행을 완전히 건너뜁니다. 이름/연락처 세부 정보 편집 내용이 유지되며 소스에서 제거되어도 더 이상 영향을 받지 않습니다. Users를 참조하십시오.

Access Time Windows를 제공하는 소스의 경우, 분리하면 명시적으로 확인한 후 해당 소스의 기간도 지워집니다. 다시 연결하면 다음에 성공한 완전한 스냅샷에서 기간이 복원되며, 실패한 가져오기에서 캐시된 기간은 복원되지 않습니다.

제거

통합에서 회원이 삭제되면 해당 회원의 출입문 액세스가 제거됩니다(Removed by integration). Users 행은 삭제되지 않으므로 기록이 유지됩니다.

동기화로 인해 한 번에 비정상적으로 많은 사람이 제거될 경우, 해당 제거는 대신 검토를 위해 보류됩니다(N removals held back for review). 안전 한도를 초과하는 통합 기반 제거는 적용되기 전에 관리자의 검토를 기다리므로, 통합에서 잘못된 데이터를 가져와도 모든 사람의 액세스가 한꺼번에 제거되지 않습니다.

Access Time Window 스냅샷

각 통합은 자체 소스 파티션만 업데이트합니다. 회원 업데이트는 단조 증가하는 리비전이 매겨진 완전한 기간 스냅샷입니다.

• 기간 데이터가 생략되면 현재 소스 스냅샷은 변경되지 않습니다.
• 더 새로운 스냅샷은 해당 소스의 전체 목록을 대체합니다.
• 리비전과 정규화된 페이로드가 같으면 멱등 재실행입니다.
• 리비전이 같지만 데이터가 다르면 충돌이며, 이전 리비전은 오래된 것으로 간주되어 건너뜁니다.
• 더 새로운 빈 스냅샷은 해당 소스의 기간을 명시적으로 취소합니다.
• 업스트림 가져오기가 실패하거나 불완전한 경우 스냅샷을 보내지 않아야 하며, 빈 스냅샷이나 일부 스냅샷을 보내서는 안 됩니다.

각 안정적인 소스 scope_key(default 포함)는 Access Time Window 매핑에서 시설 전체, 출입문 또는 Access Scope 대상에 매핑됩니다. 알 수 없거나 비활성화된 매핑은 차단 상태로 실패합니다. 설정에는 소스 경과 시간과 통합의 소스 최신성 정책도 표시됩니다.

중복 해결

그림 3: 중복 해결

"두 사람이 이메일이나 전화번호를 공유하는 경우 한 사람만 Users로 동기화할 수 있습니다. 자리를 유지할 사람을 선택하십시오. 다른 사람은 충돌로 표시되며 동기화되지 않습니다."

• Prefer the active person — "활성 상태인 사람은 항상 만료된 사람보다 우선합니다. 상태와 관계없이 동점 처리 기준을 적용하려면 끄십시오."
• Tiebreaker — 상태로 우선순위가 결정되지 않을 때 사용합니다. 예: Oldest By Date Of Birth, Then Earliest Start Date.

다른 레코드는 Users에 Not synced – duplicate로 표시되며 Not synced 타일에 집계됩니다. 예를 들어 의료 클리닉에서는 임상의가 직원이면서 환자 회원인 경우에도 레코드 하나를 유지할 수 있습니다.

자동 앱 초대

App invitations에서 Auto-send app invitations는 아직 초대를 받지 않은 자격 있는 동기화된 사용자에게 이메일을 보내며, Advanced recipient rules로 수신자를 제한할 수 있습니다. **Send invitations…**는 수신자 목록을 검토한 후 기존 사용자에게 일괄 전송합니다. 자세한 내용은 초대를 참조하십시오.

동기화 활동 및 문제 해결

Sync activity & troubleshooting을 펼쳐 *"최근 레코드가 동기화되었거나 동기화되지 않은 이유를 확인"*하십시오. 이름, ID 또는 사유로 검색할 수 있으며 Refresh로 목록을 새로 고칠 수 있습니다. 각 항목에는 결과 배지가 있습니다.

표시될 수 있는 건너뜀 사유:

항목을 클릭하면 이름, 외부 ID, 소스, 통합, 사유 및 지원 에스컬레이션용 ID가 포함된 전체 레코드가 있는 Sync activity detail이 열립니다.

동기화된 사용자 일괄 삭제

통합에서 가져온 사용자를 정리하려면(예: 통합 연결을 해제한 후) Bulk delete synced users를 사용합니다. 삭제하기 전에 정확한 목록을 검토합니다.

1. Bulk delete synced users에서 **Bulk delete…**를 클릭합니다.
2. 범위를 선택합니다. All integration-synced users 또는 단일 통합을 선택하고 Preview를 클릭합니다.
3. 검토합니다. 대화 상자에 제거될 사용자 수가 정확하게 표시됩니다(샘플 목록 포함). 경고에 유의하십시오. This cannot be undone이며, 해당 행의 모든 관리자 사용자 지정(권한, 사용자 지정 태그, 메모)이 사라집니다. 사용자의 접근 로그 기록은 유지됩니다.
4. **Also turn off syncing from this integration (recommended)**는 기본적으로 선택되어 있습니다. 켜 둔 상태로 두십시오. 그렇지 않으면 다음 동기화 실행 시 같은 사용자가 다시 생성됩니다(이전 사용자 지정은 없음).
5. I understand this is permanent and customisations will be lost를 선택한 다음 Delete N을 클릭합니다.

미리 보기와 확인 사이에 기본 사용자 집합이 변경된 경우 미리 보기를 다시 실행하라는 메시지가 표시됩니다. 이를 통해 검토한 항목만 정확하게 삭제됩니다.

관련 페이지

• Users — 소스, 분리, 사용자 패널
• Access Policy 일정 — 일정 및 Access Time Windows 설정
• 초대
• 문제 해결 — "사용자 누락/최신 상태 아님" 해결 안내