feat: connection candidates refresh + relay identity hardening

Candidates refresh (server + mobile + desktop clients):
- GET /api/client-auth/connection/candidates returns the server's current
  LAN URLs, relay candidate, and serverId for already-paired devices
- /health and /api/version expose serverId so clients can verify a learned
  address belongs to the expected server before sending their bearer token
- mobile: refresh saved candidates over the live transport after every
  connect/wake, hot-switch relay->LAN when a fresh address is reachable;
  serverId gate on direct probes; token no longer sent to /health
- desktop: refresh stored host apiUrl after a relay connect and hot-switch
  back to direct; electron probe verifies serverId before authenticated fetch

Fixes found while debugging a dead pairing:
- settings: strict reader that throws on corrupt/unreadable file instead of
  returning {}; relay signing/encryption key generation is now gated on it,
  so a swallowed read failure can no longer mint a new server identity and
  orphan every paired device (loud log when a keypair IS generated)
- SessionAuthGate: bounded auto-retry for transient session-check failures
  (initial request racing the relay tunnel's first WS attempt, startup 5xx)
This commit is contained in:
Bohdan Triapitsyn
2026-07-12 18:09:54 +03:00
parent 22d5ad3814
commit afb368e11b
16 changed files with 610 additions and 27 deletions
+24 -4
View File
@@ -16,10 +16,15 @@ import { exportPublicKeyJwk, generateEcdhKeyPair, importEcdhPrivateKey } from '.
const isJwkPair = (value) => Boolean(value && typeof value === 'object' && value.privateJwk && value.publicJwk);
/**
* @param {{ crypto: typeof import('node:crypto'), readSettingsFromDiskMigrated: () => Promise<object>, writeSettingsToDisk: (settings: object) => Promise<void> }} deps
* @param {{
* crypto: typeof import('node:crypto'),
* readSettingsFromDiskMigrated: () => Promise<object>,
* writeSettingsToDisk: (settings: object) => Promise<void>,
* readSettingsStrict?: () => Promise<object>,
* }} deps
*/
export const createRelayIdentityRuntime = (deps) => {
const { crypto, readSettingsFromDiskMigrated, writeSettingsToDisk } = deps;
const { crypto, readSettingsFromDiskMigrated, writeSettingsToDisk, readSettingsStrict } = deps;
let cachedIdentity = null;
@@ -29,10 +34,25 @@ export const createRelayIdentityRuntime = (deps) => {
if (isJwkPair(existing)) {
return existing;
}
// Same regeneration gate as the signing key: never mint a replacement
// identity key off a swallowed read failure — a new encryption key breaks
// the E2EE trust anchor pinned by every paired device. Verify "missing" via
// the strict reader (throws on corrupt/unreadable) before generating.
let verifiedSettings = settings;
if (readSettingsStrict) {
verifiedSettings = await readSettingsStrict();
const verified = verifiedSettings?.relayEncryptionKey;
if (isJwkPair(verified)) {
return verified;
}
}
// Loud on purpose: a new encryption key invalidates the E2EE trust anchor of
// every paired device. Expected exactly once, on first relay use.
console.warn('[relay-identity] Generating NEW relay encryption keypair (E2EE trust anchor changes; previously paired devices must re-pair)');
const keyPair = await generateEcdhKeyPair();
const privateJwk = await globalThis.crypto.subtle.exportKey('jwk', keyPair.privateKey);
const publicJwk = await exportPublicKeyJwk(keyPair.publicKey);
await writeSettingsToDisk({ ...settings, relayEncryptionKey: { privateJwk, publicJwk } });
await writeSettingsToDisk({ ...settings, ...(verifiedSettings || {}), relayEncryptionKey: { privateJwk, publicJwk } });
return { privateJwk, publicJwk };
};
@@ -46,7 +66,7 @@ export const createRelayIdentityRuntime = (deps) => {
*/
const getRelayIdentity = async () => {
if (cachedIdentity) return cachedIdentity;
const signing = await getOrCreateRelaySigningKeypair({ crypto, readSettingsFromDiskMigrated, writeSettingsToDisk });
const signing = await getOrCreateRelaySigningKeypair({ crypto, readSettingsFromDiskMigrated, writeSettingsToDisk, readSettingsStrict });
const serverId = deriveServerId({ crypto }, signing.publicJwk);
const encryption = await getOrCreateEncryptionKeypair();
const hostEncPrivateKey = await importEcdhPrivateKey(encryption.privateJwk);