@mostra/runtime 0.10.0 → 0.12.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/bin.js +4178 -310
- package/dist/bin.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{instance-FExcyENK.js → instance-CBUlOmzG.js} +1892 -85
- package/dist/instance-CBUlOmzG.js.map +1 -0
- package/dist/reference/cli.md +1432 -0
- package/dist/reference/diagnostics.json +1579 -0
- package/dist/reference/errors/MOSTRA_A11Y_MINOR.md +23 -0
- package/dist/reference/errors/MOSTRA_A11Y_SERIOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_CANCELLED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EVENT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_EXPORT_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_INTERRUPTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_RUN_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_THREW.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNKNOWN_FUNCTION.md +23 -0
- package/dist/reference/errors/MOSTRA_ACTION_UNSERIALIZABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_DIR_NOT_EMPTY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ENTRY_AMBIGUOUS.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_ID_DROPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_ENTRY.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_NO_PAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATCH_REJECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_PATH_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_SOURCE_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_TEMPLATE_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_COLLECTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ARTIFACT_VERSION_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_BUILD_UNRESOLVED.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_CONFIG_UNWRITABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_UNKNOWN_COMMAND.md +23 -0
- package/dist/reference/errors/MOSTRA_CLI_USAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_CONSOLE_WARNING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_INSTALL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_SPEC_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_DEP_WARM_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BIND_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BROWSER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_DOWNLOAD_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_BUNDLE_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_HELPER_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_NODE_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_PORT_TAKEN.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_INSTALLING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_RUNTIME_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SERVICE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_SHELL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_ENV_WARM_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_DUPLICATE_ID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_ID_UNSTABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_MUTATION_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_SHARED.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_FIELD_UNBOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_DISK_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GC_INCOMPLETE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_GONE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_INTEGRITY.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LEDGER_UNREADABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_LOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_MISMATCH.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NETWORK_FILESYSTEM.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_ALWAYS_ON.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_NOT_OWNED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_SOCKET_TOO_LONG.md +23 -0
- package/dist/reference/errors/MOSTRA_HOME_TOO_NEW.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CONNECTION_CLOSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_CURSOR_COMPACTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_IDENTITY_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INITIALIZE_ORDER.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INTERNAL_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_INVALID_PARAMS.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_MESSAGE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_METHOD_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_NOTIFICATION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_PORT_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REQUEST_ID_REUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_REVISION_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SHUTDOWN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_SUBSCRIPTION_UNKNOWN.md +23 -0
- package/dist/reference/errors/MOSTRA_HOST_TIMEOUT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CONTENT_TYPE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_CSRF_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_FRAME_SESSION.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HEADERS_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_HOST_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_NOT_SERVED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_ORIGIN_REFUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_REQUEST_MALFORMED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SCOPE_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_SESSION_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_HYGIENE_TOKEN_REVOKED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_SOURCE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_LIVE_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_NOT_LITERAL.md +23 -0
- package/dist/reference/errors/MOSTRA_MANIFEST_UNKNOWN_KEY.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_EXTERNAL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_NETWORK_REQUEST_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_PLATFORM_UNSUPPORTED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_ID_CONFLICT.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_SOURCE_CHANGED.md +23 -0
- package/dist/reference/errors/MOSTRA_PUBLISH_VERIFY_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ACTION_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_ARIA.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_FIELD_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_LIVE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PAGE_REMOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_REGRESSION_PIXELS.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_CONFIG_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_MOVING.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_HOME_SUSPENDED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LIMIT_REACHED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_LOGIN_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NOT_OWNER_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_NO_INSTANCE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OPERATOR_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_OWNER_OFFLINE.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_PAUSED_BY_OPERATOR.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_QUEUE_FULL.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_SIGN_IN_REQUIRED.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNDER_REVIEW.md +23 -0
- package/dist/reference/errors/MOSTRA_REMOTE_UNREACHABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_BLANK.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_PAGE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_RUNTIME_WORKER_PARKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_ENABLED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_PORTS_EXHAUSTED.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TOOL_NOT_READY.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TTL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SHARE_TUNNEL_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_BUDGET.md +23 -0
- package/dist/reference/errors/MOSTRA_SMOKE_NO_EFFECT.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_ALREADY.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_BLOCKED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_CHANNEL_DENIED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_NOT_FOUND.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_PAUSED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_POLICY_NONE.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_REVISION_MOVED.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_SIGNAL_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_SUBMIT_VIEW_INVALID.md +23 -0
- package/dist/reference/errors/MOSTRA_TARGET_UNAVAILABLE.md +23 -0
- package/dist/reference/errors/MOSTRA_TEAM_PRESENCE_RATE_LIMITED.md +23 -0
- package/dist/reference/errors/MOSTRA_TEAM_ROSTER_POLICY.md +23 -0
- package/dist/reference/errors/MOSTRA_TEAM_ROSTER_TOO_LARGE.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_ERROR.md +23 -0
- package/dist/reference/errors/MOSTRA_TYPE_UNTYPED_PACKAGE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_ACTION_SKIPPED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_BASELINE_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_CRASHED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_LIVE_FAILED.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_NO_BASELINE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SECRET_MISSING.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_SKIP_CONSEQUENCE.md +23 -0
- package/dist/reference/errors/MOSTRA_VERIFY_TIMEOUT.md +23 -0
- package/dist/reference/self-hosting.md +130 -0
- package/dist/reference/telemetry.md +84 -0
- package/dist/skill/SKILL.md +124 -0
- package/dist/skill/assets/examples/dashboard/index.tsx +161 -0
- package/dist/skill/assets/examples/dashboard/live.ts +25 -0
- package/dist/skill/assets/examples/dashboard/styles.css +125 -0
- package/dist/skill/assets/examples/decision/index.tsx +95 -0
- package/dist/skill/assets/examples/decision/styles.css +125 -0
- package/dist/skill/assets/examples/inbox/actions.ts +23 -0
- package/dist/skill/assets/examples/inbox/index.tsx +109 -0
- package/dist/skill/assets/examples/inbox/styles.css +125 -0
- package/dist/skill/assets/studio.css +125 -0
- package/dist/skill/references/answers.md +219 -0
- package/dist/skill/references/design.md +154 -0
- package/dist/skill/references/libraries.md +167 -0
- package/dist/skill/references/long-lived.md +148 -0
- package/dist/skill/references/mcp.md +68 -0
- package/dist/skill/references/page.md +131 -0
- package/dist/skill/references/server.md +146 -0
- package/dist/skill/references/sharing.md +123 -0
- package/dist/skill/references/teams.md +78 -0
- package/dist/skill/references/verify.md +71 -0
- package/package.json +10 -5
- package/src/gateway/actions.ts +20 -0
- package/src/gateway/browser.ts +128 -1
- package/src/gateway/capabilities.ts +8 -0
- package/src/gateway/http.ts +12 -1
- package/src/gateway/index.ts +210 -6
- package/src/gateway/listener.ts +31 -6
- package/src/gateway/routes.ts +8 -0
- package/src/gateway/team.ts +181 -0
- package/src/gc/index.ts +5 -0
- package/src/instance/index.ts +22 -2
- package/src/interaction/ephemeral.ts +21 -0
- package/src/interaction/events.ts +17 -0
- package/src/interaction/index.ts +325 -20
- package/src/interaction/pause.ts +106 -0
- package/src/interaction/roster.ts +585 -0
- package/src/interaction/submissions.ts +42 -1
- package/src/interaction/team.ts +426 -0
- package/src/interaction/viewers.ts +34 -1
- package/src/interaction/wait.ts +150 -0
- package/src/ledger/index.ts +20 -1
- package/src/ledger/migrations.ts +86 -0
- package/src/link/author.ts +215 -0
- package/src/link/hosted.ts +51 -4
- package/src/link/http.ts +6 -1
- package/src/link/index.ts +3 -1
- package/src/link/manager.ts +169 -35
- package/src/protocol-server/client.ts +53 -0
- package/src/protocol-server/index.ts +1 -1
- package/src/server/api.ts +514 -72
- package/src/server/auth.ts +600 -74
- package/src/server/authorize.ts +816 -0
- package/src/server/clients.ts +235 -0
- package/src/server/config.ts +7 -0
- package/src/server/data.ts +59 -1
- package/src/server/directory.ts +91 -0
- package/src/server/feed.ts +277 -0
- package/src/server/handle.ts +172 -0
- package/src/server/hosted-pages.ts +532 -0
- package/src/server/hosted.ts +551 -18
- package/src/server/index.ts +353 -61
- package/src/server/mcp.ts +330 -0
- package/src/server/metering.ts +156 -0
- package/src/server/oauth-clients.ts +510 -0
- package/src/server/operator.ts +557 -0
- package/src/server/providers.ts +284 -0
- package/src/server/remove.ts +148 -0
- package/src/server/routing.ts +275 -0
- package/src/share/index.ts +50 -2
- package/src/verify/index.ts +7 -0
- package/src/verify/runner.ts +27 -2
- package/dist/instance-FExcyENK.js.map +0 -1
|
@@ -0,0 +1,816 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The authorization server's pages on the API origin (INTERFACES §18.5, D165 items 8, 10):
|
|
3
|
+
*
|
|
4
|
+
* - `GET /oauth/authorize`: the authorization code flow with PKCE (S256) for MCP clients (Client
|
|
5
|
+
* ID Metadata Documents, registered clients) and for each hosted shell's viewer sign-in. The
|
|
6
|
+
* client and its redirect URI are checked before anything is redirected anywhere; an `iss`
|
|
7
|
+
* parameter goes with every answer (RFC 9207).
|
|
8
|
+
* - Sign-in through an identity provider (`/signin/<id>/start`, its `callback`), into a browser
|
|
9
|
+
* session on the API origin only, never the user-content domain; the operator's first sign-in
|
|
10
|
+
* steps (`/signin/return`).
|
|
11
|
+
* - The server's own consent page (`/oauth/consent`), for every client an account hasn't
|
|
12
|
+
* approved, never skipped because a provider skipped its own; for a page's sign-in it names
|
|
13
|
+
* the page's sender instead, once per account and home.
|
|
14
|
+
*
|
|
15
|
+
* Every in-progress record (an authorization request, a provider sign-in, a first sign-in step)
|
|
16
|
+
* is kept only as the SHA-256 of its handle, lives minutes, is used once, and is bound to the
|
|
17
|
+
* browser that started it by a cookie of the API origin.
|
|
18
|
+
*/
|
|
19
|
+
import { createHash, randomBytes } from "node:crypto";
|
|
20
|
+
import type { IncomingMessage, ServerResponse } from "node:http";
|
|
21
|
+
import {
|
|
22
|
+
type IdentityProvider,
|
|
23
|
+
type SignInIdentity,
|
|
24
|
+
SignInIdentity as SignInIdentitySchema,
|
|
25
|
+
} from "@mostra/protocol/operator";
|
|
26
|
+
import type { Ledger } from "../ledger/index.ts";
|
|
27
|
+
import type { Log } from "../log.ts";
|
|
28
|
+
import { type Authorization, canonicalResource, hashSecret } from "./auth.ts";
|
|
29
|
+
import { type Clients, type OAuthClient, redirectAllowed } from "./oauth-clients.ts";
|
|
30
|
+
import type { Operator } from "./operator.ts";
|
|
31
|
+
|
|
32
|
+
/** How long an authorization request, a provider sign-in or a step waits. */
|
|
33
|
+
const PENDING_MS = 15 * 60_000;
|
|
34
|
+
/** How long a browser stays signed in to the API origin. */
|
|
35
|
+
const SESSION_MS = 7 * 24 * 60 * 60_000;
|
|
36
|
+
/** At most this many first sign-in steps per sign-in (D167). */
|
|
37
|
+
const MAX_STEPS = 3;
|
|
38
|
+
/**
|
|
39
|
+
* How long an identity provider's own calls may take (its authorization address, the code's
|
|
40
|
+
* exchange): inside the 10 s every endpoint of the authorization server answers in (D165 item 10),
|
|
41
|
+
* whether the provider is built in or the operator's.
|
|
42
|
+
*/
|
|
43
|
+
const PROVIDER_MS = 8_000;
|
|
44
|
+
|
|
45
|
+
/** A provider's call, or a refusal once it took longer than {@link PROVIDER_MS}. */
|
|
46
|
+
async function bounded<T>(call: () => Promise<T> | T, what: string): Promise<T> {
|
|
47
|
+
let timer: ReturnType<typeof setTimeout> | undefined;
|
|
48
|
+
try {
|
|
49
|
+
return await Promise.race([
|
|
50
|
+
Promise.resolve().then(call),
|
|
51
|
+
new Promise<never>((_, reject) => {
|
|
52
|
+
timer = setTimeout(() => reject(new Error(`${what} took too long`)), PROVIDER_MS);
|
|
53
|
+
}),
|
|
54
|
+
]);
|
|
55
|
+
} finally {
|
|
56
|
+
clearTimeout(timer);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** What the pages need. */
|
|
61
|
+
export interface AuthorizeOptions {
|
|
62
|
+
readonly apiOrigin: string;
|
|
63
|
+
readonly directory: Ledger;
|
|
64
|
+
readonly auth: Authorization;
|
|
65
|
+
readonly clients: Clients;
|
|
66
|
+
readonly operator: Operator;
|
|
67
|
+
/** The built-in providers (configuration); the operator's join them at each sign-in. */
|
|
68
|
+
readonly providers: readonly IdentityProvider[];
|
|
69
|
+
/** Names a hosted home's owner, for a page's sign-in ("Grace Hopper's page"). */
|
|
70
|
+
readonly ownerName: (homeId: string) => string | undefined;
|
|
71
|
+
readonly log: Log;
|
|
72
|
+
readonly now?: () => number;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** A page's sign-in in progress (INTERFACES §18.4), bound to its route and shell session. */
|
|
76
|
+
export interface ViewerSignin {
|
|
77
|
+
readonly homeId: string;
|
|
78
|
+
readonly routeId: string;
|
|
79
|
+
readonly sessionId: string;
|
|
80
|
+
readonly shellOrigin: string;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** The pages. */
|
|
84
|
+
export interface Authorize {
|
|
85
|
+
/** Serves a request of the API origin when it is one of these pages; `false` otherwise. */
|
|
86
|
+
handle(request: IncomingMessage, response: ServerResponse, path: string): Promise<boolean>;
|
|
87
|
+
/**
|
|
88
|
+
* Starts a page's sign-in from its shell (a click in the trusted chrome): the address the shell
|
|
89
|
+
* sends the person to, with `state` bound to the route and the shell session.
|
|
90
|
+
*/
|
|
91
|
+
startViewerSignin(
|
|
92
|
+
signin: ViewerSignin,
|
|
93
|
+
challenge: string,
|
|
94
|
+
): { readonly url: string; readonly state: string };
|
|
95
|
+
/** Finishes a page's sign-in: the code, for the same route and session only. */
|
|
96
|
+
finishViewerSignin(input: {
|
|
97
|
+
readonly state: string;
|
|
98
|
+
readonly code: string;
|
|
99
|
+
readonly verifier: string;
|
|
100
|
+
readonly routeId: string;
|
|
101
|
+
readonly sessionId: string;
|
|
102
|
+
}):
|
|
103
|
+
| { readonly accountId: string; readonly name?: string; readonly provider?: string }
|
|
104
|
+
| { readonly refused: string };
|
|
105
|
+
/** The browser session's account of a request to the API origin, if signed in. */
|
|
106
|
+
sessionAccount(
|
|
107
|
+
request: IncomingMessage,
|
|
108
|
+
): { readonly accountId: string; readonly hash: string } | undefined;
|
|
109
|
+
/** A CSRF token for a signed-in browser's form. */
|
|
110
|
+
csrf(sessionHash: string, purpose: string): string;
|
|
111
|
+
/** The providers a sign-in may use now: configured ones, then the operator's. */
|
|
112
|
+
providers(): Promise<readonly { readonly id: string; readonly label: string }[]>;
|
|
113
|
+
/** Starts a sign-in whose end continues at a page of the API origin (the device page). */
|
|
114
|
+
signInPage(response: ServerResponse, next: string, message?: string): Promise<void>;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
const BASE = {
|
|
118
|
+
"cache-control": "no-store",
|
|
119
|
+
"cross-origin-resource-policy": "same-origin",
|
|
120
|
+
"x-content-type-options": "nosniff",
|
|
121
|
+
"x-frame-options": "DENY",
|
|
122
|
+
} as const;
|
|
123
|
+
|
|
124
|
+
function escapeHtml(text: string): string {
|
|
125
|
+
return text.replace(/[&<>"']/g, (character) => `&#${character.charCodeAt(0)};`);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
function shell(title: string, body: string): string {
|
|
129
|
+
return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="robots" content="noindex">
|
|
130
|
+
<meta name="viewport" content="width=device-width, initial-scale=1"><title>${escapeHtml(title)}</title>
|
|
131
|
+
<style>body{font:16px/1.5 system-ui,sans-serif;max-width:34rem;margin:3rem auto;padding:0 1rem}
|
|
132
|
+
input{font:inherit;padding:.3rem}button,a.button{font:inherit;padding:.4rem .9rem;margin:.2rem .5rem .2rem 0;display:inline-block}
|
|
133
|
+
.muted{color:#555}</style></head><body><h1>${escapeHtml(title)}</h1>${body}</body></html>`;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** Builds the pages. */
|
|
137
|
+
export function createAuthorize(options: AuthorizeOptions): Authorize {
|
|
138
|
+
const { apiOrigin, directory, auth, clients, operator, log } = options;
|
|
139
|
+
const now = options.now ?? (() => Date.now());
|
|
140
|
+
const secure = apiOrigin.startsWith("https:");
|
|
141
|
+
const sessionCookie = secure ? "__Host-mostra-signin" : "mostra-signin";
|
|
142
|
+
const flowCookie = secure ? "__Host-mostra-flow" : "mostra-flow";
|
|
143
|
+
const iso = (ms: number) => new Date(ms).toISOString();
|
|
144
|
+
const token = () => randomBytes(32).toString("base64url");
|
|
145
|
+
|
|
146
|
+
const cookies = (request: IncomingMessage): Map<string, string> => {
|
|
147
|
+
const found = new Map<string, string>();
|
|
148
|
+
for (const part of (request.headers.cookie ?? "").split(";")) {
|
|
149
|
+
const at = part.indexOf("=");
|
|
150
|
+
if (at <= 0) continue;
|
|
151
|
+
const name = part.slice(0, at).trim();
|
|
152
|
+
// A repeated name is ambiguous: the first is kept, as browsers send the most specific first.
|
|
153
|
+
if (!found.has(name)) found.set(name, part.slice(at + 1).trim());
|
|
154
|
+
}
|
|
155
|
+
return found;
|
|
156
|
+
};
|
|
157
|
+
const setCookie = (name: string, value: string, maxAgeS: number): string =>
|
|
158
|
+
`${name}=${value}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${maxAgeS}${secure ? "; Secure" : ""}`;
|
|
159
|
+
|
|
160
|
+
const send = (
|
|
161
|
+
response: ServerResponse,
|
|
162
|
+
status: number,
|
|
163
|
+
html: string,
|
|
164
|
+
extra: Record<string, string | string[]> = {},
|
|
165
|
+
formTargets: readonly string[] = [],
|
|
166
|
+
): void => {
|
|
167
|
+
response.writeHead(status, {
|
|
168
|
+
...BASE,
|
|
169
|
+
"content-type": "text/html; charset=utf-8",
|
|
170
|
+
// A form posts here, and its answer may redirect to a client: those origins only.
|
|
171
|
+
"content-security-policy": `default-src 'none'; style-src 'unsafe-inline'; form-action 'self' ${formTargets.join(" ")}; frame-ancestors 'none'; base-uri 'none'`,
|
|
172
|
+
// A form's POST must carry this page's Origin (D166 item 10).
|
|
173
|
+
"referrer-policy": "same-origin",
|
|
174
|
+
...extra,
|
|
175
|
+
});
|
|
176
|
+
response.end(html);
|
|
177
|
+
};
|
|
178
|
+
const redirect = (
|
|
179
|
+
response: ServerResponse,
|
|
180
|
+
location: string,
|
|
181
|
+
extra: Record<string, string | string[]> = {},
|
|
182
|
+
): void => {
|
|
183
|
+
response.writeHead(303, { ...BASE, location, "referrer-policy": "no-referrer", ...extra });
|
|
184
|
+
response.end();
|
|
185
|
+
};
|
|
186
|
+
const problem = (response: ServerResponse, status: number, message: string): void =>
|
|
187
|
+
send(
|
|
188
|
+
response,
|
|
189
|
+
status,
|
|
190
|
+
shell("Sign-in can't continue", `<p role="alert">${escapeHtml(message)}</p>`),
|
|
191
|
+
);
|
|
192
|
+
|
|
193
|
+
// ── in-progress records ─────────────────────────────────────────────────────────────────
|
|
194
|
+
|
|
195
|
+
const keep = (kind: "provider" | "step" | "authorize", handle: string, data: unknown): void =>
|
|
196
|
+
directory.write((db) => {
|
|
197
|
+
db.run("DELETE FROM signin WHERE expires_at < ?", iso(now()));
|
|
198
|
+
db.run(
|
|
199
|
+
"INSERT INTO signin (hash, kind, data_json, expires_at) VALUES (?, ?, ?, ?)",
|
|
200
|
+
hashSecret(handle),
|
|
201
|
+
kind,
|
|
202
|
+
JSON.stringify(data),
|
|
203
|
+
iso(now() + PENDING_MS),
|
|
204
|
+
);
|
|
205
|
+
});
|
|
206
|
+
const read = <T>(kind: "provider" | "step" | "authorize", handle: string): T | undefined =>
|
|
207
|
+
directory.read((db) => {
|
|
208
|
+
const row = db.get<{ data_json: string; expires_at: string }>(
|
|
209
|
+
"SELECT data_json, expires_at FROM signin WHERE hash = ? AND kind = ?",
|
|
210
|
+
hashSecret(handle),
|
|
211
|
+
kind,
|
|
212
|
+
);
|
|
213
|
+
return row && Date.parse(row.expires_at) > now()
|
|
214
|
+
? (JSON.parse(row.data_json) as T)
|
|
215
|
+
: undefined;
|
|
216
|
+
});
|
|
217
|
+
const spend = (handle: string): boolean =>
|
|
218
|
+
directory.write(
|
|
219
|
+
(db) => db.run("DELETE FROM signin WHERE hash = ?", hashSecret(handle)).changes > 0,
|
|
220
|
+
);
|
|
221
|
+
|
|
222
|
+
// ── browser sessions ────────────────────────────────────────────────────────────────────
|
|
223
|
+
|
|
224
|
+
const sessionAccount = (request: IncomingMessage) => {
|
|
225
|
+
const value = cookies(request).get(sessionCookie);
|
|
226
|
+
if (value === undefined || !/^[A-Za-z0-9_-]{43}$/.test(value)) return undefined;
|
|
227
|
+
const hash = hashSecret(value);
|
|
228
|
+
const row = directory.read((db) =>
|
|
229
|
+
db.get<{ account_id: string; expires_at: string; status: string }>(
|
|
230
|
+
`SELECT s.account_id, s.expires_at, a.status FROM browser_session s
|
|
231
|
+
JOIN account a ON a.id = s.account_id WHERE s.hash = ?`,
|
|
232
|
+
hash,
|
|
233
|
+
),
|
|
234
|
+
);
|
|
235
|
+
if (!row || Date.parse(row.expires_at) <= now() || row.status !== "active") return undefined;
|
|
236
|
+
return { accountId: row.account_id, hash };
|
|
237
|
+
};
|
|
238
|
+
const startSession = (accountId: string): string => {
|
|
239
|
+
const value = token();
|
|
240
|
+
directory.write((db) =>
|
|
241
|
+
db.run(
|
|
242
|
+
"INSERT INTO browser_session (hash, account_id, created_at, expires_at) VALUES (?, ?, ?, ?)",
|
|
243
|
+
hashSecret(value),
|
|
244
|
+
accountId,
|
|
245
|
+
iso(now()),
|
|
246
|
+
iso(now() + SESSION_MS),
|
|
247
|
+
),
|
|
248
|
+
);
|
|
249
|
+
return setCookie(sessionCookie, value, Math.floor(SESSION_MS / 1000));
|
|
250
|
+
};
|
|
251
|
+
const csrf = (sessionHash: string, purpose: string): string =>
|
|
252
|
+
createHash("sha256").update(`mostra csrf ${sessionHash} ${purpose}`).digest("base64url");
|
|
253
|
+
|
|
254
|
+
// ── providers ───────────────────────────────────────────────────────────────────────────
|
|
255
|
+
|
|
256
|
+
/** The providers now: configured ones, then the operator's (asked each time, D167). */
|
|
257
|
+
const providers = async (): Promise<IdentityProvider[]> => {
|
|
258
|
+
const supplied = await operator.providers();
|
|
259
|
+
const ids = new Set(options.providers.map((provider) => provider.id));
|
|
260
|
+
return [...options.providers, ...supplied.filter((provider) => !ids.has(provider.id))];
|
|
261
|
+
};
|
|
262
|
+
|
|
263
|
+
interface ProviderRecord {
|
|
264
|
+
readonly provider: string;
|
|
265
|
+
readonly verifier: string;
|
|
266
|
+
readonly challenge: string;
|
|
267
|
+
readonly nonce: string;
|
|
268
|
+
readonly flow: string;
|
|
269
|
+
readonly next: string;
|
|
270
|
+
}
|
|
271
|
+
interface StepRecord {
|
|
272
|
+
readonly identity: SignInIdentity;
|
|
273
|
+
readonly steps: number;
|
|
274
|
+
readonly flow: string;
|
|
275
|
+
readonly next: string;
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/** The page listing the providers; each starts a sign-in that returns to `next`. */
|
|
279
|
+
const signInPage = async (
|
|
280
|
+
response: ServerResponse,
|
|
281
|
+
next: string,
|
|
282
|
+
message?: string,
|
|
283
|
+
): Promise<void> => {
|
|
284
|
+
const list = await providers();
|
|
285
|
+
const links = list
|
|
286
|
+
.map(
|
|
287
|
+
(provider) =>
|
|
288
|
+
`<p><a class="button" href="/signin/${encodeURIComponent(provider.id)}/start?next=${encodeURIComponent(next)}">Continue with ${escapeHtml(provider.label)}</a></p>`,
|
|
289
|
+
)
|
|
290
|
+
.join("");
|
|
291
|
+
send(
|
|
292
|
+
response,
|
|
293
|
+
200,
|
|
294
|
+
shell(
|
|
295
|
+
"Sign in to Mostra",
|
|
296
|
+
`${message ? `<p role="alert">${escapeHtml(message)}</p>` : ""}${links || "<p>This server has no identity provider configured, so nobody can sign in yet.</p>"}`,
|
|
297
|
+
),
|
|
298
|
+
);
|
|
299
|
+
};
|
|
300
|
+
|
|
301
|
+
/** Where a finished sign-in continues: an address of the API origin only. */
|
|
302
|
+
const safeNext = (next: string | null): string =>
|
|
303
|
+
next?.startsWith("/") && !next.startsWith("//") ? next : "/";
|
|
304
|
+
|
|
305
|
+
/** A resolved identity: a session and on to `next`, a step, or why not. */
|
|
306
|
+
const resolved = async (
|
|
307
|
+
response: ServerResponse,
|
|
308
|
+
identity: SignInIdentity,
|
|
309
|
+
steps: number,
|
|
310
|
+
flow: string,
|
|
311
|
+
next: string,
|
|
312
|
+
): Promise<void> => {
|
|
313
|
+
const account = await auth.resolveAccount(identity, steps);
|
|
314
|
+
if (account.kind === "unavailable") {
|
|
315
|
+
problem(response, 503, "Sign-in is unavailable for a moment; try again shortly.");
|
|
316
|
+
return;
|
|
317
|
+
}
|
|
318
|
+
if (account.kind === "refused") {
|
|
319
|
+
problem(response, 403, account.message);
|
|
320
|
+
return;
|
|
321
|
+
}
|
|
322
|
+
if (account.kind === "suspended") {
|
|
323
|
+
problem(response, 403, "This account is suspended.");
|
|
324
|
+
return;
|
|
325
|
+
}
|
|
326
|
+
if (account.kind === "step") {
|
|
327
|
+
if (steps >= MAX_STEPS) {
|
|
328
|
+
problem(response, 403, "Sign-in asked for too many steps; try again later.");
|
|
329
|
+
return;
|
|
330
|
+
}
|
|
331
|
+
const handle = token();
|
|
332
|
+
keep("step", handle, { identity, steps: steps + 1, flow, next } satisfies StepRecord);
|
|
333
|
+
const url = new URL(account.url);
|
|
334
|
+
url.searchParams.set("mostra_return", `${apiOrigin}/signin/return?step=${handle}`);
|
|
335
|
+
redirect(response, url.href);
|
|
336
|
+
return;
|
|
337
|
+
}
|
|
338
|
+
log.info("signin.done", { provider: identity.provider });
|
|
339
|
+
redirect(response, `${apiOrigin}${safeNext(next)}`, {
|
|
340
|
+
"set-cookie": [startSession(account.accountId), setCookie(flowCookie, "", 0)],
|
|
341
|
+
});
|
|
342
|
+
};
|
|
343
|
+
|
|
344
|
+
// ── authorization requests ──────────────────────────────────────────────────────────────
|
|
345
|
+
|
|
346
|
+
interface AuthorizeRecord {
|
|
347
|
+
readonly clientId: string;
|
|
348
|
+
readonly redirectUri: string;
|
|
349
|
+
readonly state: string | null;
|
|
350
|
+
readonly challenge: string;
|
|
351
|
+
readonly resource: string;
|
|
352
|
+
readonly scope: string;
|
|
353
|
+
readonly viewerSignin?: string;
|
|
354
|
+
readonly redirectGiven: boolean;
|
|
355
|
+
}
|
|
356
|
+
interface ViewerSigninRecord extends ViewerSignin {
|
|
357
|
+
readonly clientId: string;
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
/** The answer to a client's redirect URI, with `iss` (RFC 9207). */
|
|
361
|
+
const toClient = (
|
|
362
|
+
response: ServerResponse,
|
|
363
|
+
redirectUri: string,
|
|
364
|
+
params: Record<string, string | null>,
|
|
365
|
+
): void => {
|
|
366
|
+
const url = new URL(redirectUri);
|
|
367
|
+
for (const [key, value] of Object.entries(params))
|
|
368
|
+
if (value !== null) url.searchParams.set(key, value);
|
|
369
|
+
url.searchParams.set("iss", apiOrigin);
|
|
370
|
+
redirect(response, url.href);
|
|
371
|
+
};
|
|
372
|
+
|
|
373
|
+
/** Consent, or the code: a signed-in account continuing an authorization request. */
|
|
374
|
+
const proceed = async (
|
|
375
|
+
request: IncomingMessage,
|
|
376
|
+
response: ServerResponse,
|
|
377
|
+
handle: string,
|
|
378
|
+
signed: { accountId: string; hash: string },
|
|
379
|
+
): Promise<void> => {
|
|
380
|
+
const pending = read<AuthorizeRecord>("authorize", handle);
|
|
381
|
+
if (!pending) {
|
|
382
|
+
problem(response, 400, "This sign-in expired or was already used; start again from the app.");
|
|
383
|
+
return;
|
|
384
|
+
}
|
|
385
|
+
const client = await clients.find(pending.clientId);
|
|
386
|
+
if ("error" in client) {
|
|
387
|
+
problem(response, 400, client.description);
|
|
388
|
+
return;
|
|
389
|
+
}
|
|
390
|
+
const viewer =
|
|
391
|
+
pending.viewerSignin !== undefined
|
|
392
|
+
? read<ViewerSigninRecord>("authorize", pending.viewerSignin)
|
|
393
|
+
: undefined;
|
|
394
|
+
const homeId = viewer?.homeId;
|
|
395
|
+
const needsConsent =
|
|
396
|
+
client.kind === "shell"
|
|
397
|
+
? homeId !== undefined && !senderShown(signed.accountId, homeId)
|
|
398
|
+
: !auth.consented(signed.accountId, client.id);
|
|
399
|
+
if (needsConsent && request.method !== "POST") {
|
|
400
|
+
consentPage(response, pending, client, handle, signed, homeId);
|
|
401
|
+
return;
|
|
402
|
+
}
|
|
403
|
+
if (request.method === "POST") {
|
|
404
|
+
// The page's own form only, from this browser's session (D166 item 10).
|
|
405
|
+
const form = await readForm(request);
|
|
406
|
+
if (
|
|
407
|
+
request.headers.origin !== apiOrigin ||
|
|
408
|
+
!form ||
|
|
409
|
+
form.get("csrf") !== csrf(signed.hash, `consent ${handle}`)
|
|
410
|
+
) {
|
|
411
|
+
problem(response, 403, "This form must be sent from its own page.");
|
|
412
|
+
return;
|
|
413
|
+
}
|
|
414
|
+
if (form.get("decision") !== "approve") {
|
|
415
|
+
spend(handle);
|
|
416
|
+
toClient(response, pending.redirectUri, { error: "access_denied", state: pending.state });
|
|
417
|
+
return;
|
|
418
|
+
}
|
|
419
|
+
if (client.kind === "shell" && homeId !== undefined)
|
|
420
|
+
markSenderShown(signed.accountId, homeId);
|
|
421
|
+
else auth.consent(signed.accountId, client.id);
|
|
422
|
+
}
|
|
423
|
+
if (!spend(handle)) {
|
|
424
|
+
problem(response, 400, "This sign-in was already used.");
|
|
425
|
+
return;
|
|
426
|
+
}
|
|
427
|
+
clients.used(client.id);
|
|
428
|
+
const code = auth.issueCode({
|
|
429
|
+
clientId: client.id,
|
|
430
|
+
redirectUri: pending.redirectUri,
|
|
431
|
+
challenge: pending.challenge,
|
|
432
|
+
resource: pending.resource,
|
|
433
|
+
scope: pending.scope,
|
|
434
|
+
accountId: signed.accountId,
|
|
435
|
+
redirectGiven: pending.redirectGiven !== false,
|
|
436
|
+
...(pending.viewerSignin !== undefined
|
|
437
|
+
? { viewerSignin: hashSecret(pending.viewerSignin) }
|
|
438
|
+
: {}),
|
|
439
|
+
});
|
|
440
|
+
log.info("oauth.code_issued", { client: client.id });
|
|
441
|
+
toClient(response, pending.redirectUri, { code, state: pending.state });
|
|
442
|
+
};
|
|
443
|
+
|
|
444
|
+
const senderShown = (accountId: string, homeId: string): boolean =>
|
|
445
|
+
directory.read(
|
|
446
|
+
(db) =>
|
|
447
|
+
db.get(
|
|
448
|
+
"SELECT 1 FROM sender_shown WHERE account_id = ? AND home_id = ?",
|
|
449
|
+
accountId,
|
|
450
|
+
homeId,
|
|
451
|
+
) !== undefined,
|
|
452
|
+
);
|
|
453
|
+
const markSenderShown = (accountId: string, homeId: string): void => {
|
|
454
|
+
directory.write((db) =>
|
|
455
|
+
db.run(
|
|
456
|
+
"INSERT OR IGNORE INTO sender_shown (account_id, home_id, at) VALUES (?, ?, ?)",
|
|
457
|
+
accountId,
|
|
458
|
+
homeId,
|
|
459
|
+
iso(now()),
|
|
460
|
+
),
|
|
461
|
+
);
|
|
462
|
+
};
|
|
463
|
+
|
|
464
|
+
const consentPage = (
|
|
465
|
+
response: ServerResponse,
|
|
466
|
+
pending: AuthorizeRecord,
|
|
467
|
+
client: OAuthClient,
|
|
468
|
+
handle: string,
|
|
469
|
+
signed: { accountId: string; hash: string },
|
|
470
|
+
homeId: string | undefined,
|
|
471
|
+
): void => {
|
|
472
|
+
const who = auth.accountName(signed.accountId).name ?? "your account";
|
|
473
|
+
const redirectHost = new URL(pending.redirectUri).host;
|
|
474
|
+
const loopback = /^(127\.0\.0\.1|\[::1\]|localhost)(:\d+)?$/.test(redirectHost);
|
|
475
|
+
const body =
|
|
476
|
+
client.kind === "shell"
|
|
477
|
+
? `<p>Continue as <strong>${escapeHtml(who)}</strong> to answer <strong>${escapeHtml(
|
|
478
|
+
(homeId !== undefined ? options.ownerName(homeId) : undefined) ?? "this person",
|
|
479
|
+
)}</strong>'s page? They will see your name with your answers.</p>`
|
|
480
|
+
: `<p><strong>${escapeHtml(client.name)}</strong>${client.unverified ? ' <span class="muted">(a name the app gives itself, not checked)</span>' : ""} asks to use Mostra as <strong>${escapeHtml(who)}</strong>: to read, create and change your hosted pages and their answers.</p>
|
|
481
|
+
<p>It will send you back to <strong>${escapeHtml(redirectHost)}</strong>.${loopback ? " That is a program on your own computer: continue only if you started this there." : ""}</p>`;
|
|
482
|
+
send(
|
|
483
|
+
response,
|
|
484
|
+
200,
|
|
485
|
+
shell(
|
|
486
|
+
client.kind === "shell" ? "Answer as yourself" : "Allow access",
|
|
487
|
+
`${body}<form method="post" action="/oauth/authorize/continue?authorize=${encodeURIComponent(handle)}">
|
|
488
|
+
<input type="hidden" name="csrf" value="${csrf(signed.hash, `consent ${handle}`)}">
|
|
489
|
+
<button name="decision" value="approve">${client.kind === "shell" ? "Continue" : "Allow"}</button>
|
|
490
|
+
<button name="decision" value="deny">Cancel</button></form>`,
|
|
491
|
+
),
|
|
492
|
+
{},
|
|
493
|
+
[new URL(pending.redirectUri).origin],
|
|
494
|
+
);
|
|
495
|
+
};
|
|
496
|
+
|
|
497
|
+
const readForm = async (request: IncomingMessage): Promise<URLSearchParams | undefined> => {
|
|
498
|
+
if (!(request.headers["content-type"] ?? "").startsWith("application/x-www-form-urlencoded")) {
|
|
499
|
+
return undefined;
|
|
500
|
+
}
|
|
501
|
+
const chunks: Buffer[] = [];
|
|
502
|
+
let size = 0;
|
|
503
|
+
for await (const chunk of request) {
|
|
504
|
+
size += (chunk as Buffer).length;
|
|
505
|
+
if (size > 16 * 1024) return undefined;
|
|
506
|
+
chunks.push(chunk as Buffer);
|
|
507
|
+
}
|
|
508
|
+
return new URLSearchParams(Buffer.concat(chunks).toString("utf8"));
|
|
509
|
+
};
|
|
510
|
+
|
|
511
|
+
/** `GET /oauth/authorize`. */
|
|
512
|
+
const authorize = async (
|
|
513
|
+
response: ServerResponse,
|
|
514
|
+
query: URLSearchParams,
|
|
515
|
+
request: IncomingMessage,
|
|
516
|
+
): Promise<void> => {
|
|
517
|
+
// A parameter given twice is ambiguous: refused before anything else (RFC 6749 §3.1).
|
|
518
|
+
for (const key of new Set(query.keys())) {
|
|
519
|
+
if (query.getAll(key).length > 1) {
|
|
520
|
+
problem(response, 400, `The request names ${key} twice.`);
|
|
521
|
+
return;
|
|
522
|
+
}
|
|
523
|
+
}
|
|
524
|
+
const clientId = query.get("client_id") ?? "";
|
|
525
|
+
const client = await clients.find(clientId);
|
|
526
|
+
if ("error" in client) {
|
|
527
|
+
problem(response, 400, client.description);
|
|
528
|
+
return;
|
|
529
|
+
}
|
|
530
|
+
const redirectUri =
|
|
531
|
+
query.get("redirect_uri") ??
|
|
532
|
+
(client.redirectUris.length === 1 ? (client.redirectUris[0] as string) : "");
|
|
533
|
+
// Nothing goes to a redirect URI the client doesn't list (RFC 6749 §4.1.2.1).
|
|
534
|
+
if (!redirectAllowed(client.redirectUris, redirectUri)) {
|
|
535
|
+
problem(response, 400, "The redirect address isn't one this app registered.");
|
|
536
|
+
return;
|
|
537
|
+
}
|
|
538
|
+
const state = query.get("state");
|
|
539
|
+
const fail = (error: string, description: string) =>
|
|
540
|
+
toClient(response, redirectUri, { error, error_description: description, state });
|
|
541
|
+
if (query.get("response_type") !== "code")
|
|
542
|
+
return fail("unsupported_response_type", "Only code.");
|
|
543
|
+
const challenge = query.get("code_challenge") ?? "";
|
|
544
|
+
if (query.get("code_challenge_method") !== "S256" || !/^[A-Za-z0-9_-]{43}$/.test(challenge)) {
|
|
545
|
+
return fail("invalid_request", "PKCE with S256 is required.");
|
|
546
|
+
}
|
|
547
|
+
if (client.kind === "cli") return fail("unauthorized_client", "The CLI uses the device grant.");
|
|
548
|
+
const scopes = (query.get("scope") ?? "mostra").split(" ").filter((part) => part !== "");
|
|
549
|
+
if (!scopes.every((part) => part === "mostra" || part === "offline_access")) {
|
|
550
|
+
return fail("invalid_scope", "The scopes are mostra and offline_access.");
|
|
551
|
+
}
|
|
552
|
+
const scope = ["mostra", ...(scopes.includes("offline_access") ? ["offline_access"] : [])].join(
|
|
553
|
+
" ",
|
|
554
|
+
);
|
|
555
|
+
let resource = "";
|
|
556
|
+
let viewerSignin: string | undefined;
|
|
557
|
+
if (client.kind === "shell") {
|
|
558
|
+
// A page's sign-in: started by its shell, bound to its route and session.
|
|
559
|
+
viewerSignin = query.get("mostra_signin") ?? "";
|
|
560
|
+
const started = read<ViewerSigninRecord>("authorize", viewerSignin);
|
|
561
|
+
if (!started || started.clientId !== client.id || state !== viewerSignin) {
|
|
562
|
+
return fail("invalid_request", "This page sign-in wasn't started from its page.");
|
|
563
|
+
}
|
|
564
|
+
resource = `${apiOrigin}/viewer`;
|
|
565
|
+
} else {
|
|
566
|
+
// The audience: the MCP endpoint (RFC 8707; every MCP client names it).
|
|
567
|
+
resource = canonicalResource(query.get("resource") ?? `${apiOrigin}/mcp`);
|
|
568
|
+
if (resource !== `${apiOrigin}/mcp`)
|
|
569
|
+
return fail("invalid_target", `The resource is ${apiOrigin}/mcp.`);
|
|
570
|
+
}
|
|
571
|
+
const handle = token();
|
|
572
|
+
keep("authorize", handle, {
|
|
573
|
+
clientId: client.id,
|
|
574
|
+
redirectUri,
|
|
575
|
+
state,
|
|
576
|
+
challenge,
|
|
577
|
+
resource,
|
|
578
|
+
scope,
|
|
579
|
+
...(viewerSignin !== undefined ? { viewerSignin } : {}),
|
|
580
|
+
redirectGiven: query.get("redirect_uri") !== null,
|
|
581
|
+
} satisfies AuthorizeRecord);
|
|
582
|
+
const signed = sessionAccount(request);
|
|
583
|
+
if (signed) {
|
|
584
|
+
await proceed(request, response, handle, signed);
|
|
585
|
+
return;
|
|
586
|
+
}
|
|
587
|
+
await signInPage(response, `/oauth/authorize/continue?authorize=${handle}`);
|
|
588
|
+
};
|
|
589
|
+
|
|
590
|
+
return {
|
|
591
|
+
sessionAccount,
|
|
592
|
+
csrf,
|
|
593
|
+
signInPage,
|
|
594
|
+
providers: async () =>
|
|
595
|
+
(await providers()).map((provider) => ({ id: provider.id, label: provider.label })),
|
|
596
|
+
|
|
597
|
+
startViewerSignin(signin, challenge) {
|
|
598
|
+
const state = token();
|
|
599
|
+
const clientId = clients.shellClientId(signin.shellOrigin);
|
|
600
|
+
keep("authorize", state, { ...signin, clientId } satisfies ViewerSigninRecord);
|
|
601
|
+
const url = new URL(`${apiOrigin}/oauth/authorize`);
|
|
602
|
+
url.searchParams.set("response_type", "code");
|
|
603
|
+
url.searchParams.set("client_id", clientId);
|
|
604
|
+
url.searchParams.set("redirect_uri", `${signin.shellOrigin}/_mostra/signin`);
|
|
605
|
+
url.searchParams.set("state", state);
|
|
606
|
+
url.searchParams.set("mostra_signin", state);
|
|
607
|
+
url.searchParams.set("code_challenge", challenge);
|
|
608
|
+
url.searchParams.set("code_challenge_method", "S256");
|
|
609
|
+
return { url: url.href, state };
|
|
610
|
+
},
|
|
611
|
+
|
|
612
|
+
finishViewerSignin(input) {
|
|
613
|
+
const started = read<ViewerSigninRecord>("authorize", input.state);
|
|
614
|
+
// A code started on one route, or for another shell session, is refused here (login CSRF).
|
|
615
|
+
if (!started || started.routeId !== input.routeId || started.sessionId !== input.sessionId) {
|
|
616
|
+
return { refused: "This sign-in was started for another page." };
|
|
617
|
+
}
|
|
618
|
+
const redeemed = auth.redeemViewerCode({
|
|
619
|
+
code: input.code,
|
|
620
|
+
verifier: input.verifier,
|
|
621
|
+
clientId: started.clientId,
|
|
622
|
+
viewerSignin: hashSecret(input.state),
|
|
623
|
+
});
|
|
624
|
+
spend(input.state);
|
|
625
|
+
if ("refused" in redeemed) return redeemed;
|
|
626
|
+
const named = auth.accountName(redeemed.accountId);
|
|
627
|
+
return {
|
|
628
|
+
accountId: redeemed.accountId,
|
|
629
|
+
...(named.name !== undefined ? { name: named.name } : {}),
|
|
630
|
+
...(named.provider !== undefined ? { provider: named.provider } : {}),
|
|
631
|
+
};
|
|
632
|
+
},
|
|
633
|
+
|
|
634
|
+
async handle(request, response, path) {
|
|
635
|
+
const method = request.method ?? "GET";
|
|
636
|
+
const url = new URL(request.url ?? "/", apiOrigin);
|
|
637
|
+
if (method === "GET" && path === "/oauth/authorize") {
|
|
638
|
+
await authorize(response, url.searchParams, request);
|
|
639
|
+
return true;
|
|
640
|
+
}
|
|
641
|
+
if (path === "/oauth/authorize/continue" && (method === "GET" || method === "POST")) {
|
|
642
|
+
const handle = url.searchParams.get("authorize") ?? "";
|
|
643
|
+
const signed = sessionAccount(request);
|
|
644
|
+
if (!signed) {
|
|
645
|
+
await signInPage(response, `/oauth/authorize/continue?authorize=${handle}`);
|
|
646
|
+
return true;
|
|
647
|
+
}
|
|
648
|
+
await proceed(request, response, handle, signed);
|
|
649
|
+
return true;
|
|
650
|
+
}
|
|
651
|
+
const start = /^\/signin\/([a-z][a-z0-9-]{0,31})\/start$/.exec(path);
|
|
652
|
+
if (method === "GET" && start) {
|
|
653
|
+
const provider = (await providers()).find((candidate) => candidate.id === start[1]);
|
|
654
|
+
if (!provider) {
|
|
655
|
+
problem(response, 404, "No such sign-in.");
|
|
656
|
+
return true;
|
|
657
|
+
}
|
|
658
|
+
const state = token();
|
|
659
|
+
const verifier = token();
|
|
660
|
+
const challenge = createHash("sha256").update(verifier).digest("base64url");
|
|
661
|
+
const nonce = token();
|
|
662
|
+
const flow = token();
|
|
663
|
+
keep("provider", state, {
|
|
664
|
+
provider: provider.id,
|
|
665
|
+
verifier,
|
|
666
|
+
challenge,
|
|
667
|
+
nonce,
|
|
668
|
+
flow: hashSecret(flow),
|
|
669
|
+
next: safeNext(url.searchParams.get("next")),
|
|
670
|
+
} satisfies ProviderRecord);
|
|
671
|
+
let target: string;
|
|
672
|
+
try {
|
|
673
|
+
target = await bounded(
|
|
674
|
+
() =>
|
|
675
|
+
provider.authorize(
|
|
676
|
+
state,
|
|
677
|
+
{ challenge, method: "S256", verifier },
|
|
678
|
+
{ redirectUri: `${apiOrigin}/signin/${provider.id}/callback`, nonce },
|
|
679
|
+
),
|
|
680
|
+
"the provider's sign-in address",
|
|
681
|
+
);
|
|
682
|
+
// Only to an https: page (a server on loopback http, as tests and a first run use, may
|
|
683
|
+
// send its own providers' pages over http too).
|
|
684
|
+
const parsed = new URL(target, apiOrigin);
|
|
685
|
+
if (parsed.protocol !== "https:" && (secure || parsed.protocol !== "http:")) {
|
|
686
|
+
throw new Error("the provider's sign-in address isn't https:");
|
|
687
|
+
}
|
|
688
|
+
target = parsed.href;
|
|
689
|
+
} catch (error) {
|
|
690
|
+
log.warn("signin.provider_failed", {
|
|
691
|
+
provider: provider.id,
|
|
692
|
+
message: (error as Error).message,
|
|
693
|
+
});
|
|
694
|
+
problem(
|
|
695
|
+
response,
|
|
696
|
+
503,
|
|
697
|
+
`${provider.label} can't be reached right now; try again shortly.`,
|
|
698
|
+
);
|
|
699
|
+
return true;
|
|
700
|
+
}
|
|
701
|
+
redirect(response, target, {
|
|
702
|
+
"set-cookie": setCookie(flowCookie, flow, Math.floor(PENDING_MS / 1000)),
|
|
703
|
+
});
|
|
704
|
+
return true;
|
|
705
|
+
}
|
|
706
|
+
const name = /^\/signin\/([a-z][a-z0-9-]{0,31})\/name$/.exec(path);
|
|
707
|
+
const callback = /^\/signin\/([a-z][a-z0-9-]{0,31})\/callback$/.exec(path);
|
|
708
|
+
if ((method === "GET" && callback) || (name && (method === "GET" || method === "POST"))) {
|
|
709
|
+
const id = (callback ?? name)?.[1] as string;
|
|
710
|
+
const provider = (await providers()).find((candidate) => candidate.id === id);
|
|
711
|
+
if (!provider) {
|
|
712
|
+
problem(response, 404, "No such sign-in.");
|
|
713
|
+
return true;
|
|
714
|
+
}
|
|
715
|
+
if (name && method === "GET") {
|
|
716
|
+
// The development provider's page: a name, trusted as typed (D166 item 4).
|
|
717
|
+
const state = url.searchParams.get("state") ?? "";
|
|
718
|
+
send(
|
|
719
|
+
response,
|
|
720
|
+
200,
|
|
721
|
+
shell(
|
|
722
|
+
"Development sign-in",
|
|
723
|
+
`<p class="muted">This server signs people in with a development provider, which trusts the name you type. Use it only on a server you run for yourself or for tests.</p>
|
|
724
|
+
<form method="post" action="/signin/${escapeHtml(id)}/name"><input type="hidden" name="state" value="${escapeHtml(state)}">
|
|
725
|
+
<label>Your name <input name="name" required maxlength="64"></label> <button>Continue</button></form>`,
|
|
726
|
+
),
|
|
727
|
+
);
|
|
728
|
+
return true;
|
|
729
|
+
}
|
|
730
|
+
let params: Record<string, string>;
|
|
731
|
+
if (name) {
|
|
732
|
+
const form = await readForm(request);
|
|
733
|
+
if (request.headers.origin !== apiOrigin || !form) {
|
|
734
|
+
problem(response, 403, "This form must be sent from its own page.");
|
|
735
|
+
return true;
|
|
736
|
+
}
|
|
737
|
+
params = Object.fromEntries(form.entries());
|
|
738
|
+
} else {
|
|
739
|
+
params = {};
|
|
740
|
+
for (const key of new Set(url.searchParams.keys())) {
|
|
741
|
+
if (url.searchParams.getAll(key).length > 1) {
|
|
742
|
+
problem(response, 400, `The provider's answer names ${key} twice.`);
|
|
743
|
+
return true;
|
|
744
|
+
}
|
|
745
|
+
params[key] = url.searchParams.get(key) as string;
|
|
746
|
+
}
|
|
747
|
+
}
|
|
748
|
+
const state = params["state"] ?? "";
|
|
749
|
+
const pending = read<ProviderRecord>("provider", state);
|
|
750
|
+
const flow = cookies(request).get(flowCookie);
|
|
751
|
+
// The sign-in this browser started, at this provider, once.
|
|
752
|
+
if (
|
|
753
|
+
!pending ||
|
|
754
|
+
pending.provider !== provider.id ||
|
|
755
|
+
flow === undefined ||
|
|
756
|
+
hashSecret(flow) !== pending.flow ||
|
|
757
|
+
!spend(state)
|
|
758
|
+
) {
|
|
759
|
+
problem(
|
|
760
|
+
response,
|
|
761
|
+
400,
|
|
762
|
+
"This sign-in expired, was used, or was started in another browser.",
|
|
763
|
+
);
|
|
764
|
+
return true;
|
|
765
|
+
}
|
|
766
|
+
let identity: SignInIdentity;
|
|
767
|
+
try {
|
|
768
|
+
const answered = await bounded(
|
|
769
|
+
() =>
|
|
770
|
+
provider.callback(params, {
|
|
771
|
+
redirectUri: `${apiOrigin}/signin/${provider.id}/callback`,
|
|
772
|
+
nonce: pending.nonce,
|
|
773
|
+
state,
|
|
774
|
+
pkce: { challenge: pending.challenge, method: "S256", verifier: pending.verifier },
|
|
775
|
+
}),
|
|
776
|
+
"the provider's answer",
|
|
777
|
+
);
|
|
778
|
+
// An operator's provider is checked as every operator answer is (D167): a malformed
|
|
779
|
+
// identity names nobody.
|
|
780
|
+
const checked = SignInIdentitySchema.safeParse({ ...answered, provider: provider.id });
|
|
781
|
+
if (!checked.success) throw new Error("the provider named nobody this server can use");
|
|
782
|
+
identity = checked.data;
|
|
783
|
+
} catch (error) {
|
|
784
|
+
log.warn("signin.callback_failed", {
|
|
785
|
+
provider: provider.id,
|
|
786
|
+
message: (error as Error).message,
|
|
787
|
+
});
|
|
788
|
+
problem(
|
|
789
|
+
response,
|
|
790
|
+
400,
|
|
791
|
+
`${provider.label} didn't sign you in: ${(error as Error).message}`,
|
|
792
|
+
);
|
|
793
|
+
return true;
|
|
794
|
+
}
|
|
795
|
+
await resolved(response, identity, 0, pending.flow, pending.next);
|
|
796
|
+
return true;
|
|
797
|
+
}
|
|
798
|
+
if (method === "GET" && path === "/signin/return") {
|
|
799
|
+
const handle = url.searchParams.get("step") ?? "";
|
|
800
|
+
const step = read<StepRecord>("step", handle);
|
|
801
|
+
const flow = cookies(request).get(flowCookie);
|
|
802
|
+
if (!step || flow === undefined || hashSecret(flow) !== step.flow || !spend(handle)) {
|
|
803
|
+
problem(
|
|
804
|
+
response,
|
|
805
|
+
400,
|
|
806
|
+
"This sign-in step expired, was used, or belongs to another browser.",
|
|
807
|
+
);
|
|
808
|
+
return true;
|
|
809
|
+
}
|
|
810
|
+
await resolved(response, step.identity, step.steps, step.flow, step.next);
|
|
811
|
+
return true;
|
|
812
|
+
}
|
|
813
|
+
return false;
|
|
814
|
+
},
|
|
815
|
+
};
|
|
816
|
+
}
|