#!/usr/bin/env node // Pair this machine with a dsh-remote master WITHOUT a running local DSH: exchange a // one-time pairing code for a device key and write the slave link state. // // node deploy/pair.mjs --master https://dsh.example.com --code ABCD-... --name my-mac // [--edge basic --edge-user USER] # password from $DSH_REMOTE_EDGE_PASSWORD or prompt // [--edge bearer] # token from $DSH_REMOTE_EDGE_TOKEN or prompt // [--edge oauth2 --edge-token-url URL --edge-client-id ID [--edge-user USER] [--edge-client-secret]] // [--edge cookie] # proxy session cookie from $DSH_REMOTE_EDGE_COOKIE or prompt // [--edge headers --edge-header "CF-Access-Client-Id: …" --edge-header "CF-Access-Client-Secret: …"] // [--state ] // // Edge = an auth proxy (Authentik, oauth2-proxy, Cloudflare Access, Basic) in front of the // master. Its secrets are stored in $DSH_HOME/.credentials.yaml (refs, 0600) — the same store // DSH's credentials service reads — and only their ref names go into the link state. // Restart DSH afterwards. import fs from 'node:fs' import os from 'node:os' import path from 'node:path' import readline from 'node:readline' import tty from 'node:tty' import { fileURLToPath } from 'node:url' const here = path.dirname(fileURLToPath(import.meta.url)) const { createEdgeAuth } = await import(path.join(here, '..', 'lib', 'edge-auth.mjs')) const { setRefIn, getRefIn } = await import(path.join(here, 'pair-lib.mjs')) const args = process.argv.slice(2) const opt = (k, d) => { const i = args.indexOf(`--${k}`); return i >= 0 ? args[i + 1] : d } const opts = (k) => args.flatMap((a, i) => (a === `--${k}` ? [args[i + 1]] : [])) const master = String(opt('master', '')).replace(/\/+$/, '') const code = opt('code', '') const name = opt('name', os.hostname()) const home = process.env.DSH_HOME || path.join(os.homedir(), '.dsh') const stateFile = opt('state', path.join(home, 'profiles', opt('profile', 'web'), 'dsh-remote', 'state.json')) if (!/^https?:\/\//.test(master) || !code) { console.error('usage: pair.mjs --master --code [--name ] [--edge basic|bearer|oauth2|cookie|headers …]') process.exit(2) } // ---- credentials.yaml refs (the store DSH's credentials service reads) ---------------- const credFile = path.join(home, '.credentials.yaml') function setRef(ref, value) { let text = '' try { text = fs.readFileSync(credFile, 'utf8') } catch { text = '' } fs.mkdirSync(home, { recursive: true, mode: 0o700 }) const tmp = `${credFile}.${process.pid}.tmp` fs.writeFileSync(tmp, setRefIn(text, ref, value), { mode: 0o600 }) fs.renameSync(tmp, credFile) } function getRef(ref) { if (process.env[ref]) return process.env[ref] try { return getRefIn(fs.readFileSync(credFile, 'utf8'), ref) } catch { return undefined } } function prompt(question) { // `curl … | bash` makes stdin the script; read from the terminal instead. let input = process.stdin let output = process.stdout if (!process.stdin.isTTY) { try { const fd = fs.openSync('/dev/tty', 'r+') input = new tty.ReadStream(fd) output = new tty.WriteStream(fd) } catch { return Promise.resolve('') } } return new Promise((resolve) => { const rl = readline.createInterface({ input, output, terminal: true }) rl._writeToOutput = (s) => { if (s.includes(question)) output.write(s) } // hide typed secret rl.question(question, (a) => { rl.close(); output.write('\n'); if (input !== process.stdin) input.destroy(); resolve(a.trim()) }) }) } // ---- edge auth spec ---------------------------------------------------------------------- const edgeMode = opt('edge', 'none') let edgeAuth = { mode: 'none' } async function secretRef(ref, what) { let v = getRef(ref) if (!v) v = await prompt(`${what}: `) if (!v) { console.error(`missing ${what} (set ${ref} or answer the prompt)`); process.exit(2) } setRef(ref, v) return ref } if (edgeMode === 'basic') { edgeAuth = { mode: 'basic', username: opt('edge-user', ''), passwordRef: await secretRef('DSH_REMOTE_EDGE_PASSWORD', `Password / app password for "${opt('edge-user', '')}" at the auth proxy`) } } else if (edgeMode === 'bearer') { edgeAuth = { mode: 'bearer', tokenRef: await secretRef('DSH_REMOTE_EDGE_TOKEN', 'Bearer token for the auth proxy') } } else if (edgeMode === 'oauth2') { edgeAuth = { mode: 'oauth2', tokenUrl: opt('edge-token-url'), clientId: opt('edge-client-id'), username: opt('edge-user'), scope: opt('edge-scope') } if (!edgeAuth.tokenUrl || !edgeAuth.clientId) { console.error('--edge oauth2 needs --edge-token-url and --edge-client-id'); process.exit(2) } if (edgeAuth.username) edgeAuth.passwordRef = await secretRef('DSH_REMOTE_EDGE_PASSWORD', `App password for "${edgeAuth.username}"`) if (args.includes('--edge-client-secret')) edgeAuth.clientSecretRef = await secretRef('DSH_REMOTE_EDGE_CLIENT_SECRET', 'OAuth2 client secret') } else if (edgeMode === 'cookie') { edgeAuth = { mode: 'cookie', cookieRef: await secretRef('DSH_REMOTE_EDGE_COOKIE', 'Proxy session cookie (name=value, or the whole Cookie header)') } } else if (edgeMode === 'headers') { edgeAuth = { mode: 'headers', headers: {} } let i = 0 for (const h of opts('edge-header')) { const at = h.indexOf(':') if (at <= 0) { console.error(`bad --edge-header "${h}" (want "Name: value")`); process.exit(2) } const ref = `DSH_REMOTE_EDGE_HEADER_${++i}` setRef(ref, h.slice(at + 1).trim()) edgeAuth.headers[h.slice(0, at).trim()] = `ref:${ref}` } } else if (edgeMode !== 'none') { console.error(`unknown --edge mode ${edgeMode}`) process.exit(2) } // ---- enroll ----------------------------------------------------------------------------------- const slug = (s) => String(s || '').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'device' let state = {} try { state = JSON.parse(fs.readFileSync(stateFile, 'utf8')) } catch { state = {} } state.self ||= { id: slug(name), name, createdAt: Date.now() } state.self.name = name const edge = createEdgeAuth(edgeAuth, async (ref) => getRef(ref)) let r try { r = await edge.edgeFetch(`${master}/dsh-remote/enroll`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ code: code.trim().toUpperCase(), id: state.self.id, name, platform: `${process.platform}-${process.arch}` }), }) } catch (e) { console.error(`pairing failed: ${e.message}${e.hint ? `\n hint: ${e.hint}` : ''}`) process.exit(1) } let j = {} try { j = await r.json() } catch { j = {} } if (!r.ok) { console.error(`pairing failed: ${j.error || `HTTP ${r.status}`}`); process.exit(1) } state.master = { url: master, deviceId: j.deviceId, key: j.key, master: j.master, edgeAuth, pairedAt: Date.now() } state.self.id = j.deviceId fs.mkdirSync(path.dirname(stateFile), { recursive: true, mode: 0o700 }) const tmp = `${stateFile}.${process.pid}.tmp` fs.writeFileSync(tmp, JSON.stringify(state, null, 2), { mode: 0o600 }) fs.renameSync(tmp, stateFile) console.log(`paired as "${j.deviceId}" with master ${j.master?.name || master}${edgeAuth.mode !== 'none' ? ` (through ${edgeAuth.mode} edge auth)` : ''}`)