Skip to main content
即刻安装 Cobo WaaS Skill,在 Claude Code、Cursor 等 AI 开发环境中使用自然语言集成 WaaS API,显著提升开发效率 🚀
本指南解释了如何使用 RSA 密钥对配置回调服务器和 TSS Node 之间的安全通信。

生成和交换回调密钥

1. 生成回调服务器密钥

在您的回调服务器上,生成一个 RSA 密钥对:
  1. 生成私钥:
  1. 在回调服务器上配置私钥,因为您需要使用它来签署回调响应。
  2. 导出公钥:

2. 获取 TSS Node 的回调公钥

初始化 TSS Node 后,检索其回调公钥:
输出将包括回调公钥:

3. 交换公钥

  1. 将回调服务器的公钥复制到 TSS Node 的安装目录中,例如:
  1. 将 TSS Node 的回调公钥复制到您的回调服务器的配置中

配置 TSS Node 设置

修改 TSS Node 上的 cobo-tss-node-config.yaml 文件,以包含回调服务器的 URL、公钥和其他回调相关设置。 您可以配置多个回调服务器以增强安全性。TSS Node 仅在所有配置的回调服务器都批准时才会执行任务。以下示例显示了如何配置两个回调服务器:

配置参数

  • cb_server: TSS Node Callback 服务器的地址列表,接收 v1 版本 的回调请求。虽然仍然支持,但我们强烈建议使用 cb_server_v2 选项,因为它提供了更全面的请求信息,并与 WaaS 2.0 API 兼容。
  • cb_server_v2: TSS Node Callback 服务器的地址列表,接收 v2 版本的回调请求。
    • service_address: 回调服务器的 HTTP 端点。
    • pubkey_path: 回调服务器公钥文件的路径。
  • token_expire_minutes: JWT 过期时间(分钟)。
  • retry_times: 失败请求的最大重试次数。
  • sleep_seconds: 重试之间的延迟(秒)。
  • request_timeout: HTTP 请求超时时间(秒)。指定 TSS Node 等待回调服务器响应的时间长度。
  • monitor_interval: 指定 TSS Node 检查回调服务器状态的频率。使用 s 表示秒,m 表示分钟,h 表示小时(例如,30s5m2h)。如果省略,则禁用状态监控。

验证配置

配置完成后:
  1. 启动回调服务器
  2. 启动 TSS Node
  3. 通过发起任务请求测试连接
  4. 验证回调流程

下一步