문제 해결

가장 흔한 Door & Gate Access 문제에 대한 증상별 해결 방법입니다. 각 항목은 증상 → 원인 → 해결 순서로 구성됩니다. 상태나 거부 사유의 의미는 참조를, 기본 결정 로직은 액세스 결정 방식을 참조하십시오.

접근 로그부터 확인하십시오. "들어갈 수 없다"는 거의 모든 보고에는 접근 로그에 정확한 사유가 포함된 거부 이벤트가 있습니다. 회원 이름을 검색하고 가장 최근의 거부 이벤트를 확인한 다음 아래에서 해당하는 섹션으로 이동하십시오.

출입문이 오프라인으로 표시됨

증상: 출입문 카드에 오프라인이 표시되고, 회원에게 "Door offline"이 표시되며, 잠금 해제를 보낼 수 없습니다.

원인: 도어 컨트롤러가 5분 넘게 보고하지 않았습니다. 기기의 전원이나 네트워크가 끊긴 상태입니다.

해결 방법:

1. 컨트롤러에 전원이 공급되고 네트워크 연결(Ethernet 케이블/Wi-Fi)이 되어 있는지 확인합니다. 하드웨어 문제 해결 페이지에서 현장 점검(표시등 LED, PoE 스플리터, 케이블 연결, 4G 모델의 SIM/안테나)을 다룹니다.
2. 출입문 패널 → Overview 탭을 열어 Status(마지막 확인 시간), IP address 및 가동 시간을 확인합니다. 마지막 확인 시간이 최근이면 기기 고장보다는 간헐적인 네트워크 문제일 가능성이 높습니다.
3. 필요한 경우 컨트롤러의 전원을 껐다가 다시 켭니다.
4. 더 자세히 진단하려면 Open in Device Management for advanced configuration을 따르십시오.
5. 여러 출입문이 동시에 오프라인이 되었다면 기기보다는 사이트의 네트워크/인터넷을 의심하십시오.

출입문이 오프라인인 동안 회원의 대시보드에는 지원 연락처 세부 정보가 표시되므로(기본 Smart 모드) 회원이 사용자에게 전화할 수 있습니다.

회원이 거부됨 — "You don't have access to this door"

증상: 사유가 no_matching_policy_or_grant인 거부 이벤트가 있습니다.

원인: 허용된 추가 경로가 없습니다. Who, Where, When을 모두 충족하는 활성화된 Access Policy가 없고, 해당 출입문을 포함하는 영구 권한이나 활성 관리자/통합 기간도 없습니다.

해결 방법:

1. Users에서 회원을 열고 사람 유형, 멤버십 상태, 동기화된/사용자 지정 태그를 정책의 Who와 비교합니다.
2. Where에 해당 출입문이 직접, Access Scope를 통해 또는 모든 시설 출입문을 통해 포함되어 있고, 제외 항목으로 인해 빠지지 않았는지 확인합니다.
3. When을 확인합니다. Anytime이거나 활성 Weekly/One-time 기간이 하나 이상 있어야 합니다. 종료 시간은 포함되지 않습니다.
4. 정책들은 OR로 결합되지만 각 정책은 Who, Where, When을 모두 충족해야 한다는 점을 기억하십시오. 일부만 일치하면 절대 액세스가 허용되지 않습니다.
5. 적절한 경우 별도의 영구 권한이나 관리자 기간을 사용하십시오. 이는 계속 추가적으로 적용됩니다.

회원이 거부됨 — "Your access has been suspended"

증상: 사유가 access_disabled인 거부 이벤트가 있으며, 사용자에게 Disabled 배지가 표시됩니다.

원인: 사용자의 액세스가 꺼져 있습니다. 수동으로(관리자가 Access enabled를 끔) 또는 자동으로(통합에서 회원이 삭제되어 패널에 Removed by integration이 표시되거나 소프트 삭제됨) 발생합니다.

해결 방법: 사용자를 열고 Access enabled를 다시 켭니다. Removed by integration이 표시되는 경우 소스 시스템에서 사용자를 복원합니다(또는 행을 분리하고 수동으로 액세스를 활성화합니다).

예약된 정책이 액세스를 허용하지 않음

증상: 앱에 향후 이용 가능 시간이 표시되거나 로그에 outside_access_time_window가 있습니다. 소스 기간이 Stale 또는 Unmapped로 표시되거나, 예상하지 못한 시간에 액세스가 변경됩니다.

