44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# cross-sign 一次性工具
|
|
|
|
给 bot 设备做 **cross-signing(交叉签名)**,让它在 Element 设备列表里显示为
|
|
「已验证」(绿盾),并触发你的其它设备自动向 bot 分享房间密钥(从而能解部分旧消息)。
|
|
|
|
## 为什么需要它
|
|
|
|
bot 主程序用的是 `matrix-bot-sdk`,其底层加密内核
|
|
(`@matrix-org/[email protected]`)**不支持设备验证 / cross-signing**,
|
|
所以你在 Element 里点「验证」会一直卡在「等待对方接受」。
|
|
|
|
本工具改用官方 **`matrix-js-sdk`**(支持完整验证)临时登录一次,从你的
|
|
Secret Storage(4S)取出 cross-signing 私钥,直接给目标设备签名 —— 等价于
|
|
Element 里 SAS 对暗号成功后的那一步。签完立即登出并删除这个临时设备。
|
|
**bot 运行时完全不受影响。**
|
|
|
|
## 前提
|
|
|
|
你的 Matrix 账号必须**已设置过 cross-signing + 安全密钥(Security Key)或安全短语**
|
|
(Element → 设置 → 安全与隐私 → 加密)。
|
|
|
|
## 用法
|
|
|
|
```bash
|
|
cd scripts/cross-sign
|
|
npm install # 首次需要
|
|
node ./cross-sign.mjs
|
|
```
|
|
|
|
然后按提示**交互式粘贴**即可(无需任何环境变量 / 配置文件):
|
|
|
|
1. 账号域名或 API 地址(回车用默认 `tchncs.de`)
|
|
2. 账号 user id(回车用默认 `@eskimapro:tchncs.de`)
|
|
3. 账号密码 —— **粘贴时不回显**
|
|
4. 安全密钥(base58,如 `EsTc ...`)—— 不回显;直接回车则改填安全短语
|
|
5. 要签名的设备 ID(回车用默认 `ZHEAJZJMDZ`;留空则签名名下所有未验证设备)
|
|
|
|
跑一次即可,之后无需再跑(除非 bot 重新登录产生了新设备)。
|
|
|
|
## 注意
|
|
|
|
- 密码、恢复密钥/短语只在本机脚本内使用,不会上传任何第三方;输入时不回显。
|
|
- 过程中会**短暂**出现一个名为 `cross-sign-temp (可删)` 的临时设备,脚本结束会自动删除。
|