From 7b5fbbc1d790faac6417c0df5fdce4144dfad997 Mon Sep 17 00:00:00 2001 From: Alex Flom Date: Fri, 13 Nov 2026 18:40:25 -0700 Subject: [PATCH] Restore the prior Prism identity integration for containment Revert the identity integration introduced by #73 while preserving later template changes. Regenerate the canonical frame lock. No stored account, recovery-kit, project, or chat data is deleted. --- .github/workflows/try-page.yml | 4 +- bootstrap/page.mjs | 34 +- frame.lock | 4 +- frame/frame.css | 4 +- frame/frame.mjs | 50 +- frame/panels.css | 24 +- frame/panels.mjs | 723 ++++------- frame/publish.mjs | 17 +- identity/PROTOCOL.md | 210 +-- identity/README.md | 108 +- identity/dev.mjs | 126 +- identity/id.css | 44 + identity/id.mjs | 303 +++++ identity/index.html | 25 + identity/prism-id.mjs | 2186 -------------------------------- identity/publish.mjs | 32 + identity/stitch-sync.mjs | 176 --- identity/stitch.lock | 55 - identity/test.mjs | 478 ++++--- package.json | 2 +- site/page.template.html | 4 +- 21 files changed, 1193 insertions(+), 3416 deletions(-) create mode 100644 identity/id.css create mode 100644 identity/id.mjs create mode 100644 identity/index.html delete mode 100644 identity/prism-id.mjs create mode 100644 identity/publish.mjs delete mode 100644 identity/stitch-sync.mjs delete mode 100644 identity/stitch.lock diff --git a/.github/workflows/try-page.yml b/.github/workflows/try-page.yml index 78ab599..675c888 100644 --- a/.github/workflows/try-page.yml +++ b/.github/workflows/try-page.yml @@ -42,10 +42,12 @@ jobs: "$RUNNER_TEMP/frame-draw/bin/python" -I bootstrap/og.py - name: The frame verifies in a real module worker, refuses bad archives and works offline run: node --test site/worker-browser.test.mjs - - name: Prism ids - the pinned stitch copy matches its lock, every session check refuses, and two apps share one id + - name: Prism accounts - every signature check refuses, and the passkey flow signs in run: npm run test:identity - name: Build the canonical frame every Prism app loads run: node frame/publish.mjs "$RUNNER_TEMP/frame" "$GITHUB_SHA" + - name: Build the sign-in page for id.uor.foundation, pinned by hash + run: node identity/publish.mjs "$RUNNER_TEMP/identity" "$GITHUB_SHA" deploy: name: publish the try page and the canonical frame diff --git a/bootstrap/page.mjs b/bootstrap/page.mjs index e8811d1..6e00344 100644 --- a/bootstrap/page.mjs +++ b/bootstrap/page.mjs @@ -104,6 +104,10 @@ const prismRegistry = new URL(`https://${DEFAULT_REGISTRY}/`); // a frame change reaches this app without rebuilding it. app.json may name // another frame host, for a test or a mirror. const frameHost = new URL(meta.frame ?? "https://uor-foundation.github.io/template/frame/"); +// Prism accounts: the sign-in page the frame's account panel shows. The +// page's policy frames that one origin and no other. app.json may name +// another, for a test. +const accounts = new URL(meta.accounts ?? "https://id.uor.foundation/"); const shareUrl = live.href; // The one speculation rule: the frame marks the pages a visitor is about to @@ -117,26 +121,23 @@ const speculationRules = JSON.stringify({ // with the page's, so the frame does not wait for a TLS handshake. const frameConnect = frameHost.origin !== live.origin ? `` : ""; -// The origins this page's connect-src must name for the frame: its Unsplash -// worker, for the theme panel's search, and stitch's relay (with its -// WebSocket origin), where a visitor's Prism id devices meet. Both are read -// from the live frame at build, after its SHA-256 is checked as the browser -// checks it. The frame itself is not written into the page: the page's own -// stand-in (prism-page.css) shows, drawn as the bar, until the module -// arrives, which keeps the first load inside the Lighthouse budget. -async function frameAllowed() { +// The frame's Unsplash worker, which this page's connect-src must name for +// the theme panel's search: read from the live frame at build, after its +// SHA-256 is checked as the browser checks it. The frame itself is not +// written into the page: the page's own stand-in (prism-page.css) shows, +// drawn as the bar, until the module arrives, which keeps the first load +// inside the Lighthouse budget. +async function frameUnsplash() { try { const pointer = await (await fetch(new URL("current.json", frameHost), { cache: "no-store" })).json(); if (!/^[0-9a-f]{64}$/.test(pointer.sha256 ?? "")) throw new Error("the frame pointer names no sha256"); const bytes = Buffer.from(await (await fetch(new URL(pointer.module, frameHost))).arrayBuffer()); if (hex(bytes) !== pointer.sha256) throw new Error(`the frame is ${hex(bytes)}, its pointer says ${pointer.sha256}`); const frame = await import(`data:text/javascript;base64,${bytes.toString("base64")}`); - const origin = (value) => (/^https:\/\/[a-z0-9.-]+$/.test(value ?? "") ? value : ""); - const relay = origin(/^https:\/\/[a-z0-9.-]+/.exec(frame.PRISM_RELAY ?? "")?.[0]); - return { unsplash: origin(frame.UNSPLASH_ORIGIN), relay: relay ? `${relay} ${relay.replace(/^https:/, "wss:")}` : "" }; + return /^https:\/\/[a-z0-9.-]+$/.test(frame.UNSPLASH_ORIGIN ?? "") ? frame.UNSPLASH_ORIGIN : ""; } catch (error) { - console.warn(`page: the frame could not be read at build (${error.message}); no Unsplash or relay origin in connect-src`); - return { unsplash: "", relay: "" }; + console.warn(`page: the frame could not be read at build (${error.message}); no Unsplash origin in connect-src`); + return ""; } } // The repository's GitHub stars at build, so the bar shows them from its @@ -165,7 +166,7 @@ async function githubStars() { } } const stars = await githubStars(); -const frameOrigins = await frameAllowed(); +const unsplashOrigin = await frameUnsplash(); // --------------------------------------------------------------------------- // The workspace and the spec, rendered here so the page says everything @@ -431,8 +432,9 @@ const fill = { HOLO_SEARCH_ORIGIN: holoSearch.origin, REGISTRY_ORIGIN: prismRegistry.origin, FRAME_ORIGIN: frameHost.origin, - UNSPLASH_ORIGIN: frameOrigins.unsplash, - PRISM_RELAY_ORIGINS: frameOrigins.relay, + ACCOUNTS: escape(accounts.href), + ACCOUNTS_ORIGIN: accounts.origin, + UNSPLASH_ORIGIN: unsplashOrigin, OG_IMAGE: escape(new URL("og.png", live).href), OG_ALT: escape(`${meta.name}: ${meta.purpose}`), NAME: escape(meta.name), diff --git a/frame.lock b/frame.lock index cd4c7f9..6f5bdab 100644 --- a/frame.lock +++ b/frame.lock @@ -15,7 +15,7 @@ }, { "path": "bootstrap/page.mjs", - "sha256": "8eee238bce9206ca58fc9be5471c28c0bdab82e2350ed78f1972da2a1da6581f" + "sha256": "2df4ef057d37e778b04f67e4f63d862c7da6a77c301d0862b2bb8681fc8ec9d4" }, { "path": "bootstrap/precache.mjs", @@ -51,7 +51,7 @@ }, { "path": "site/page.template.html", - "sha256": "b48b9d18e23e959c9e96b4bec58e2e7d80b7b977e981d8a7b0fd369293819b08" + "sha256": "d7df0bc4d5190ca38ee768bdbd54cbc665ede811608de846068c8a92bd02c14d" }, { "path": "site/prism-page.css", diff --git a/frame/frame.css b/frame/frame.css index b233c1c..db9cb45 100644 --- a/frame/frame.css +++ b/frame/frame.css @@ -252,8 +252,8 @@ svg.gh, svg.fill { fill: currentColor; stroke: none; } #github[hidden] + .sep { display: none; } /* Full screen: the corners point out to enter, in to leave. */ :host([fullscreen]) #fullscreen .expand, :host(:not([fullscreen])) #fullscreen .shrink { display: none; } -/* The account: a line drawing signed out; while the Prism id window is open - * it breathes; signed in, the same figure filled, in the full text +/* The account: a line drawing signed out; while the device is asked for its + * passkey it breathes; signed in, the same figure filled, in the full text * colour, so who is signed in reads at a glance and nothing else changes. */ #account.signed-in { color: var(--foreground); } #account.signed-in svg.person { fill: currentColor; } diff --git a/frame/frame.mjs b/frame/frame.mjs index 7085b64..74ad3d6 100644 --- a/frame/frame.mjs +++ b/frame/frame.mjs @@ -7,7 +7,7 @@ // // The contract (prism/frame/1): // +// verdict verdict-label fingerprint proof proof-url examples accounts> // … optional: shown in the bar, e.g. "Update available" // // name the app's name ("Luhn check") @@ -25,10 +25,11 @@ // proof-url optional: the proof's attestation // examples optional: "passed/total" once the page has replayed the holo's // examples, "running" while it does, "error" when it could not -// The element's account is the visitor's Prism id (null when signed out); -// sign(bytes) signs with this browser's session key and returns the -// signature with the id's delegation; "accountchange" fires on sign-in and -// sign-out. identity/PROTOCOL.md is the account contract. +// accounts optional: the Prism accounts origin (https://id.uor.foundation) +// The element's account is the visitor's Prism account (null when signed +// out); sign(bytes) signs with this browser's session key and returns the +// signature with the passkey's delegation; "accountchange" fires on sign-in +// and sign-out. identity/PROTOCOL.md is the account contract. // The shield sums the three: green only when the bytes are authentic and // every example gives its proved answer; its panel shows each check, as a // browser shows a page's security. @@ -345,14 +346,12 @@ function holoIndex() { const githubMark = ''; const starMark = ''; -// Prism ids (prism/identity/4, identity/PROTOCOL.md): stitch's Prism id, -// named by the κ of its genesis and held by devices whose keys never leave -// them, with a recovery kit its owner keeps, so losing a device never loses -// the id. The frame keeps this app's session and signs with it; the panels -// module holds this origin's device and runs the sign-in, in the visitor's -// browser. Devices of one id meet on stitch's relay, which the page build -// reads from here into the page's connect-src (with its WebSocket origin). -export const PRISM_RELAY = "https://ntfy.sh"; +// Prism accounts (prism/identity/1, identity/PROTOCOL.md). An account is a +// passkey: its private key stays in the device's secure hardware, and the +// account's name is the hash of its public key. The frame keeps the session +// and signs with it; the panels module runs the sign-in and checks every +// signature the sign-in page hands back, in the visitor's browser. +const ACCOUNTS = "https://id.uor.foundation"; const SESSION_DAYS = 7; const b64u = (bytes) => btoa(String.fromCharCode(...new Uint8Array(bytes))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, ""); // The session, in this app's IndexedDB: the browser key cannot be read out @@ -374,11 +373,11 @@ function store(mode, work) { const accountChannel = { session: null, loaded: null }; function loadSession() { return (accountChannel.loaded ??= store("readonly", (s) => s.get("current")) - .then((saved) => (accountChannel.session = saved?.delegation?.envelope && saved.expires > Date.now() ? saved : null)) + .then((saved) => (accountChannel.session = saved && saved.delegation.expires > Date.now() ? saved : null)) .catch(() => null)); } // What the account panel, in the panels module, borrows from the frame. -const ACCOUNT_CORE = { SESSION_DAYS, b64u, store, accountChannel, loadSession, PRISM_RELAY }; +const ACCOUNT_CORE = { SESSION_DAYS, b64u, store, accountChannel, loadSession }; // Everything the markup needs, from the attributes (get), the page's title // and its address: one function, for the element and for the shell. @@ -401,6 +400,7 @@ function modelOf(get, title, base) { ...starsOf(Number(get("stars"))), card: get("card") ?? new URL("og.png", url).href, identity: get("identity") ?? "#identity-title", + accounts: get("accounts") ?? ACCOUNTS, host: (url.host + url.pathname).replace(/\/$/, ""), x: `https://x.com/intent/post?${query({ text, url: url.href })}`, linkedin: `https://www.linkedin.com/sharing/share-offsite/?${query({ url: url.href })}`, @@ -448,7 +448,7 @@ export function shell(attributes, base) { // there is none, to write the shell. const Element = globalThis.HTMLElement ?? class {}; class PrismFrame extends Element { - static observedAttributes = ["name", "address", "live", "repo", "home", "purpose", "card", "identity", "verdict", "verdict-label", "fingerprint", "proof", "proof-url", "examples", "stars"]; + static observedAttributes = ["name", "address", "live", "repo", "home", "purpose", "card", "identity", "verdict", "verdict-label", "fingerprint", "proof", "proof-url", "examples", "stars", "accounts"]; constructor() { super(); @@ -831,32 +831,32 @@ class PrismFrame extends Element { // The visitor's Prism account, for the app: null when signed out. get account() { const saved = accountChannel.session; - return saved ? { id: saved.account, key: saved.key, expires: saved.expires } : null; + return saved ? { id: saved.account, key: saved.key, expires: saved.delegation.expires } : null; } // Signs bytes with this browser's session key. The delegation proves the - // Prism id let that key act for it here; verifySession checks it. + // account's passkey let that key act for it here; verifySession checks it. async sign(data) { const saved = accountChannel.session; - if (!saved || saved.expires <= Date.now()) throw Object.assign(new Error("No one is signed in"), { name: "IdentityError", code: "signed-out" }); + if (!saved || saved.delegation.expires <= Date.now()) throw Object.assign(new Error("No one is signed in"), { name: "IdentityError", code: "signed-out" }); const signature = await crypto.subtle.sign({ name: "ECDSA", hash: "SHA-256" }, saved.privateKey, data); return { signature: b64u(signature), delegation: saved.delegation }; } - // The account icon, after full screen: a line drawing signed out, filled - // once signed in. Its panel and the + // The account icon, after full screen: a line drawing signed out, a soft + // pulse while a passkey is asked, filled once signed in. Its panel and the // sign-in itself come with the panels module (accounts() there), fetched // when the visitor reaches for the icon, so an app's first load carries - // none of it. Where a Prism id cannot work (no secure context, no - // WebCrypto, no IndexedDB, no popover) the icon is not shown, so it never - // offers what would fail. + // none of it. Where passkeys cannot work (no secure context, no WebAuthn, + // no IndexedDB, no popover) the icon is not shown, so it never offers + // what would fail. accountPanel() { const button = this.$("account"); const panel = this.$("account-panel"); this.accountWatch?.abort(); this.accountReady = null; let wired = false; - if (typeof panel.showPopover !== "function" || !window.isSecureContext || !globalThis.crypto?.subtle || !globalThis.indexedDB) { + if (typeof panel.showPopover !== "function" || !window.isSecureContext || !window.PublicKeyCredential || !globalThis.indexedDB) { button.hidden = true; return; } diff --git a/frame/panels.css b/frame/panels.css index d60dca9..9ea77de 100644 --- a/frame/panels.css +++ b/frame/panels.css @@ -466,21 +466,17 @@ .account-panel .row { justify-content: flex-start; width: 100%; min-height: 2.618rem; padding: 0 1rem; border: 0; border-radius: var(--radius-control); background: none; color: var(--foreground); font-size: 1rem; text-align: start; cursor: pointer; } .account-panel .row:hover { background: var(--accent); } .account-panel .row:focus-visible, .account-panel .text:focus-visible, .account-close:focus-visible { outline: var(--ring-width) solid var(--ring); outline-offset: var(--ring-offset); } -.account-panel .primary { width: 100%; min-height: 2.618rem; font-size: 1rem; } -.account-panel .account-in > p { margin-bottom: 0.618rem; color: var(--muted-foreground); } -.account-panel .account-in > p b { color: var(--foreground); font-weight: 600; } -.account-panel input:not([type="file"]) { width: 100%; min-height: 2.618rem; padding: 0 1rem; border: var(--border-width) solid var(--border); border-radius: var(--radius-control); background: var(--background); color: var(--foreground); font: inherit; font-size: 1rem; } -.account-panel #account-code { margin-top: 0.382rem; font-family: var(--font-mono); letter-spacing: 0.2em; } -.account-panel label { display: grid; color: var(--muted-foreground); } -.account-panel input:focus-visible { outline: var(--ring-width) solid var(--ring); outline-offset: var(--ring-offset); } -.account-code { margin-top: 0.618rem !important; color: var(--foreground); font-size: 1rem; } -.account-devices { display: grid; gap: 0.382rem; margin: 0; padding: 0; list-style: none; } -.account-devices li { display: flex; align-items: center; justify-content: space-between; gap: var(--space-2); min-height: 2.618rem; padding: 0 1rem; border: var(--border-width) solid var(--border); border-radius: var(--radius-control); } -.account-devices code { font-family: var(--font-mono); color: var(--muted-foreground); } -.account-error { margin-top: 1rem !important; color: var(--destructive, #c2410c); } -.account-panel.busy > :not(.account-close) { opacity: 0.618; pointer-events: none; } +.account-ceremony:empty { display: none; } +/* The iframe's colour scheme matches the page inside it; a mismatch would + * make the browser paint it an opaque ground over the dialog. */ +.account-ceremony iframe { display: block; width: 100%; height: 2.618rem; border: 0; color-scheme: light; } +:host([dark]) .account-ceremony iframe { color-scheme: dark; } +/* Shown only once the sign-in page has answered, so a page that fails to + * load never shows the browser's error page in the dialog. */ +.account-ceremony iframe:not(.ready) { visibility: hidden; height: 0 !important; } +#account-window { width: 100%; min-height: 2.618rem; font-size: 1rem; } @media (pointer: coarse) { - .account-panel .row, .account-panel .primary, .account-panel input:not([type="file"]) { min-height: var(--touch); } + .account-panel .row, #account-window { min-height: var(--touch); } .account-close { top: 0.618rem; right: 0.618rem; width: var(--touch); height: var(--touch); min-height: var(--touch); } } @media (prefers-reduced-transparency: reduce) { .account-panel::backdrop { -webkit-backdrop-filter: none; backdrop-filter: none; background: rgb(0 0 0 / 0.618); } } diff --git a/frame/panels.mjs b/frame/panels.mjs index 9836a41..61e1170 100644 --- a/frame/panels.mjs +++ b/frame/panels.mjs @@ -341,23 +341,19 @@ export function panel(frame, core) { return { open: () => query || home() }; } -// Prism ids (prism/identity/4, identity/PROTOCOL.md). A visitor's Prism id -// is stitch's Prism id (afflom/stitch, pinned in identity/stitch.lock): the -// κ of its genesis, held by devices whose keys never leave them. Each app's -// origin keeps its own device of the id, made here with no prompt; another -// device or app joins the same id by stitch's link offer, confirmed with a -// six-digit code, and a recovery kit brings it back after every device is -// lost. Devices meet on stitch's substrate (its relay), so nothing here -// needs a server of Prism's own. -// -// Signing in is the device signing one action for this app, -// "prism/session/1", which lets a session key made here act for the id on -// this origin until it expires. verifySession checks that action against the -// id's log with Prism id's own verifyAction, here and for anyone the app -// shows a signature to. A failed check is an IdentityError naming which. -const SESSION_ACTION = "prism/session/1"; -const MAX_SESSION_MS = 8 * 24 * 60 * 60 * 1000; +// The theme panel's contents, which the frame puts in its empty panel. +// Prism accounts (prism/identity/1, identity/PROTOCOL.md): the checks the +// sign-in page's answer must pass. The page is trusted with nothing; every +// signature is checked here, in the visitor's browser, as the frame checks +// the holo's bytes. A failed check is an IdentityError naming which one. +const MAX_CHAIN = 5; +const enc = new TextEncoder(); const b64u = (bytes) => btoa(String.fromCharCode(...new Uint8Array(bytes))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, ""); +const unb64u = (text) => { + if (typeof text !== "string" || !/^[\w-]*$/.test(text)) throw new IdentityError("encoding", "A value is not base64url"); + return Uint8Array.from(atob(text.replace(/-/g, "+").replace(/_/g, "/")), (c) => c.charCodeAt(0)); +}; +const digest = async (bytes) => new Uint8Array(await crypto.subtle.digest("SHA-256", bytes)); export class IdentityError extends Error { constructor(code, message) { @@ -370,518 +366,307 @@ const deny = (code, message) => { throw new IdentityError(code, message); }; -// Prism id itself (identity/prism-id.mjs), published beside the frame and -// named by its SHA-256, which frame/publish.mjs writes here. It is fetched -// when the visitor reaches for the account icon, and checked as the frame -// checks this module. Unpublished (tests, a checkout), it is read from the -// repository. -const PRISM_ID = "/*PRISM_ID*/"; -let prismModule = null; -export const prismId = () => - (prismModule ??= (async () => { - if (!/^[0-9a-f]{64}$/.test(PRISM_ID)) return import("../identity/prism-id.mjs"); - const bytes = await (await fetch(new URL(`${PRISM_ID}/prism-id.mjs`, FRAME_HOST))).arrayBuffer(); - const hex = Array.from(new Uint8Array(await crypto.subtle.digest("SHA-256", bytes)), (b) => b.toString(16).padStart(2, "0")).join(""); - if (hex !== PRISM_ID) throw new Error("Prism id is not the module this frame names"); - const url = URL.createObjectURL(new Blob([bytes], { type: "text/javascript" })); - try { - return await import(url); - } finally { - URL.revokeObjectURL(url); - } - })().catch((error) => { - prismModule = null; - throw error; - })); - -// A session: { app, envelope, records }. The envelope is the id's -// "prism/session/1" action for `app`, naming the session key and its expiry; -// records are the id's log as the signing device knew it. `fresh` is the -// window in which it must be checked after signing (Prism id's actionFresh); -// anyone checking a kept session later checks it as of its own signing -// (fresh: 0), and its expiry bounds it. -export async function verifySession(session, { now = Date.now(), fresh = 60000 } = {}) { - const Prism = await prismId(); - const { app, envelope, records } = session ?? {}; - const body = envelope?.body; - if (typeof app !== "string" || !/^https?:\/\/[^/]+$/.test(app)) deny("app", "The session names no app"); - if (body?.action !== SESSION_ACTION) deny("action", "The signature is not a session"); - const { sessionKey, expires } = body.payload ?? {}; - if (typeof sessionKey !== "string" || !/^[\w-]{87}$/.test(sessionKey)) deny("key", "The session key is malformed"); - if (!Number.isSafeInteger(expires) || expires <= now) deny("expired", "The session has expired"); - if (expires > body.at + MAX_SESSION_MS) deny("expired", "The session lasts too long"); - let log; - try { - log = await Prism.logFromRecords(records); - } catch (error) { - if (error instanceof Prism.PrismIdError) deny("log", "The log does not parse"); - throw error; - } - const at = fresh ? now : body.at; - let verdict; - try { - verdict = await Prism.verifyAction(body.prism, log, envelope, { audience: app, now: at, window: fresh || 1 }); - } catch (error) { - if (error instanceof Prism.PrismIdError) deny("log", `The log does not resolve: ${error.message}`); - throw error; - } - if (!verdict.allowed) deny(verdict.reason === "scope" ? "scope" : "signature", `The session was refused (${verdict.reason})`); - return { account: body.prism, key: envelope.signer, sessionKey, expires }; -} +// The origins whose signatures count, each with its WebAuthn rpId. +export const originsOf = (accounts) => ({ [new URL(accounts).origin]: new URL(accounts).hostname }); -// ---------------------------------------------------------------- this origin's device +const ALGORITHMS = { + [-7]: { key: { name: "ECDSA", namedCurve: "P-256" }, verify: { name: "ECDSA", hash: "SHA-256" } }, + [-257]: { key: { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" }, verify: { name: "RSASSA-PKCS1-v1_5" } }, +}; -// The device and its view of the id, in this origin's IndexedDB. IndexedDB -// keeps CryptoKeys as they are: a non-extractable key stays one. -function deviceStore(mode, work) { - return new Promise((done, fail) => { - const open = indexedDB.open("prism-id", 1); - open.onupgradeneeded = () => open.result.createObjectStore("prism"); - open.onerror = () => fail(open.error); - open.onsuccess = () => { - const tx = open.result.transaction("prism", mode); - const request = work(tx.objectStore("prism")); - tx.oncomplete = () => (open.result.close(), done(request?.result)); - tx.onerror = () => (open.result.close(), fail(tx.error)); - }; - }); +// WebAuthn's ECDSA signatures are DER; WebCrypto's are the two 32-byte halves. +function rawSignature(der) { + let at = 2; + const integer = () => { + if (der[at++] !== 0x02) deny("signature", "The signature is not DER"); + const length = der[at++]; + let value = der.slice(at, (at += length)); + while (value.length > 32 && value[0] === 0) value = value.slice(1); + if (value.length > 32 || at > der.length) deny("signature", "The signature is not DER"); + const out = new Uint8Array(32); + out.set(value, 32 - value.length); + return out; + }; + if (der[0] !== 0x30 || der[1] !== der.length - 2) deny("signature", "The signature is not DER"); + const r = integer(); + const s = integer(); + return new Uint8Array([...r, ...s]); } -export const loadDevice = () => deviceStore("readonly", (s) => s.get("self")).catch(() => null); -const saveDevice = (held) => deviceStore("readwrite", (s) => s.put(held, "self")); -const forgetDevice = () => deviceStore("readwrite", (s) => s.delete("self")); - -// The bus to the id's other devices: stitch's relay (the frame's -// PRISM_RELAY), which the page's connect-src must name; the page build reads -// it from the frame. A page that does not admit it keeps the id on this -// device: sign-in and recovery work, linking and syncing wait. -let relay = null; -let relayBus = null; -const relayAdmitted = (origin) => { - const policy = [...document.querySelectorAll('meta[http-equiv="Content-Security-Policy" i]')].map((meta) => meta.content).join(";"); - const connect = /(?:^|;)\s*connect-src([^;]*)/.exec(policy)?.[1] ?? /(?:^|;)\s*default-src([^;]*)/.exec(policy)?.[1]; - return connect === undefined || connect.includes(origin); -}; -const bus = (Prism) => (relayBus ??= Prism.createRelayBus({ relay: relay && relayAdmitted(new URL(relay).origin) ? relay : null })); -// Share this device's log with the id's other devices, under every boundary -// key it holds, so a device that has not taken up a rotation still hears. -async function share(Prism, held) { - for (const keyId of held.keyring.keys()) await Prism.publishSync(held, bus(Prism), { keyId }).catch(() => {}); +// One WebAuthn assertion: the passkey of record signed message. The six +// checks of PROTOCOL.md, in its order, failing closed. +export async function verifySigned(record, signed, message, origins) { + if (signed?.credential !== record.credential) deny("credential", "The signature is from another passkey"); + let client; + try { + client = JSON.parse(new TextDecoder().decode(unb64u(signed.clientDataJSON))); + } catch { + deny("client", "The signed client data is not JSON"); + } + if (client.type !== "webauthn.get") deny("type", "The signature is not a sign-in"); + if (client.challenge !== b64u(await digest(enc.encode(message)))) deny("challenge", "The signature is for another request"); + const rp = Object.hasOwn(origins, client.origin) ? origins[client.origin] : null; + if (!rp) deny("origin", "The signature was made on another site"); + const data = unb64u(signed.authenticatorData); + if (data.length < 37 || b64u(data.slice(0, 32)) !== b64u(await digest(enc.encode(rp)))) deny("rp", "The passkey belongs to another site"); + if ((data[32] & 0x05) !== 0x05) deny("flags", "The device did not verify its user"); + const algorithm = ALGORITHMS[record.alg] ?? deny("algorithm", "The passkey's algorithm is not ES256 or RS256"); + const key = await crypto.subtle.importKey("spki", unb64u(record.spki), algorithm.key, false, ["verify"]).catch(() => deny("key", "The public key does not parse")); + let signature = unb64u(signed.signature); + if (record.alg === -7) signature = rawSignature(signature); + const body = new Uint8Array([...data, ...(await digest(unb64u(signed.clientDataJSON)))]); + if (!(await crypto.subtle.verify(algorithm.verify, key, signature, body))) deny("signature", "The signature does not verify"); } -// Take in what the other devices shared. A message that does not open or -// resolve is someone else's or stale: it is skipped, never trusted. -async function pull(Prism, held) { - for (const keyId of [...held.keyring.keys()]) { - const topic = await Prism.syncTopic(held, keyId).catch(() => null); - if (!topic) continue; - for (const bytes of await bus(Prism).fetch(topic).catch(() => [])) { - try { - held = await Prism.receiveSync(held, bytes); - } catch (error) { - if (!(error instanceof Prism.PrismIdError) && !(error instanceof DOMException) && !(error instanceof SyntaxError)) throw error; - } - } + +// A key record, accepted only when its name is its key's hash and it is the +// account's first key or bound to it by a key already accepted. +export async function acceptRecord(credential, records, origins, depth = 0) { + const record = records.find((r) => r?.credential === credential); + if (!record || record.spec !== "prism/identity/key/1") deny("record", "The passkey has no record"); + if (b64u(await digest(unb64u(record.spki))) !== record.key) deny("key", "The record's name is not its key's hash"); + if (record.key === record.account) { + if (record.binding) deny("binding", "An account's first key has no binding"); + return record; } - return held; + if (depth >= MAX_CHAIN || !record.binding) deny("binding", "The key is not bound to its account"); + const parent = await acceptRecord(record.binding.credential, records, origins, depth + 1); + if (parent.account !== record.account) deny("binding", "The key is bound by another account"); + await verifySigned(parent, record.binding, `prism/identity/bind/1\n${record.account}\n${record.key}`, origins); + return record; } -// A recovery kit: the paper share of the id's recovery device (stitch's -// threshold recovery, one share of one) and the id's log. It is as secret as -// the id: whoever holds it can take the id over. -const KIT = "prism/recovery-kit/1"; -const ONE_PAPER_SHARE = { threshold: 1, guardians: [{ paper: true }] }; -const kitOf = (held, share) => ({ kind: KIT, prism: held.prism, share, records: [...held.log.values()] }); +// A session: the account's passkey let one browser key act for it, on one +// app's origin, until it expires. Anyone holding the session can check it. +export async function verifySession(session, origins, now = Date.now()) { + const { app, nonce, sessionKey, expires, assertion, records } = session ?? {}; + if (!Number.isSafeInteger(expires) || expires <= now) deny("expired", "The session has expired"); + const record = await acceptRecord(assertion?.credential, records ?? [], origins); + await verifySigned(record, assertion, `prism/identity/session/1\n${app}\n${nonce}\n${sessionKey}\n${expires}`, origins); + return { account: record.account, key: record.key, credential: record.credential, expires }; +} -const json = (value) => new TextEncoder().encode(JSON.stringify(value)); -const parse = (bytes) => JSON.parse(new TextDecoder().decode(bytes)); -const short = (id) => `${id.slice(0, 15)}…${id.slice(-4)}`; -const sentence = (text) => (text ? text[0].toUpperCase() + text.slice(1) + (/[.!?]$/.test(text) ? "" : ".") : text); -const KIND_LABEL = { browser: "Browser", native: "App", mobile: "Phone", embedded: "Device", recovery: "Recovery kit" }; const ACCOUNT_PANEL = `

Sign in

-

One Prism id for every Prism app. No password.

- -