본문으로 건너뛰기

키카드 인코더 문제 해결

빠른 조치

먼저 네트워크와 전원을 확인한 뒤 카드 1장을 다시 인코딩해 보세요. 약 2분이면 됩니다.

이 가이드는 키카드 인코더에서 자주 발생하는 문제를 해결하는 방법을 안내합니다.

빠른 참고​

보이는 현상발생 이유조치
인코더가 응답하지 않음전원 또는 네트워크 문제연결 상태 확인
카드가 인코딩되지 않음카드 유형 또는 장치 문제카드 및 장치 확인
"UserCredentialsNotProvided.NotApplicable"Saflok 자격 증명이 누락되었거나 불완전함Saflok 자격 증명 추가
인코더 유형 변경이 유지되지 않음이전 저장으로 인코더 상태가 섞임인코더 유형 다시 저장
"Test Connection" 실패(Be-Tech)Base URL 또는 서비스 문제Be-Tech 연결 수정
"Service URL is required" (LockSDK)Direct 모드에서 인코더마다 Service URL이 필요함LockSDK 서비스 URL 추가
LockSDK 에이전트가 Not registered아직 인코더별 에이전트 장치가 없음LockSDK 에이전트 등록
Heartbeat Monitor가 저장 후 꺼짐현재 호텔 세션에 저장이 유지되지 않음Heartbeat Monitor 다시 저장
Heartbeat가 unreachableAgent 오프라인 또는 터널 문제Agent 상태 확인
인코더가 계속 사용 불가로 표시됨연결 상태가 false인데 heartbeat는 정상실시간 인코더 상태 확인
Windows Agent가 Not connectedAgent가 실행되지 않거나 설치가 불완전함Agent 다시 연결

인코더가 응답하지 않음​

보이는 현상: AVA에서 인코더가 오프라인이거나 응답하지 않습니다.

해결 방법:

  1. 인코더의 전원과 케이블을 확인합니다.
  2. 키오스크와 인코더 사이의 네트워크 연결을 확인합니다(Direct Connection 전용).
  3. 서버 IP와 포트가 올바른지 확인합니다.
  4. 인코더 소프트웨어를 다시 시작합니다.

카드가 인코딩되지 않음​

보이는 현상: 키카드 쓰기가 실패하거나 빈 카드가 나옵니다.

해결 방법:

  1. 카드 유형이 인코더와 일치하는지 확인합니다.
  2. 카드를 다시 넣고 재시도합니다.
  3. 새 빈 카드로 시험해 봅니다.
  4. Enable guest selection이 꺼져 있으면 키오스크가 올바른 인코더로 라우팅되는지 확인합니다.
  5. Enable guest selection이 켜져 있으면 키오스크에서 게스트가 온라인 인코더를 선택하는지 확인합니다.

Saflok 자격 증명이 제공되지 않음​

보이는 현상: 키카드 인코딩 중 "UserCredentialsNotProvided.NotApplicable"가 표시됩니다.

해결 방법:

  1. **Settings → Room Access → Key Card Encoding (Kiosk)**로 이동합니다.
  2. Encoder Type을 Saflok으로 설정합니다.
  3. Encoder Credentials에 Username과 Password를 입력합니다.
  4. Direct communication을 켠 경우 PMSI Server URL을 입력합니다.
  5. Save를 클릭합니다.
  6. Test Connection을 클릭한 뒤 테스트 카드 1장을 인코딩합니다.

인코더 유형 변경이 유지되지 않음​

보이는 현상: 인코더 유형을 하나 선택했지만 다른 인코더가 계속 활성화됩니다.

해결 방법:

  1. **Settings → Room Access → Key Card Encoding (Kiosk)**로 이동합니다.
  2. Keycard Encoder Settings에서 원하는 인코더 유형을 선택합니다.
  3. Save를 한 번 클릭하고 성공 메시지를 기다립니다.
  4. 페이지를 새로고침해 해당 인코더 유형만 활성화되었는지 확인합니다.
  5. 문제가 반복되면 유형을 바꿔 저장한 뒤, 다시 원래 유형으로 돌아가 저장합니다.

Be-Tech 연결 테스트 실패​

보이는 현상: "Test Connection"이 실패하거나 버튼이 비활성화된 상태로 남습니다.

해결 방법:

  1. Base URL이 http:// 또는 https://로 시작하는지 확인합니다.
  2. 인코더 워크스테이션에서 Be-Tech 서비스가 실행 중인지 확인합니다.
  3. 워크스테이션과 키오스크가 같은 네트워크에 있는지 확인합니다.
  4. Hotel Name, Chain No, Workstation, Reader No를 다시 입력합니다.
  5. Test Connection을 다시 클릭합니다.

LockSDK 서비스 URL이 필요함​

