Signal-CLI中JSON-RPC模式下设备链接的持久化问题解析

背景介绍

Signal-CLI是一个命令行工具，允许用户通过终端与Signal消息服务进行交互。它提供了多种操作模式，包括直接命令执行、守护进程模式(daemon)以及JSON-RPC接口。其中JSON-RPC接口为开发者提供了更灵活的集成方式。

问题核心

在Signal-CLI的JSON-RPC模式下，当尝试使用startLink和finishLink方法完成设备链接时，用户可能会遇到"Unknown device link uri"错误。这是因为Signal-CLI在JSON-RPC模式下没有持久化存储设备链接的临时凭证信息。

技术原理

1. 设备链接流程：Signal使用两步验证机制完成设备链接：

   • 第一步(startLink)生成一个临时的设备链接URI
   • 第二步(finishLink)使用该URI完成设备验证

2. 内存存储限制：在JSON-RPC模式下，Signal-CLI将临时凭证存储在内存中，当进程结束时这些信息就会丢失。这与守护进程模式不同，后者会保持进程运行从而保留内存中的凭证信息。

解决方案

虽然Signal-CLI目前没有实现凭证的持久化存储，但可以通过保持进程运行的方式完成设备链接：

FIFO_FILE="/tmp/fifo"

# 创建命名管道
rm -f "$FIFO_FILE"
mkfifo "$FIFO_FILE"

# 启动JSON-RPC服务并保持运行
signal-cli jsonRpc < "$FIFO_FILE" &

# 通过文件描述符3与命名管道通信
exec 3> "$FIFO_FILE"
  # 第一步：启动设备链接
  echo '{"jsonrpc": "2.0", "id": "t1", "method": "startLink"}' >&3
  
  # 获取设备链接URI(需要用户手动操作)
  
  # 第二步：完成设备链接
  echo '{"jsonrpc": "2.0", "id": "t2", "method": "finishLink", "params": {"deviceLinkUri": "sgnl://...", "deviceName": "test_cli"}}' >&3

# 关闭文件描述符
exec 3>&-

# 等待进程结束
wait

未来改进方向

Signal-CLI开发者已经注意到这个问题，未来可能会通过以下方式改进：

1. 实现临时凭证的持久化存储
2. 添加专门的存储文件来保存链接状态
3. 延长内存中凭证的有效期

总结

目前在使用Signal-CLI的JSON-RPC接口进行设备链接时，开发者需要确保整个链接过程在同一个进程中完成。通过使用命名管道等技术手段，可以有效地解决临时凭证丢失的问题。对于需要更稳定链接方式的用户，建议考虑使用守护进程模式，或者等待未来版本中可能添加的持久化存储功能。