轮换条形码

简介

轮播条形码看起来和常规条形码类似,但会定期更改, 通常每分钟发送一次,并且终端/读卡器只接受接收 最新的一个。这项安全措施可降低 条形码截图,特别是门票盗窃或未经授权的门票 转售。旋转条形码也可以作为一种替代方法,供无法 由于不支持 NFC(缺少硬件或 软件禁用)。

API 参考文档

有关轮换条形码的技术详情,请参阅 RotatingBarcode 类型

载荷示例

JSON
{
  "rotatingBarcode": {
    "type": "QR_CODE",
    "valuePattern": "MyRotatingBarcode-{totp_timestamp_seconds}-{totp_value_0}",
    "alternateText": "Ticket#: 1234567890",
    "totpDetails": {
      "algorithm": "TOTP_SHA1",
      "periodMillis": "3000",
      "parameters": [
        {
          "key": "3132333435363738393031323334353637383930",
          "valueLength": "8"
        }
      ]
    }
  }
}

回退机制

在用户设备上,给定时间内仅使用一种兑换机制, 具体取决于卡券的配置方式以及设备的功能。 按照优先级顺序,系统将使用以下兑换类型:

  1. 智能触碰:如果指定了智能触碰负载,并且设备支持 NFC/HCE <ph type="x-smartling-placeholder">
      </ph>
    • 请注意,用户可以通过点击“显示代码”来覆盖此设置, 会强制显示旋转的条形码/静态条形码。
  2. 轮换条形码:如果指定了轮换的条形码有效负载
  3. 静态条形码:如果指定了条形码载荷

指定多个兑换载荷可确保所有用户均受支持,但 可能存在安全隐患具体来说,将静态条形码用作 轮换条形码的替代功能会抵消使用 旋转条形码。静态条形码后备仅在网页视图中显示 或在不支持旋转条形码的客户端上。截至今天,我们预计 所有 Google 电子钱包客户端都支持旋转条形码。

保存流

Google Wallet API 提供了多种流程,包括:

  • 在保存时间或提前创建登机课程
  • 发送 JWT 中的完整对象,或先保存对象, 然后在 JWT 中按 ID 引用它们
  • 在保存对象后对其进行更新

提议的 rotationBarcode 字段与所有这些流兼容, 不过,为了提高安全性,我们建议:

  • 调用 object:insert API 以将卡券插入 Google 电子钱包服务器,然后配置“添加到 Google 钱包”按钮, 在 JWT 中按 ID 引用特定对象。这样可以确保 生成的 JWT 不包含轮替条形码的密钥。
  • 请使用范围限定为单次凭证的动态密码密钥
  • 除非更新密钥,否则预计有效期为 通行证。我们预计此密钥在更新期间不会以任何频率更新 正常操作过程中的影响。

以下序列图展示了不同操作者之间的流程 对于典型集成:

使用旋转条形码的序列图