设置 EVA 政府集成
快速设置
如果你的酒店位于新加坡,通常可在约 3 分钟内启用 EVA 并保存密钥。
本指南帮助你为新加坡酒店启用 EVA,并管理政府集成相关设置。
快速参考
| 设置项 | 控制内容 | 操作建议 |
|---|---|---|
| Country | 显示与国家/地区相关的选项 | 选择 Singapore 以解锁 EVA 设置 |
| Enable E-Visitor Authentication (EVA) | 开启或关闭 EVA 流程 | 打开后会显示 EVA 凭证字段 |
| 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。
必须保存
点击 Generate JWKS 后生成的密钥不会永久保存,直到你点击 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 持续生成失败
建议附上:
- 错误截图
- 酒店名称
- 问题开始时间