@jskit-ai/auth-web 0.2.32 → 0.2.34
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/fixtures/sign-in/main.js +27 -1
- package/locales/en.json +51 -0
- package/package.json +42 -6
- package/patterns/auth-surface/PATTERN.md +10 -0
- package/src/client/browser.js +6 -0
- package/src/client/composables/secondFactor/useSecondFactorProof.js +79 -0
- package/src/client/composables/secondFactor/useSecondFactorSettings.js +122 -0
- package/src/client/composables/secondFactor/useSecondFactorStepUp.js +51 -0
- package/src/client/index.js +1 -0
- package/src/client/lib/qrCode.js +32 -0
- package/src/client/runtime/secondFactorRequests.js +56 -0
- package/src/client/types.js +32 -0
- package/src/client/views/SecondFactorDialog.vue +37 -0
- package/src/client/views/SecondFactorPrompt.vue +27 -0
- package/src/client/views/SecondFactorProofForm.vue +78 -0
- package/src/client/views/SecondFactorSettings.vue +212 -0
- package/src/server/AuthWebFeature.js +2 -0
- package/src/server/authRateLimits.js +9 -4
- package/src/server/authWeb.js +7 -5
- package/src/server/managedPreviewIdentity.js +78 -43
- package/src/server/routes/authRoutes.js +1 -1
- package/src/server/routes/secondFactorRoutes.js +134 -0
- package/src/server/types.js +6 -1
- package/test/managedPreviewIdentity.test.js +98 -1
- package/test/secondFactor.browser.test.js +219 -0
- package/test/secondFactorClient.test.js +140 -0
- package/test/secondFactorRoutes.test.js +152 -0
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
import assert from "node:assert/strict";
|
|
2
|
+
import fs from "node:fs/promises";
|
|
3
|
+
import os from "node:os";
|
|
4
|
+
import path from "node:path";
|
|
5
|
+
import test from "node:test";
|
|
6
|
+
import Fastify from "fastify";
|
|
7
|
+
import { AuthExtensionsProvider } from "@jskit-ai/auth-core/server/providers/AuthExtensionsProvider";
|
|
8
|
+
import { AuthFeature } from "@jskit-ai/auth-core/server/providers/AuthFeature";
|
|
9
|
+
import { AuthPolicyProvider } from "@jskit-ai/auth-core/server/providers/AuthPolicyProvider";
|
|
10
|
+
import { ActionProvider } from "@jskit-ai/kernel/server/actions";
|
|
11
|
+
import { HttpProvider } from "@jskit-ai/kernel/server/http";
|
|
12
|
+
import { EventProvider } from "@jskit-ai/kernel/server/runtime";
|
|
13
|
+
import { silentLogger } from "@jskit-ai/kernel/server/runtime/logger";
|
|
14
|
+
import { createCapabilityRuntime, defineProvider } from "@jskit-ai/kernel/shared/capabilities";
|
|
15
|
+
import { createLocalAuthService, createLocalFileBackend } from "../../auth-provider-local-core/src/server/lib/index.js";
|
|
16
|
+
import { sessionCookies } from "../../auth-provider-local-core/test-support/oauthHarness.js";
|
|
17
|
+
import {
|
|
18
|
+
SCENARIO_START,
|
|
19
|
+
codeAt,
|
|
20
|
+
secondFactorServiceOptions
|
|
21
|
+
} from "../../auth-provider-local-core/test-support/secondFactorScenario.js";
|
|
22
|
+
import { AuthWebFeature } from "../src/server/AuthWebFeature.js";
|
|
23
|
+
import { DEFAULT_AUTH_RATE_LIMITS } from "../src/server/authRateLimits.js";
|
|
24
|
+
|
|
25
|
+
const PASSWORD = "correct horse battery staple";
|
|
26
|
+
|
|
27
|
+
// An application's console: a page that asks for the session's second factor, and a dangerous action that asks for a
|
|
28
|
+
// code proved within five minutes.
|
|
29
|
+
const ConsoleRoutes = defineProvider({
|
|
30
|
+
id: "test.console.routes",
|
|
31
|
+
requires: { http: "runtime.http" },
|
|
32
|
+
setup({ http }) {
|
|
33
|
+
http.router.register("GET", "/api/console", { auth: "required", secondFactor: true }, async (request, reply) => {
|
|
34
|
+
reply.send({ page: "console" });
|
|
35
|
+
});
|
|
36
|
+
http.router.register("POST", "/api/console/refund", { auth: "required", secondFactor: { maxAgeSeconds: 300 } },
|
|
37
|
+
async (request, reply) => {
|
|
38
|
+
reply.send({ refunded: true });
|
|
39
|
+
});
|
|
40
|
+
return {};
|
|
41
|
+
}
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
/** The auth routes, the auth policy and the console over local auth in a store of the test's own. */
|
|
45
|
+
async function startConsole(t) {
|
|
46
|
+
const storeDir = await fs.mkdtemp(path.join(os.tmpdir(), "jskit-auth-web-second-factor-"));
|
|
47
|
+
t.after(() => fs.rm(storeDir, { recursive: true, force: true }));
|
|
48
|
+
const authService = createLocalAuthService({
|
|
49
|
+
...secondFactorServiceOptions().options,
|
|
50
|
+
backend: createLocalFileBackend({ storeDir })
|
|
51
|
+
});
|
|
52
|
+
const app = Fastify();
|
|
53
|
+
const runtime = createCapabilityRuntime({
|
|
54
|
+
inputs: {
|
|
55
|
+
"auth.service": authService,
|
|
56
|
+
"runtime.config": {},
|
|
57
|
+
"runtime.env": { NODE_ENV: "test" },
|
|
58
|
+
"runtime.fastify": app,
|
|
59
|
+
"runtime.logger": silentLogger
|
|
60
|
+
},
|
|
61
|
+
providers: [EventProvider, ActionProvider, HttpProvider, AuthExtensionsProvider, AuthFeature, AuthPolicyProvider, AuthWebFeature,
|
|
62
|
+
ConsoleRoutes]
|
|
63
|
+
});
|
|
64
|
+
await runtime.start();
|
|
65
|
+
t.after(async () => {
|
|
66
|
+
await runtime.shutdown();
|
|
67
|
+
await app.close();
|
|
68
|
+
});
|
|
69
|
+
return { app, authService };
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** A signed-in browser: its cookies and CSRF token, sending each request from one address. */
|
|
73
|
+
async function signedInBrowser(app, authService, email) {
|
|
74
|
+
await authService.register({ email, password: PASSWORD });
|
|
75
|
+
const cookies = sessionCookies((await authService.login({ email, password: PASSWORD })).session);
|
|
76
|
+
const session = await app.inject({ method: "GET", url: "/api/session", cookies });
|
|
77
|
+
for (const cookie of session.cookies) {
|
|
78
|
+
cookies[cookie.name] = cookie.value;
|
|
79
|
+
}
|
|
80
|
+
const csrfToken = session.json().csrfToken;
|
|
81
|
+
return (method, url, payload) => app.inject({
|
|
82
|
+
method,
|
|
83
|
+
url,
|
|
84
|
+
cookies,
|
|
85
|
+
remoteAddress: "203.0.113.7",
|
|
86
|
+
headers: { "csrf-token": csrfToken },
|
|
87
|
+
...(payload === undefined ? {} : { payload })
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function refusedFor(response, status, code) {
|
|
92
|
+
assert.equal(response.statusCode, status, response.body);
|
|
93
|
+
assert.equal(response.json().code, code);
|
|
94
|
+
return response.json();
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
test("a console asks for the session's second factor, and its dangerous action for one proved within five minutes", async (t) => {
|
|
98
|
+
t.mock.timers.enable({ apis: ["Date"], now: SCENARIO_START });
|
|
99
|
+
const { app, authService } = await startConsole(t);
|
|
100
|
+
const ada = await signedInBrowser(app, authService, "ada@example.com");
|
|
101
|
+
|
|
102
|
+
// A signed-in session without a second factor is refused, saying what the route asks for.
|
|
103
|
+
assert.deepEqual(refusedFor(await ada("GET", "/api/console"), 403, "auth.secondFactor.required").params, {});
|
|
104
|
+
assert.deepEqual(refusedFor(await ada("POST", "/api/console/refund"), 403, "auth.secondFactor.required").params, {
|
|
105
|
+
maxAgeSeconds: 300
|
|
106
|
+
});
|
|
107
|
+
refusedFor(await app.inject({ method: "GET", url: "/api/console" }), 401, "auth.session.required");
|
|
108
|
+
|
|
109
|
+
// Setting up the authenticator proves this session's second factor.
|
|
110
|
+
assert.deepEqual((await ada("GET", "/api/second-factor")).json(), { enrolled: false, enrolledAt: null, recoveryCodesLeft: 0, verifiedAt: null });
|
|
111
|
+
const setup = await ada("POST", "/api/second-factor/setup");
|
|
112
|
+
assert.equal(setup.statusCode, 200, setup.body);
|
|
113
|
+
const { secret } = setup.json();
|
|
114
|
+
refusedFor(await ada("POST", "/api/second-factor/setup/confirm", {}), 400, "validation_failed");
|
|
115
|
+
const confirmed = await ada("POST", "/api/second-factor/setup/confirm", { code: codeAt(secret) });
|
|
116
|
+
assert.equal(confirmed.statusCode, 200, confirmed.body);
|
|
117
|
+
assert.equal(confirmed.json().recoveryCodes.length, 10);
|
|
118
|
+
assert.deepEqual((await ada("GET", "/api/console")).json(), { page: "console" });
|
|
119
|
+
assert.deepEqual((await ada("POST", "/api/console/refund")).json(), { refunded: true });
|
|
120
|
+
|
|
121
|
+
// Six minutes on, the console still opens but the refund asks for a fresh code.
|
|
122
|
+
t.mock.timers.tick(6 * 60_000);
|
|
123
|
+
assert.equal((await ada("GET", "/api/console")).statusCode, 200);
|
|
124
|
+
refusedFor(await ada("POST", "/api/console/refund"), 403, "auth.secondFactor.required");
|
|
125
|
+
refusedFor(await ada("POST", "/api/second-factor/verify", { code: codeAt(secret, -2) }), 400, "auth.local.secondFactor.codeInvalid");
|
|
126
|
+
const verified = await ada("POST", "/api/second-factor/verify", { code: codeAt(secret) });
|
|
127
|
+
assert.deepEqual(verified.json(), { verifiedAt: new Date().toISOString(), method: "code", recoveryCodesLeft: 10 });
|
|
128
|
+
assert.deepEqual((await ada("POST", "/api/console/refund")).json(), { refunded: true });
|
|
129
|
+
|
|
130
|
+
// Another signed-in person proves nothing for Ada's session, and Ada's proof opens nothing for them.
|
|
131
|
+
const bob = await signedInBrowser(app, authService, "bob@example.com");
|
|
132
|
+
refusedFor(await bob("GET", "/api/console"), 403, "auth.secondFactor.required");
|
|
133
|
+
refusedFor(await bob("POST", "/api/second-factor/verify", { code: codeAt(secret) }), 409, "auth.local.secondFactor.notSetUp");
|
|
134
|
+
|
|
135
|
+
// Removing it takes a proof, and afterwards the console asks again.
|
|
136
|
+
t.mock.timers.tick(30_000);
|
|
137
|
+
refusedFor(await ada("DELETE", "/api/second-factor", {}), 400, "auth.local.secondFactor.proofRequired");
|
|
138
|
+
assert.deepEqual((await ada("DELETE", "/api/second-factor", { code: codeAt(secret) })).json(), { ok: true });
|
|
139
|
+
refusedFor(await ada("GET", "/api/console"), 403, "auth.secondFactor.required");
|
|
140
|
+
});
|
|
141
|
+
|
|
142
|
+
test("one address may try codes only as fast as the verify route's limit", async (t) => {
|
|
143
|
+
const { app, authService } = await startConsole(t);
|
|
144
|
+
const ada = await signedInBrowser(app, authService, "ada@example.com");
|
|
145
|
+
const statuses = [];
|
|
146
|
+
for (let attempt = 0; attempt < 15; attempt += 1) {
|
|
147
|
+
statuses.push((await ada("POST", "/api/second-factor/verify", { code: "123456" })).statusCode);
|
|
148
|
+
}
|
|
149
|
+
const allowed = DEFAULT_AUTH_RATE_LIMITS.secondFactorVerify.max;
|
|
150
|
+
assert.deepEqual(statuses.slice(0, allowed), Array(allowed).fill(409), "Ada has no authenticator to check");
|
|
151
|
+
assert.deepEqual(statuses.slice(allowed), Array(15 - allowed).fill(429));
|
|
152
|
+
});
|