EVA 정부 연동 설정
호텔이 싱가포르에 있다면 약 3분 만에 EVA를 활성화하고 키를 저장할 수 있습니다.
이 가이드에서는 싱가포르 숙소에서 EVA를 활성화하고 정부 연동 설정을 관리하는 방법을 설명합니다. 공식 진입점으로 Government Compliance → Singapore → STB EVA를 사용하세요.
빠른 참조
| 설정 | 제어하는 항목 | 수행할 작업 |
|---|---|---|
| Country | 위치별 옵션 표시 | EVA 설정을 잠금 해제하려면 Singapore 선택 |
| Enable E-Visitor Authentication (EVA) | EVA 흐름 켜기 또는 끄기 | EVA 자격 증명 필드를 표시하려면 켜기 |
| EVA Environment | 샌드박스 또는 운영 트래픽 | 선택 사항은 즉시 저장되며, LIVE에는 확인이 필요합니다 |
| Generate JWKS | 최초 설정 또는 갱신을 위한 키 생성 | 기존 키가 교체되므로 새 JWKS를 STB에 등록 |
| Restore Existing Keys | Streamliner에 없는 STB 등록 키 세트 복원 | 누락되었거나 불완전한 기존 키에만 사용 |
| 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 키 생성
최초 설정, 키 갱신 또는 키 교체에 이 기능을 사용하세요.
- Government Integration을 엽니다.
- Country가 Singapore이고 EVA가 활성화되어 있는지 확인합니다.
- Generate JWKS를 클릭합니다.
- 필드가 업데이트될 때까지 기다립니다.
- Save Government Settings를 클릭합니다.
✓ 업데이트된 JWKS, Public Key, Private Key 값이 표시되어야 합니다.
키가 이미 있으면 Generate JWKS가 기존 키를 교체합니다. 새 JWKS를 STB에 다시 등록한 다음 나머지 온보딩 단계를 반복하세요.
기존 EVA 키 세트 복원
키 세트가 이미 STB에 등록되어 있지만 Streamliner에서 누락되었거나 불완전한 경우에만 사용하세요.
- Advanced options를 엽니다.
- Restore Existing Keys를 클릭합니다.
- STB에 등록된 키 세트에 제공된 기존 키 값을 입력합니다.
- 복원한 값을 저장합니다.
Save Government Settings를 클릭하기 전까지 생성된 키는 영구적이지 않습니다.
기존 시크릿 값 업데이트
일부 시크릿 필드는 "Configured"로 표시되고 잠긴 상태로 유지될 수 있습니다. 이는 기존 값이 노출되지 않도록 보호합니다.
- 해당 필드의 Edit 버튼을 클릭합니다.
- 새 값을 입력합니다.
- Save Government Settings를 클릭합니다.
문제 해결
정부 연동 섹션이 없습니다
표시되는 내용: 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 생성이 반복해서 실패함
다음 정보를 함께 제공하면 도움이 됩니다.
- 오류 스크린샷
- 호텔 이름
- 문제가 시작된 시간