액세스 결정 방식
이 페이지의 내용
이 페이지에서는 모든 잠금 해제의 기반이 되는 모델을 설명합니다. 누가 출입문을 통과할 수 있는지, 확인이 어떤 순서로 실행되는지, Access Policies, 권한 및 안전 확인이 어떻게 상호 작용하는지를 다룹니다. 다른 모든 페이지가 이 개념을 바탕으로 하므로 이 페이지를 먼저 읽으십시오.
추가형 허용 경로
사용자는 어떤 정책 또는 권한 경로를 통해서든 출입문 통과를 허용받을 수 있습니다. 하나의 경로만 통과하면 충분하며, 한 경로가 다른 경로에서 부여한 액세스를 빼는 일은 없습니다.
| 경로 | 설명 | 구성 위치 |
|---|---|---|
| Access Policies | 이름이 지정된 여러 개의 허용 전용 정책입니다. 각 정책은 Who, Where, When을 정의합니다. | Settings → Access Policies |
| 영구 권한 | 한 사람에 대한 명시적 권한입니다. 시설 전체, 선택한 출입문 또는 선택한 접근 범위에 적용되며, 선택적으로 자체 시간을 지정할 수 있습니다. | Users → 사용자 열기 → Access Control → Additional permanent access |
| Access Time Windows | 한 사람과 선택한 시설/출입문/범위 대상에 대해 관리자가 소유하는 임시 액세스입니다. | Users → 사용자 열기 → Access Time Windows |
| 통합 Access Time Windows | 동기화된 사람에 대한 읽기 전용 원본 기간으로, 논리적 원본 범위 키에서 매핑됩니다. | 원본 데이터 및 Settings → Sync settings 매핑 |
정책은 Who AND Where AND When이 일치할 때만 일치합니다. 정책은 서로 OR로 결합됩니다. Who 안에서는 사람 유형/상태 조건과 태그가 대체 조건이며, When 안에서는 Weekly와 One-time 기간이 대체 조건입니다. Where에는 시설의 모든 출입문, 접근 범위, 개별 출입문 및 제외 항목을 포함할 수 있습니다.
예: "Active members" 정책은 Front entrances 범위를 Anytime으로 적용하고, 별도의 "Staff" 정책은 Plant room을 제외한 시설의 모든 출입문에 적용할 수 있습니다. 둘 다 일치하지 않는 청소 담당자도 Service entries 범위에 대한 영구 권한을 받을 수 있습니다.
영구 권한과 관리자/통합 기간은 별도로 유지되며 추가적으로 적용됩니다. 정책 편집이나 자동 가져오기는 이를 흡수하거나 제거하지 않습니다.
Users로 동기화된 Performance Hub 직원은 다른 정책과 마찬가지로 편집 가능한 Performance Hub staff 정책을 통해 출입문 액세스를 받습니다. 동기화 및 통합을 참조하십시오.
전체 결정 순서
사용자가 모바일 앱에서 Unlock을 탭하면 서버가 다음 항목을 순서대로 확인합니다. 처음으로 실패한 확인에서 잠금 해제가 거부되고 그 사유가 접근 로그에 기록됩니다.
- 사용자의 액세스가 활성화되어 있습니까? Users에서 사용자 행의 Access enabled 스위치는 관리자용 긴급 차단 스위치입니다. 삭제, 비활성화 또는 동기화 차단된 사용자는 정책이나 권한과 관계없이 잠금을 해제할 수 없습니다. (예:
access_disabled.) - 출입문이 차단되었거나 유지 관리 중입니까? 명시적인
blockAllAccess는 모든 회원 경로를 거부합니다. 유지 관리 Force closed는 출입문을 잠근 상태로 유지하고 회원에게 사용 중지 상태로 표시하며, Force open은 출입문을 잠금 해제 상태로 유지합니다. 관리자는 출입문 잠금을 원격으로 해제할 수 있으며, 모든 관리자 잠금 해제는 접근 로그에 기록됩니다. - 추가형 허용 경로 중 통과하는 것이 있습니까?
- 정책 경로: Who, Where, When이 모두 일치하는 활성화된 명명 정책이 있으면 액세스가 허용됩니다.
- 영구 권한 경로: 시설, 출입문 또는 해당 출입문을 포함하는 접근 범위 권한이 있고 선택적 시간이 일치하면 액세스가 허용됩니다.
- 사용자 기간 경로: 관리자가 소유한 Access Time Window가 활성 상태이고 이 출입문, 시설 또는 이를 포함하는 접근 범위를 대상으로 합니다.
- 통합 기간 경로: 최신 원본 기간이 활성 상태이고 구성된
scope_key매핑이 이 출입문을 대상으로 합니다. 오래되었거나 매핑되지 않은 원본 기간은 안전하게 차단 상태로 실패합니다. - 통과하는 경로가 없으면 → 거부됨 (
no_matching_policy_or_grant)
- 지오펜스 확인(활성화된 경우). 휴대폰이 보고한 위치를 사용합니다.
- 휴대폰이 위치를 제공하지 못하면 → 거부됨 (
location_unavailable) - GPS 측정값이 Require GPS accuracy better than 설정보다 부정확하면 → 거부됨 (
gps_too_imprecise) - 지오펜스 중심으로부터 사용자의 거리가 반경 + GPS 정확도 + 정확도 버퍼를 초과하면 → 거부됨 (
outside_geofence) - 서버가 최종 판단 권한을 가지므로 휴대폰에서 위조된 위치도 서버 측에서 거부됩니다.
- 휴대폰이 위치를 제공하지 못하면 → 거부됨 (
- 도어 컨트롤러가 온라인 상태입니까? 컨트롤러가 보고하지 않았으면(최근 5분 이내 하트비트) 잠금 해제를 전달할 수 없습니다 (
device_offline). 명령이 전송되었지만 컨트롤러가 확인하지 않으면 이벤트가 Timed out으로 기록됩니다. - 잠금 해제. 릴레이가 출입문의 Hold time(1–30초, 기본값 10초) 동안 해제된 후 자동으로 다시 잠깁니다. 컨트롤러가 확인하면 이벤트가 Confirmed unlocked로 기록됩니다.
One-time 기간과 기간이 지정된 Weekly 기간은 정수 Unix 초 경계와 반개방 경계 [from, to)를 사용합니다. 시작 시점은 포함되고 종료 시점은 포함되지 않습니다. Weekly 블록은 선언된 IANA 시간대와 현지 시계/일광 절약 시간 규칙을 사용합니다. Access Policy 일정을 참조하십시오.
새 클라이언트는 향후 기간만 있는 출입문에 대해 outside_access_time_window 세부 정보와 구조화된 다음 이용 가능 시간을 받습니다. 호환성 롤아웃 기간 동안 이전 클라이언트는 출입문이 안전하게 비활성화된 상태로 표시되도록 계속 outside_access_hours를 기본 사유로 받습니다.
기존 구성
기존 액세스 구성은 Access Policies로 자동으로 가져옵니다. 가져오기 시 액세스 권한이 있던 사람, 사용할 수 있던 출입문 또는 접근 범위, 적용되는 시간이 정책의 Who, Where, When 값으로 보존됩니다. 관리자는 결과 정책을 직접 관리하며, 롤아웃 모드나 수동 변환 워크플로는 없습니다.
지오펜스 상속은 Access Policies와 독립적으로 유지됩니다. 정책이 일치하더라도 유효 지오펜스와 기타 모든 안전/기기 확인을 거쳐야 합니다.
OTP 로그인의 역할과 한계
모바일 앱 로그인(SMS 또는 이메일을 통한 일회용 코드)은 인증 전용입니다. 사용자가 누구인지 증명할 뿐이며, 그 자체로 출입문 액세스를 부여하지 않습니다. 모든 잠금 해제는 위의 결정 순서에 따라 개별적으로 승인됩니다. 사용자가 앱에 로그인되어 있어도 "You don't have access to this door."가 표시될 수 있습니다.
용어집
| 용어 | 정의 |
|---|---|
| 도어 컨트롤러 | 출입문/게이트에 페어링되어 잠금 릴레이를 작동시키는 하드웨어 기기입니다. 이 모듈에서는 "출입문"으로, Device Management에서는 기기로 표시됩니다. |
| 출입문 | 시설에 등록된 도어 컨트롤러로, 이름, 위치 라벨, 아이콘 및 설정이 있습니다. |
| 사용자 행 | Users 탭에 있는 이 시설의 개인 레코드입니다. 수동, CSV 가져오기 또는 동기화로 생성됩니다. 연락처 식별자, 유형/상태/태그, 권한 및 앱 상태를 보관합니다. |
| 원본 | 사용자 행의 출처입니다. Manually added, External Integration, CCTV/Computer Vision 또는 Performance Hub staff입니다. |
| Access Policy | Who, Where, When을 포함하는 이름이 지정된 허용 전용 정책입니다. 세 가지가 모두 일치해야 하며, 정책끼리는 OR로 결합됩니다. |
| 사람 유형 조건 | 사람 유형과 선택적 멤버십 상태를 포함하는 정책 Who 조건입니다. 상태가 비어 있으면 모든 상태를 의미합니다. |
| 태그 | 사용자에 붙는 라벨입니다. 동기화된 태그는 통합에서 가져오며 동기화할 때마다 덮어쓰입니다. 사용자 지정 태그는 관리자가 소유하며 덮어쓰이지 않습니다. 둘 다 정책 Who 조건을 충족할 수 있습니다. |
| 운영 시간 / 시간 블록 | 정책이나 권한이 액세스를 허용하는 시간을 제한하는 요일별 시간대(예: 월 06:00–22:00)입니다. 비어 있으면 항상 허용됩니다. 시간은 시설의 시간대를 사용합니다. |
| Access Time Window | 정책 일정이나 별도의 관리자/통합 권한 경로에 사용되는 Weekly 또는 One-time 기간입니다. |
| 사용자별 권한 | 한 사용자에게 부여된 명시적 액세스입니다. 시설 전체(모든 출입문), 특정 출입문 또는 특정 접근 범위에 적용되며, 선택적으로 자체 운영 시간을 지정할 수 있습니다. |
| 접근 범위 | 정책이나 권한 대상 및 범위 수준 지오펜스 설정에 사용되는 이름이 지정된 출입문 묶음(예: "Main entrances", "Staff-only")입니다. 내부적으로 출입문 그룹이라고도 합니다. |
| 정책 제외 | 한 정책의 Where 일치에서 제거된 출입문 또는 접근 범위입니다. 다른 정책이나 권한 경로를 거부하지 않습니다. |
| Geofence | 시설 주변의 원(중심 + 반경)입니다. 활성화하면 사용자가 잠금을 해제하려면 (GPS 정확도와 버퍼를 감안하여) 실제로 원 안에 있어야 합니다. |
| 정확도 버퍼 | 일반적인 GPS 오차를 허용하기 위해 지오펜스 반경에 추가되는 거리(미터)입니다. 기본값은 25 m입니다. |
| 유지 관리 모드 | 출입문을 정상 작동에서 제외하는 출입문별 설정입니다. Normal, Force open(잠금 해제 상태 유지) 또는 Force closed(잠근 상태로 유지하고 회원에게 사용 중지 상태로 표시)입니다. |
| Block all access | 유지 관리 모드를 사용하지 않고 해당 출입문에서 정책과 사용자별 권한보다 우선하는 출입문별 안전 차단입니다. 관리자 잠금 해제는 계속 사용할 수 있습니다. |
| 유지 시간 | 잠금 해제 후 다시 잠기기 전까지 릴레이가 해제된 상태로 유지되는 시간입니다. 범위는 1–30초이며 기본값은 10초입니다. |
| 자동 잠금 해제 일정 | 시설의 직원 상주 시간 또는 사용자 지정 일정 동안 출입문을 잠금 해제 상태로 유지하는 출입문별 일정입니다. Access Policies와 독립적입니다. |
| Lock now | 자동 잠금 해제 일정에 따라 열려 있는 출입문을 일정의 다음 변경 시점까지 잠급니다. Resume schedule로 되돌립니다. |
| Access enabled | 사용자별 긴급 차단 스위치입니다. 꺼져 있으면 사용자는 아무것도 잠금 해제할 수 없습니다. |
| 분리됨 | Track source updates 스위치가 꺼진 동기화된 사용자입니다. 동기화가 해당 행을 건너뛰므로 관리자 편집 내용이 보존됩니다. |
| 초대 | 모바일 앱 다운로드 링크와 함께 사용자에게 전송되는 이메일입니다. 사용자별로 추적됩니다(Not invited / Invited / Send failed). |
| OTP 로그인 | 모바일 앱의 비밀번호 없는 로그인 방식으로, 사용자의 휴대폰이나 이메일로 일회용 코드가 전송됩니다. |
| 관리자 재정의 / 관리자 잠금 해제 | 관리자가 Performance Hub에서 실행한 잠금 해제입니다(Doors 탭 → Open 또는 출입문 패널의 Unlock door). 모든 관리자 잠금 해제는 관리자의 계정으로 접근 로그에 기록됩니다. |
| 앱 잠금 | 앱을 사용하기 전에 시설에서 적용하는 기기 재인증(Face ID / Touch ID / Android 생체 인식 / 암호)입니다. |
| 앱 메시지 | 앱 대시보드의 공지 카드로, 시설 전체, 사용자별 또는 App Messaging 규칙에 의해 자동으로 설정됩니다. |
| 액세스 이벤트 | 접근 로그의 레코드 하나로, 잠금 해제 시도와 그 결과입니다. |
관련 페이지
- Access Policies — Who, Where, When 및 자동 가져오기
- Access Policy 일정 — Anytime, Weekly, One-time
- Access Scopes — 재사용 가능한 출입문 묶음
- Geofencing — 위치 확인
- Users — 사용자별 권한 및 긴급 차단 스위치
- 참조 — 모든 거부 사유와 기본값을 하나의 표에 정리
- 출입문은 Duress 대응에도 포함할 수 있습니다. Duress의 대응 작업을 참조하십시오.