解决Signal-CLI-REST-API中的身份信任问题

在使用Signal-CLI-REST-API进行消息发送时，开发者可能会遇到"Failed to send message due to untrusted identities"错误。这个问题通常发生在尝试向新联系人发送消息时，Signal的安全机制要求必须先验证对方的身份。

问题背景

Signal采用端到端加密技术保护通信安全。当首次与某个联系人通信时，系统会生成一个安全号码(Safety Number)，用于验证对方身份的真实性。在Signal-CLI-REST-API中，如果不先验证这个安全号码，API会拒绝发送消息以防止中间人攻击。

解决方案步骤

1. 获取联系人的安全号码

首先需要查询特定联系人的安全号码信息：

curl -X 'GET' \
'http://localhost:8080/v1/identities/[phone]' \
-H 'accept: application/json'

这个命令会返回一个JSON响应，其中包含与指定号码([phone])通信的所有联系人的安全号码信息。

2. 验证并信任联系人

获取到安全号码后，可以执行信任操作：

curl -X 'PUT' \
'http://localhost:8080/v1/identities/[phone]/trust/[phone]' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"trust_all_known_keys": false,
"verified_safety_number": "49424 46754 81606 03014 47112 96921 824327 91222 76213 34383 57434 54246"
}'

参数说明：

• [phone]: 你的Signal账号
• [phone]: 你要信任的联系人号码
• verified_safety_number: 从第一步获取的安全号码
• trust_all_known_keys: 设置为false表示只信任提供的特定安全号码

3. 验证信任是否成功

成功执行上述命令后，系统会返回HTTP 200状态码。此时再次尝试发送消息应该就能正常工作了。

注意事项

1. 安全号码中的空格不是必须的，可以去掉空格直接使用连续数字
2. 如果确定要信任所有已知密钥，可以将trust_all_known_keys设为true，但这会降低安全性
3. 安全号码是区分大小写的，必须完全匹配
4. 如果联系人更换设备，安全号码会改变，需要重新验证

技术原理

Signal使用安全号码机制来防止中间人攻击。每个会话都会生成唯一的安全号码，它实际上是公钥的指纹。通过比较这个号码，用户可以确认通信对方的真实身份。Signal-CLI-REST-API通过提供专门的API端点，使得自动化系统也能遵循这一安全协议。

通过上述步骤，开发者可以安全地集成Signal消息发送功能到自己的应用中，同时保持Signal强大的端到端加密安全性。