Authenticate and authorize every route: org layer + Supabase JWKS

Until now every HTTP route was unauthenticated. A probe against the
running server returned a farm's `edgeProxyToken` and a printer's
`accessCode` to an anonymous caller, and that pair is enough to connect
as a farm's gateway and drive its printers. The previous commit stopped
the credentials appearing in responses; this one makes the routes ask
who is calling.

Authentication. Access tokens are verified against the Supabase
project's published JWKS via `createSupabaseJwtVerifier` from
`@continuum/ts-core`: RS256, public key only, no secret in this
process. It replaces the HS256 `@elysiajs/jwt` path, where
`SUPABASE_JWT_SECRET` was simultaneously the verification key and a
key that could mint tokens, present in the environment of every
instance. `src/auth/verifier.ts` builds it at module load so a
misconfigured deployment fails at boot rather than on first login.

The edge-gateway token stays symmetric and that is not an
inconsistency: this service is both its issuer and its only verifier,
so there is no second party to keep a secret from. It now carries an
`exp`, which it did not, despite the response saying
`expiresInSeconds: 3600`.

Tenancy. An org layer above farms - `organisations`,
`org_members(org_id, user_id, role)`, `farms.org_id` - so a farm can
have more than one operator without sharing an account. `farms.owner_id`
is gone. Authorization is one rule applied everywhere: resolve the
thing being acted on back to an organisation and check the caller's
role there, user -> org -> farm -> printer, with nothing in between
carrying permissions of its own. The ladder is
`viewer` < `operator` < `owner`; printer commands and job submission
need `operator`, because they move physical machines, and that is the
one boundary here that is not about data.

A non-member gets 404, not 403: a 403 would confirm that a given farm
or printer id exists and belongs to someone, which is an enumeration
oracle over the whole system. 403 is kept for a member who may see the
record but not do this to it.

List endpoints scope in the `where` clause, not after the query - a
filter applied to the result is one `return` away from being skipped.
They are also bounded now (`limit`/`offset`, default 50, max 200
refused rather than clamped).

`ownerId` and `submittedBy` no longer come from request bodies. Nor do
the printer telemetry columns: `POST /printers` is narrowed to the
columns a client owns, because a client that could POST
`status: "idle"` could make the scheduler send work to a printer that
is mid-print.

Also fills the CRUD gaps that made the API unusable - PATCH and DELETE
for farms, printers, jobs and orgs, and membership management - plus
one error shape for the whole API via `toErrorResponse`, so an
authorization failure is a throw that leaves the handler rather than a
status somebody has to remember to set.

Guards on the two changes that cannot be undone through the API:
removing or demoting an organisation's last owner, and deleting an
organisation while farms are still attached (it would cascade to every
printer, print job and stored frame).

Migration 0001 is hand-edited after generation. drizzle-kit emitted
`ADD COLUMN org_id uuid NOT NULL`, which cannot apply to a populated
table, and dropped `owner_id` without moving what it encodes anywhere.
It now adds the column nullable, creates one organisation per distinct
legacy owner with that user as its `owner` member, points each farm at
it, and only then tightens the column and drops `owner_id`. Verified
both ways: from empty via `drizzle-kit migrate`, and against a seeded
database where two farms shared an owner and a third did not.

Testing. `scripts/dev-auth.ts` is a local RS256 issuer publishing a
JWKS at the path the backend fetches, so the real verification path is
testable without a Supabase project. The alternative was a test-only
bypass in the backend - an env var making it trust an unsigned token -
which would be a permanent hole one misconfiguration from production,
and would mean the code under test is not the code that ships.

- `tests/authz.test.ts` (19 tests): the role ladder written out in full
  rather than derived the same way the implementation derives it, and
  the real JWKS path - a token signed by a key outside the JWKS, an
  expired token and a token with `aud: "anon"` (Supabase's own anon key
  is a valid project JWT) are all rejected, with the same message, so
  probing cannot tell which part of a forged token to fix next.
- `scripts/e2e-authz.sh` (68 assertions, real Postgres, real routes):
  four users across two organisations; anonymous 401s, cross-org 404s,
  viewer-cannot-command, operator-cannot-rotate, a spoofed
  `submittedBy` in the body ignored, no credential in any read, and the
  rotated token still minting an edge JWT.
- `scripts/e2e-edge.sh` updated for the org layer and now authenticates
  as a seeded `operator` - the weakest role that should work, so the
  run would fail if the command boundary were not where it claims to
  be. Re-verified against both live printers: telemetry from `h2c` and
  `p1p` persisted, and an authenticated `set_fan_speed` went
  HTTP -> WebSocket -> MQTT -> P1P and back `ok:true`, fan returned
  to 0.