보이는 현상: 저장이 막히거나 인코더 폼에 "Service URL is required."가 표시됩니다.

해결 방법:

  1. **Settings → Room Access → Key Card Encoding (Kiosk)**로 이동합니다.
  2. LockSDK를 선택합니다.
  3. Physical Encoder Devices를 열고 인코더를 편집합니다.
  4. http://127.0.0.1:8092처럼 유효한 Service URL을 입력합니다.
  5. Save를 클릭한 뒤 Test Connection을 실행합니다.

LockSDK 에이전트가 등록되지 않음​

보이는 현상: LockSDK 인코더 카드의 Windows Agent에 Not registered가 표시됩니다.

해결 방법:

  1. Physical Encoder Devices에 LockSDK 인코더가 있는지 확인합니다.
  2. Windows Agent로 이동해 인코더 카드를 찾습니다.
  3. 카드가 새 카드라면 Download Windows Agent를, 이미 존재한다면 Reinstall을 클릭합니다.
  4. 패키지를 압축 해제하고 연결된 Windows PC에서 .bat 파일을 실행합니다.
  5. 상태를 새로고침해 카드가 Not registered에서 Connected 또는 Not connected로 바뀌는지 확인합니다.
  6. Advanced options에서는 View Logs, Rotate Secret, 또는 Delete만 사용합니다.

Heartbeat Monitor가 저장 후 꺼짐​

보이는 현상: Heartbeat Monitor를 켠 뒤 Save를 클릭하면 다시 꺼집니다.

해결 방법:

  1. **Settings → Room Access → Key Card Encoding (Kiosk)**로 이동합니다.
  2. Encoding Options → Advanced options를 엽니다.
  3. Heartbeat Monitor를 켭니다.
  4. Save를 한 번 클릭하고 성공 메시지를 기다립니다.
  5. 페이지를 새로고침해 Heartbeat Monitor가 계속 켜져 있는지 확인합니다.
  6. 그래도 꺼지면 호텔 전환 후 설정이 저장되지 않음을 따릅니다.

Heartbeat 실패​

보이는 현상: Heartbeat Monitor에 unreachable가 표시됩니다.

해결 방법:

  1. Agent가 키오스크/PC에서 실행 중인지 확인합니다.
  2. Registered Agents에서 온라인 상태와 터널 도달 가능 여부를 확인합니다.
  3. Agent 로그에서 오류를 확인합니다.
  4. 필요하면 Agent를 재설치합니다.

실시간 인코더 상태가 일치하지 않음​

보이는 현상: 인코더는 설정되어 보이지만 AVA에서는 여전히 사용 불가로 표시됩니다.

이유: AVA는 Agent가 연결되고 터널에 도달 가능할 때만 online으로 표시합니다.

해결 방법:

  1. Registered Agents에서 해당 인코더 카드를 확인합니다.
  2. 장치가 연결되어 있고 터널에 도달 가능한지 확인합니다.
  3. 먼저 Agent 또는 네트워크 문제를 해결합니다.
  4. Settings → Room Access를 새로고침합니다.
  5. 다시 인코딩을 시도합니다.
  6. 설정 페이지의 Status: 줄을 다시 확인합니다.

Windows Agent가 연결되지 않음​

보이는 현상: 상태가 Not connected 또는 "Never online."으로 표시됩니다.

해결 방법:

  1. 다운로드한 zip을 열고 .bat 파일을 실행합니다.
  2. Windows PC에 인터넷 연결이 있는지 확인합니다.
  3. 필요하면 Windows Agent에서 Reinstall을 क्लिक합니다.
  4. Registered Agents 상태를 새로고침합니다.
  5. Settings → Room Access로 돌아가 **Status:**가 online으로 바뀌었는지 확인합니다.

Kiosk 라우팅 규칙이 보이지 않음​

보이는 현상: Kiosk to Encoder Routing 아래에서 라우팅 규칙을 찾을 수 없습니다.

해결 방법:

  1. Enable guest selection이 켜져 있는지 확인합니다.
  2. 수동 라우팅 규칙을 보이게 하려면 이 옵션을 끕니다.
  3. Physical Encoder Devices에 장치를 최소 1개 추가합니다.

계속 문제가 있나요?​

다음 경우 success@vouch-technologies.com으로 문의하세요.

  • ❌ 전원과 네트워크를 확인한 뒤에도 인코더가 오프라인 상태
  • ❌ 여러 키오스크에서 카드 인코딩 실패
  • ❌ Heartbeat가 30분 이상 비정상 상태

함께 보내면 좋은 정보:

  • 인코더 유형과 모델
  • Registered Agents와 Heartbeat Monitor 스크린샷
  • 문제가 시작된 시간

관련 가이드​