키카드 인코더 설정

빠른 설정

인코더 유형을 선택하고, 필요하면 연결 방식을 고른 뒤, 인코더를 추가하세요. 약 15분 정도를 예상하면 됩니다.

이 안내서는 키오스크 또는 프런트 데스크용 인코더 우선 키카드 인코딩을 설정하는 방법을 설명합니다. 이제 Be-Tech Windows Agent 설정도 포함합니다. Be-Tech은 직접 Base URL을 구성하지 않는 한 기본적으로 Windows Agent를 사용합니다. 키오스크 라우팅은 이제 Settings → Kiosk에 있습니다.

빠른 참고

작업	수행 기능	클릭 위치
Select method	키카드 인코딩 활성화	Room Access → Keycard Encoding
Choose encoder type	잠금 시스템 선택	Encoder Type
Choose connection method	직접 연결 또는 Windows Agent(Saflok/Be-Tech/GreatLocks)	Advanced options → Enable direct communication
Configure encoder	서버 또는 자격 증명 정보 추가	유형별 필드
Add encoders	실제 인코더 ID가 있는 물리 장치 등록	Physical Encoder Devices
Choose kiosk routing	키오스크 전용 라우팅 규칙 제어	Settings → Kiosk → Device Routing
Download Windows Agent	에이전트용 부트스트랩 패키지 다운로드	Windows Agent
Check agent version	설치 버전과 최신 버전 상태 표시	Windows Agent
Update agent	업데이트 안내 모달 열기	Update
Manage agent cards	설치, 업데이트, 재설치 동작 제공	Windows Agent
Advanced agent actions	로그 보기, 비밀값 회전, 에이전트 삭제	Advanced options
Set encoding defaults	숙박당 카드 수 + 만료 시간	Encoding Options

찾는 위치

Settings → Room Access → Keycard Encoding

1단계: 키카드 방식 선택

1. Settings → Room Access로 이동합니다.
2. 객실 접근 방식으로 Keycard Encoding을 선택합니다.
3. Save를 클릭합니다.

2단계: 인코더 유형 선택

1. Keycard Encoder Settings까지 스크롤합니다.

2. Saflok, Be-Tech, LockSDK, GreatLocks, 또는 PMS Integration을 선택합니다.

   ✓ AVA는 선택한 인코더 유형만 활성 상태로 유지합니다.

3단계: 연결 방식 선택

1. Select Encoder Type에서 Advanced options를 엽니다.
2. Saflok, GreatLocks, 또는 LockSDK의 경우 Windows Agent를 우회하려면 Enable direct communication을 켭니다.
3. Windows Agent를 사용하려면 끈 상태로 둡니다(기본값).
4. Be-Tech은 이미 직접 Base URL을 구성한 경우가 아니라면 Windows Agent를 사용합니다.
5. PMS Integration은 직접 통신만 사용하므로 이 단계는 건너뜁니다.

4단계: 인코더 시스템 구성

인코더 자격 증명 제목

여러 인코더를 사용하면 섹션 제목이 Encoder Credentials & Devices로 표시됩니다.

Saflok을 사용하는 경우

• 직접 통신
  • PMSI Server URL, Username, Password를 입력합니다.
  • PMSI 서버는 인터넷에서 접근 가능해야 합니다.
  • Test Connection을 클릭합니다.
• Windows Agent
  • Username과 Password만 입력합니다.
  • PMSI URL과 연결 테스트는 에이전트가 처리합니다.
  • AVA는 Saflok PMSI 준비 상태를 계속 재확인하므로, 느린 부팅과 재시작도 보통 자동 복구됩니다.
• Physical Encoder Devices에서 인코더 장치를 추가합니다(Encoder ID 필요).
• 필요하면 각 인코더에 Location을 설정합니다.
• 여러 키오스크가 인코더를 공유하면 Settings → Kiosk → Device Routing에서 라우팅을 추가합니다.

Be-Tech을 사용하는 경우

• 직접 통신
  • Be-Tech 서비스의 Base URL을 입력합니다.
  • 서비스는 인터넷에서 접근 가능해야 합니다.
  • Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
  • Be-Tech 설정에 필요하면 Category와 Card Type을 설정합니다.
  • Base URL이 저장되어 있으면 AVA는 Be-Tech을 직접 모드로 유지합니다.
  • Test Connection으로 인코더 응답을 확인합니다.