해결 방법:

1. 정책이 활성화되어 있는지 확인합니다.
2. When 일정을 조사하기 전에 같은 정책의 Who와 Where를 확인합니다.
3. One-time 기간의 경우 시도 시간을 [from, to)와 비교합니다. 표시되는 시간대는 저장된 시점을 바꾸지 않습니다.
4. Weekly 기간의 경우 IANA 시간대, 현지 요일/시간 블록, 선택적 활성 기간 경계 및 일광 절약 시간 전환을 확인합니다. 종료 시간은 포함되지 않으며 자정을 넘기는 블록은 나누어야 합니다.
5. 접근 로그의 policyId 및 policyName을 사용하여 어떤 이름의 정책이 평가되었는지 확인합니다.
6. blockAllAccess, Force closed, 사용자 비활성화, 지오펜스 및 컨트롤러 상태가 우선 적용되고 있지 않은지 확인합니다.

별도의 통합 기간의 경우 논리적 범위 매핑, 소스 리비전, 소스 경과 시간 및 전송 상태도 확인하십시오. 알 수 없거나, 매핑되지 않았거나, 오래된 소스 기간은 Access Policy 또는 영구 권한 경로를 제거하지 않고 차단 상태로 실패합니다.

호환성 사유가 outside_access_hours이므로 이전 클라이언트에는 Outside hours가 표시될 수 있습니다. 접근 로그와 최신 클라이언트는 outside_access_time_window 세부 정보를 사용합니다.

지오펜스 거부 — "Move closer" 등

증상: 사유가 outside_geofence, gps_too_imprecise 또는 location_unavailable인 거부 이벤트가 있습니다.

거부 이벤트의 세부 정보 대화 상자에는 보고된 좌표, 정확도 및 거리가 표시되므로 회원이 실제로 현장에 있었는지 판단하는 데 매우 유용합니다.

잠금 해제를 보냈지만 출입문이 열리지 않음(Timed out / Failed)

증상: 이벤트가 Confirmed unlocked가 아닌 Timed out 또는 Failed로 끝납니다.

원인: 명령이 서버에 도달했지만 컨트롤러가 확인하지 않았습니다. 출입문의 연결이 불안정하거나 기기에 결함이 있습니다.

해결 방법:

1. 출입문의 온라인 상태와 기기 정보(Overview 탭)를 확인합니다. 한 출입문에서 시간 초과가 반복되면 해당 출입문의 네트워크 문제입니다.
2. 출입문을 지켜보면서 패널에서 관리자 Unlock door를 시도합니다.
3. Identify device(신호음 세 번)를 사용하여 실제로 올바른 컨트롤러 앞에 있는지 확인합니다.
4. 릴레이에서 딸깍 소리가 나지만 출입문이 풀리지 않으면 잠금 회로에 결함이 있는 것입니다. 하드웨어 문제 해결의 점퍼 및 멀티미터 테스트를 실행하십시오.
5. 기기가 온라인이지만 작동하지 않으면 Device Management 진단을 통해 에스컬레이션합니다.

Maintenance mode도 확인하십시오. Force closed로 설정된 출입문은 설계상 회원에게 잠긴 상태로 유지됩니다. Block all access at this door는 명시적으로 blockAllAccess를 설정하여 모든 회원 정책, 영구 권한 및 Access Time Window를 거부합니다.

컨트롤러가 온라인이지만 정상적으로 응답하지 않으면 Remotely reboot device(출입문 패널 → Configuration → Advanced)로 다시 시작합니다. 출입문은 현재 잠금 상태를 유지하며 부팅하는 동안 1~2분간 오프라인이 됩니다.

회원이 앱에 로그인할 수 없음

증상: Send code 단계에서 "No record found"가 표시됩니다.

원인: 입력한 전화번호/이메일이 어떤 Users 레코드와도 일치하지 않습니다.

해결 방법: Users에서 해당 행을 찾아 식별자를 정확히 비교합니다. 다른 번호 형식, 이전 이메일 또는 누락된 식별자가 일반적인 원인입니다. 행을 업데이트합니다(또는 회원에게 등록된 식별자를 사용하도록 안내합니다). 각 행에는 전화번호나 이메일 중 하나 이상이 필요하다는 점을 기억하십시오.

증상: "Too many attempts."

