1.8 KiB
1.8 KiB
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 → 设置 → 安全与隐私 → 加密)。
用法
cd scripts/cross-sign
npm install # 首次需要
node ./cross-sign.mjs
然后按提示交互式粘贴即可(无需任何环境变量 / 配置文件):
- 输入账号域名或 API 地址
- 输入完整的 Matrix 用户 ID,例如
@bot:example.org - 账号密码 —— 粘贴时不回显
- 安全密钥(base58,如
EsTc ...)—— 不回显;直接回车则改填安全短语 - 输入要签名的设备 ID。留空后还需输入
ALL才会签名所有未验证设备。
跑一次即可,之后无需再跑(除非 bot 重新登录产生了新设备)。
注意
- 密码、恢复密钥/短语只在本机脚本内使用,不会上传任何第三方;输入时不回显。
- 过程中会短暂出现一个名为
cross-sign-temp (可删)的临时设备,脚本结束会自动删除。