ftown 0.20.8 → 0.21.0
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/dist/centrifugo-client.d.ts +15 -11
- package/dist/centrifugo-client.js +63 -70
- package/dist/centrifugo-client.js.map +1 -1
- package/dist/cli-client.d.ts +11 -1
- package/dist/cli-client.js +23 -3
- package/dist/cli-client.js.map +1 -1
- package/dist/command-rpc.js +4 -8
- package/dist/command-rpc.js.map +1 -1
- package/dist/identity-reset.d.ts +11 -0
- package/dist/identity-reset.js +192 -0
- package/dist/identity-reset.js.map +1 -0
- package/dist/index.js +276 -279
- package/dist/index.js.map +1 -1
- package/dist/ledger-pairing-client.d.ts +28 -0
- package/dist/ledger-pairing-client.js +152 -0
- package/dist/ledger-pairing-client.js.map +1 -0
- package/dist/ledger-relay.d.ts +124 -0
- package/dist/ledger-relay.js +453 -0
- package/dist/ledger-relay.js.map +1 -0
- package/dist/ledger-startup.d.ts +151 -0
- package/dist/ledger-startup.js +203 -0
- package/dist/ledger-startup.js.map +1 -0
- package/dist/relay-token.d.ts +39 -0
- package/dist/relay-token.js +130 -0
- package/dist/relay-token.js.map +1 -0
- package/dist/revocation-gating.d.ts +15 -0
- package/dist/revocation-gating.js +16 -0
- package/dist/revocation-gating.js.map +1 -0
- package/dist/revoked-restart.d.ts +21 -0
- package/dist/revoked-restart.js +55 -0
- package/dist/revoked-restart.js.map +1 -0
- package/dist/security/bridge/identity.d.ts +2 -47
- package/dist/security/bridge/identity.js +3 -3
- package/dist/security/bridge/identity.js.map +1 -1
- package/dist/security/bridge/ledger-identity.d.ts +48 -0
- package/dist/security/bridge/ledger-identity.js +342 -0
- package/dist/security/bridge/ledger-identity.js.map +1 -0
- package/dist/security/bridge/ledger-store.d.ts +84 -0
- package/dist/security/bridge/ledger-store.js +485 -0
- package/dist/security/bridge/ledger-store.js.map +1 -0
- package/dist/security/bridge/metadata.d.ts +2 -2
- package/dist/security/bridge/permissions.js +2 -2
- package/dist/security/bridge/permissions.js.map +1 -1
- package/dist/security/bridge/policy.d.ts +42 -21
- package/dist/security/bridge/policy.js +217 -135
- package/dist/security/bridge/policy.js.map +1 -1
- package/dist/security/bridge/security.d.ts +91 -28
- package/dist/security/bridge/security.js +274 -117
- package/dist/security/bridge/security.js.map +1 -1
- package/dist/security/crypto.js +1 -1
- package/dist/security/crypto.js.map +1 -1
- package/dist/security/ledger/channels.d.ts +5 -0
- package/dist/security/ledger/channels.js +21 -0
- package/dist/security/ledger/channels.js.map +1 -0
- package/dist/security/ledger/ledger.d.ts +61 -0
- package/dist/security/ledger/ledger.js +597 -0
- package/dist/security/ledger/ledger.js.map +1 -0
- package/dist/security/ledger/pairing.d.ts +81 -0
- package/dist/security/ledger/pairing.js +414 -0
- package/dist/security/ledger/pairing.js.map +1 -0
- package/dist/security/ledger/proof.d.ts +24 -0
- package/dist/security/ledger/proof.js +161 -0
- package/dist/security/ledger/proof.js.map +1 -0
- package/dist/security/ledger/protocol.d.ts +100 -0
- package/dist/security/ledger/protocol.js +16 -0
- package/dist/security/ledger/protocol.js.map +1 -0
- package/dist/security/ledger/testing.d.ts +27 -0
- package/dist/security/ledger/testing.js +70 -0
- package/dist/security/ledger/testing.js.map +1 -0
- package/dist/security/ledger/webauthn.d.ts +12 -0
- package/dist/security/ledger/webauthn.js +147 -0
- package/dist/security/ledger/webauthn.js.map +1 -0
- package/dist/security/protocol.d.ts +5 -10
- package/dist/security-cli.d.ts +5 -0
- package/dist/security-cli.js +28 -16
- package/dist/security-cli.js.map +1 -1
- package/dist/token-provider.d.ts +39 -0
- package/dist/token-provider.js +101 -0
- package/dist/token-provider.js.map +1 -0
- package/dist/types.d.ts +1 -1
- package/package.json +2 -2
- package/skills/ftown/references/sessions.md +4 -0
- package/dist/bridge-auth.d.ts +0 -25
- package/dist/bridge-auth.js +0 -56
- package/dist/bridge-auth.js.map +0 -1
- package/dist/pairing-client.d.ts +0 -60
- package/dist/pairing-client.js +0 -460
- package/dist/pairing-client.js.map +0 -1
- package/dist/rotating-token-refresher.d.ts +0 -42
- package/dist/rotating-token-refresher.js +0 -91
- package/dist/rotating-token-refresher.js.map +0 -1
- package/dist/security/account-crypto.d.ts +0 -33
- package/dist/security/account-crypto.js +0 -649
- package/dist/security/account-crypto.js.map +0 -1
- package/dist/security/account-protocol.d.ts +0 -228
- package/dist/security/account-protocol.js +0 -2
- package/dist/security/account-protocol.js.map +0 -1
- package/dist/security/bridge/account-client.d.ts +0 -7
- package/dist/security/bridge/account-client.js +0 -87
- package/dist/security/bridge/account-client.js.map +0 -1
- package/dist/security/bridge/account-state.d.ts +0 -105
- package/dist/security/bridge/account-state.js +0 -79
- package/dist/security/bridge/account-state.js.map +0 -1
- package/dist/security/bridge/pending-approval.d.ts +0 -21
- package/dist/security/bridge/pending-approval.js +0 -80
- package/dist/security/bridge/pending-approval.js.map +0 -1
- package/dist/security/bridge/pending-enrollment.d.ts +0 -33
- package/dist/security/bridge/pending-enrollment.js +0 -177
- package/dist/security/bridge/pending-enrollment.js.map +0 -1
- package/dist/security/pending-approval-crypto.d.ts +0 -29
- package/dist/security/pending-approval-crypto.js +0 -716
- package/dist/security/pending-approval-crypto.js.map +0 -1
- package/dist/security/pending-approval-protocol.d.ts +0 -329
- package/dist/security/pending-approval-protocol.js +0 -2
- package/dist/security/pending-approval-protocol.js.map +0 -1
- package/dist/security/security-nudge.d.ts +0 -31
- package/dist/security/security-nudge.js +0 -98
- package/dist/security/security-nudge.js.map +0 -1
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
const PROOF_DOMAIN = 'ftown-auth-proof-v1\n';
|
|
2
|
+
const ECDSA = { name: 'ECDSA', namedCurve: 'P-256' };
|
|
3
|
+
const SIGN = { name: 'ECDSA', hash: 'SHA-256' };
|
|
4
|
+
const MAX_NONCE = 128;
|
|
5
|
+
const B64URL = /^[A-Za-z0-9_-]+$/;
|
|
6
|
+
const KEYS = ['accountId', 'kind', 'keyId', 'nonce', 'purpose', 'audience', 'signature'];
|
|
7
|
+
const MAX_ACCOUNT = 64;
|
|
8
|
+
const MAX_KEY_ID = 128;
|
|
9
|
+
const MAX_AUDIENCE = 256;
|
|
10
|
+
const SIGNATURE_LENGTH = 86;
|
|
11
|
+
const LOOPBACK = ['localhost', '127.0.0.1', '[::1]'];
|
|
12
|
+
const ORDER = hexBytes('FFFFFFFF00000000FFFFFFFFFFFFFFFFBCE6FAADA7179E84F3B9CAC2FC632551');
|
|
13
|
+
const HALF_ORDER = hexBytes('7FFFFFFF800000007FFFFFFFFFFFFFFFDE737D56D38BCF4279DCE5617E3192A8');
|
|
14
|
+
function hexBytes(hex) {
|
|
15
|
+
const out = [];
|
|
16
|
+
for (let i = 0; i < hex.length; i += 2)
|
|
17
|
+
out.push(parseInt(hex.slice(i, i + 2), 16));
|
|
18
|
+
return out;
|
|
19
|
+
}
|
|
20
|
+
function isHighS(s) {
|
|
21
|
+
for (let i = 0; i < 32; i++) {
|
|
22
|
+
if (s[i] !== HALF_ORDER[i])
|
|
23
|
+
return s[i] > HALF_ORDER[i];
|
|
24
|
+
}
|
|
25
|
+
return false;
|
|
26
|
+
}
|
|
27
|
+
function lowS(signature) {
|
|
28
|
+
if (!isHighS(signature.subarray(32)))
|
|
29
|
+
return signature;
|
|
30
|
+
const out = new Uint8Array(signature);
|
|
31
|
+
let borrow = 0;
|
|
32
|
+
for (let i = 31; i >= 0; i--) {
|
|
33
|
+
let value = ORDER[i] - signature[32 + i] - borrow;
|
|
34
|
+
borrow = value < 0 ? 1 : 0;
|
|
35
|
+
if (value < 0)
|
|
36
|
+
value += 256;
|
|
37
|
+
out[32 + i] = value;
|
|
38
|
+
}
|
|
39
|
+
return out;
|
|
40
|
+
}
|
|
41
|
+
function validAudience(value) {
|
|
42
|
+
if (value.length === 0 || value.length > MAX_AUDIENCE)
|
|
43
|
+
return false;
|
|
44
|
+
try {
|
|
45
|
+
const url = new URL(value);
|
|
46
|
+
if (url.origin !== value)
|
|
47
|
+
return false;
|
|
48
|
+
return url.protocol === 'https:' || (url.protocol === 'http:' && LOOPBACK.indexOf(url.hostname) !== -1);
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
return false;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
function encode(data) {
|
|
55
|
+
let binary = '';
|
|
56
|
+
for (let i = 0; i < data.length; i++)
|
|
57
|
+
binary += String.fromCharCode(data[i]);
|
|
58
|
+
return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
|
|
59
|
+
}
|
|
60
|
+
function decode(value) {
|
|
61
|
+
if (!B64URL.test(value) || value.length % 4 === 1)
|
|
62
|
+
return null;
|
|
63
|
+
try {
|
|
64
|
+
const binary = atob(value.replace(/-/g, '+').replace(/_/g, '/'));
|
|
65
|
+
const out = new Uint8Array(new ArrayBuffer(binary.length));
|
|
66
|
+
for (let i = 0; i < binary.length; i++)
|
|
67
|
+
out[i] = binary.charCodeAt(i);
|
|
68
|
+
return out;
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
return null;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
function canonicalBytes(fields) {
|
|
75
|
+
const ordered = {
|
|
76
|
+
accountId: fields.accountId,
|
|
77
|
+
audience: fields.audience,
|
|
78
|
+
keyId: fields.keyId,
|
|
79
|
+
kind: fields.kind,
|
|
80
|
+
nonce: fields.nonce,
|
|
81
|
+
purpose: fields.purpose,
|
|
82
|
+
};
|
|
83
|
+
const text = PROOF_DOMAIN + JSON.stringify(ordered);
|
|
84
|
+
const out = new Uint8Array(new ArrayBuffer(text.length * 3));
|
|
85
|
+
const { written } = new TextEncoder().encodeInto(text, out);
|
|
86
|
+
return out.slice(0, written);
|
|
87
|
+
}
|
|
88
|
+
export async function generateAuthKey(extractable) {
|
|
89
|
+
const pair = await crypto.subtle.generateKey(ECDSA, extractable, ['sign', 'verify']);
|
|
90
|
+
const publicKey = encode(new Uint8Array(await crypto.subtle.exportKey('raw', pair.publicKey)));
|
|
91
|
+
return { publicKey, privateKey: pair.privateKey };
|
|
92
|
+
}
|
|
93
|
+
export async function signAuthProof(privateKey, fields) {
|
|
94
|
+
const { accountId, kind, keyId, nonce, purpose, audience } = fields;
|
|
95
|
+
const signature = new Uint8Array(await crypto.subtle.sign(SIGN, privateKey, canonicalBytes({ accountId, kind, keyId, nonce, purpose, audience })));
|
|
96
|
+
return { accountId, kind, keyId, nonce, purpose, audience, signature: encode(lowS(signature)) };
|
|
97
|
+
}
|
|
98
|
+
export function parseAuthProof(value) {
|
|
99
|
+
try {
|
|
100
|
+
if (typeof value !== 'object' || value === null || Array.isArray(value))
|
|
101
|
+
return null;
|
|
102
|
+
const record = value;
|
|
103
|
+
const keys = Object.keys(record);
|
|
104
|
+
if (keys.length !== KEYS.length || !keys.every(key => KEYS.indexOf(key) !== -1))
|
|
105
|
+
return null;
|
|
106
|
+
const { accountId, kind, keyId, nonce, purpose, audience, signature } = record;
|
|
107
|
+
if (typeof accountId !== 'string' || !accountId || accountId.length > MAX_ACCOUNT)
|
|
108
|
+
return null;
|
|
109
|
+
if (typeof keyId !== 'string' || !keyId || keyId.length > MAX_KEY_ID)
|
|
110
|
+
return null;
|
|
111
|
+
if (kind !== 'device' && kind !== 'bridge')
|
|
112
|
+
return null;
|
|
113
|
+
if (purpose !== 'session' && purpose !== 'relay')
|
|
114
|
+
return null;
|
|
115
|
+
if (typeof nonce !== 'string' || nonce.length === 0 || nonce.length > MAX_NONCE || !B64URL.test(nonce))
|
|
116
|
+
return null;
|
|
117
|
+
if (typeof audience !== 'string' || !validAudience(audience))
|
|
118
|
+
return null;
|
|
119
|
+
if (typeof signature !== 'string' || signature.length !== SIGNATURE_LENGTH || !B64URL.test(signature))
|
|
120
|
+
return null;
|
|
121
|
+
return { accountId, kind, keyId, nonce, purpose, audience, signature };
|
|
122
|
+
}
|
|
123
|
+
catch {
|
|
124
|
+
return null;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
// Nonce freshness and single use are enforced by the server, not here.
|
|
128
|
+
export async function verifyAuthProof(checkpoint, proof, expect) {
|
|
129
|
+
try {
|
|
130
|
+
const parsed = parseAuthProof(proof);
|
|
131
|
+
if (!parsed || parsed.accountId !== checkpoint.accountId)
|
|
132
|
+
return false;
|
|
133
|
+
if (parsed.audience !== expect.audience || parsed.purpose !== expect.purpose)
|
|
134
|
+
return false;
|
|
135
|
+
if (parsed.kind === 'bridge' && parsed.purpose === 'session')
|
|
136
|
+
return false;
|
|
137
|
+
let authPublicKey;
|
|
138
|
+
if (parsed.kind === 'device') {
|
|
139
|
+
if (checkpoint.revokedDeviceIds.indexOf(parsed.keyId) !== -1)
|
|
140
|
+
return false;
|
|
141
|
+
authPublicKey = checkpoint.devices.filter(entry => entry.endpoint.id === parsed.keyId)[0]?.authPublicKey;
|
|
142
|
+
}
|
|
143
|
+
else {
|
|
144
|
+
if (checkpoint.revokedBridgeIds.indexOf(parsed.keyId) !== -1)
|
|
145
|
+
return false;
|
|
146
|
+
authPublicKey = checkpoint.bridges.filter(entry => entry.bridgeId === parsed.keyId)[0]?.authPublicKey;
|
|
147
|
+
}
|
|
148
|
+
if (!authPublicKey)
|
|
149
|
+
return false;
|
|
150
|
+
const raw = decode(authPublicKey);
|
|
151
|
+
const signature = decode(parsed.signature);
|
|
152
|
+
if (!raw || raw.length !== 65 || !signature || signature.length !== 64 || encode(signature) !== parsed.signature || isHighS(signature.subarray(32)))
|
|
153
|
+
return false;
|
|
154
|
+
const key = await crypto.subtle.importKey('raw', raw, ECDSA, false, ['verify']);
|
|
155
|
+
return await crypto.subtle.verify(SIGN, key, signature, canonicalBytes(parsed));
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return false;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
//# sourceMappingURL=proof.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"proof.js","sourceRoot":"","sources":["../../../src/security/ledger/proof.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import type { EndpointPublic } from '../protocol.js';
|
|
2
|
+
export declare const LEDGER_DOMAIN = "ftown-account-trust-v2\n";
|
|
3
|
+
/** Sign-in assertions are over SHA-256(SIGNIN_DOMAIN + nonce); never over raw server bytes. */
|
|
4
|
+
export declare const SIGNIN_DOMAIN = "ftown-signin-v2\n";
|
|
5
|
+
/** A new authority's consent is its own assertion over SHA-256(AUTHORITY_CONSENT_DOMAIN + canonical({accountId, credentialId, publicKey})). */
|
|
6
|
+
export declare const AUTHORITY_CONSENT_DOMAIN = "ftown-authority-consent-v2\n";
|
|
7
|
+
export interface LedgerAuthority {
|
|
8
|
+
credentialId: string;
|
|
9
|
+
/** Raw uncompressed P-256 point, 65 bytes, base64url. */
|
|
10
|
+
publicKey: string;
|
|
11
|
+
label: string;
|
|
12
|
+
addedAt: number;
|
|
13
|
+
}
|
|
14
|
+
export interface LedgerDevice {
|
|
15
|
+
endpoint: EndpointPublic;
|
|
16
|
+
authPublicKey: string;
|
|
17
|
+
label: string;
|
|
18
|
+
approvedAt: number;
|
|
19
|
+
}
|
|
20
|
+
export interface LedgerBridge {
|
|
21
|
+
bridgeId: string;
|
|
22
|
+
endpoint: EndpointPublic;
|
|
23
|
+
authPublicKey: string;
|
|
24
|
+
label: string;
|
|
25
|
+
approvedAt: number;
|
|
26
|
+
}
|
|
27
|
+
export interface LedgerGenesis {
|
|
28
|
+
type: 'ftown_account_genesis';
|
|
29
|
+
version: 2;
|
|
30
|
+
rpId: string;
|
|
31
|
+
origins: string[];
|
|
32
|
+
/** WebAuthn user.id: 32 random bytes, base64url. */
|
|
33
|
+
handle: string;
|
|
34
|
+
createdAt: number;
|
|
35
|
+
authority: LedgerAuthority;
|
|
36
|
+
}
|
|
37
|
+
/** Authorities are add-only: a lost or compromised passkey means a new account. `consent` is the added passkey's own assertion
|
|
38
|
+
* over authorityConsentChallenge(accountId, authority), so no account can claim a passkey that did not agree to join it. */
|
|
39
|
+
export type LedgerOperation = {
|
|
40
|
+
type: 'add_device';
|
|
41
|
+
device: LedgerDevice;
|
|
42
|
+
} | {
|
|
43
|
+
type: 'revoke_device';
|
|
44
|
+
endpointId: string;
|
|
45
|
+
} | {
|
|
46
|
+
type: 'add_bridge';
|
|
47
|
+
bridge: LedgerBridge;
|
|
48
|
+
} | {
|
|
49
|
+
type: 'revoke_bridge';
|
|
50
|
+
bridgeId: string;
|
|
51
|
+
} | {
|
|
52
|
+
type: 'add_authority';
|
|
53
|
+
authority: LedgerAuthority;
|
|
54
|
+
consent: PasskeySignature;
|
|
55
|
+
};
|
|
56
|
+
export interface LedgerTransition {
|
|
57
|
+
type: 'ftown_account_transition';
|
|
58
|
+
version: 2;
|
|
59
|
+
accountId: string;
|
|
60
|
+
revision: number;
|
|
61
|
+
previousHead: string;
|
|
62
|
+
issuedAt: number;
|
|
63
|
+
credentialId: string;
|
|
64
|
+
operation: LedgerOperation;
|
|
65
|
+
}
|
|
66
|
+
/** All fields base64url; signature is DER. */
|
|
67
|
+
export interface PasskeySignature {
|
|
68
|
+
authenticatorData: string;
|
|
69
|
+
clientDataJSON: string;
|
|
70
|
+
signature: string;
|
|
71
|
+
}
|
|
72
|
+
export interface Signed<T> {
|
|
73
|
+
payload: T;
|
|
74
|
+
signature: PasskeySignature;
|
|
75
|
+
}
|
|
76
|
+
export interface Ledger {
|
|
77
|
+
genesis: Signed<LedgerGenesis>;
|
|
78
|
+
transitions: Signed<LedgerTransition>[];
|
|
79
|
+
}
|
|
80
|
+
export interface LedgerCheckpoint {
|
|
81
|
+
version: 2;
|
|
82
|
+
accountId: string;
|
|
83
|
+
revision: number;
|
|
84
|
+
head: string;
|
|
85
|
+
authorities: LedgerAuthority[];
|
|
86
|
+
devices: LedgerDevice[];
|
|
87
|
+
bridges: LedgerBridge[];
|
|
88
|
+
revokedDeviceIds: string[];
|
|
89
|
+
revokedBridgeIds: string[];
|
|
90
|
+
}
|
|
91
|
+
export declare const LEDGER_LIMITS: {
|
|
92
|
+
readonly maxBytes: 2097152;
|
|
93
|
+
readonly maxTransitions: 1024;
|
|
94
|
+
readonly maxAuthorities: 8;
|
|
95
|
+
readonly maxDevices: 128;
|
|
96
|
+
readonly maxBridges: 128;
|
|
97
|
+
readonly maxFutureSkewMs: 30000;
|
|
98
|
+
readonly maxLabelLength: 200;
|
|
99
|
+
readonly offlineGraceMs: 86400000;
|
|
100
|
+
};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export const LEDGER_DOMAIN = 'ftown-account-trust-v2\n';
|
|
2
|
+
/** Sign-in assertions are over SHA-256(SIGNIN_DOMAIN + nonce); never over raw server bytes. */
|
|
3
|
+
export const SIGNIN_DOMAIN = 'ftown-signin-v2\n';
|
|
4
|
+
/** A new authority's consent is its own assertion over SHA-256(AUTHORITY_CONSENT_DOMAIN + canonical({accountId, credentialId, publicKey})). */
|
|
5
|
+
export const AUTHORITY_CONSENT_DOMAIN = 'ftown-authority-consent-v2\n';
|
|
6
|
+
export const LEDGER_LIMITS = {
|
|
7
|
+
maxBytes: 2097152,
|
|
8
|
+
maxTransitions: 1024,
|
|
9
|
+
maxAuthorities: 8,
|
|
10
|
+
maxDevices: 128,
|
|
11
|
+
maxBridges: 128,
|
|
12
|
+
maxFutureSkewMs: 30000,
|
|
13
|
+
maxLabelLength: 200,
|
|
14
|
+
offlineGraceMs: 86400000,
|
|
15
|
+
};
|
|
16
|
+
//# sourceMappingURL=protocol.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/security/ledger/protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AACxD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC;AACjD,+IAA+I;AAC/I,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AAsDvE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,OAAO;IACjB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG;IACf,UAAU,EAAE,GAAG;IACf,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,QAAQ;CAChB,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { PasskeySignature } from './protocol.js';
|
|
2
|
+
export interface SoftPasskeySignOptions {
|
|
3
|
+
origin?: string;
|
|
4
|
+
rpId?: string;
|
|
5
|
+
/** false clears, true sets, the UV bit on top of `flags`. */
|
|
6
|
+
uv?: boolean;
|
|
7
|
+
/** false clears, true sets, the UP bit on top of `flags`. */
|
|
8
|
+
up?: boolean;
|
|
9
|
+
type?: string;
|
|
10
|
+
crossOrigin?: boolean;
|
|
11
|
+
/** authenticatorData flags byte. Defaults to 0x1D (UP|UV|BE|BS), as synced Apple and Google passkeys emit. */
|
|
12
|
+
flags?: number;
|
|
13
|
+
/** Big-endian uint32 signature counter. Defaults to 0. */
|
|
14
|
+
signCount?: number;
|
|
15
|
+
}
|
|
16
|
+
/** Byte-faithful assertions: authenticatorData = rpIdHash | flags | signCount, browser-style clientDataJSON, DER signature. */
|
|
17
|
+
export interface SoftPasskey {
|
|
18
|
+
credentialId: string;
|
|
19
|
+
publicKey: string;
|
|
20
|
+
sign(challenge: Uint8Array, options?: SoftPasskeySignOptions): Promise<PasskeySignature>;
|
|
21
|
+
}
|
|
22
|
+
/** 64-byte r||s to a minimal DER SEQUENCE of two INTEGERs. */
|
|
23
|
+
export declare function rawToDerSignature(raw: Uint8Array): Uint8Array<ArrayBuffer>;
|
|
24
|
+
export declare function createSoftPasskey(defaults: {
|
|
25
|
+
rpId: string;
|
|
26
|
+
origin: string;
|
|
27
|
+
}): Promise<SoftPasskey>;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
const encoder = new TextEncoder();
|
|
2
|
+
const FLAG_UP = 0x01;
|
|
3
|
+
const FLAG_UV = 0x04;
|
|
4
|
+
const DEFAULT_FLAGS = 0x1d;
|
|
5
|
+
function b64url(data) {
|
|
6
|
+
let binary = '';
|
|
7
|
+
for (let index = 0; index < data.length; index += 1)
|
|
8
|
+
binary += String.fromCharCode(data[index]);
|
|
9
|
+
return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
|
|
10
|
+
}
|
|
11
|
+
function derInteger(value) {
|
|
12
|
+
let start = 0;
|
|
13
|
+
while (start < value.length - 1 && value[start] === 0)
|
|
14
|
+
start += 1;
|
|
15
|
+
const body = [];
|
|
16
|
+
if ((value[start] & 0x80) !== 0)
|
|
17
|
+
body.push(0);
|
|
18
|
+
for (let index = start; index < value.length; index += 1)
|
|
19
|
+
body.push(value[index]);
|
|
20
|
+
return [0x02, body.length].concat(body);
|
|
21
|
+
}
|
|
22
|
+
function withBit(flags, bit, value) {
|
|
23
|
+
if (value === true)
|
|
24
|
+
return flags | bit;
|
|
25
|
+
if (value === false)
|
|
26
|
+
return flags & ~bit & 0xff;
|
|
27
|
+
return flags;
|
|
28
|
+
}
|
|
29
|
+
/** 64-byte r||s to a minimal DER SEQUENCE of two INTEGERs. */
|
|
30
|
+
export function rawToDerSignature(raw) {
|
|
31
|
+
if (raw.length !== 64)
|
|
32
|
+
throw new Error('Raw P-256 signature must be 64 bytes');
|
|
33
|
+
const content = derInteger(raw.subarray(0, 32)).concat(derInteger(raw.subarray(32, 64)));
|
|
34
|
+
return new Uint8Array([0x30, content.length].concat(content));
|
|
35
|
+
}
|
|
36
|
+
export async function createSoftPasskey(defaults) {
|
|
37
|
+
const keyPair = await crypto.subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign', 'verify']);
|
|
38
|
+
const publicKey = b64url(new Uint8Array(await crypto.subtle.exportKey('raw', keyPair.publicKey)));
|
|
39
|
+
const credentialId = b64url(crypto.getRandomValues(new Uint8Array(32)));
|
|
40
|
+
async function sign(challenge, options = {}) {
|
|
41
|
+
const baseFlags = options.flags ?? DEFAULT_FLAGS;
|
|
42
|
+
const signCount = options.signCount ?? 0;
|
|
43
|
+
if (!Number.isInteger(baseFlags) || baseFlags < 0 || baseFlags > 0xff)
|
|
44
|
+
throw new Error('flags must be one byte');
|
|
45
|
+
if (!Number.isInteger(signCount) || signCount < 0 || signCount > 0xffffffff)
|
|
46
|
+
throw new Error('signCount must be a uint32');
|
|
47
|
+
const rpIdHash = new Uint8Array(await crypto.subtle.digest('SHA-256', encoder.encode(options.rpId ?? defaults.rpId)));
|
|
48
|
+
const authenticatorData = new Uint8Array(37);
|
|
49
|
+
authenticatorData.set(rpIdHash, 0);
|
|
50
|
+
authenticatorData[32] = withBit(withBit(baseFlags, FLAG_UP, options.up), FLAG_UV, options.uv);
|
|
51
|
+
authenticatorData[33] = (signCount >>> 24) & 0xff;
|
|
52
|
+
authenticatorData[34] = (signCount >>> 16) & 0xff;
|
|
53
|
+
authenticatorData[35] = (signCount >>> 8) & 0xff;
|
|
54
|
+
authenticatorData[36] = signCount & 0xff;
|
|
55
|
+
const clientDataJSON = encoder.encode(JSON.stringify({
|
|
56
|
+
type: options.type ?? 'webauthn.get',
|
|
57
|
+
challenge: b64url(challenge),
|
|
58
|
+
origin: options.origin ?? defaults.origin,
|
|
59
|
+
crossOrigin: options.crossOrigin ?? false,
|
|
60
|
+
}));
|
|
61
|
+
const clientDataHash = new Uint8Array(await crypto.subtle.digest('SHA-256', clientDataJSON));
|
|
62
|
+
const signed = new Uint8Array(authenticatorData.length + clientDataHash.length);
|
|
63
|
+
signed.set(authenticatorData, 0);
|
|
64
|
+
signed.set(clientDataHash, authenticatorData.length);
|
|
65
|
+
const raw = new Uint8Array(await crypto.subtle.sign({ name: 'ECDSA', hash: 'SHA-256' }, keyPair.privateKey, signed));
|
|
66
|
+
return { authenticatorData: b64url(authenticatorData), clientDataJSON: b64url(clientDataJSON), signature: b64url(rawToDerSignature(raw)) };
|
|
67
|
+
}
|
|
68
|
+
return { credentialId, publicKey, sign };
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=testing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/security/ledger/testing.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { PasskeySignature } from './protocol.js';
|
|
2
|
+
export declare function derToRawSignature(der: Uint8Array): Uint8Array<ArrayBuffer>;
|
|
3
|
+
/** Pure. True iff: clientData.type==='webauthn.get'; clientData.challenge === b64url(challenge); clientData.origin ∈ origins;
|
|
4
|
+
* authenticatorData[0..32) === SHA-256(rpId); flags UP and UV set; ECDSA P-256/SHA-256 verifies over authenticatorData || SHA-256(clientDataJSON). Never throws.
|
|
5
|
+
* Also fails closed on crossOrigin other than absent/false and on challenges shorter than 16 bytes. The signature counter is ignored. */
|
|
6
|
+
export declare function verifyPasskeyAssertion(input: {
|
|
7
|
+
publicKey: string;
|
|
8
|
+
rpId: string;
|
|
9
|
+
origins: readonly string[];
|
|
10
|
+
challenge: Uint8Array;
|
|
11
|
+
signature: PasskeySignature;
|
|
12
|
+
}): Promise<boolean>;
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
const encoder = new TextEncoder();
|
|
2
|
+
const FLAG_UP = 0x01;
|
|
3
|
+
const FLAG_UV = 0x04;
|
|
4
|
+
const MIN_CHALLENGE_BYTES = 16;
|
|
5
|
+
const MAX_AUTHENTICATOR_DATA_BYTES = 4096;
|
|
6
|
+
const MAX_CLIENT_DATA_BYTES = 4096;
|
|
7
|
+
const MAX_DER_SIGNATURE_BYTES = 72;
|
|
8
|
+
function malformed() {
|
|
9
|
+
throw new Error('Malformed DER signature');
|
|
10
|
+
}
|
|
11
|
+
function isBytes(value) {
|
|
12
|
+
// Tag check instead of instanceof so typed arrays from another realm are accepted.
|
|
13
|
+
return ArrayBuffer.isView(value) && Object.prototype.toString.call(value) === '[object Uint8Array]';
|
|
14
|
+
}
|
|
15
|
+
function isRecord(value) {
|
|
16
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
17
|
+
}
|
|
18
|
+
function b64url(data) {
|
|
19
|
+
let binary = '';
|
|
20
|
+
for (let index = 0; index < data.length; index += 1)
|
|
21
|
+
binary += String.fromCharCode(data[index]);
|
|
22
|
+
return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
|
|
23
|
+
}
|
|
24
|
+
/** Canonical unpadded base64url only; the length bound is checked before decoding. */
|
|
25
|
+
function fromB64url(value, min, max) {
|
|
26
|
+
if (typeof value !== 'string' || value.length > Math.ceil(max * 4 / 3) || !/^[A-Za-z0-9_-]+$/.test(value)) {
|
|
27
|
+
throw new Error('Invalid base64url');
|
|
28
|
+
}
|
|
29
|
+
const binary = atob(value.replace(/-/g, '+').replace(/_/g, '/'));
|
|
30
|
+
if (binary.length < min || binary.length > max)
|
|
31
|
+
throw new Error('Invalid length');
|
|
32
|
+
const result = new Uint8Array(binary.length);
|
|
33
|
+
for (let index = 0; index < binary.length; index += 1)
|
|
34
|
+
result[index] = binary.charCodeAt(index);
|
|
35
|
+
if (b64url(result) !== value)
|
|
36
|
+
throw new Error('Non-canonical base64url');
|
|
37
|
+
return result;
|
|
38
|
+
}
|
|
39
|
+
function sameBytes(left, right) {
|
|
40
|
+
if (left.length !== right.length)
|
|
41
|
+
return false;
|
|
42
|
+
let difference = 0;
|
|
43
|
+
for (let index = 0; index < left.length; index += 1)
|
|
44
|
+
difference |= left[index] ^ right[index];
|
|
45
|
+
return difference === 0;
|
|
46
|
+
}
|
|
47
|
+
/** Returns [length, offset of the content]. Definite lengths only, minimally encoded. */
|
|
48
|
+
function derLength(der, offset) {
|
|
49
|
+
if (offset >= der.length)
|
|
50
|
+
return malformed();
|
|
51
|
+
const first = der[offset];
|
|
52
|
+
if (first < 0x80)
|
|
53
|
+
return [first, offset + 1];
|
|
54
|
+
const count = first & 0x7f;
|
|
55
|
+
if (count < 1 || count > 2 || offset + 1 + count > der.length)
|
|
56
|
+
return malformed();
|
|
57
|
+
let length = 0;
|
|
58
|
+
for (let index = 0; index < count; index += 1)
|
|
59
|
+
length = length * 256 + der[offset + 1 + index];
|
|
60
|
+
if (length < (count === 1 ? 0x80 : 0x100))
|
|
61
|
+
return malformed();
|
|
62
|
+
return [length, offset + 1 + count];
|
|
63
|
+
}
|
|
64
|
+
/** One positive, minimally encoded INTEGER of at most 32 significant bytes, left-padded to 32. */
|
|
65
|
+
function derInteger(der, offset, end) {
|
|
66
|
+
if (offset >= end || der[offset] !== 0x02)
|
|
67
|
+
return malformed();
|
|
68
|
+
const [length, start] = derLength(der, offset + 1);
|
|
69
|
+
const next = start + length;
|
|
70
|
+
if (length < 1 || next > end)
|
|
71
|
+
return malformed();
|
|
72
|
+
let value = der.subarray(start, next);
|
|
73
|
+
if ((value[0] & 0x80) !== 0)
|
|
74
|
+
return malformed();
|
|
75
|
+
if (value[0] === 0) {
|
|
76
|
+
// A leading zero is only legal as the sign pad of a high-bit byte; a lone zero is r or s = 0.
|
|
77
|
+
if (value.length === 1 || (value[1] & 0x80) === 0)
|
|
78
|
+
return malformed();
|
|
79
|
+
value = value.subarray(1);
|
|
80
|
+
}
|
|
81
|
+
if (value.length > 32)
|
|
82
|
+
return malformed();
|
|
83
|
+
const padded = new Uint8Array(32);
|
|
84
|
+
padded.set(value, 32 - value.length);
|
|
85
|
+
return { value: padded, next };
|
|
86
|
+
}
|
|
87
|
+
export function derToRawSignature(der) {
|
|
88
|
+
if (!isBytes(der) || der.length < 8 || der.length > MAX_DER_SIGNATURE_BYTES || der[0] !== 0x30)
|
|
89
|
+
return malformed();
|
|
90
|
+
const [length, start] = derLength(der, 1);
|
|
91
|
+
if (start + length !== der.length)
|
|
92
|
+
return malformed();
|
|
93
|
+
const r = derInteger(der, start, der.length);
|
|
94
|
+
const s = derInteger(der, r.next, der.length);
|
|
95
|
+
if (s.next !== der.length)
|
|
96
|
+
return malformed();
|
|
97
|
+
const raw = new Uint8Array(64);
|
|
98
|
+
raw.set(r.value, 0);
|
|
99
|
+
raw.set(s.value, 32);
|
|
100
|
+
return raw;
|
|
101
|
+
}
|
|
102
|
+
/** Pure. True iff: clientData.type==='webauthn.get'; clientData.challenge === b64url(challenge); clientData.origin ∈ origins;
|
|
103
|
+
* authenticatorData[0..32) === SHA-256(rpId); flags UP and UV set; ECDSA P-256/SHA-256 verifies over authenticatorData || SHA-256(clientDataJSON). Never throws.
|
|
104
|
+
* Also fails closed on crossOrigin other than absent/false and on challenges shorter than 16 bytes. The signature counter is ignored. */
|
|
105
|
+
export async function verifyPasskeyAssertion(input) {
|
|
106
|
+
try {
|
|
107
|
+
const { publicKey, rpId, origins, challenge, signature } = input;
|
|
108
|
+
if (!isBytes(challenge) || challenge.length < MIN_CHALLENGE_BYTES)
|
|
109
|
+
return false;
|
|
110
|
+
if (typeof rpId !== 'string' || rpId.length === 0 || !Array.isArray(origins) || !isRecord(signature))
|
|
111
|
+
return false;
|
|
112
|
+
const authenticatorData = fromB64url(signature.authenticatorData, 37, MAX_AUTHENTICATOR_DATA_BYTES);
|
|
113
|
+
const clientDataBytes = fromB64url(signature.clientDataJSON, 1, MAX_CLIENT_DATA_BYTES);
|
|
114
|
+
const clientData = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(clientDataBytes));
|
|
115
|
+
if (!isRecord(clientData))
|
|
116
|
+
return false;
|
|
117
|
+
if (clientData.type !== 'webauthn.get')
|
|
118
|
+
return false;
|
|
119
|
+
if (typeof clientData.challenge !== 'string' || clientData.challenge !== b64url(challenge))
|
|
120
|
+
return false;
|
|
121
|
+
if (typeof clientData.origin !== 'string' || !origins.includes(clientData.origin))
|
|
122
|
+
return false;
|
|
123
|
+
if (clientData.crossOrigin !== undefined && clientData.crossOrigin !== false)
|
|
124
|
+
return false;
|
|
125
|
+
const rpIdHash = new Uint8Array(await crypto.subtle.digest('SHA-256', encoder.encode(rpId)));
|
|
126
|
+
if (!sameBytes(authenticatorData.subarray(0, 32), rpIdHash))
|
|
127
|
+
return false;
|
|
128
|
+
if ((authenticatorData[32] & FLAG_UP) === 0)
|
|
129
|
+
return false;
|
|
130
|
+
if ((authenticatorData[32] & FLAG_UV) === 0)
|
|
131
|
+
return false;
|
|
132
|
+
const point = fromB64url(publicKey, 65, 65);
|
|
133
|
+
if (point[0] !== 0x04)
|
|
134
|
+
return false;
|
|
135
|
+
const key = await crypto.subtle.importKey('raw', point, { name: 'ECDSA', namedCurve: 'P-256' }, false, ['verify']);
|
|
136
|
+
const raw = derToRawSignature(fromB64url(signature.signature, 8, MAX_DER_SIGNATURE_BYTES));
|
|
137
|
+
const clientDataHash = new Uint8Array(await crypto.subtle.digest('SHA-256', clientDataBytes));
|
|
138
|
+
const signed = new Uint8Array(authenticatorData.length + clientDataHash.length);
|
|
139
|
+
signed.set(authenticatorData, 0);
|
|
140
|
+
signed.set(clientDataHash, authenticatorData.length);
|
|
141
|
+
return await crypto.subtle.verify({ name: 'ECDSA', hash: 'SHA-256' }, key, raw, signed) === true;
|
|
142
|
+
}
|
|
143
|
+
catch {
|
|
144
|
+
return false;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
//# sourceMappingURL=webauthn.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"webauthn.js","sourceRoot":"","sources":["../../../src/security/ledger/webauthn.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,7 +5,6 @@
|
|
|
5
5
|
* Behavior/security rules: docs/investigations/2026-10-24-e2ee-contract.md.
|
|
6
6
|
* Types only. All implementation modules depend on this file, never vice versa.
|
|
7
7
|
*/
|
|
8
|
-
import type { AccountErrorCode, AccountHead } from './account-protocol.js';
|
|
9
8
|
/** Existing application JSON is intentionally open; domain handlers validate it. */
|
|
10
9
|
export type ApplicationJson = null | boolean | number | string | ApplicationJson[] | {
|
|
11
10
|
[key: string]: ApplicationJson;
|
|
@@ -81,7 +80,11 @@ export interface SecureCrypto {
|
|
|
81
80
|
parseSecureEnvelope(value: unknown): SecureEnvelope;
|
|
82
81
|
parseSecurePublication(value: unknown): SecurePublication;
|
|
83
82
|
}
|
|
84
|
-
export type SecurityErrorCode =
|
|
83
|
+
export type SecurityErrorCode =
|
|
84
|
+
/** Account mode (passkey ledger): a device the ledger revoked or no longer lists, this bridge revoked, or offline grace lapsed. */
|
|
85
|
+
'account_device_revoked' | 'account_bridge_revoked' | 'account_offline_expired' | 'security_setup_required' | 'secure_context_required' | 'storage_unavailable' | 'upgrade_required' | 'approval_required' | 'key_changed' | 'endpoint_revoked' | 'invalid_envelope' | 'authentication_failed' | 'wrong_context' | 'expired' | 'replayed' | 'epoch_changed' | 'permission_denied' | 'invitation_invalid' | 'invitation_expired' | 'invitation_consumed' | 'capacity_exceeded' | 'audit_unavailable' | 'outcome_unknown' | 'bridge_offline' | 'invalid_cursor' | 'key_unavailable'
|
|
86
|
+
/** Account mode: membership is the passkey ledger's; invitations and bridge-side removal of ledger devices are refused. */
|
|
87
|
+
| 'account_managed';
|
|
85
88
|
/** Implementations throw sanitized errors with these fields; never raw secrets. */
|
|
86
89
|
export interface SecurityFailure {
|
|
87
90
|
code: SecurityErrorCode;
|
|
@@ -202,15 +205,8 @@ export type SecurityCommand = {
|
|
|
202
205
|
type: 'security_revoke';
|
|
203
206
|
bridgeId: string;
|
|
204
207
|
endpointId: string;
|
|
205
|
-
} | {
|
|
206
|
-
type: 'security_account_adopt';
|
|
207
|
-
bridgeId: string;
|
|
208
|
-
head: AccountHead;
|
|
209
208
|
};
|
|
210
209
|
export interface SecurityCommandResults {
|
|
211
|
-
security_account_adopt: {
|
|
212
|
-
head: AccountHead;
|
|
213
|
-
};
|
|
214
210
|
security_devices: {
|
|
215
211
|
devices: ApprovedEndpoint[];
|
|
216
212
|
};
|
|
@@ -273,7 +269,6 @@ export interface BridgeSecurity {
|
|
|
273
269
|
createInvitation(actor: VerifiedPrincipal | LocalRecoveryAuthority, options: InvitationOptions): Promise<BridgeInvitation>;
|
|
274
270
|
listDevices(actor: VerifiedPrincipal): Promise<ApprovedEndpoint[]>;
|
|
275
271
|
revokeEndpoint(actor: VerifiedPrincipal, endpointId: string): Promise<void>;
|
|
276
|
-
adoptAccount(actor: VerifiedPrincipal, head: AccountHead): Promise<AccountHead>;
|
|
277
272
|
onRevoked(listener: (endpointId: string) => void): () => void;
|
|
278
273
|
close(): Promise<void>;
|
|
279
274
|
}
|
package/dist/security-cli.d.ts
CHANGED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
import { SecurityCommandError } from './cli-client.js';
|
|
1
2
|
import type { BridgeInvitation } from './security/protocol.js';
|
|
3
|
+
/** Printed instead of an invitation by an account bridge: its browsers come only from the passkey ledger (account_managed). */
|
|
4
|
+
export declare const ACCOUNT_MANAGED_INVITE_MESSAGE: string;
|
|
5
|
+
/** The line printed for a security command the bridge refused: its typed code, explained when known. */
|
|
6
|
+
export declare function securityRefusalMessage(error: SecurityCommandError): string;
|
|
2
7
|
export declare function invitationLink(invitation: BridgeInvitation, apiUrl?: string): string;
|
|
3
8
|
export declare function runSecurity(argv: string[]): Promise<number>;
|