원인: 속도 제한입니다. 연락처당 시간당 5회의 코드 요청 제한과 네트워크 수준 제한이 있습니다.

해결 방법: 기다리십시오. 연락처별 제한은 보안 조치이므로 해제할 수 없습니다.

초대 문제

초대 → 문제 해결의 전용 표를 참조하십시오. 빠른 해결: Send failed → 주소를 확인하고 다시 보냅니다. 일괄 전송에 포함되지 않음 → 이미 초대되었거나, 앱을 사용한 적이 있거나, 이메일이 없거나, 액세스 권한이 없습니다.

동기화된 사용자가 누락되었거나 최신 상태가 아님

증상: 회원 시스템에는 사람이 있지만 Users에는 없거나, 세부 정보가 오래되었습니다.

해결 방법:

1. Settings → Sync settings를 확인합니다. 소스가 활성화되어 있습니까? 특정 통합이 활성화되어 있습니까? 카드에 N removals held back for review가 표시되면 대규모 제거가 관리자의 검토를 기다리고 있는 것입니다.
2. Sync activity & troubleshooting을 펼치고 해당 사람을 검색합니다. 건너뜀 사유에 정확한 이유(식별자 누락, 분리됨, 통합 꺼짐 등)가 표시됩니다. 건너뜀 사유 표를 참조하십시오.
3. 사용자의 Track source updates 토글을 확인합니다. 분리된 행은 소스에서 절대 업데이트되지 않습니다.
4. 행에 Not synced – duplicate가 표시되면 다른 레코드가 같은 이메일이나 전화번호를 공유하고 있는 것입니다. 중복 해결을 참조하십시오.
5. 매일 실행되는 전체 동기화를 기다리지 말고 Sync now로 강제로 실행합니다.
6. Access Time Windows의 경우 소스 경과 시간, 리비전 결과(updated/idempotent/stale/conflict) 및 scope_key 매핑도 검사합니다. 가져오기가 실패하면 이전 스냅샷을 지우지 않고 그대로 유지해야 합니다.

자동 잠금 해제 일정이 출입문을 열지 않음

증상: 예약된 기간 동안 출입문이 열린 상태로 유지되지 않습니다.

해결 방법:

1. 출입문의 Schedule 탭을 열고 Auto-unlock이 켜져 있는지 확인합니다. Next 14 days 미리 보기에서 출입문이 잠금 해제되어야 하는 시간을 확인합니다.
2. 시설 직원 상주 시간을 사용하는 경우 시설 및 시스템 구성에서 시설의 직원 상주 시간과 휴일 운영 시간을 확인합니다. 공휴일에는 On public holidays 설정에 따라 출입문이 휴일 운영 시간을 따를지, 잠긴 상태를 유지할지, 휴일을 무시할지가 결정됩니다.
3. Custom schedule을 사용하는 경우 해당 요일에 실제로 시간 블록이 있는지 확인합니다.
4. 직원이 Lock now를 사용했는지 확인합니다. 카드에 Locked by staff until HH:MM이 표시됩니다. Resume schedule로 일정을 다시 적용합니다.
5. 일정 변경은 저장한 후에만 적용되며, 저장하면 컨트롤러가 다시 로드된다는 점(일반적으로 10~15초)을 기억하십시오.
6. Maintenance mode가 우선 적용됩니다. Force closed로 설정된 출입문은 자동으로 열리지 않습니다.
7. 시간은 시설의 시간대를 기준으로 합니다. 기간이 이상한 시간에 실행되면 시설의 시간대 설정을 확인하십시오.

관리자가 설정을 변경했지만 아무 변화가 없음

증상: 정책/지오펜스/메시지를 편집했지만 효과가 없습니다.

원인: Settings 탭의 변경 사항은 저장 표시줄에서 Save changes를 클릭해야 적용됩니다. 다른 페이지로 이동하면 변경 사항을 취소할지 묻습니다.

해결 방법: 다시 적용하고 저장합니다. 정책 및 지오펜스 변경 사항은 이후 인증 시도에 사용되며, 앱 측 설정은 회원의 앱이 다음에 새로 고쳐질 때 표시됩니다.

관련 페이지

• 하드웨어 문제 해결 — 전원, 릴레이 및 잠금 배선 진단
• 접근 로그
• Access Policy 일정
• 참조 — 모든 거부 사유 및 기본값
• 자주 묻는 질문