跳到主要内容

设置 EVA 政府集成

快速设置

如果你的酒店位于新加坡，你可以在约 3 分钟内启用 EVA 并保存密钥。

本指南帮助你为新加坡酒店启用 EVA，并管理政府集成设置。 请将 Government Compliance → Singapore → STB EVA 作为标准入口。

快速参考​

设置项控制内容操作
Country显示特定位置的选项选择 Singapore 以解锁 EVA 设置
Enable E-Visitor Authentication (EVA)开启或关闭 EVA 流程打开后显示 EVA 凭证字段
EVA Environment沙盒或生产流量选择会立即保存；LIVE 需要确认
Generate JWKS为首次设置或续期创建密钥现有密钥会被替换；向 STB 注册新的 JWKS
Restore Existing Keys恢复 Streamliner 中缺失的 STB 注册密钥集仅用于缺失或不完整的现有密钥
Save Government Settings保存所有更新修改后点击 Save Government Settings

开始前准备​

  • 确认你的酒店可以访问合规报告功能。
  • 确认你有权限编辑设置。
  • 准备好 EVA 凭证。

没有 settings:write 权限的用户可以查看环境，但无法更改环境。

访问要求

只有酒店套餐包含合规报告访问权限时，你才会看到 Government Integration。

按步骤设置 EVA​

  1. 前往 Government Compliance → Singapore → STB EVA。
  2. 如果页面显示设置状态，请按照下一个未完成的步骤操作。
  3. 将 Country 设置为 Singapore。
  4. 打开 Enable E-Visitor Authentication (EVA)。
  5. 选择 EVA Environment：
    • 仅为服务器批准的 STB 沙盒商户选择 TEST。
    • 仅在拥有 STB 批准的生产凭证时选择 LIVE。
    • 如果选择 LIVE，请在确认对话框中点击 Switch to LIVE。
    • 如果存储的值缺失或不受支持，Streamliner 会显示 TEST。
  6. 填写以下字段：
    • Hotel Code
    • API Key
    • JWKS
    • Public Key (PEM)
    • Private Key (PEM)
  7. 点击 Save Government Settings 保存凭证字段。

环境选择会单独保存，不会替换现有的 EVA 凭证。

✓ 保存后应看到成功消息。

旧的 Settings → Government Integration 链接会重定向到此设置页面。

沙盒测试访问权限​

只有服务器批准的沙盒商户才能看到 Test access。 沙盒交易使用 STB TEST，无法联系正式 STB，也不会记录正式确认信息。 请勿将沙盒流程切换为 LIVE。

生成 JWKS 密钥​

首次设置、密钥续期或密钥轮换时使用此功能。

  1. 打开 Government Integration。
  2. 确认 Country 为 Singapore，且 EVA 已启用。
  3. 点击 Generate JWKS。
  4. 等待字段更新。
  5. 点击 Save Government Settings。

✓ 你应看到更新后的 JWKS、Public Key 和 Private Key 值。

生成 JWKS 会替换现有密钥

如果密钥已经存在，Generate JWKS 会替换这些密钥。 请再次向 STB 注册新的 JWKS，然后重复剩余的入驻步骤。

恢复现有 EVA 密钥集​

仅当密钥集已向 STB 注册，但在 Streamliner 中缺失或不完整时使用此功能。

  1. 打开 Advanced options。
  2. 点击 Restore Existing Keys。
  3. 输入为已向 STB 注册的密钥集提供的现有密钥值。
  4. 保存恢复的值。
必须保存

在点击 Save Government Settings 之前，生成的密钥都不是永久的。

更新现有的敏感值​

部分敏感字段可能显示“Configured”并保持锁定状态。 这是为了保护现有值，避免其被暴露。

  1. 点击该字段对应的 Edit 按钮。
  2. 输入新值。
  3. 点击 Save Government Settings。

故障排查​

缺少 Government Integration 区块​

现象： 在 Government Compliance 中没有 STB EVA 页面。

解决方法：

  1. 确认酒店拥有合规报告访问权限。
  2. 确认 Country 为 Singapore。
  3. 刷新 Government Compliance。
  4. 如果仍然缺少，请让管理员检查套餐访问权限。

EVA 字段未显示​

现象： 你可以选择国家，但 EVA 字段处于隐藏状态。

解决方法：

  1. 将 Country 设置为 Singapore。
  2. 打开 Government Compliance → Singapore → STB EVA。
  3. 打开 Enable E-Visitor Authentication (EVA)。

敏感字段因“Configured”而被禁用​

现象： 你无法在敏感字段中输入内容。

解决方法：

  1. 点击字段的 Edit 按钮。
  2. 输入新值。
  3. 保存更改。

“Generate JWKS”失败​

现象： 点击 Generate JWKS 后出现错误。

解决方法：

  1. 10 秒后重试。
  2. 检查网络连接。
  3. 保存并刷新页面。
  4. 如果错误持续，请联系支持团队。

EVA 环境选择被拒绝​

现象： Streamliner 拒绝你选择的 TEST 或 LIVE。

解决方法：

  1. 让服务器批准的沙盒商户保持使用 TEST。
  2. 仅在正式环境访问权限获批后使用 LIVE。
  3. 确认你拥有 settings:write 权限。
  4. 如果该策略与你的酒店不符，请联系 Vouch Support。

仍无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 新加坡酒店不显示 EVA 设置
  • ❌ 多次重试后保存仍然失败
  • ❌ JWKS 反复生成失败

建议附上：

  • 错误截图
  • 酒店名称
  • 问题开始的时间