Two bugs found in the test scripts while writing this, both the same
shape as the earlier `pkill -f` incident: `kill "${PID:-0}"` with an
unset PID signals the whole process group, including the harness, and
`uuidgen` is not installed in this sandbox.
This commit is contained in:
2026-10-03 15:49:29 +00:00
parent 01bcc73996
commit d8f8653dee
25 changed files with 2458 additions and 180 deletions
+1 -1
View File
@@ -44,7 +44,7 @@ function projection<T extends object, K extends keyof T>(table: T, keys: readonl
export const farmProjection = projection(farms, [
"id",
"name",
"ownerId",
"orgId",
"location",
"settings",
"createdAt",
+26 -11
View File
@@ -1,15 +1,30 @@
import { pgTable, uuid, text, timestamp, jsonb } from "drizzle-orm/pg-core";
import { pgTable, uuid, text, timestamp, jsonb, index } from "drizzle-orm/pg-core";
import { organisations } from "./orgs";
export const farms = pgTable("farms", {
id: uuid("id").primaryKey().defaultRandom(),
name: text("name").notNull(),
ownerId: uuid("owner_id").notNull(),
edgeProxyToken: text("edge_proxy_token").notNull(),
location: text("location"),
settings: jsonb("settings").$type<Record<string, unknown>>().default({}),
createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
});
export const farms = pgTable(
"farms",
{
id: uuid("id").primaryKey().defaultRandom(),
name: text("name").notNull(),
/**
* Replaces the old `owner_id`. A farm used to point straight at a single
* Supabase user, which left no way to let a second person operate it
* without handing over the account - so ownership moved up a level and
* who may do what is now a row in `org_members`.
*/
orgId: uuid("org_id")
.notNull()
.references(() => organisations.id, { onDelete: "cascade" }),
edgeProxyToken: text("edge_proxy_token").notNull(),
location: text("location"),
settings: jsonb("settings").$type<Record<string, unknown>>().default({}),
createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
},
(table) => ({
orgIdx: index("farms_org_id_idx").on(table.orgId),
}),
);
export type Farm = typeof farms.$inferSelect;
export type NewFarm = typeof farms.$inferInsert;
+1
View File
@@ -1,3 +1,4 @@
export * from "./orgs";
export * from "./farms";
export * from "./printers";
export * from "./print_jobs";
+65
View File
@@ -0,0 +1,65 @@
import { pgTable, uuid, text, timestamp, jsonb, pgEnum, index, primaryKey } from "drizzle-orm/pg-core";
/**
* The role ladder, lowest first. Order matters: `src/auth/scope.ts` compares
* roles by their position in this array, so a role inserted in the middle
* changes what every `minRole` check means.
*
* - `viewer` - read farms, printers, jobs.
* - `operator` - plus submit jobs and send printer commands. Those commands
* move physical machines (home, pause, set fan/temperature),
* so this is the boundary that matters most here.
* - `owner` - plus manage membership, create and delete farms and
* printers, and rotate a farm's edge-proxy token.
*/
export const ORG_ROLES = ["viewer", "operator", "owner"] as const;
export type OrgRole = (typeof ORG_ROLES)[number];
export const orgRoleEnum = pgEnum("org_role", ORG_ROLES);
/**
* An organisation is the unit of ownership and billing: it owns farms, which
* own printers. Nothing below this level carries its own access control -
* authorization is always resolved as user -> org -> farm -> printer.
*/
export const organisations = pgTable("organisations", {
id: uuid("id").primaryKey().defaultRandom(),
name: text("name").notNull(),
settings: jsonb("settings").$type<Record<string, unknown>>().default({}),
createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
});
/**
* Membership is the only thing that grants access to anything in Continuum.
*
* `userId` is a Supabase `auth.users.id` - the `sub` claim of a verified
* access token. It is deliberately *not* a foreign key: that table lives in
* Supabase's own schema and may not even be in this database, so the
* reference is by value and a deleted user leaves a row that matches no
* token. Harmless, since nothing can authenticate as them any more.
*/
export const orgMembers = pgTable(
"org_members",
{
orgId: uuid("org_id")
.notNull()
.references(() => organisations.id, { onDelete: "cascade" }),
userId: uuid("user_id").notNull(),
role: orgRoleEnum("role").notNull().default("viewer"),
createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull(),
},
(table) => ({
pk: primaryKey({ columns: [table.orgId, table.userId] }),
// Every authenticated request starts by asking "which orgs is this user
// in?", so that lookup gets its own index; the primary key is no help
// because it leads with org_id.
userIdx: index("org_members_user_id_idx").on(table.userId),
}),
);
export type Organisation = typeof organisations.$inferSelect;
export type NewOrganisation = typeof organisations.$inferInsert;
export type OrgMember = typeof orgMembers.$inferSelect;
export type NewOrgMember = typeof orgMembers.$inferInsert;