239 lines
8.3 KiB
JavaScript
239 lines
8.3 KiB
JavaScript
/**
|
|
* 一次性交互脚本:用你的「恢复密钥 / 安全短语」给 bot 设备做 cross-signing。
|
|
*
|
|
* 背景:bot 跑的 matrix-bot-sdk(底层 crypto 0.4.0)不支持设备验证,
|
|
* 所以在 Element 里点「验证」会一直卡住。本脚本用官方 matrix-js-sdk
|
|
* 临时登录一次,从你的 Secret Storage(4S)取出 cross-signing 私钥,
|
|
* 直接给目标设备签名(等价于 Element 里 SAS 验证成功后的那一步),
|
|
* 签完立刻登出这个临时设备。bot 运行时完全不动。
|
|
*
|
|
* 用法:node ./cross-sign.mjs 然后按提示粘贴即可。
|
|
*/
|
|
import { createClient, AutoDiscovery } from 'matrix-js-sdk';
|
|
import { decodeRecoveryKey } from 'matrix-js-sdk/lib/crypto-api/recovery-key.js';
|
|
import { pbkdf2 } from 'node:crypto';
|
|
import { promisify } from 'node:util';
|
|
import { createInterface } from 'node:readline';
|
|
import { stdin, stdout } from 'node:process';
|
|
|
|
const pbkdf2Async = promisify(pbkdf2);
|
|
|
|
function fail(msg) {
|
|
console.error(`❌ ${msg}`);
|
|
process.exit(1);
|
|
}
|
|
|
|
/** 普通提问;支持默认值(直接回车采用) */
|
|
function ask(question, def) {
|
|
const rl = createInterface({ input: stdin, output: stdout });
|
|
const suffix = def ? ` [${def}]` : '';
|
|
return new Promise((resolve) => {
|
|
rl.question(`${question}${suffix}: `, (ans) => {
|
|
rl.close();
|
|
resolve((ans.trim() || def || '').trim());
|
|
});
|
|
});
|
|
}
|
|
|
|
/** 隐藏输入(粘贴时不回显),用于密码 / 恢复密钥 */
|
|
function askSecret(question) {
|
|
return new Promise((resolve) => {
|
|
// 先把提示语打印出来(可见),再静音后续按键回显
|
|
stdout.write(`${question}: `);
|
|
const rl = createInterface({ input: stdin, output: stdout });
|
|
rl._writeToOutput = function (str) {
|
|
// 仅放行换行,其余按键不回显
|
|
if (str.includes('\n')) rl.output.write('\n');
|
|
};
|
|
rl.question('', (ans) => {
|
|
rl.close();
|
|
resolve(ans.trim());
|
|
});
|
|
});
|
|
}
|
|
|
|
let RECOVERY_KEY = '';
|
|
let SECURITY_PHRASE = '';
|
|
let PASSWORD = '';
|
|
let TARGET_DEVICE_ID = '';
|
|
|
|
async function main() {
|
|
console.log('=== bot 设备 cross-signing 工具 ===\n');
|
|
|
|
const homeserverInput = await ask('账号域名或 API 地址');
|
|
if (!homeserverInput) fail('必须输入账号域名或 API 地址。');
|
|
const userId = await ask('账号 user id');
|
|
if (!userId) fail('必须输入账号 ID。');
|
|
PASSWORD = await askSecret('账号密码(粘贴,不回显)');
|
|
if (!PASSWORD) fail('必须输入密码。');
|
|
|
|
console.log(
|
|
'\n签名需要你的「安全密钥」或「安全短语」二选一。安全密钥优先,直接回车切到安全短语。',
|
|
);
|
|
RECOVERY_KEY = await askSecret('安全密钥(base58,如 EsTc...;不回显)');
|
|
if (RECOVERY_KEY) {
|
|
try {
|
|
decodeRecoveryKey(RECOVERY_KEY.replace(/\s+/g, ''));
|
|
} catch {
|
|
fail('安全密钥格式不对(应是 EsTx... 的 base58,4 字符一组共 12 组)。');
|
|
}
|
|
} else {
|
|
SECURITY_PHRASE = await askSecret('安全短语(不回显)');
|
|
if (!SECURITY_PHRASE) fail('安全密钥和安全短语必须至少提供一个。');
|
|
}
|
|
|
|
TARGET_DEVICE_ID = await ask('要签名的设备 ID');
|
|
if (!TARGET_DEVICE_ID && await ask('签名所有未验证设备?输入 ALL 确认') !== 'ALL') {
|
|
fail('未选择签名目标。');
|
|
}
|
|
|
|
// 1) 解析真实 API 地址(支持裸域名 well-known 发现)
|
|
const baseUrl = await resolveBaseUrl(homeserverInput);
|
|
console.log(`\n🔗 homeserver API: ${baseUrl}`);
|
|
|
|
// 2) 临时登录(产生一个临时设备,结束后登出删除)
|
|
const loginClient = createClient({ baseUrl });
|
|
console.log('🔑 临时登录中...');
|
|
const login = await loginClient.login('m.login.password', {
|
|
identifier: { type: 'm.id.user', user: userId },
|
|
password: PASSWORD,
|
|
initial_device_display_name: 'cross-sign-temp (可删)',
|
|
});
|
|
const accessToken = login.access_token;
|
|
const deviceId = login.device_id;
|
|
const realUserId = login.user_id;
|
|
console.log(`✅ 临时设备已登录: ${deviceId}`);
|
|
|
|
// 3) 构建带 crypto 的 client,提供 secret storage 取钥回调
|
|
const client = createClient({
|
|
baseUrl,
|
|
accessToken,
|
|
userId: realUserId,
|
|
deviceId,
|
|
cryptoCallbacks: { getSecretStorageKey },
|
|
});
|
|
|
|
let signedOk = false;
|
|
try {
|
|
await client.initRustCrypto({ useIndexedDB: false });
|
|
const crypto = client.getCrypto();
|
|
if (!crypto) fail('crypto 初始化失败。');
|
|
|
|
console.log('🔄 启动同步(拉取设备列表 / secret storage)...');
|
|
await client.startClient({ initialSyncLimit: 1 });
|
|
await waitForSync(client);
|
|
|
|
// 4) 从 4S 导入 cross-signing 私钥(不重置已有密钥)
|
|
console.log('📥 从 Secret Storage 导入 cross-signing 私钥...');
|
|
await crypto.bootstrapCrossSigning({
|
|
authUploadDeviceSigningKeys: async (makeRequest) => {
|
|
await makeRequest({
|
|
type: 'm.login.password',
|
|
identifier: { type: 'm.id.user', user: realUserId },
|
|
password: PASSWORD,
|
|
});
|
|
},
|
|
});
|
|
if (!(await crypto.isCrossSigningReady())) {
|
|
fail(
|
|
'cross-signing 未就绪——恢复密钥/短语可能不对,或账号未设置过 cross-signing。',
|
|
);
|
|
}
|
|
console.log('✅ cross-signing 私钥就绪。');
|
|
|
|
// 5) 确定要签名的设备
|
|
const targets = await resolveTargets(crypto, realUserId, deviceId);
|
|
if (targets.length === 0) {
|
|
console.log('ℹ️ 没有需要签名的设备(可能都已验证)。');
|
|
}
|
|
for (const dev of targets) {
|
|
console.log(`✍️ 签名设备 ${dev} ...`);
|
|
await crypto.crossSignDevice(dev);
|
|
const st = await crypto.getDeviceVerificationStatus(realUserId, dev);
|
|
console.log(` → crossSigningVerified=${st?.crossSigningVerified ?? '?'}`);
|
|
}
|
|
signedOk = true;
|
|
} finally {
|
|
// 6) 清理:登出临时设备(删除它),停止 client
|
|
try {
|
|
client.stopClient();
|
|
} catch {}
|
|
try {
|
|
console.log('🧹 登出并删除临时设备...');
|
|
await client.logout(true);
|
|
console.log('✅ 临时设备已删除。');
|
|
} catch (e) {
|
|
console.warn('⚠️ 登出临时设备失败(可手动在 Element 删除):', e?.message);
|
|
}
|
|
}
|
|
|
|
if (signedOk) {
|
|
console.log('\n🎉 完成!刷新 Element 设备列表即可看到目标设备已验证(绿盾)。');
|
|
}
|
|
process.exit(signedOk ? 0 : 1);
|
|
}
|
|
|
|
/** secret storage 取钥回调:用恢复密钥或安全短语派生 4S 密钥 */
|
|
async function getSecretStorageKey({ keys }) {
|
|
const keyId = Object.keys(keys)[0];
|
|
const info = keys[keyId];
|
|
let privateKey;
|
|
if (RECOVERY_KEY) {
|
|
privateKey = decodeRecoveryKey(RECOVERY_KEY.replace(/\s+/g, ''));
|
|
} else {
|
|
const pp = info?.passphrase;
|
|
if (!pp?.salt || !pp?.iterations) {
|
|
fail('该账号的 4S 没有 passphrase 信息,请改用安全密钥。');
|
|
}
|
|
privateKey = new Uint8Array(
|
|
await pbkdf2Async(SECURITY_PHRASE, pp.salt, pp.iterations, 32, 'sha512'),
|
|
);
|
|
}
|
|
return [keyId, privateKey];
|
|
}
|
|
|
|
/** 决定签名目标:指定了 TARGET_DEVICE_ID 就只签它;否则签名所有未交叉验证的自有设备(除临时设备) */
|
|
async function resolveTargets(crypto, userId, tempDeviceId) {
|
|
if (TARGET_DEVICE_ID) return [TARGET_DEVICE_ID];
|
|
const map = await crypto.getUserDeviceInfo([userId], true);
|
|
const devices = map.get(userId);
|
|
const out = [];
|
|
if (!devices) return out;
|
|
for (const devId of devices.keys()) {
|
|
if (devId === tempDeviceId) continue;
|
|
const st = await crypto.getDeviceVerificationStatus(userId, devId);
|
|
if (!st?.crossSigningVerified) out.push(devId);
|
|
}
|
|
return out;
|
|
}
|
|
|
|
/** well-known 发现:裸域名 → 真实 API 地址 */
|
|
async function resolveBaseUrl(input) {
|
|
if (/^https?:\/\//.test(input)) return input.replace(/\/$/, '');
|
|
const res = await AutoDiscovery.findClientConfig(input);
|
|
const url = res?.['m.homeserver']?.base_url;
|
|
if (!url) fail(`无法从 ${input} 发现 homeserver,请直接填完整 API 地址。`);
|
|
return url.replace(/\/$/, '');
|
|
}
|
|
|
|
/** 等待首次同步完成 */
|
|
function waitForSync(client) {
|
|
return new Promise((resolve, reject) => {
|
|
const to = setTimeout(() => reject(new Error('同步超时(60s)')), 60_000);
|
|
client.once('sync', function handler(state) {
|
|
if (state === 'PREPARED') {
|
|
clearTimeout(to);
|
|
resolve();
|
|
} else if (state === 'ERROR') {
|
|
clearTimeout(to);
|
|
reject(new Error('同步出错'));
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
main().catch((e) => {
|
|
console.error('💥 出错:', e);
|
|
process.exit(1);
|
|
});
|