참조
이 페이지의 내용
Door & Gate Access의 전체 참조 표로, 모든 이벤트 상태, 거부 사유, 설정, 기본값, 제한 및 옵션 값을 한곳에 정리합니다. 값의 정확한 의미를 찾아볼 때 이 페이지를 사용하십시오. 각 기능의 사용 방법은 링크된 가이드 페이지에서 설명합니다.
액세스 이벤트 상태
접근 로그에 표시됩니다.
| 상태 | 의미 |
|---|---|
| Request received | 잠금 해제 요청이 도착하여 평가 중입니다(일시적 상태) |
| Pending | 요청이 확인을 통과하여 전송 대기 중입니다(일시적 상태) |
| Unlocked | 잠금 해제가 성공한 것으로 보고되었습니다 |
| Confirmed unlocked | 도어 컨트롤러가 릴레이 해제를 확인했습니다 |
| Admin Unlocked | 관리자가 Performance Hub에서 잠금 해제를 실행했습니다(관리자 재정의). 명령이 전송될 때 기록됩니다 |
| Denied | 요청이 거부되었습니다. 이벤트의 거부 사유를 참조하십시오 |
| Timed out | 명령이 전송되었지만 컨트롤러가 제시간에 확인하지 않았습니다 |
| Failed | 오류로 인해 잠금 해제를 완료할 수 없었습니다 |
| Locked by staff | 자동 잠금 해제 일정에 따라 출입문이 열려 있는 동안 직원이 Lock now를 사용했습니다(잠금 해제 시도가 아닌 일정 이벤트) |
| Schedule resumed | 자동 잠금 해제 일정이 다시 적용되었습니다(잠금 해제 시도가 아닌 일정 이벤트) |
이벤트 수명 주기: 수신 → 전송 → 잠금 해제 확인 / 거부 / 시간 초과 / 실패.
거부 사유
거부되거나 실패한 각 잠금 해제에는 사유가 기록됩니다. 아래 표는 사유별로 회원에게 표시되는 내용과 해결 방법을 정리한 것입니다.
| 사유(기록된 값) | 회원에게 표시되는 메시지 | 원인 | 해결 방법 |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | 사용자의 Access enabled 스위치가 꺼져 있음 | Users의 사용자 패널에서 다시 활성화합니다 |
no_matching_policy_or_grant | "You don't have access to this door" | Who AND Where AND When과 일치하는 Access Policy가 없고 액세스를 허용한 추가 권한 경로도 없음 | Access Policies, 사용자 속성, 대상/제외 항목, 일정 및 권한을 검토합니다 |
no_matching_policy_target | "You don't have access to this door" | 요청에 대해 이 출입문을 대상으로 하는 활성 Access Policy가 없음 | 출입문 또는 해당 접근 범위를 정책에 추가하거나 모든 출입문 대상을 사용합니다 |
no_matching_policy_audience | "You don't have access to this door" | 정책이 출입문을 대상으로 하지만 사람의 유형/상태 또는 태그와 일치하는 정책이 없음 | 정책의 Who 섹션과 Users 레코드를 검토합니다 |
outside_policy_schedule | "Outside allowed access hours" | Who와 Where는 일치하지만 일치하는 모든 정책 일정이 비활성 상태이거나 만료됨 | 정책의 When 섹션과 시설 시간대를 검토합니다 |
outside_geofence | "Move closer — you're outside the location's geofence." | 보고된 위치가 지오펜스 중심으로부터 반경 + GPS 정확도 + 버퍼를 벗어남 | 회원이 더 가까이 이동하거나, 지오펜스 반경/핀을 검토합니다 |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | 휴대폰의 GPS 정확도가 Require GPS accuracy better than 임계값보다 나쁨 | 회원이 실외나 간섭이 없는 곳에서 다시 시도하거나, 임계값을 높입니다 |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | 휴대폰이 사용 가능한 위치를 보고하지 않음 | 회원이 앱의 위치(Precise)를 활성화합니다 |
geofence_misconfigured | 잠금 해제 거부됨 | 지오펜스가 활성화되어 있지만 중심/핀이 없음. 시스템이 안전하게 차단 상태로 실패함 | Settings → Geofencing에서 지오펜스 핀을 배치합니다 |
device_offline | "Door is offline. Please contact the facility." | 도어 컨트롤러가 보고하지 않음(5분 이내 하트비트 없음) | 컨트롤러의 전원/네트워크를 복구합니다. 문제 해결을 참조하십시오 |
user_deleted | "You don't have access…" | Users 레코드가 삭제됨 | 사용자를 다시 만들거나 복원합니다 |
outside_access_time_window | 출입문이 비활성화되며, 알려진 경우 다음 이용 가능 시간 표시 | 향후 기간이 사용자의 유일한 허용 가능 경로이며 아직 활성 상태가 아님 | 제공된 이용 가능 시간, 시간대, 원본 최신 상태 및 매핑을 확인합니다. Access Policies와 권한은 여전히 독립적으로 적용됩니다 |
일부 앱 버전에서는 정책별 거부에 대해 더 포괄적인 "You don't have access to this door" 또는 "Outside allowed access hours" 메시지를 표시합니다. 접근 로그에는 관리자를 위한 자세한 사유가 보존됩니다.
출입 정책
| 속성 | 의미 |
|---|---|
| 정책 구성 | 고유한 이름, 선택적 설명, 활성화 플래그, Who 대상, Where 대상/제외 항목, When 일정 |
| 정책 일치 | Who AND Where AND When |
| 여러 정책 | OR. 일치하는 활성 정책이 하나라도 있으면 허용 |
| Who | 사람 유형과 선택적 상태, 또는 동기화된/사용자 지정 태그. 상태가 비어 있으면 모든 상태 |
| Where | 시설의 모든 출입문, 접근 범위, 개별 출입문 또는 이들의 조합. 해당 정책 안에서는 제외 항목이 우선 |
| When | Anytime 또는 OR로 결합된 Weekly/One-time 기간 |
| 기타 허용 경로 | 영구 권한과 관리자/통합 기간은 별도로 유지되며 추가적으로 적용 |
| 안전 | 삭제/비활성화/동기화 차단된 사용자, 출입문 삭제/차단, 유지 관리, 지오펜스, 속도 제한 및 컨트롤러 확인이 계속 적용 |
| 기존 구성 | 명시적인 Who, Where, When을 가진 동등한 명명 정책으로 자동으로 가져옴 |
정책 귀속
접근 로그는 일치하는 정책을 이름으로 식별하며 해당 정책의 대상자, 대상 및 일정을 표시할 수 있습니다. 일정에 따른 일치에는 활성 상태인 구체적인 시작 및 종료 시점도 포함될 수 있습니다.
Access Time Window 참조
| 속성 | 의미 |
|---|---|
| 승인 | 정책 일정 기간은 정책의 When이며, 관리자/통합 기간은 별도의 추가형 허용 경로 |
| 절대 경계 | 정수 Unix 초 UTC 시점, [from, to) |
| 절대 시간대 | 표시/감사용 메타데이터이며 에포크를 이동하지 않음 |
| Weekly 경계 | 종료 시점이 포함되지 않는 현지 HH:mm 블록 |
| Weekly 시간대 | 실제 시계 기준 요일/시간과 일광 절약 시간을 결정하는 유효한 IANA 시간대 |
| Weekly 범위 | 선택적 Unix 초 시작/종료 시점. 종료 시점은 포함되지 않음 |
| 자정 넘김/중복 | 허용되지 않음. 자정을 넘기는 기간은 날짜별로 나누고 블록이 겹치지 않도록 유지 |
| 사용자 소유권 | 관리자와 각 통합 원본은 서로 격리되며, 하나가 다른 하나를 지울 수 없음 |
| 통합 범위 | 안정적인 원본 scope_key(기본값 default)를 PH 대상에 매핑. 알 수 없거나 매핑되지 않으면 안전하게 차단 상태로 실패 |
| 원본 최신 상태 | 통합 주기별로 구성. 오래된 원본에 대한 동작을 명시해야 함 |
| 안전 | 비활성화/삭제/충돌 사용자, blockAllAccess, 유지 관리, 지오펜스, 속도 제한 또는 컨트롤러 확인을 절대 우회하지 않음 |
초기 제한: 정책/권한/원본 컨테이너당 50개 기간, 최대 절대 기간 90일, ID/라벨/범위 키 120자, 하루 8개 주간 블록, 새로 작성하는 항목은 이미 1시간 넘게 만료된 상태일 수 없음.
설정, 기본값 및 범위
출입문 설정
| 설정 | 기본값 | 범위 / 옵션 |
|---|---|---|
| 유지 시간 | 10초 | 1–30초 |
| 유지 관리 모드 | Normal | Normal / Force open / Force closed |
| 출입문 열림 소리 | 꺼짐 | 켜짐 / 꺼짐 |
| 출입문 위치 라벨 | — | 자유 텍스트, 최대 64자 |
| 아이콘 | Door | 10가지 옵션(아래 참조) |
| 자동 잠금 해제 일정 | 꺼짐 | Facility staffed hours 또는 Custom schedule, 시설 시간대 |
| 자동 잠금 해제 Unlock / Lock 시점 | At opening / At closing | At opening / At closing 또는 5, 10, 15, 30, 45, 60, 90, 120분 전이나 후 |
| 공휴일 자동 잠금 해제 | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| 액세스 승인(출입문별) | Access Policies | 일치하는 정책을 나열하며 blockAllAccess 허용 |
| 지오펜스(출입문별) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| 온라인 기준 | — | 최근 5분 이내에 하트비트가 있으면 컨트롤러가 온라인으로 간주됨 |
출입문 아이콘
| 아이콘 | 용도 |
|---|---|
| Door | 표준 단일 출입문(기본값) |
| Sliding door | 미닫이/자동문 |
| Double door | 양문/프렌치 도어 |
| Garage | 차고/롤러 도어 |
| Boom gate | 차단기 게이트/차단봉 |
| Pedestrian | 직원/보행자 출입구 |
| Security | 제한 구역/보안 출입문 |
| Office | 사무실/직원 전용 공간 |
| Delivery | 하역장/배송 구역 |
| Locker | 사물함/보관함 |
지오펜스 설정
| 설정 | 기본값 | 범위 |
|---|---|---|
| 지오펜스 활성화 | 켜짐(새 시설 구성의 경우) | 켜짐 / 꺼짐 |
| 반경 | 200 m | 50–5000 m(10 m 단위, 사전 설정 50 / 200 / 500 / 1000 m) |
| 정확도 버퍼 | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| 허용 범위 공식 | — | 반경 + 보고된 GPS 정확도 + 정확도 버퍼 |
액세스 유예 기간
Settings → Access Time Windows에서 설정합니다.
| 설정 | 옵션 |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30분 |
| Allow access after end | Off / 5 / 10 / 15 / 30분 |
앱 잠금 설정
| 설정 | 기본값 | 옵션 |
|---|---|---|
| Enforce app lock for this facility | 꺼짐 | 켜짐 / 꺼짐 |
| Grace period before re-prompting | 5분 | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| 여러 시설에서의 동작 | — | 연결된 시설 중 하나라도 적용하면 적용됨. 적용하는 시설 중 가장 짧은 유예 기간이 우선 |
지원 연락처
| 모드 | 동작 |
|---|---|
| Smart(기본값) | 출입문이 오프라인이거나 UI에 정보가 제한적일 때 자동으로 표시됨 |
| Always show | 항상 앱 대시보드에 표시됨 |
| Never show | 표시되지 않음 |
앱 메시지
| 필드 | 제한 / 옵션 |
|---|---|
| Notification type | Information / Notice / Urgent |
| Title | 120자 |
| Body | 2000자(500자에서 경고) |
| Link URL | http(s)만 해당, 2000자 |
| Link label | 80자, 기본값 "More info" |
| Schedule | 선택적 Starts at / Ends at |
| 자리 표시자(자동 규칙) | {firstName}, {lastName} |
| 자동 규칙 일치 필드 | Membership status / Person type / Tag(태그는 동기화된 태그 + 사용자 지정 태그와 일치, 대소문자 구분 안 함) / Door visibility |
| 규칙 우선순위 | 일치하는 첫 번째 활성 규칙이 우선(목록 순서) |
사용자 필드
| 필드 | 제한 / 참고 |
|---|---|
| 이름 / 성 | 각각 80자 |
| 휴대폰 번호 / 이메일 | 하나 이상 필요(OTP 로그인에 사용). 전화번호는 국제 형식으로 정규화됨 |
| 태그 | 태그당 80자. 동기화된 태그는 동기화 시 덮어쓰이며, 사용자 지정 태그는 관리자가 소유 |
| 메모 | 2000자 |
| Access enabled | 기본값 켜짐. 꺼지면 모든 잠금 해제가 거부됨 |
| 권한 | 시설 전체, 출입문 목록, 범위 목록, 선택적 운영 시간 |
| Access Policies | 사용자는 하나 이상의 명명 정책에 포함될 수 있음. 목록/유효 액세스에는 Access granted via policy가 사용됨 |
| Access Time Windows | 관리자가 소유한 편집 가능한 기간과 원본이 소유한 읽기 전용 기간. 정책 일정과는 별개 |
원본, 상태 및 기타 열거형
| 열거형 | 값 |
|---|---|
| 사용자 원본 | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| 사용자 타일 | All users / Has access / No access / Not synced |
| 초대 상태 | Not invited / Invited / Send failed |
| 초대 수신자 | Only users with door access / All eligible synced users |
| 초대 규칙 필드 | Membership status / Person type / Tag / Sync source / Integration. 연산자 is any of / is not any of |
| 접근 로그 보기 | Door events / No visit recorded |
| 앱 사용 현황 | Active(앱을 사용한 적 있음) / Not yet active |
| 필수 식별자(동기화) | Email OR phone(기본값) / Email required / Phone required / Both required |
| 동기화 로그 결과 | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| 기간 상태 | Active / Upcoming / Expired / Stale / Unmapped |
| 멤버십 상태 라벨 | Active, Current, Expired, On hold, Cancelled, Pending(및 원본 시스템의 모든 값) |
| 접근 범위 템플릿 | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| 자동 메시지 템플릿 | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
동기화 건너뛰기 사유
| 동기화 로그에 표시되는 사유 | 의미 |
|---|---|
| Integration sync is turned off for this facility | 원본의 마스터 토글이 꺼져 있음 |
| This integration is turned off in sync settings | 특정 통합이 제외됨 |
| No phone or email on the record (a phone or email is required to log in) | 레코드가 Require identifier 규칙을 충족하지 않음 |
| Record is decoupled and managed manually | 이 사용자의 Track source updates가 꺼져 있음 |
| No facility on the source record | 원본 레코드가 이 시설에 연결되어 있지 않음 |
| No matching user record | 변경 사항이 이곳에 행이 없는 사람을 참조함 |
운영 제한
| 제한 | 값 |
|---|---|
| CSV 가져오기 | 가져오기 1회당 200명 |
| 일괄 초대 | 50개 단위로 일괄 전송 |
| 일괄 삭제 미리 보기 샘플 | 처음 50명 표시 |
| 접근 로그 조회 | 기간당 최근 이벤트 최대 500개 |
| 액세스 이벤트 보존 | 약 13개월 후 자동으로 제거 |
| 관리자 잠금 해제 명령 유효 시간 | 30초(전달되지 않으면 명령이 만료됨) |
| 도어 컨트롤러 하트비트 | 약 30초마다. 5분 동안 응답이 없으면 오프라인 |
| 로그인 코드 요청 | 전화번호/이메일당 시간당 5회(보안 제한, 해제 불가) |
| 앱 로그아웃 적용 | 즉시 취소됨. 활성 세션이 완전히 종료되기까지 최대 15분 |
| 출입문 설정 저장 | 컨트롤러가 다시 로드됨. 일반적으로 10–15초 |
| No visit recorded 보존 | 약 13개월 |
| Access Time Window 매핑 | 통합당 50개 |
| 컨테이너당 Access Time Windows | 50개 |
| One-time 기간 범위 | 90일 |
| Weekly 블록 | 요일당 8개 |
| 기간/원본 ID, 라벨, 범위 키 | 120자 |
| 시설당 Access Policies | 100개 |
| 전체 정책 기간 | 500개 |
| Access Policy 이름/ID | 120자 |
| Access Policy 설명 | 500자 |
| Access Policy 구성 | 300 KiB UTF-8 |