• Windows Agent
  • Be-Tech 워크스테이션에 연결된 Windows PC에 에이전트를 설치합니다.
  • Hotel Name, Chain No, Workstation, Reader No를 입력합니다.
  • 에이전트가 로컬 Be-Tech 어댑터를 처리하고 벤더 트래픽을 프록시합니다.
  • AVA는 5분마다 /check로 에이전트를 확인합니다.
  • 재시작 후 상태가 반영되기까지 몇 분 걸릴 수 있습니다.
  • Base URL이 저장되어 있지 않으면 AVA는 Windows Agent 흐름으로 되돌아갑니다.
• Physical Encoder Devices에서 인코더 장치를 추가합니다.
• 여러 인코더를 쓰면 Settings → Kiosk → Device Routing에서 라우팅을 추가할 수 있습니다.

GreatLocks를 사용하는 경우

• 직접 통신
  • Server Name(선택 사항), XHLSI Server IP Address, TCP Port를 입력합니다.
  • 서버는 인터넷에서 접근 가능해야 합니다.
  • GreatLocks는 서버당 인코더 1개를 지원합니다.
  • Test Connection을 클릭합니다.
• Windows Agent
  • 서버 정보는 에이전트가 처리하므로 IP/포트가 필요하지 않습니다.
  • GreatLocks는 서버당 인코더 1개를 지원합니다.

참고: AVA는 Room Access에 저장한 GreatLocks 서버 레코드를 사용합니다. 이전 설정을 업데이트한 경우, Test Connection 전에 Save를 클릭하세요. 재고 동기화가 켜져 있으면 AVA는 활성 에이전트 터널을 통해 건물, 층, 객실 데이터를 읽습니다. 객실 목록을 최신 상태로 유지하려면 에이전트를 온라인 상태로 두세요. GreatLocks가 리프트 접근에 건물과 층 값을 사용하게 하려면 Enable lift access를 켭니다. 이 설정은 GreatLocks에서만 사용할 수 있습니다.

LockSDK를 사용하는 경우

• 직접 통신
  • 각 LockSDK 인코더를 Physical Encoder Devices에 추가합니다.
  • 각 인코더에 Encoder ID와 Service URL을 입력합니다.
  • 인코더 항목을 추가한 뒤 Test Connection을 클릭합니다.
• Windows Agent
  • 각 LockSDK 인코더를 Physical Encoder Devices에 추가합니다.
  • LockSDK 인코더마다 Windows Agent 하나를 등록합니다.
  • 에이전트 카드에는 매칭 인코더와 실시간 상태가 표시됩니다.
• 여러 인코더를 쓰면 Settings → Kiosk → Device Routing에서 라우팅을 추가할 수 있습니다.
• 결합 객실의 경우, LockSDK는 최대 4개 객실을 지원하며 RF50/Mifare lock type 5가 필요합니다.

PMS Integration을 사용하는 경우

• 활성 PMS 연동(Cloudbeds 또는 Opera)이 있는지 확인합니다.
• Physical Encoder Devices에서 다음 중 하나를 수행합니다.
  • Load Encoders와 Add Selected를 클릭하거나
  • Add Encoder를 클릭해 Encoder ID와 PMS Encoder ID를 입력합니다.
• 불러온 장치는 이제 공급자 인코더 ID를 직접 유지합니다.
• 사용하지 않을 인코더는 Active로 비활성화합니다.

라우팅 위치 변경

AVA는 이제 키오스크 라우팅을 Settings → Kiosk → Device Routing에서 관리합니다. Room Access 페이지는 인코더 설정을 유지하고, 라우팅은 여기서 설정하라는 안내만 보여줍니다.

5단계: 키오스크 라우팅 설정(선택 사항)

이 섹션은 키오스크 전용 라우팅 동작이 필요할 때만 사용합니다.

1. Settings → Kiosk로 이동합니다.

2. Device Routing을 엽니다.

3. 게스트가 키오스크에서 인코더를 선택할 수 있게 하려면 Enable guest selection을 켭니다.

4. 직접 라우팅 규칙을 추가하려면 끕니다.

5. AVA는 이러한 키오스크 규칙을 Mini MDM Device ID에 저장합니다.

6. 예전 장치 ID 매핑은 저장 시 자동으로 업데이트됩니다.

   ✓ 게스트 선택이 켜져 있으면 AVA는 수동 라우팅 규칙을 숨깁니다. ⚠️ Physical Encoder Devices에는 여전히 최소 한 개의 인코더 장치가 필요합니다. ✓ AVA는 키오스크 매핑 없이 encoderId로 인코딩 요청을 보낼 수 있습니다.

