@dotrino/vault 0.33.3 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/vault",
-  "version": "0.33.3",
+  "version": "0.35.0",
   "description": "Usa ESTE dispositivo (navegador) como bóveda/CA del ecosistema Dotrino: atiende enrolamientos por el proxy y firma certificados de delegación a tus máquinas. Incluye el cliente de SERVICIO (Node): un proyecto se enrola una vez y jala sus credenciales del vault en vez del .env (`import '@dotrino/vault/config'`).",
   "type": "module",
   "main": "src/index.js",
@@ -47,8 +47,8 @@
     "pairing"
   ],
   "peerDependencies": {
-    "@dotrino/identity": ">=0.58.0",
-    "@dotrino/proxy-client": ">=0.9.0"
+    "@dotrino/identity": ">=0.61.0",
+    "@dotrino/proxy-client": ">=0.13.0"
   },
   "license": "MIT",
   "repository": {

package/src/enroll.js

@@ -52,7 +52,7 @@ export const MSG_REVOKED = 'vault.revoked'
 export const MSG_ERROR = 'vault.error'
 
 /** Los scopes del cert se corresponden 1:1 con las capacidades del acta (§D7). */
-const SCOPE_TO_CAP = { 'vault:sign': 'sign', 'vault:store': 'store', 'vault:read': 'read', 'vault:admin': 'admin' }
+const SCOPE_TO_CAP = { 'vault:sign': 'sign', 'vault:store': 'store', 'vault:read': 'read', 'vault:admin': 'admin', 'vault:passwords': 'passwords' }
 export const scopeToCaps = (scope) =>
   (Array.isArray(scope) ? scope : [scope]).map((s) => SCOPE_TO_CAP[s]).filter(Boolean)
 

package/src/index.js

@@ -25,10 +25,10 @@
  * (`identity.signDelegation`). Transporte: `@dotrino/proxy-client` (import perezoso).
  * No reimplementa nada del ecosistema.
  */
-import { verifyChain } from '@dotrino/identity/capabilities'
+import { verifyChain, verifyDeviceSig } from '@dotrino/identity/capabilities'
 import { createEnrollDesk, deviceIdOf, DEVICE_TTL_MS, FRESH_WINDOW_MS } from './enroll.js'
 // Las constantes del protocolo salen del MISMO módulo que usa el daemon: si la lista
-// local se queda corta, el dispositivo deja de atender mensajes sin que nadie lo note.
+// local se queda corta, el dispositivo deja de handle mensajes sin que nadie lo note.
 import { MSG, SCOPE } from './protocol.js'
 
 const SIGN_SCOPE = SCOPE.SIGN
@@ -168,15 +168,132 @@ export async function startDeviceVault (identity, { proxyUrl, client: injectedCl
     if (mine) desk.emitRevoke(chk.device, mine.nonce)
   }
 
+  /**
+   * Lo que el daemon comprueba antes de cualquier operación firmada, en un solo sitio:
+   * frescura (anti-replay), cadena de certs, scope esperado y revocaciones.
+   *
+   * Estaba repetido en `handleRenew` y `handleDevices` con matices distintos; al añadir
+   * el resto de operaciones eso habría sido cuatro copias divergiendo.
+   */
+  async function authorise (from, p, expectedScope) {
+    const d = p?.data
+    if (!d || !p.signature || !p.cert) {
+      send(from, { type: MSG.ERROR, error: 'invalid request' })
+      return null
+    }
+    if (typeof d.ts !== 'number' || Math.abs(Date.now() - d.ts) > FRESH_WINDOW_MS) {
+      send(from, { type: MSG.ERROR, error: 'stale request: ts outside the ±5 min window (possible replay, or a clock out of sync)' })
+      return null
+    }
+    const chk = await verifyChain({
+      data: d, signature: p.signature, cert: p.cert,
+      ...(expectedScope ? { expectedScope } : {}),
+      trustedIssuer: iss, revoked: await revocationSet(),
+    })
+    if (!chk.ok) {
+      send(from, { type: MSG.ERROR, error: 'unauthorized: ' + chk.reason })
+      return null
+    }
+    return chk
+  }
+
+  /**
+   * FIRMAR en name de la identidad. Es la razón de ser de una bóveda, y faltaba: un
+   * aparato enrolado contra este dispositivo podía renovar su cert y listar aparatos,
+   * pero no pedir la única cosa para la que se enroló.
+   */
+  async function handleSign (from, p) {
+    const chk = await authorise(from, p, SCOPE.SIGN)
+    if (!chk) return
+    const toSign = p.data?.payload
+    if (toSign == null) return send(from, { type: MSG.ERROR, error: 'data.payload required' })
+    const { signature, publickey } = await identity.signData(toSign)
+    send(from, { type: MSG.SIGNED, signature, publickey, device: chk.device })
+  }
+
+  /** Leer del almacén del perfil. Mismo scope que en el daemon: `read`. */
+  async function handleGet (from, p) {
+    const chk = await authorise(from, p, SCOPE.READ)
+    if (!chk) return
+    const id = p.data?.id || 'root'
+    try {
+      const node = await identity.getNode?.(id)
+      send(from, { type: MSG.DATA, id, node: node ?? null })
+    } catch (e) {
+      send(from, { type: MSG.ERROR, error: 'get: ' + e.message })
+    }
+  }
+
+  /**
+   * Escribir en el almacén. Se pasa por `vaultStore`, que es el mismo camino que usa
+   * un aparato contra el daemon — no se reimplementa el store aquí.
+   */
+  async function handleStore (from, p) {
+    const d = p?.data
+    if (!d || typeof d.method !== 'string') {
+      return send(from, { type: MSG.ERROR, error: 'store: invalid method' })
+    }
+    const chk = await authorise(from, p, SCOPE.STORE)
+    if (!chk) return
+    try {
+      const result = await identity.vaultStore?.(d.method, d.args || [])
+      send(from, { type: MSG.DATA, id: d.method, node: result ?? null })
+    } catch (e) {
+      send(from, { type: MSG.ERROR, error: 'store: ' + e.message })
+    }
+  }
+
+  /**
+   * ¿Sigue este aparato dentro del acta? Lo pregunta un aparato al arrancar, y por eso
+   * NO va firmado con cert: va firmado con su propia llave. Un aparato revocado tiene
+   * que poder enterarse de que lo está.
+   */
+  async function handleCheck (from, p) {
+    const d = p?.data
+    if (!d || typeof d.ts !== 'number' || Math.abs(Date.now() - d.ts) > FRESH_WINDOW_MS) return
+    const pub = d.publickey
+    if (typeof pub !== 'string') return send(from, { type: MSG.ERROR, error: 'unauthorized: shape' })
+    if (!(await verifyDeviceSig({ publickey: pub, data: d, signature: p.signature }))) {
+      return send(from, { type: MSG.ERROR, error: 'unauthorized: bad-signature' })
+    }
+    const record = (await identity.profileActa?.().catch(() => null))?.acta || null
+    const inside = (record?.members || []).some((m) => m?.pub === pub)
+    if (inside) return send(from, { type: MSG.CHECKED, in: true })
+
+    // Fuera del acta: se le dice, y además se le re-emite el aviso firmado si consta
+    // revocado — para que se apague solo en vez de quedarse creyendo que sigue dentro.
+    const { revokedCerts, issued } = await identity.listDelegations()
+    const mine = (revokedCerts || issued || []).find((x) => x.sub === pub && x.revokedAt)
+    if (mine) desk.emitRevoke(pub, mine.nonce)
+    send(from, { type: MSG.CHECKED, in: false })
+  }
+
+  /**
+   * Un fallo dentro de un handler NO se traga.
+   *
+   * El router llevaba `.catch(() => {})` en cada rama: si algo reventaba, el aparato del
+   * otro lado se quedaba esperando para siempre y aquí no quedaba rastro. Ahora se
+   * contesta el error — que es lo que permite depurarlo desde el lado que pregunta.
+   */
+  const handle = (name, promise, from) => Promise.resolve(promise).catch((e) => {
+    send(from, { type: MSG.ERROR, error: `${name}: ${e?.message || e}` })
+  })
+
   client.on('message', (_from, p) => {
     if (!p || typeof p !== 'object') return
     // El QR corto no lleva la llave: el aparato la pide con un HELLO presentando el `sn`.
-    if (p.type === MSG.HELLO) Promise.resolve(desk.handleHello(_from, p)).catch(() => {})
-    else if (p.type === MSG.ENROLL) desk.handleEnroll(_from, p).catch(() => {})
+    if (p.type === MSG.HELLO) handle('hello', desk.handleHello(_from, p), _from)
+    else if (p.type === MSG.ENROLL) handle('enroll', desk.handleEnroll(_from, p), _from)
     // Camino A: el aparato devuelve su acta sellada admitiendo a esta bóveda.
-    else if (p.type === MSG.ACTA_SEALED) Promise.resolve(desk.handleActaSealed(_from, p)).catch(() => {})
-    else if (p.type === MSG.RENEW) handleRenew(_from, p).catch(() => {})
-    else if (p.type === MSG.DEVICES) handleDevices(_from, p).catch(() => {})
+    else if (p.type === MSG.ACTA_SEALED) handle('acta', desk.handleActaSealed(_from, p), _from)
+    else if (p.type === MSG.RENEW) handle('renew', handleRenew(_from, p), _from)
+    else if (p.type === MSG.DEVICES) handle('devices', handleDevices(_from, p), _from)
+    // Lo que faltaba para que un aparato enrolado aquí pueda hacer lo mismo que contra
+    // el daemon del PC: firmar, leer, guardar y comprobar que sigue dentro.
+    else if (p.type === MSG.SIGN) handle('sign', handleSign(_from, p), _from)
+    else if (p.type === MSG.GET) handle('get', handleGet(_from, p), _from)
+    else if (p.type === MSG.STORE) handle('store', handleStore(_from, p), _from)
+    else if (p.type === MSG.CHECK) handle('check', handleCheck(_from, p), _from)
   })
 
   /**

package/src/invite.js

@@ -69,10 +69,12 @@ export const FMT_SHORT = 't'
 export const DEFAULT_PROXY = 'wss://proxy.dotrino.com'
 
 /**
- * La base del enlace del QR. Corta a propósito (`/d#v=` en vez de
- * `/dispositivos#vault=`): son 15 caracteres menos dentro del QR, y ahí los
- * caracteres se pagan en módulos. `vault.dotrino.com/dispositivos` sigue
- * funcionando —es la ruta que la gente ya tiene— y `parseInvite` lee las dos.
+ * La base del enlace del QR. Corta a propósito (`/d#v=` en vez de `/vault#vault=`):
+ * son caracteres menos dentro del QR, y ahí los caracteres se pagan en módulos.
+ *
+ * `parseInvite` no mira la ruta, solo el #fragment: por eso un enlace emitido con
+ * cualquiera de las formas anteriores sigue emparejando aunque su dirección ya no
+ * exista.
  */
 export const PAIR_URL = 'https://vault.dotrino.com/d#v='
 

package/src/protocol.js

@@ -98,7 +98,11 @@ export const SCOPE = Object.freeze({
   // NO incluye cambiar permisos, traspasar el mando ni conceder `admin`: eso es el rol
   // de master y sigue siendo local. No se empareja — se concede desde el PC.
   ADMIN: 'vault:admin',
-  APPROVE: 'vault:approve' // aprobar pedidos de secretos (cajones con `approval`); se concede a mano, como admin
+  APPROVE: 'vault:approve', // aprobar pedidos de secretos (cajones con `approval`); se concede a mano, como admin
+  // El gestor de contraseñas: pedir credenciales de la bóveda, de a una y por dominio.
+  // Nunca lista la bóveda entera. Este SÍ se empareja (`pair --scope contrasenas`): es
+  // lo primero que hace la extensión, y no tendría sentido obligar a un segundo paso.
+  PASSWORDS: 'vault:passwords'
 })
 
 /**