@blamejs/blamejs-shop 0.1.11 → 0.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +2 -0
- package/lib/storefront.js +59 -0
- package/lib/vendor/MANIFEST.json +2 -2
- package/lib/vendor/blamejs/CHANGELOG.md +2 -0
- package/lib/vendor/blamejs/README.md +1 -0
- package/lib/vendor/blamejs/api-snapshot.json +27 -2
- package/lib/vendor/blamejs/index.js +2 -0
- package/lib/vendor/blamejs/lib/privacy-pass.js +267 -0
- package/lib/vendor/blamejs/package.json +1 -1
- package/lib/vendor/blamejs/release-notes/v0.12.52.json +18 -0
- package/lib/vendor/blamejs/test/layer-0-primitives/codebase-patterns.test.js +2 -1
- package/lib/vendor/blamejs/test/layer-0-primitives/privacy-pass.test.js +120 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
|
|
|
8
8
|
|
|
9
9
|
## v0.1.x
|
|
10
10
|
|
|
11
|
+
- v0.1.12 (2026-05-25) — **Card payments now finalize the order — the Stripe webhook is handled end to end.** A confirmed Stripe payment now advances the order from pending to paid. The container now serves the `POST /api/webhooks/stripe` route the edge worker forwards to: it re-verifies the event signature over the exact raw bytes, maps the event to the order's FSM transition, and is idempotent across Stripe's re-deliveries. Previously the edge verified the webhook but nothing consumed it on the container, so a paid PaymentIntent (card, Apple Pay, or Google Pay) left the order stuck in pending — no fulfillment, no paid status. Operators running checkout should upgrade and confirm their Stripe webhook points at `/api/webhooks/stripe`. **Added:** *Raw-body capture for payment webhooks* — A small middleware preserves the exact request bytes for the webhook path before the JSON body-parser runs, so signature verification (which is computed over the raw body) is reliable. It is scoped to the webhook routes and leaves every other request untouched. **Fixed:** *Stripe webhook completes the order* — `POST /api/webhooks/stripe` is now handled on the container: the event signature is re-verified against `STRIPE_WEBHOOK_SECRET` over the raw request body (a tampered or unsigned event is rejected with 400), then `payment_intent.succeeded` / `.canceled` / `charge.refunded` drive the order FSM (`mark_paid` / `cancel` / `refund`). Re-deliveries are idempotent — an event for an order already in the target state is acknowledged with 200 and skipped. A delivery for an unknown PaymentIntent is acknowledged without effect. This closes the gap where a confirmed payment never moved the order out of `pending`.
|
|
12
|
+
|
|
11
13
|
- v0.1.11 (2026-05-25) — **Sign in with Apple.** Customers can now sign in with Apple, alongside passkeys and Google. A “Continue with Apple” button appears on the account login page once the operator wires the Apple credentials; the callback turns the verified Apple identity into a shop session, adopts the guest cart, and claims prior guest orders placed under the same verified email — the same way Google sign-in does. Apple's OAuth client secret is itself an ES256 JWT, which the shop mints from the team's Sign-in-with-Apple key. Sign in with Apple is off until the credentials are set, like every other integration. **Added:** *Sign in with Apple (OIDC)* — `GET /account/login/apple` starts the flow (sealed in-flight state cookie, PKCE, nonce); Apple posts the result back to `POST /account/auth/apple/callback` (response_mode=form_post). The callback verifies the state, exchanges the code, signs the customer in on `(provider=apple, subject)`, adopts the guest cart, and — when Apple reports the email as verified — claims prior guest orders under that email. The display name is captured from Apple's first-authorization `user` field (Apple sends it only once and never in the ID token). The button appears on `/account/login` only when the credentials are configured, and is listed on `/admin/integrations`. · *customers.mintAppleClientSecret* — Mints Apple's required ES256 client-secret JWT from a Services-ID `.p8` key (team id, key id, client id). This is the one signature the protocol forces to be classical ECDSA P-256 rather than the framework's post-quantum default — an external identity provider's wire format, not an application default. The secret is minted at boot with a 150-day life (inside Apple's six-month ceiling) and re-minted on each deploy. **Changed:** *Account login offers Apple when configured* — The login page shows Continue-with-Google and Continue-with-Apple buttons independently, each gated on its own credentials. Set `APPLE_TEAM_ID`, `APPLE_KEY_ID`, `APPLE_CLIENT_ID` (your Services ID), `APPLE_PRIVATE_KEY` (the `.p8` contents), and `SHOP_ORIGIN`, and add `<SHOP_ORIGIN>/account/auth/apple/callback` as a Return URL on the Services ID. Requires an Apple Developer Program membership. See the README “Optional integrations” section.
|
|
12
14
|
|
|
13
15
|
- v0.1.10 (2026-05-25) — **Admin console — a review moderation screen.** Reviews join the admin console, completing the set of management screens. `/admin/reviews` is the moderation queue: filter by status (pending, published, rejected) and act on each submission inline — publish it, reject it with a reason, or take a published one back down. Reviews are short, so the queue shows each one in full (rating, title, body, verified-purchase flag) with its actions, no separate detail page. As with the other screens, every path content-negotiates: a bearer-token client gets the JSON API unchanged, a signed-in browser gets the HTML console. **Added:** *Review moderation screen* — `/admin/reviews` renders the review queue as inline cards (rating stars, title, body, verified-purchase flag, product, date) with status-filter chips, when opened in a signed-in browser; the same path serves the existing JSON list to a bearer-token client. Each card offers the actions that fit its status — a pending review can be published or rejected, a published one taken down, a rejected one published — with Reject taking a reason. Publish and reject post to their endpoints and redirect (PRG); a missing id is a no-op notice, never a 500. **Changed:** *Console nav gains Reviews; the reviews API content-negotiates* — The signed-in admin nav now includes Reviews — shown, like Returns, only when the reviews primitive is wired. The `/admin/reviews` list and the publish / reject endpoints serve the HTML console to a signed-in browser while continuing to serve the JSON API to a bearer-token client unchanged. A request without the bearer token is no longer answered with a 401 on the list path — a browser GET receives the sign-in form — matching the other console screens.
|
package/lib/storefront.js
CHANGED
|
@@ -34,6 +34,34 @@ function _b() {
|
|
|
34
34
|
return bShop.framework;
|
|
35
35
|
}
|
|
36
36
|
|
|
37
|
+
// Payment-webhook signatures (Stripe's HMAC, PayPal's, …) are computed over
|
|
38
|
+
// the EXACT raw request bytes, but the global JSON body-parser reparses and
|
|
39
|
+
// discards them. This middleware buffers the raw body for the given POST
|
|
40
|
+
// paths into `req.rawBody` BEFORE the body-parser runs, and pre-sets
|
|
41
|
+
// `req.body` so the parser short-circuits (its `req.body !== undefined`
|
|
42
|
+
// guard) instead of re-reading an already-drained stream. Mount it ahead of
|
|
43
|
+
// `b.middleware.bodyParser()`; the webhook handlers read `req.rawBody`.
|
|
44
|
+
function webhookRawBodyCapture(paths) {
|
|
45
|
+
var pathSet = {};
|
|
46
|
+
(paths || []).forEach(function (p) { pathSet[p] = true; });
|
|
47
|
+
// Compose the framework's raw body-parser (req.body ← a Buffer of the
|
|
48
|
+
// exact request bytes) instead of hand-reading the stream — it already
|
|
49
|
+
// honours the router's await/next contract and the byte-limit cap.
|
|
50
|
+
// Scoped to the webhook paths and mounted ahead of the global JSON parser:
|
|
51
|
+
// payment webhooks verify the signature over the raw body, which the JSON
|
|
52
|
+
// parser would reparse + discard. The JSON parser then skips these paths
|
|
53
|
+
// via its own `req.body !== undefined` guard.
|
|
54
|
+
var rawParser = _b().middleware.bodyParser.raw({
|
|
55
|
+
limit: _b().constants.BYTES.mib(1),
|
|
56
|
+
contentTypes: ["application/json", "application/*"],
|
|
57
|
+
});
|
|
58
|
+
return function (req, res, next) {
|
|
59
|
+
var path = String(req.url || "").split("?")[0];
|
|
60
|
+
if ((req.method || "").toUpperCase() !== "POST" || !pathSet[path]) return next();
|
|
61
|
+
return rawParser(req, res, next);
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
|
|
37
65
|
// Re-use the strict renderer from the email primitive (same shape,
|
|
38
66
|
// same XSS guard, same unknown / unused refusal).
|
|
39
67
|
var _render = emailModule._render;
|
|
@@ -2898,6 +2926,36 @@ function mount(router, deps) {
|
|
|
2898
2926
|
theme: theme,
|
|
2899
2927
|
}));
|
|
2900
2928
|
});
|
|
2929
|
+
|
|
2930
|
+
// Stripe webhook — the order-completion path. A PaymentIntent succeeds
|
|
2931
|
+
// asynchronously (the customer may close the tab before Stripe fires),
|
|
2932
|
+
// so the order's pending→paid transition lands here, not on the return
|
|
2933
|
+
// page. The body is verified over the RAW bytes (captured upstream by
|
|
2934
|
+
// webhookRawBodyCapture into req.rawBody); handleStripeEvent re-verifies
|
|
2935
|
+
// the signature, maps the event to an FSM transition, and dedupes
|
|
2936
|
+
// Stripe's re-deliveries. A bad signature is 400; a handler error is
|
|
2937
|
+
// 500 so Stripe retries; otherwise 200.
|
|
2938
|
+
router.post("/api/webhooks/stripe", async function (req, res) {
|
|
2939
|
+
// webhookRawBodyCapture set req.body to the exact bytes as a Buffer.
|
|
2940
|
+
var raw = Buffer.isBuffer(req.body) ? req.body.toString("utf8")
|
|
2941
|
+
: (typeof req.body === "string" ? req.body : "");
|
|
2942
|
+
try {
|
|
2943
|
+
var result = await deps.checkout.handleStripeEvent({ headers: req.headers || {}, rawBody: raw });
|
|
2944
|
+
res.status(200);
|
|
2945
|
+
res.setHeader && res.setHeader("content-type", "application/json; charset=utf-8");
|
|
2946
|
+
var payload = JSON.stringify({ ok: true, handled: !!(result && result.handled) });
|
|
2947
|
+
return res.end ? res.end(payload) : res.send(payload);
|
|
2948
|
+
} catch (e) {
|
|
2949
|
+
if (e && e.code === "WEBHOOK_INVALID") {
|
|
2950
|
+
res.status(400);
|
|
2951
|
+
return res.end ? res.end("invalid signature") : res.send("");
|
|
2952
|
+
}
|
|
2953
|
+
// A real failure (e.g. an illegal FSM transition) — 500 so Stripe
|
|
2954
|
+
// retries the delivery rather than marking it permanently failed.
|
|
2955
|
+
res.status(500);
|
|
2956
|
+
return res.end ? res.end("handler error") : res.send("");
|
|
2957
|
+
}
|
|
2958
|
+
});
|
|
2901
2959
|
}
|
|
2902
2960
|
|
|
2903
2961
|
// ---- customer accounts (passkey-only) ------------------------------
|
|
@@ -4180,6 +4238,7 @@ function mount(router, deps) {
|
|
|
4180
4238
|
|
|
4181
4239
|
module.exports = {
|
|
4182
4240
|
mount: mount,
|
|
4241
|
+
webhookRawBodyCapture: webhookRawBodyCapture,
|
|
4183
4242
|
renderHome: renderHome,
|
|
4184
4243
|
renderSearch: renderSearch,
|
|
4185
4244
|
renderProduct: renderProduct,
|
package/lib/vendor/MANIFEST.json
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
"_about": "blamejs.shop vendors a single framework — blamejs — which itself bundles every server-side crypto/identity dependency. The transitive packages blamejs ships are surfaced in its own MANIFEST.json at lib/vendor/blamejs/lib/vendor/MANIFEST.json — Trivy / Grype rely on that nested data for CVE attribution.",
|
|
4
4
|
"packages": {
|
|
5
5
|
"blamejs": {
|
|
6
|
-
"version": "0.12.
|
|
7
|
-
"tag": "v0.12.
|
|
6
|
+
"version": "0.12.52",
|
|
7
|
+
"tag": "v0.12.52",
|
|
8
8
|
"license": "Apache-2.0",
|
|
9
9
|
"author": "blamejs contributors",
|
|
10
10
|
"source": "https://github.com/blamejs/blamejs",
|
|
@@ -8,6 +8,8 @@ upgrading across more than a few patches at a time.
|
|
|
8
8
|
|
|
9
9
|
## v0.12.x
|
|
10
10
|
|
|
11
|
+
- v0.12.52 (2026-05-25) — **`b.privacyPass` — Privacy Pass origin-side token verification (RFC 9577 / 9578).** Anonymous, publicly verifiable authorization: an origin issues a WWW-Authenticate: PrivateToken challenge and verifies a presented token cryptographically, without learning who the client is and without a callback to the issuer. b.privacyPass implements the publicly verifiable token type 0x0002 (Blind RSA, 2048-bit): the token's authenticator is an RSA Blind Signature (RFC 9474) checked as RSASSA-PSS (SHA-384, 48-byte salt) over token_input = token_type ‖ nonce ‖ challenge_digest ‖ token_key_id, using only the issuer's public key. The token is bound to that key (token_key_id) and, optionally, to the challenge it answers, so a token minted for another origin is refused. Blind RSA is the algorithm Privacy Pass defines on the wire — like the DNSSEC / DANE verifiers it validates an external protocol's signatures rather than introducing classical crypto as a framework default. Verified against the RFC 9578 §8.2 test vector. **Added:** *`b.privacyPass.verifyToken(opts)` / `parseToken` / `buildChallenge`* — `buildChallenge` builds a TokenChallenge (RFC 9577 §2.1) and the matching `WWW-Authenticate: PrivateToken challenge=…, token-key=…` header an origin returns to request a token, scoped to an issuer (and optionally an origin and a 32-byte redemption context). `parseToken` splits a token into its fields (type / nonce / challenge_digest / token_key_id / authenticator). `verifyToken` verifies a type 0x0002 (Blind RSA) token: it confirms the token's `token_key_id` is the SHA-256 of the supplied issuer public key, optionally that its `challenge_digest` matches `opts.challenge`, and that the authenticator is a valid RSASSA-PSS signature over the token input. Refuses unknown / privately verifiable token types (the VOPRF type 0x0001 needs the issuer secret and is an issuer-side operation), key-id and challenge mismatches, and tampered authenticators. Marked experimental while the issuance protocols see deployment.
|
|
12
|
+
|
|
11
13
|
- v0.12.51 (2026-05-25) — **`b.network.dns.dane.matchCertificate` — DANE / TLSA certificate matching (RFC 6698 / 7671).** Pin a service's certificate through DNS instead of a public CA. matchCertificate checks a server certificate against a set of TLSA records: the selected data — the full certificate (selector 0) or its subjectPublicKeyInfo (selector 1) — is hashed per the matching type (exact / SHA-256 / SHA-512) and compared in constant time to the record's association data. For a DANE-EE (usage 3) record a match is self-authenticating — the TLSA pins the key, so no public-CA path is needed (the common SMTP-DANE case, RFC 7672); for the PKIX usages a match is reported as necessary-but-not-sufficient so the caller still runs PKIX. This is the payoff of the DNSSEC verifier: verify the TLSA RRset with b.network.dns.dnssec, then match the certificate. Verified against a live DNSSEC-signed TLSA record and the matching server certificate. **Added:** *`b.network.dns.dane.matchCertificate(opts)`* — Matches a leaf certificate (and optional `chain`) against a TLSA RRset (`{ usage, selector, matchingType, data }`). Selector 0 hashes the full certificate DER, selector 1 the subjectPublicKeyInfo; matching type 0 is an exact comparison, 1 SHA-256, 2 SHA-512 (SHA-1 and any other type are refused, not guessed). End-entity usages (PKIX-EE 1, DANE-EE 3) match the leaf; trust-anchor usages (PKIX-TA 0, DANE-TA 2) match the leaf or any supplied chain certificate. Returns `{ ok, matched, daneAuthenticated, trustAnchorMatch, pkixRequired, matchedCertIndex }` — `daneAuthenticated` is true only for a DANE-EE match (the key is pinned, no CA needed); `pkixRequired` flags the PKIX usages. Throws `dane/no-match` when nothing matches, and refuses unknown usage / selector / matching values and unparseable certificates. Verify the TLSA RRset with `b.network.dns.dnssec` first — an unauthenticated TLSA record proves nothing.
|
|
12
14
|
|
|
13
15
|
- v0.12.50 (2026-05-25) — **`b.network.dns.dnssec.verifyChain` — validate a DNSSEC delegation chain to a pinned root anchor.** Completes local DNSSEC verification: validate a full delegation chain from the root down to a zone against a pinned trust anchor (RFC 4035 §5), instead of trusting any single resolver. For each link, the zone's DNSKEY RRset must be self-signed by one of its keys, and that key must be vouched for either by a pinned anchor (at the root) or by a DS record served + signed by the already-trusted parent — so trust flows root → TLD → zone with no gap. The IANA root KSKs (KSK-2017 tag 20326, KSK-2024 tag 38696) ship as the default anchors; override with opts.trustAnchors for a private root. verifyChain returns the leaf zone's trusted DNSKEY set, which you then hand to verifyRrset / verifyDenial for the actual answer. Composes verifyRrset + verifyDs + the key tag; verified end-to-end against a live root→org chain. **Added:** *`b.network.dns.dnssec.verifyChain(opts)`* — Walks an ordered, root-first list of `links` ({ zone, dnskeys, dnskeyRrsig, dsRdatas?, dsRrsig? }). At each link it verifies the DNSKEY RRset's self-signature (composing `verifyRrset`), then establishes trust in the signing key: at the root by matching a pinned anchor's DS digest (`verifyDs`), at every delegation by verifying the parent-served DS RRset's signature with the already-trusted parent key and confirming the signing KSK matches one of those DS records. Returns `{ ok, zone, keys, path }` with the leaf zone's trusted DNSKEY set. Refuses a root key that matches no anchor (`dnssec/chain-anchor-mismatch`), a KSK that matches no parent DS (`dnssec/chain-ds-mismatch`), and a missing parent key (`dnssec/chain-no-parent-key`). The default `DEFAULT_ROOT_ANCHORS` are the published IANA root KSK DS records; `opts.trustAnchors` overrides them for a private or test root.
|
|
@@ -89,6 +89,7 @@ The framework bundles the surface a typical Node app reaches for. Every primitiv
|
|
|
89
89
|
- **Financial / Open Banking** — FAPI 2.0 Final composite posture (PAR + PKCE-S256 + DPoP-or-mTLS + RFC 9207); runtime enforcement helpers `b.fapi2.assertCallback` (refuses missing iss + bare-param under message-signing) and `b.fapi2.assertAuthzRequest` (refuses non-JAR); CFPB §1033 / FDX 6.0 consumer-financial-data-sharing wrapper (`b.fdx`)
|
|
90
90
|
- **Data-subject coordination** — cross-table export / rectify / erase / restrict / objection (`b.subject`, `b.subject.eraseHard`); subject-level legal-hold registry consulted by erase + retention paths (FRCP Rule 26/37(e), GDPR Art 17(3)(e), SEC Rule 17a-4, HIPAA §164.530(j)(2)) (`b.legalHold`)
|
|
91
91
|
- **Account safety** — adaptive bot-challenge staircase (`b.authBotChallenge`); session-to-device-posture binding with fail-closed verify (`b.sessionDeviceBinding`)
|
|
92
|
+
- **Anonymous authorization** — Privacy Pass origin side (RFC 9577/9578 — `b.privacyPass`): issue a `WWW-Authenticate: PrivateToken` challenge and verify a presented Blind-RSA (type 0x0002) token against the issuer public key, with no issuer callback and no client identity
|
|
92
93
|
### Crypto
|
|
93
94
|
|
|
94
95
|
- **At-rest envelope** — envelope-versioned PQC (ML-KEM-1024 + P-384 hybrid, XChaCha20-Poly1305, SHAKE256); vault sealing (`b.crypto`, `b.vault`)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 1,
|
|
3
|
-
"frameworkVersion": "0.12.
|
|
4
|
-
"createdAt": "2026-05-
|
|
3
|
+
"frameworkVersion": "0.12.52",
|
|
4
|
+
"createdAt": "2026-05-25T16:02:59.536Z",
|
|
5
5
|
"exports": {
|
|
6
6
|
"a2a": {
|
|
7
7
|
"type": "object",
|
|
@@ -44979,6 +44979,31 @@
|
|
|
44979
44979
|
}
|
|
44980
44980
|
}
|
|
44981
44981
|
},
|
|
44982
|
+
"privacyPass": {
|
|
44983
|
+
"type": "object",
|
|
44984
|
+
"members": {
|
|
44985
|
+
"PrivacyPassError": {
|
|
44986
|
+
"type": "function",
|
|
44987
|
+
"arity": 4
|
|
44988
|
+
},
|
|
44989
|
+
"TOKEN_TYPE_BLIND_RSA": {
|
|
44990
|
+
"type": "primitive",
|
|
44991
|
+
"valueType": "number"
|
|
44992
|
+
},
|
|
44993
|
+
"buildChallenge": {
|
|
44994
|
+
"type": "function",
|
|
44995
|
+
"arity": 1
|
|
44996
|
+
},
|
|
44997
|
+
"parseToken": {
|
|
44998
|
+
"type": "function",
|
|
44999
|
+
"arity": 1
|
|
45000
|
+
},
|
|
45001
|
+
"verifyToken": {
|
|
45002
|
+
"type": "function",
|
|
45003
|
+
"arity": 1
|
|
45004
|
+
}
|
|
45005
|
+
}
|
|
45006
|
+
},
|
|
44982
45007
|
"problemDetails": {
|
|
44983
45008
|
"type": "object",
|
|
44984
45009
|
"members": {
|
|
@@ -394,6 +394,7 @@ var webPush = require("./lib/web-push-vapid");
|
|
|
394
394
|
var fedcm = require("./lib/fedcm");
|
|
395
395
|
var dbsc = require("./lib/dbsc");
|
|
396
396
|
var importmapIntegrity = require("./lib/importmap-integrity");
|
|
397
|
+
var privacyPass = require("./lib/privacy-pass");
|
|
397
398
|
var standardWebhooks = require("./lib/standard-webhooks");
|
|
398
399
|
var lro = require("./lib/lro");
|
|
399
400
|
var jsonApi = require("./lib/jsonapi");
|
|
@@ -409,6 +410,7 @@ module.exports = {
|
|
|
409
410
|
fedcm: fedcm,
|
|
410
411
|
dbsc: dbsc,
|
|
411
412
|
importmapIntegrity: importmapIntegrity,
|
|
413
|
+
privacyPass: privacyPass,
|
|
412
414
|
standardWebhooks: standardWebhooks,
|
|
413
415
|
lro: lro,
|
|
414
416
|
jsonApi: jsonApi,
|
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @module b.privacyPass
|
|
4
|
+
* @nav Identity
|
|
5
|
+
* @title Privacy Pass
|
|
6
|
+
*
|
|
7
|
+
* @intro
|
|
8
|
+
* Origin / relying-party side of Privacy Pass (RFC 9577 HTTP
|
|
9
|
+
* authentication scheme, RFC 9578 issuance protocols) — issue a token
|
|
10
|
+
* challenge and verify a presented token without learning who the
|
|
11
|
+
* client is. An origin asks for a token with a
|
|
12
|
+
* <code>WWW-Authenticate: PrivateToken</code> challenge; the client
|
|
13
|
+
* obtains a token from an issuer and presents it; the origin verifies
|
|
14
|
+
* it cryptographically.
|
|
15
|
+
*
|
|
16
|
+
* This implements the publicly verifiable token type
|
|
17
|
+
* <strong>0x0002 (Blind RSA, 2048-bit)</strong>: the token's
|
|
18
|
+
* authenticator is an RSA Blind Signature (RFC 9474) that any party
|
|
19
|
+
* holding the issuer's public key can verify with RSASSA-PSS — so the
|
|
20
|
+
* origin verifies tokens itself, with no issuer secret and no callback.
|
|
21
|
+
* The privately verifiable VOPRF type (0x0001) requires the issuer's
|
|
22
|
+
* secret key and is an issuer-side operation, not implemented here.
|
|
23
|
+
*
|
|
24
|
+
* Blind RSA is the algorithm Privacy Pass defines on the wire; like
|
|
25
|
+
* the framework's DNSSEC / DANE verifiers it validates an external
|
|
26
|
+
* protocol's signatures (RSASSA-PSS, SHA-384) rather than introducing
|
|
27
|
+
* classical crypto as a framework default.
|
|
28
|
+
*
|
|
29
|
+
* @card
|
|
30
|
+
* Privacy Pass origin side (RFC 9577 / 9578). Issue a
|
|
31
|
+
* <code>WWW-Authenticate: PrivateToken</code> challenge and verify a
|
|
32
|
+
* presented Blind-RSA (type 0x0002) token against the issuer public
|
|
33
|
+
* key — anonymous, publicly verifiable authorization with no issuer
|
|
34
|
+
* callback.
|
|
35
|
+
*/
|
|
36
|
+
|
|
37
|
+
var nodeCrypto = require("node:crypto");
|
|
38
|
+
var bCrypto = require("./crypto");
|
|
39
|
+
var validateOpts = require("./validate-opts");
|
|
40
|
+
var { defineClass } = require("./framework-error");
|
|
41
|
+
|
|
42
|
+
var PrivacyPassError = defineClass("PrivacyPassError", { alwaysPermanent: true });
|
|
43
|
+
|
|
44
|
+
var TOKEN_TYPE_BLIND_RSA = 0x0002;
|
|
45
|
+
// RFC 9578 §5.3 token type 0x0002: RSABSSA-SHA384-PSS, salt length 48.
|
|
46
|
+
var PSS_HASH = "sha384";
|
|
47
|
+
var PSS_SALT_LEN = 48; // allow:raw-byte-literal — RFC 9578 §5.3 PSS salt length (= SHA-384 digest size)
|
|
48
|
+
// Fixed-size token fields (RFC 9577 §2.2): type(2) nonce(32)
|
|
49
|
+
// challenge_digest(32) token_key_id(32), then the authenticator.
|
|
50
|
+
var TOKEN_PREFIX_LEN = 98; // allow:raw-byte-literal — 2 + 32 + 32 + 32 (token_input length)
|
|
51
|
+
|
|
52
|
+
// RFC 9577 §2.1 sends the challenge / token-key auth-params as base64url
|
|
53
|
+
// WITH padding; Node's "base64url" output is unpadded, so pad to a
|
|
54
|
+
// multiple of 4 so strict clients / proxies accept the header.
|
|
55
|
+
function _b64urlPadded(buf) {
|
|
56
|
+
var s = Buffer.from(buf).toString("base64url");
|
|
57
|
+
while (s.length % 4 !== 0) s += "="; // allow:raw-byte-literal — base64 quantum is 4 chars
|
|
58
|
+
return s;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function _bytes(x, what) {
|
|
62
|
+
if (Buffer.isBuffer(x)) return x;
|
|
63
|
+
if (x instanceof Uint8Array) return Buffer.from(x);
|
|
64
|
+
if (typeof x === "string") return Buffer.from(x, "base64");
|
|
65
|
+
throw new PrivacyPassError("privacy-pass/bad-bytes", "privacyPass: " + what + " must be a Buffer / Uint8Array / base64 string");
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// Import the issuer public key and capture the SubjectPublicKeyInfo
|
|
69
|
+
// bytes used to derive token_key_id. When the caller supplies the
|
|
70
|
+
// published SPKI DER directly, hash THOSE bytes — re-exporting an
|
|
71
|
+
// rsa-pss KeyObject can re-encode the AlgorithmIdentifier and change the
|
|
72
|
+
// digest. token_key_id is SHA-256 of the issuer's distributed key
|
|
73
|
+
// (RFC 9577 §2.2), which is the SPKI as published.
|
|
74
|
+
function _importIssuerKey(k) {
|
|
75
|
+
if (k && typeof k === "object" && typeof k.export === "function" && k.type === "public") {
|
|
76
|
+
return { key: k, spki: k.export({ format: "der", type: "spki" }) };
|
|
77
|
+
}
|
|
78
|
+
try {
|
|
79
|
+
if (Buffer.isBuffer(k) || k instanceof Uint8Array) {
|
|
80
|
+
var der = Buffer.from(k);
|
|
81
|
+
return { key: nodeCrypto.createPublicKey({ key: der, format: "der", type: "spki" }), spki: der };
|
|
82
|
+
}
|
|
83
|
+
// A "PUBLIC KEY" PEM body IS the SubjectPublicKeyInfo DER — decode it
|
|
84
|
+
// directly so token_key_id is SHA-256 of the issuer's exact bytes,
|
|
85
|
+
// not a re-encoding (Node can re-emit rsa-pss AlgorithmIdentifier
|
|
86
|
+
// parameters differently on export).
|
|
87
|
+
if (typeof k === "string" && /-----BEGIN PUBLIC KEY-----/.test(k)) {
|
|
88
|
+
var body = k.replace(/-----BEGIN PUBLIC KEY-----/, "").replace(/-----END PUBLIC KEY-----/, "").replace(/\s+/g, "");
|
|
89
|
+
var pemDer = Buffer.from(body, "base64");
|
|
90
|
+
return { key: nodeCrypto.createPublicKey(k), spki: pemDer };
|
|
91
|
+
}
|
|
92
|
+
var key = nodeCrypto.createPublicKey(k); // other key spec (best-effort SPKI export)
|
|
93
|
+
return { key: key, spki: key.export({ format: "der", type: "spki" }) };
|
|
94
|
+
} catch (e) {
|
|
95
|
+
throw new PrivacyPassError("privacy-pass/bad-key", "privacyPass: could not import issuerPublicKey: " + ((e && e.message) || e));
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* @primitive b.privacyPass.parseToken
|
|
101
|
+
* @signature b.privacyPass.parseToken(token)
|
|
102
|
+
* @since 0.12.52
|
|
103
|
+
* @status experimental
|
|
104
|
+
* @related b.privacyPass.verifyToken, b.privacyPass.buildChallenge
|
|
105
|
+
*
|
|
106
|
+
* Parse a Privacy Pass token (RFC 9577 §2.2) into its fields: the
|
|
107
|
+
* <code>tokenType</code>, the client <code>nonce</code>, the
|
|
108
|
+
* <code>challengeDigest</code> (SHA-256 of the TokenChallenge the token
|
|
109
|
+
* answers), the <code>tokenKeyId</code> (SHA-256 of the issuer public
|
|
110
|
+
* key), and the <code>authenticator</code>. Structural only — call
|
|
111
|
+
* <code>verifyToken</code> to check the signature.
|
|
112
|
+
*
|
|
113
|
+
* @example
|
|
114
|
+
* var t = b.privacyPass.parseToken(tokenBytes);
|
|
115
|
+
* // → { tokenType: 2, nonce, challengeDigest, tokenKeyId, authenticator }
|
|
116
|
+
*/
|
|
117
|
+
function parseToken(token) {
|
|
118
|
+
var b = _bytes(token, "token");
|
|
119
|
+
if (b.length < TOKEN_PREFIX_LEN + 1) throw new PrivacyPassError("privacy-pass/bad-token", "privacyPass.parseToken: token too short");
|
|
120
|
+
return {
|
|
121
|
+
tokenType: b.readUInt16BE(0),
|
|
122
|
+
nonce: b.slice(2, 34),
|
|
123
|
+
challengeDigest: b.slice(34, 66),
|
|
124
|
+
tokenKeyId: b.slice(66, 98),
|
|
125
|
+
authenticator: b.slice(98),
|
|
126
|
+
tokenInput: b.slice(0, TOKEN_PREFIX_LEN),
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* @primitive b.privacyPass.verifyToken
|
|
132
|
+
* @signature b.privacyPass.verifyToken(opts)
|
|
133
|
+
* @since 0.12.52
|
|
134
|
+
* @status experimental
|
|
135
|
+
* @compliance soc2
|
|
136
|
+
* @related b.privacyPass.buildChallenge, b.privacyPass.parseToken
|
|
137
|
+
*
|
|
138
|
+
* Verify a publicly verifiable Privacy Pass token (type 0x0002, Blind
|
|
139
|
+
* RSA — RFC 9578 §8.2). The authenticator is checked as an RSASSA-PSS
|
|
140
|
+
* (SHA-384, MGF1-SHA-384, 48-byte salt) signature over
|
|
141
|
+
* <code>token_input = token_type ‖ nonce ‖ challenge_digest ‖
|
|
142
|
+
* token_key_id</code> using the issuer's public key. The token is bound
|
|
143
|
+
* to that key — its <code>token_key_id</code> must equal the SHA-256 of
|
|
144
|
+
* the supplied key's SubjectPublicKeyInfo — and, when
|
|
145
|
+
* <code>opts.challenge</code> is given, to that challenge (its SHA-256
|
|
146
|
+
* must equal the token's <code>challenge_digest</code>), so a token
|
|
147
|
+
* minted for a different origin's challenge is refused.
|
|
148
|
+
*
|
|
149
|
+
* @opts
|
|
150
|
+
* {
|
|
151
|
+
* token: Buffer|base64, // the presented token
|
|
152
|
+
* issuerPublicKey: KeyObject|Buffer(SPKI DER)|PEM,
|
|
153
|
+
* challenge?: Buffer|base64, // the TokenChallenge this token must answer
|
|
154
|
+
* }
|
|
155
|
+
*
|
|
156
|
+
* @example
|
|
157
|
+
* var r = b.privacyPass.verifyToken({ token: tok, issuerPublicKey: issuerSpki });
|
|
158
|
+
* // → { ok: true, tokenType: 2, nonce, challengeDigest, tokenKeyId }
|
|
159
|
+
*/
|
|
160
|
+
function verifyToken(opts) {
|
|
161
|
+
validateOpts.requireObject(opts, "privacyPass.verifyToken", PrivacyPassError);
|
|
162
|
+
validateOpts(opts, ["token", "issuerPublicKey", "challenge"], "privacyPass.verifyToken");
|
|
163
|
+
if (opts.issuerPublicKey === undefined || opts.issuerPublicKey === null) throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.verifyToken: opts.issuerPublicKey is required");
|
|
164
|
+
|
|
165
|
+
var parsed = parseToken(opts.token);
|
|
166
|
+
if (parsed.tokenType !== TOKEN_TYPE_BLIND_RSA) {
|
|
167
|
+
throw new PrivacyPassError("privacy-pass/unsupported-token-type", "privacyPass.verifyToken: only token type 0x0002 (Blind RSA) is verifiable by the origin; got 0x" + parsed.tokenType.toString(16).padStart(4, "0")); // allow:raw-byte-literal — base-16 radix + 4-hex-digit pad, not a size
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
var imported = _importIssuerKey(opts.issuerPublicKey);
|
|
171
|
+
var key = imported.key;
|
|
172
|
+
if (key.asymmetricKeyType !== "rsa" && key.asymmetricKeyType !== "rsa-pss") {
|
|
173
|
+
throw new PrivacyPassError("privacy-pass/bad-key", "privacyPass.verifyToken: issuerPublicKey must be an RSA key for token type 0x0002");
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// Bind the token to the issuer key: token_key_id = SHA-256(SPKI).
|
|
177
|
+
var keyId = nodeCrypto.createHash("sha256").update(imported.spki).digest();
|
|
178
|
+
if (!bCrypto.timingSafeEqual(keyId, parsed.tokenKeyId)) {
|
|
179
|
+
throw new PrivacyPassError("privacy-pass/key-id-mismatch", "privacyPass.verifyToken: token_key_id does not match the issuer public key");
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
// Bind the token to the challenge, when supplied.
|
|
183
|
+
if (opts.challenge !== undefined && opts.challenge !== null) {
|
|
184
|
+
var cd = nodeCrypto.createHash("sha256").update(_bytes(opts.challenge, "challenge")).digest();
|
|
185
|
+
if (!bCrypto.timingSafeEqual(cd, parsed.challengeDigest)) {
|
|
186
|
+
throw new PrivacyPassError("privacy-pass/challenge-mismatch", "privacyPass.verifyToken: challenge_digest does not match opts.challenge");
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
var ok;
|
|
191
|
+
try {
|
|
192
|
+
ok = nodeCrypto.verify(PSS_HASH, parsed.tokenInput, { key: key, padding: nodeCrypto.constants.RSA_PKCS1_PSS_PADDING, saltLength: PSS_SALT_LEN }, parsed.authenticator);
|
|
193
|
+
} catch (e) {
|
|
194
|
+
throw new PrivacyPassError("privacy-pass/verify-threw", "privacyPass.verifyToken: signature verification threw: " + ((e && e.message) || e));
|
|
195
|
+
}
|
|
196
|
+
if (!ok) throw new PrivacyPassError("privacy-pass/bad-authenticator", "privacyPass.verifyToken: token authenticator did not verify");
|
|
197
|
+
return { ok: true, tokenType: parsed.tokenType, nonce: parsed.nonce, challengeDigest: parsed.challengeDigest, tokenKeyId: parsed.tokenKeyId };
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* @primitive b.privacyPass.buildChallenge
|
|
202
|
+
* @signature b.privacyPass.buildChallenge(opts)
|
|
203
|
+
* @since 0.12.52
|
|
204
|
+
* @status experimental
|
|
205
|
+
* @related b.privacyPass.verifyToken
|
|
206
|
+
*
|
|
207
|
+
* Build a TokenChallenge (RFC 9577 §2.1) and the matching
|
|
208
|
+
* <code>WWW-Authenticate: PrivateToken</code> header value an origin
|
|
209
|
+
* returns to ask a client for a token. The challenge binds the token to
|
|
210
|
+
* this issuer (and optionally this origin and a redemption context);
|
|
211
|
+
* its SHA-256 is the <code>challenge_digest</code> that
|
|
212
|
+
* <code>verifyToken</code> checks.
|
|
213
|
+
*
|
|
214
|
+
* @opts
|
|
215
|
+
* {
|
|
216
|
+
* issuerName: string, // the token issuer's name
|
|
217
|
+
* tokenType?: number, // default 0x0002 (Blind RSA)
|
|
218
|
+
* originInfo?: string, // origin name(s) the token is scoped to (default: any)
|
|
219
|
+
* redemptionContext?: Buffer, // 0 or 32 bytes (default: empty)
|
|
220
|
+
* tokenKey?: Buffer|KeyObject, // issuer SPKI, included as token-key= when given
|
|
221
|
+
* }
|
|
222
|
+
*
|
|
223
|
+
* @example
|
|
224
|
+
* var c = b.privacyPass.buildChallenge({ issuerName: "issuer.example", originInfo: "origin.example" });
|
|
225
|
+
* res.setHeader("WWW-Authenticate", c.wwwAuthenticate);
|
|
226
|
+
*/
|
|
227
|
+
function buildChallenge(opts) {
|
|
228
|
+
validateOpts.requireObject(opts, "privacyPass.buildChallenge", PrivacyPassError);
|
|
229
|
+
validateOpts(opts, ["issuerName", "tokenType", "originInfo", "redemptionContext", "tokenKey"], "privacyPass.buildChallenge");
|
|
230
|
+
if (typeof opts.issuerName !== "string" || opts.issuerName === "") throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: opts.issuerName is required");
|
|
231
|
+
var tokenType = opts.tokenType === undefined ? TOKEN_TYPE_BLIND_RSA : opts.tokenType;
|
|
232
|
+
if (typeof tokenType !== "number" || !Number.isInteger(tokenType) || tokenType < 0 || tokenType > 0xffff) throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: tokenType must be a uint16");
|
|
233
|
+
|
|
234
|
+
var issuer = Buffer.from(opts.issuerName, "utf8");
|
|
235
|
+
if (issuer.length > 0xffff) throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: issuerName too long");
|
|
236
|
+
var origin = Buffer.alloc(0);
|
|
237
|
+
if (opts.originInfo !== undefined && opts.originInfo !== null) {
|
|
238
|
+
if (typeof opts.originInfo !== "string") throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: originInfo must be a string");
|
|
239
|
+
origin = Buffer.from(opts.originInfo, "utf8");
|
|
240
|
+
if (origin.length > 0xffff) throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: originInfo too long");
|
|
241
|
+
}
|
|
242
|
+
var rc = opts.redemptionContext !== undefined && opts.redemptionContext !== null ? _bytes(opts.redemptionContext, "redemptionContext") : Buffer.alloc(0);
|
|
243
|
+
if (rc.length !== 0 && rc.length !== 32) throw new PrivacyPassError("privacy-pass/bad-arg", "privacyPass.buildChallenge: redemptionContext must be empty or 32 bytes"); // allow:raw-byte-literal — RFC 9577 redemption_context is 0 or 32 bytes
|
|
244
|
+
|
|
245
|
+
var u16 = function (n) { return Buffer.from([(n >> 8) & 0xff, n & 0xff]); };
|
|
246
|
+
var challenge = Buffer.concat([
|
|
247
|
+
u16(tokenType),
|
|
248
|
+
u16(issuer.length), issuer,
|
|
249
|
+
Buffer.from([rc.length]), rc,
|
|
250
|
+
u16(origin.length), origin,
|
|
251
|
+
]);
|
|
252
|
+
|
|
253
|
+
var parts = ['PrivateToken challenge="' + _b64urlPadded(challenge) + '"'];
|
|
254
|
+
if (opts.tokenKey !== undefined && opts.tokenKey !== null) {
|
|
255
|
+
var spki = (opts.tokenKey && typeof opts.tokenKey.export === "function") ? opts.tokenKey.export({ format: "der", type: "spki" }) : _bytes(opts.tokenKey, "tokenKey");
|
|
256
|
+
parts.push('token-key="' + _b64urlPadded(spki) + '"');
|
|
257
|
+
}
|
|
258
|
+
return { challenge: challenge, wwwAuthenticate: parts.join(", ") };
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
module.exports = {
|
|
262
|
+
parseToken: parseToken,
|
|
263
|
+
verifyToken: verifyToken,
|
|
264
|
+
buildChallenge: buildChallenge,
|
|
265
|
+
TOKEN_TYPE_BLIND_RSA: TOKEN_TYPE_BLIND_RSA,
|
|
266
|
+
PrivacyPassError: PrivacyPassError,
|
|
267
|
+
};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "../scripts/release-notes-schema.json",
|
|
3
|
+
"version": "0.12.52",
|
|
4
|
+
"date": "2026-05-25",
|
|
5
|
+
"headline": "`b.privacyPass` — Privacy Pass origin-side token verification (RFC 9577 / 9578)",
|
|
6
|
+
"summary": "Anonymous, publicly verifiable authorization: an origin issues a WWW-Authenticate: PrivateToken challenge and verifies a presented token cryptographically, without learning who the client is and without a callback to the issuer. b.privacyPass implements the publicly verifiable token type 0x0002 (Blind RSA, 2048-bit): the token's authenticator is an RSA Blind Signature (RFC 9474) checked as RSASSA-PSS (SHA-384, 48-byte salt) over token_input = token_type ‖ nonce ‖ challenge_digest ‖ token_key_id, using only the issuer's public key. The token is bound to that key (token_key_id) and, optionally, to the challenge it answers, so a token minted for another origin is refused. Blind RSA is the algorithm Privacy Pass defines on the wire — like the DNSSEC / DANE verifiers it validates an external protocol's signatures rather than introducing classical crypto as a framework default. Verified against the RFC 9578 §8.2 test vector.",
|
|
7
|
+
"sections": [
|
|
8
|
+
{
|
|
9
|
+
"heading": "Added",
|
|
10
|
+
"items": [
|
|
11
|
+
{
|
|
12
|
+
"title": "`b.privacyPass.verifyToken(opts)` / `parseToken` / `buildChallenge`",
|
|
13
|
+
"body": "`buildChallenge` builds a TokenChallenge (RFC 9577 §2.1) and the matching `WWW-Authenticate: PrivateToken challenge=…, token-key=…` header an origin returns to request a token, scoped to an issuer (and optionally an origin and a 32-byte redemption context). `parseToken` splits a token into its fields (type / nonce / challenge_digest / token_key_id / authenticator). `verifyToken` verifies a type 0x0002 (Blind RSA) token: it confirms the token's `token_key_id` is the SHA-256 of the supplied issuer public key, optionally that its `challenge_digest` matches `opts.challenge`, and that the authenticator is a valid RSASSA-PSS signature over the token input. Refuses unknown / privately verifiable token types (the VOPRF type 0x0001 needs the issuer secret and is an issuer-side operation), key-id and challenge mismatches, and tampered authenticators. Marked experimental while the issuance protocols see deployment."
|
|
14
|
+
}
|
|
15
|
+
]
|
|
16
|
+
}
|
|
17
|
+
]
|
|
18
|
+
}
|
|
@@ -2271,9 +2271,10 @@ async function testNoDuplicateCodeBlocks() {
|
|
|
2271
2271
|
"lib/mdoc.js:_bytes",
|
|
2272
2272
|
"lib/network-dnssec.js:_bytes",
|
|
2273
2273
|
"lib/network-dane.js:_bytes",
|
|
2274
|
+
"lib/privacy-pass.js:_bytes",
|
|
2274
2275
|
"lib/tsa.js:_bytes",
|
|
2275
2276
|
],
|
|
2276
|
-
reason: "v0.12.48 / v0.12.51 — Buffer-coercion guard (`if (Buffer.isBuffer(x)) return x; if (x instanceof Uint8Array) return Buffer.from(x); throw <Error>`) repeats across byte-string-consuming primitives. Each throws a MODULE-LOCAL typed error code (cose/bad-cose-key, mdoc/bad-input, dnssec/bad-bytes, dane/bad-bytes, tsa/bad-input) naming the local argument; network-dane additionally coerces a hex string. The duplicated three-line shape is the symptom, the cause is that JS can't throw a caller-namespaced ErrorClass without the local closure. Same documented exception as the v0.12.7 require-non-empty-string cluster — the typed-error CODE is the divergence the dup detector can't see.",
|
|
2277
|
+
reason: "v0.12.48 / v0.12.51 / v0.12.52 — Buffer-coercion guard (`if (Buffer.isBuffer(x)) return x; if (x instanceof Uint8Array) return Buffer.from(x); throw <Error>`) repeats across byte-string-consuming primitives. Each throws a MODULE-LOCAL typed error code (cose/bad-cose-key, mdoc/bad-input, dnssec/bad-bytes, dane/bad-bytes, tsa/bad-input) naming the local argument; network-dane additionally coerces a hex string. The duplicated three-line shape is the symptom, the cause is that JS can't throw a caller-namespaced ErrorClass without the local closure. Same documented exception as the v0.12.7 require-non-empty-string cluster — the typed-error CODE is the divergence the dup detector can't see.",
|
|
2277
2278
|
},
|
|
2278
2279
|
{
|
|
2279
2280
|
mode: "family-subset",
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Layer 0 — b.privacyPass (Privacy Pass origin side, RFC 9577 / 9578).
|
|
4
|
+
* The oracle is the published RFC 9578 §8.2 test vector for token type
|
|
5
|
+
* 0x0002 (Blind RSA): the issuer public key, the TokenChallenge, and the
|
|
6
|
+
* issued token. A wrong token_input layout or PSS parameter would fail
|
|
7
|
+
* the real RSASSA-PSS verification, and the build-then-digest round trip
|
|
8
|
+
* reproduces the vector's challenge_digest byte-for-byte.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
var b = require("../../index");
|
|
12
|
+
var helpers = require("../helpers");
|
|
13
|
+
var check = helpers.check;
|
|
14
|
+
var crypto = require("node:crypto");
|
|
15
|
+
|
|
16
|
+
// RFC 9578 §8.2, test vector 1 (token type 0x0002, Blind RSA 2048).
|
|
17
|
+
var PKI_SPKI_HEX = "30820152303d06092a864886f70d01010a3030a00d300b0609608648016503040202a11a301806092a864886f70d010108300b0609608648016503040202a2030201300382010f003082010a0282010100cb1aed6b6a95f5b1ce013a4cfcab25b94b2e64a23034e4250a7eab43c0df3a8c12993af12b111908d4b471bec31d4b6c9ad9cdda90612a2ee903523e6de5a224d6b02f09e5c374d0cfe01d8f529c500a78a2f67908fa682b5a2b430c81eaf1af72d7b5e794fc98a3139276879757ce453b526ef9bf6ceb99979b8423b90f4461a22af37aab0cf5733f7597abe44d31c732db68a181c6cbbe607d8c0e52e0655fd9996dc584eca0be87afbcd78a337d17b1dba9e828bbd81e291317144e7ff89f55619709b096cbb9ea474cead264c2073fe49740c01f00e109106066983d21e5f83f086e2e823c879cd43cef700d2a352a9babd612d03cad02db134b7e225a5f0203010001";
|
|
18
|
+
var TOKEN_CHALLENGE_HEX = "0002000e6973737565722e6578616d706c65208e7acc900e393381e8810b7c9e4a68b5163f1f880ab6688a6ffe780923609e88000e6f726967696e2e6578616d706c65";
|
|
19
|
+
var TOKEN_HEX = "0002aa72019d1f951df197021ce63876fe8b0a02dc1c31a12b0a2dd1508d07827f055969f643b4cfda5196d4aa86aeb5368834f4f06de46950ed435b3b81bd036d44ca572f8982a9ca248a3056186322d93ca147266121ddeb5632c07f1f71cd2708bc6a21b533d07294b5e900faf5537dd3eb33cee4e08c9670d1e5358fd184b0e00c637174f5206b14c7bb0e724ebf6b56271e5aa2ed94c051c4a433d302b23bc52460810d489fb050f9de5c868c6c1b06e3849fd087629f704cc724bc0d0984d5c339686fcdd75f9a9cdd25f37f855f6f4c584d84f716864f546b696d620c5bd41a811498de84ff9740ba3003ba2422d26b91eb745c084758974642a42078201543246ddb58030ea8e722376aa82484dca9610a8fb7e018e396165462e17a03e40ea7e128c090a911ecc708066cb201833010c1ebd4e910fc8e27a1be467f78671836a508257123a45e4e0ae2180a434bd1037713466347a8ebe46439d3da1970";
|
|
20
|
+
|
|
21
|
+
function spki() { return Buffer.from(PKI_SPKI_HEX, "hex"); }
|
|
22
|
+
function token() { return Buffer.from(TOKEN_HEX, "hex"); }
|
|
23
|
+
function challenge() { return Buffer.from(TOKEN_CHALLENGE_HEX, "hex"); }
|
|
24
|
+
function code(fn) { try { fn(); return "NO-THROW"; } catch (e) { return e.code; } }
|
|
25
|
+
|
|
26
|
+
function testSurface() {
|
|
27
|
+
check("b.privacyPass.verifyToken is a function", typeof b.privacyPass.verifyToken === "function");
|
|
28
|
+
check("b.privacyPass.parseToken is a function", typeof b.privacyPass.parseToken === "function");
|
|
29
|
+
check("b.privacyPass.buildChallenge is a function", typeof b.privacyPass.buildChallenge === "function");
|
|
30
|
+
check("b.privacyPass.TOKEN_TYPE_BLIND_RSA is 0x0002", b.privacyPass.TOKEN_TYPE_BLIND_RSA === 0x0002);
|
|
31
|
+
check("b.privacyPass.PrivacyPassError is the typed error class", typeof b.privacyPass.PrivacyPassError === "function" && code(function () { b.privacyPass.parseToken(Buffer.alloc(2)); }) === "privacy-pass/bad-token");
|
|
32
|
+
var threw = null; try { b.privacyPass.parseToken(Buffer.alloc(2)); } catch (e) { threw = e; }
|
|
33
|
+
check("PrivacyPassError instances are thrown", threw instanceof b.privacyPass.PrivacyPassError);
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
function testParse() {
|
|
37
|
+
var t = b.privacyPass.parseToken(token());
|
|
38
|
+
check("parseToken: token type 0x0002", t.tokenType === 0x0002);
|
|
39
|
+
check("parseToken: 32-byte nonce / digest / key-id", t.nonce.length === 32 && t.challengeDigest.length === 32 && t.tokenKeyId.length === 32);
|
|
40
|
+
check("parseToken: 256-byte authenticator (RSA-2048)", t.authenticator.length === 256);
|
|
41
|
+
// The embedded token_key_id is SHA-256 of the issuer SPKI.
|
|
42
|
+
var keyId = crypto.createHash("sha256").update(spki()).digest();
|
|
43
|
+
check("parseToken: token_key_id == SHA-256(issuer SPKI)", Buffer.compare(keyId, t.tokenKeyId) === 0);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function testRealVector() {
|
|
47
|
+
var out = b.privacyPass.verifyToken({ token: token(), issuerPublicKey: spki() });
|
|
48
|
+
check("verifyToken: real RFC 9578 §8.2 Blind RSA token verifies", out.ok && out.tokenType === 0x0002);
|
|
49
|
+
// Bound to the challenge it answers.
|
|
50
|
+
var out2 = b.privacyPass.verifyToken({ token: token(), issuerPublicKey: spki(), challenge: challenge() });
|
|
51
|
+
check("verifyToken: verifies when bound to the matching challenge", out2.ok === true);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function testBuildChallengeRoundTrip() {
|
|
55
|
+
// Rebuilding the vector's TokenChallenge reproduces it byte-for-byte,
|
|
56
|
+
// and its SHA-256 is the challenge_digest embedded in the token.
|
|
57
|
+
var rc = challenge().slice(19, 51); // the 32-byte redemption_context (after the 1-byte length at offset 18)
|
|
58
|
+
var c = b.privacyPass.buildChallenge({ issuerName: "issuer.example", originInfo: "origin.example", redemptionContext: rc });
|
|
59
|
+
check("buildChallenge: reproduces the RFC TokenChallenge bytes", Buffer.compare(c.challenge, challenge()) === 0);
|
|
60
|
+
var digest = crypto.createHash("sha256").update(c.challenge).digest();
|
|
61
|
+
var t = b.privacyPass.parseToken(token());
|
|
62
|
+
check("buildChallenge: SHA-256(challenge) == token challenge_digest", Buffer.compare(digest, t.challengeDigest) === 0);
|
|
63
|
+
check("buildChallenge: emits a PrivateToken WWW-Authenticate header", /^PrivateToken challenge="/.test(c.wwwAuthenticate));
|
|
64
|
+
// RFC 9577 §2.1: auth-param values are padded base64url.
|
|
65
|
+
var cv = c.wwwAuthenticate.match(/challenge="([^"]+)"/)[1];
|
|
66
|
+
check("buildChallenge: challenge value is base64url with padding (len % 4 === 0)", cv.length % 4 === 0 && !/[+/]/.test(cv));
|
|
67
|
+
var ck = b.privacyPass.buildChallenge({ issuerName: "issuer.example", tokenKey: spki() });
|
|
68
|
+
check("buildChallenge: token-key value is padded base64url", /token-key="([^"]+)"/.test(ck.wwwAuthenticate) && ck.wwwAuthenticate.match(/token-key="([^"]+)"/)[1].length % 4 === 0);
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function testPemKeyId() {
|
|
72
|
+
// A PEM-encoded issuer key must derive the same token_key_id as the raw
|
|
73
|
+
// SPKI bytes (Node can re-encode an rsa-pss AlgorithmIdentifier on
|
|
74
|
+
// export, so the PEM body bytes — not a re-export — must be hashed).
|
|
75
|
+
var pem = "-----BEGIN PUBLIC KEY-----\n" + spki().toString("base64").replace(/(.{64})/g, "$1\n").replace(/\n$/, "") + "\n-----END PUBLIC KEY-----\n";
|
|
76
|
+
var out = b.privacyPass.verifyToken({ token: token(), issuerPublicKey: pem });
|
|
77
|
+
check("verifyToken: real token verifies with a PEM issuer key", out.ok === true);
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function testRefusals() {
|
|
81
|
+
// Tampered authenticator fails.
|
|
82
|
+
check("verifyToken: tampered authenticator refused", code(function () {
|
|
83
|
+
var bad = token(); bad[bad.length - 1] ^= 0xff;
|
|
84
|
+
b.privacyPass.verifyToken({ token: bad, issuerPublicKey: spki() });
|
|
85
|
+
}) === "privacy-pass/bad-authenticator");
|
|
86
|
+
// Wrong issuer key → token_key_id mismatch (caught before signature).
|
|
87
|
+
check("verifyToken: wrong issuer key refused (key-id mismatch)", code(function () {
|
|
88
|
+
var otherKey = crypto.generateKeyPairSync("rsa", { modulusLength: 2048 }).publicKey.export({ format: "der", type: "spki" });
|
|
89
|
+
b.privacyPass.verifyToken({ token: token(), issuerPublicKey: otherKey });
|
|
90
|
+
}) === "privacy-pass/key-id-mismatch");
|
|
91
|
+
// Wrong challenge → challenge_digest mismatch.
|
|
92
|
+
check("verifyToken: mismatched challenge refused", code(function () {
|
|
93
|
+
b.privacyPass.verifyToken({ token: token(), issuerPublicKey: spki(), challenge: Buffer.from("not the challenge") });
|
|
94
|
+
}) === "privacy-pass/challenge-mismatch");
|
|
95
|
+
// Privately verifiable VOPRF (0x0001) is not an origin-verify operation.
|
|
96
|
+
check("verifyToken: token type 0x0001 (VOPRF) refused", code(function () {
|
|
97
|
+
var t = token(); t.writeUInt16BE(0x0001, 0);
|
|
98
|
+
b.privacyPass.verifyToken({ token: t, issuerPublicKey: spki() });
|
|
99
|
+
}) === "privacy-pass/unsupported-token-type");
|
|
100
|
+
// Truncated token refused.
|
|
101
|
+
check("parseToken: short token refused", code(function () { b.privacyPass.parseToken(Buffer.alloc(40)); }) === "privacy-pass/bad-token");
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
async function run() {
|
|
105
|
+
testSurface();
|
|
106
|
+
testParse();
|
|
107
|
+
testRealVector();
|
|
108
|
+
testBuildChallengeRoundTrip();
|
|
109
|
+
testPemKeyId();
|
|
110
|
+
testRefusals();
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
module.exports = { run: run };
|
|
114
|
+
|
|
115
|
+
if (require.main === module) {
|
|
116
|
+
run().then(
|
|
117
|
+
function () { console.log("[privacy-pass] OK — " + helpers.getChecks() + " checks passed"); },
|
|
118
|
+
function (e) { console.error("FAIL:", e && e.stack || e); process.exit(1); }
|
|
119
|
+
);
|
|
120
|
+
}
|
package/package.json
CHANGED