운영에서의 인코더 선택 동작

• 온라인 인코더가 정확히 하나면 AVA가 자동으로 선택합니다.
• 온라인 인코더가 여러 개면 직원이 직접 하나를 선택해야 합니다.

실시간 온라인 상태

Online은 인코더의 장치 상태와 에이전트 터널이 모두 정상이라는 뜻입니다. Status: 줄에는 연결이 살아난 뒤에만 online이 표시됩니다. 인코더가 오프라인으로 떨어지면 먼저 에이전트 또는 터널을 복구하세요.

6단계: Windows Agent 설정(Windows Agent 전용)

Direct communication을 켜지 않았다면 Windows Agent를 설치합니다.

1. Windows Agent로 이동합니다.

2. 새 카드의 Download Windows Agent를 클릭하거나, 기존 카드의 Reinstall을 클릭합니다.

3. 인코더에 연결된 Windows PC에 에이전트를 설치합니다.

4. 카드에 Not connected 또는 Never online이 표시되면, 다운로드한 zip을 풀고 download-installer.bat을 실행합니다.

5. 다운로드가 끝나면 저장된 설치 파일 .exe를 실행합니다.

   ✓ 에이전트가 Registered Agents에 상태 정보와 함께 표시됩니다. ✓ AVA는 인코더 사용 가능 여부를 판단할 때 이 실시간 상태를 사용합니다. ✓ 각 카드에는 Installed version과 가능한 경우 Latest version이 표시됩니다. ✓ 에이전트가 최신이면 Latest version installed가 표시됩니다. ✓ 에이전트가 오래됐으면 Reinstall 전에 Update를 클릭합니다.

Be-Tech, Saflok, GreatLocks, LockSDK는 모두 Windows Agent를 사용할 수 있습니다. 에이전트가 오래되었을 때는 메인 카드에서 Reinstall 앞에 Update가 표시됩니다. Advanced options를 열면 View Logs, Rotate Secret, Delete를 사용할 수 있습니다. Rotate Secret는 현재 에이전트를 분리하기 전에 확인 대화상자를 엽니다.

서비스 제어

서비스를 제어해야 할 때는 Windows Agent 트레이에서 Start, Stop, Restart를 사용합니다. Windows가 권한을 요청하면 계속하려면 UAC 프롬프트를 허용하세요. 프롬프트를 취소했다면 작업을 다시 시도하고 허용합니다.

버전이 오래되었을 때 보이는 내용

보이는 현상: 카드에 Outdated가 표시되거나, 하트비트에서 설치 버전이 보고되지 않았다고 나옵니다.

해결:

1. Update를 클릭합니다.
2. 업데이트 모달을 읽습니다.
3. Windows Agent 앱을 엽니다.
4. Check for Update를 클릭합니다.
5. 제공된 업데이트를 설치합니다.
6. Settings → Room Access를 새로고치고 버전 상태가 최신인지 확인합니다.

같은 버전 상태는 LockSDK 에이전트 카드에도 표시됩니다.

7단계: 인코딩 기본값 설정

1. Number of Cards to Encode를 설정합니다(보통 1~2개).
2. Keycard Expiration Time을 설정합니다(기본값: 11:00 AM). 이 시간은 수동 키카드 인코딩 시 Valid Until에 미리 채워집니다.

선택 사항으로 Advanced options를 펼쳐 Heartbeat Monitor를 켤 수 있습니다.

선택 사항: PMS 객실을 인코더 이름에 매핑

인코더가 PMS와 다른 객실 이름을 사용한다면:

• Keycard Room Mapping을 사용합니다.

문제 해결

인코더가 응답하지 않거나 카드 인코딩이 실패하면 전체 점검 목록을 사용합니다.

• 키카드 인코더 문제 해결

아직 막혔나요?

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

• ❌ 인코더 설정은 저장되지만 장치가 계속 오프라인 상태임
• ❌ 어떤 객실도 인코딩할 수 없음
• ❌ Registered Agents에서 에이전트가 온라인으로 표시되지 않음

포함하면 좋은 정보:

• 인코더 유형과 모델
• Keycard Encoder Settings 스크린샷
• 문제가 시작된 시각

관련 안내

• 키카드 객실 매핑
• 결합 객실 설정
• 키카드 인코더 문제 해결