EVA 정부 연동 설정
호텔이 싱가포르에 있다면 약 3분 만에 EVA를 활성화하고 키를 저장할 수 있습니다.
이 가이드에서는 싱가포르 숙소의 EVA 활성화 및 정부 연동 설정 관리 방법을 설명합니다. 공식 진입점으로 Government Compliance → Singapore → STB EVA를 사용하세요.
빠른 참조
| 설정 | 제어하는 항목 | 수행할 작업 |
|---|---|---|
| Country | 위치별 옵션 표시 | EVA 설정을 잠금 해제하려면 Singapore 선택 |
| Enable E-Visitor Authentication (EVA) | EVA 흐름 켜기 또는 끄기 | EVA 자격 증명 필드를 표시하려면 켜기 |
| EVA Environment | 샌드박스 또는 운영 트래픽 | 선택 사항은 즉시 저장되며, LIVE에는 확인이 필요합니다 |
| Generate JWKS | 키 자료 생성 | 한 번 클릭한 다음 생성된 값 검토 |
| Save Government Settings | 모든 업데이트 저장 | 변경 후 Save Government Settings 클릭 |
시작하기 전에
- 호텔에서 규정 준수 보고 기능에 접근할 수 있는지 확인하세요.
- 설정을 수정할 권한이 있는지 확인하세요.
- EVA 자격 증명을 준비해 두세요.
settings:write가 없는 사용자는 환경을 볼 수 있지만 변경할 수 없습니다.
호텔 요금제에 규정 준수 보고 접근 권한이 포함된 경우에만 Government Integration이 표시됩니다.
단계별 EVA 설정
- Government Compliance → Singapore → STB EVA로 이동합니다.
- 페이지에 설정 상태가 표시되면 아직 완료되지 않은 다음 단계를 따릅니다.
- Country를 Singapore로 설정합니다.
- **Enable E-Visitor Authentication (EVA)**를 켭니다.
- EVA Environment를 선택합니다.
- 서버 승인을 받은 STB 샌드박스 가맹점인 경우에만 TEST를 선택합니다.
- STB 승인을 받은 운영 자격 증명이 있는 경우에만 LIVE를 선택합니다.
- LIVE를 선택하면 확인 대화 상자에서 Switch to LIVE를 클릭합니다.
- 저장된 값이 없거나 지원되지 않는 경우 Streamliner는 TEST를 표시합니다.
- 다음 필드에 입력합니다.
- Hotel Code
- API Key
- JWKS
- Public Key (PEM)
- Private Key (PEM)
- 자격 증명 필드에 대해 Save Government Settings를 클릭합니다.
환경 선택 사항은 별도로 저장되며 기존 EVA 자격 증명을 대체하지 않습니다.
✓ 저장 후 성공 메시지가 표시되어야 합니다.
이전의 Settings → Government Integration 링크는 이 설정 페이지로 리디렉션됩니다.
샌드박스 테스트 액세스
서버 승인을 받은 샌드박스 가맹점에게만 Test access가 표시됩니다. 샌드박스 거래는 STB TEST를 사용하며 운영 STB에 연결하거나 운영 확인을 기록할 수 없습니다. 샌드박스 흐름을 LIVE로 전환하지 마세요.
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 섹션이 없습니다
표시되는 내용: Government Compliance에 STB EVA 페이지가 없습니다.
해결 방법:
- 호텔에 규정 준수 보고 접근 권한이 있는지 확인합니다.
- Country가 Singapore인지 확인합니다.
- Government Compliance를 새로 고칩니다.
- 여전히 표시되지 않으면 관리자에게 요금제 접근 권한을 검토해 달라고 요청합니다.
EVA 필드가 표시되지 않습니다
표시되는 내용: 국가를 선택할 수 있지만 EVA 필드가 숨겨져 있습니다.
해결 방법:
- Country를 Singapore로 설정합니다.
- Government Compliance → Singapore → STB EVA를 엽니다.
- **Enable E-Visitor Authentication (EVA)**를 켭니다.
시크릿 필드가 "Configured"로 비활성화되어 있습니다
표시되는 내용: 시크릿 필드에 입력할 수 없습니다.
해결 방법:
- 해당 필드의 Edit 버튼을 클릭합니다.
- 새 값을 입력합니다.
- 변경 사항을 저장합니다.
"Generate JWKS"가 실패합니다
표시되는 내용: Generate JWKS를 클릭한 후 오류가 발생합니다.
해결 방법:
- 10초 후 다시 시도합니다.
- 인터넷 연결을 확인합니다.
- 저장한 후 페이지를 새로 고칩니다.
- 오류가 계속되면 지원팀에 문의합니다.
EVA 환경 선택이 거부됩니다
표시되는 내용: Streamliner가 TEST 또는 LIVE 선택을 거부합니다.
해결 방법:
- 서버 승인을 받은 샌드박스 가맹점은 TEST를 유지합니다.
- 운영 액세스가 승인된 후에만 LIVE를 사용합니다.
settings:write권한이 있는지 확인합니다.- 정책이 호텔에 적용되는 내용과 일치하지 않으면 Vouch Support에 문의합니다.
여전히 해결되지 않나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ 싱가포르에서 EVA 설정이 표시되지 않음
- ❌ 다시 시도해도 저장이 계속 실패함
- ❌ JWKS 생성이 반복해서 실패함
다음 정보를 함께 제공하면 도움이 됩니다.
- 오류 스크린샷
- 호텔 이름
- 문제가 시작된 시간