EVA 정부 연동 설정
빠른 설정
호텔이 싱가포르에 있는 경우 약 3분 내에 EVA를 활성화하고 키를 저장할 수 있습니다.
이 가이드는 싱가포르 숙소에서 EVA를 활성화하고 정부 연동 설정을 관리하는 방법을 안내합니다.
빠른 참조
| 설정 | 제어 항목 | 수행 작업 |
|---|---|---|
| Country | 위치별 옵션 표시 | EVA 설정을 열려면 Singapore를 선택 |
| Enable E-Visitor Authentication (EVA) | EVA 흐름 On/Off | EVA 자격 증명 필드를 표시하려면 On |
| EVA Environment | 운영 또는 테스트 트래픽 | 먼저 TEST, 이후 LIVE로 전환 |
| Generate JWKS | 키 자료 생성 | 한 번 클릭 후 생성된 값을 확인 |
| Save Government Settings | 모든 변경 저장 | 변경 후 Save Government Settings 클릭 |
시작 전
- 호텔에서 규정 준수 보고 기능에 접근 가능한지 확인합니다.
- 설정 수정 권한이 있는지 확인합니다.
- EVA 자격 증명을 준비해 둡니다.
접근 권한 요구사항
호텔 요금제에 규정 준수 보고 접근 권한이 포함된 경우에만 Government Integration이 표시됩니다.
단계별 EVA 설정
- Settings → Government Integration으로 이동합니다.
- 필요하면 Settings에서 아래로 스크롤합니다. 이 메뉴는 Security 아래에 표시됩니다.
- Country를 Singapore로 설정합니다.
- **Enable E-Visitor Authentication (EVA)**를 켭니다.
- EVA Environment를 선택합니다.
- 점검용: TEST
- 운영용: LIVE
- 다음 필드를 입력합니다.
- Hotel Code
- API Key
- JWKS
- Public Key (PEM)
- Private Key (PEM)
- Save Government Settings를 클릭합니다.
✓ 저장 후 성공 메시지가 표시되어야 합니다.
JWKS 키 생성
새 JWKS 및 PEM 키가 필요할 때 사용합니다.
- Government Integration을 엽니다.
- Country가 Singapore인지, EVA가 활성화되어 있는지 확인합니다.
- Generate JWKS를 클릭합니다.
- 필드가 업데이트될 때까지 기다립니다.
- Save Government Settings를 클릭합니다.
✓ JWKS, Public Key, Private Key 값이 갱신되어야 합니다.
저장 필수
생성된 키는 Save Government Settings를 클릭하기 전까지 영구 저장되지 않습니다.
기존 시크릿 값 업데이트
일부 시크릿 필드는 "Configured"로 표시되며 잠긴 상태일 수 있습니다. 기존 값이 노출되지 않도록 보호하기 위한 동작입니다.
- 해당 필드의 Edit 버튼을 클릭합니다.
- 새 값을 입력합니다.
- Save Government Settings를 클릭합니다.
문제 해결
Government Integration 섹션이 보이지 않음
증상: Settings → Government Integration에 페이지가 없습니다.
해결 방법:
- 호텔에 규정 준수 보고 접근 권한이 있는지 확인합니다.
- 페이지를 새로고침합니다.
- 계속 보이지 않으면 관리자에게 요금제 접근 권한을 확인해 달라고 요청합니다.
EVA 필드가 표시되지 않음
증상: 국가는 선택되지만 EVA 필드는 숨겨져 있습니다.
해결 방법:
- Country를 Singapore로 설정합니다.
- **Enable E-Visitor Authentication (EVA)**를 켭니다.
시크릿 필드가 "Configured" 상태로 비활성화됨
증상: 시크릿 필드에 입력할 수 없습니다.
해결 방법:
- 해당 필드의 Edit 버튼을 클릭합니다.
- 새 값을 입력합니다.
- 변경 사항을 저장합니다.
"Generate JWKS" 실패
증상: Generate JWKS 클릭 후 오류가 발생합니다.
해결 방법:
- 10초 후 다시 시도합니다.
- 인터넷 연결을 확인합니다.
- 저장 후 페이지를 새로고침합니다.
- 오류가 계속되면 지원팀에 문의합니다.
계속 문제가 있나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 싱가포르 설정인데 EVA 옵션이 나타나지 않음
- ❌ 여러 번 시도해도 저장 실패가 반복됨
- ❌ JWKS 생성이 계속 실패함
문의 시 아래 정보를 함께 보내면 도움이 됩니다.
- 오류 화면 스크린샷
- 호텔 이름
- 문제 시작 시각