Files
HiveGrid-Wireframes/hivegrid-cloud/apps/web/app/utils/db/.server/rls-file-isolation.integration.test.ts
T

146 lines
6.9 KiB
TypeScript

// @vitest-environment node
import fs from "node:fs";
import path from "node:path";
import { fileURLToPath } from "node:url";
import pg from "pg";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
// Resolve the repo root from this file's location so the SQL artifacts load
// regardless of the cwd vitest runs under (root vs the @toolctrl/web package dir).
// This file lives at apps/web/app/utils/db/.server/ → six segments below root.
const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../../../..");
// AK-P4a — FILE RLS GATE PROOF. Companion to R-P2b's rls-tenant-isolation
// integration test: proves that once the File RLS block
// (local/AK-P4a-merge-migration.sql) is applied, the restricted hivegrid_app role
// (NOSUPERUSER, NOBYPASSRLS) is confined to its own tenant's File / FileEntityLink
// rows, sees nothing without a tenant context, and is blocked by WITH CHECK from
// writing cross-tenant rows. This is what makes the P5 activation a pure switch:
// the wrapped fileService.server.ts / worker write-backs already set the GUC, so
// flipping RLS on cannot break Files.
//
// Runs ONLY when RLS_TEST_DATABASE_URL is set (a SUPERUSER connection to a
// throwaway DB with the schema pushed). Without it the block is skipped so the
// normal unit suite stays green without a DB.
//
// Setup:
// docker run -d --name hg-rls-pg -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=hivegrid -p 5433:5432 pgvector/pgvector:pg16
// DIRECT_URL=postgresql://postgres:postgres@localhost:5433/hivegrid pnpm exec prisma db push
// RLS_TEST_DATABASE_URL=postgresql://postgres:postgres@localhost:5433/hivegrid pnpm vitest run rls-file-isolation
const ADMIN_URL = process.env.RLS_TEST_DATABASE_URL;
const APP_ROLE = "hivegrid_app";
const APP_PASSWORD = "hivegrid_app_pw";
function appUrlFrom(adminUrl: string): string {
const url = new URL(adminUrl);
url.username = APP_ROLE;
url.password = APP_PASSWORD;
return url.toString();
}
const describeIfDb = ADMIN_URL ? describe : describe.skip;
describeIfDb("File RLS tenant isolation gate proof (File, FileEntityLink)", () => {
let admin: pg.Client;
let app: pg.Client;
beforeAll(async () => {
admin = new pg.Client({ connectionString: ADMIN_URL });
await admin.connect();
// 1) Base RLS mechanic + restricted role (creates hivegrid_app, NOBYPASSRLS).
const baseSql = fs.readFileSync(path.join(REPO_ROOT, "prisma/rls/tenant-isolation.sql"), "utf8");
await admin.query(baseSql);
// 2) File RLS block: ENABLE/FORCE + tenant_isolation policy + GRANTs on the
// four Files tables (the deferred P5 activation artifact, applied here).
const fileRlsSql = fs.readFileSync(path.join(REPO_ROOT, "prisma/rls/file-isolation.sql"), "utf8");
await admin.query(fileRlsSql);
await admin.query(`GRANT CONNECT ON DATABASE ${new URL(ADMIN_URL!).pathname.slice(1)} TO ${APP_ROLE}`);
// 3) Seed two tenants' files + links as superuser (bypasses RLS). File has no
// FK on tenantId/createdByUserId, so no User/Tenant rows are required.
await admin.query(`INSERT INTO "File"(id,"updatedAt","tenantId","createdByUserId","displayName","mimeType","sizeBytes","storageKey") VALUES
('rls_fileA',now(),'rls_tenantA','rls_userA','a.txt','text/plain',1,'tenants/rls_tenantA/files/rls_fileA/original'),
('rls_fileB',now(),'rls_tenantB','rls_userB','b.txt','text/plain',1,'tenants/rls_tenantB/files/rls_fileB/original')
ON CONFLICT (id) DO NOTHING`);
await admin.query(`INSERT INTO "FileEntityLink"(id,"tenantId","createdByUserId","fileId","entityType","entityId") VALUES
('rls_linkA','rls_tenantA','rls_userA','rls_fileA','contact','rls_c1'),
('rls_linkB','rls_tenantB','rls_userB','rls_fileB','contact','rls_c2')
ON CONFLICT (id) DO NOTHING`);
app = new pg.Client({ connectionString: appUrlFrom(ADMIN_URL!) });
await app.connect();
});
afterAll(async () => {
await app?.end();
await admin?.end();
});
async function underTenant<T>(tenantId: string, run: () => Promise<T>): Promise<T> {
await app.query("BEGIN");
try {
await app.query("SELECT set_config('app.tenant_id', $1, true)", [tenantId]);
const result = await run();
await app.query("COMMIT");
return result;
} catch (error) {
await app.query("ROLLBACK");
throw error;
}
}
it("confirms the app role is neither superuser nor BYPASSRLS", async () => {
const { rows } = await admin.query(`SELECT rolsuper, rolbypassrls FROM pg_roles WHERE rolname = $1`, [APP_ROLE]);
expect(rows[0]).toMatchObject({ rolsuper: false, rolbypassrls: false });
});
it("under tenant A context, only tenant A files are visible", async () => {
const ids = await underTenant("rls_tenantA", async () => (await app.query(`SELECT id FROM "File" ORDER BY id`)).rows.map((r) => r.id));
expect(ids).toEqual(["rls_fileA"]);
});
it("cannot read another tenant's file even with an explicit WHERE filter", async () => {
const count = await underTenant("rls_tenantA", async () => (await app.query(`SELECT count(*)::int AS c FROM "File" WHERE "tenantId" = 'rls_tenantB'`)).rows[0].c);
expect(count).toBe(0);
});
it("sees no files at all when no tenant context is set", async () => {
const count = (await app.query(`SELECT count(*)::int AS c FROM "File"`)).rows[0].c;
expect(count).toBe(0);
});
it("WITH CHECK blocks inserting a file for a foreign tenant", async () => {
await expect(
underTenant("rls_tenantA", async () =>
app.query(
`INSERT INTO "File"(id,"updatedAt","tenantId","createdByUserId","displayName","mimeType","sizeBytes","storageKey")
VALUES ('rls_fileX',now(),'rls_tenantB','rls_userB','x.txt','text/plain',1,'tenants/rls_tenantB/files/rls_fileX/original')`,
),
),
).rejects.toThrow(/row-level security/i);
});
it("allows inserting and reading a file for the active tenant", async () => {
await underTenant("rls_tenantA", async () => {
await app.query(
`INSERT INTO "File"(id,"updatedAt","tenantId","createdByUserId","displayName","mimeType","sizeBytes","storageKey")
VALUES ('rls_fileA2',now(),'rls_tenantA','rls_userA','a2.txt','text/plain',1,'tenants/rls_tenantA/files/rls_fileA2/original')
ON CONFLICT (id) DO NOTHING`,
);
const ids = (await app.query(`SELECT id FROM "File" ORDER BY id`)).rows.map((r) => r.id);
expect(ids).toContain("rls_fileA2");
expect(ids).not.toContain("rls_fileB");
});
});
it("isolates FileEntityLink rows by tenant as well", async () => {
const ids = await underTenant("rls_tenantA", async () => (await app.query(`SELECT id FROM "FileEntityLink" ORDER BY id`)).rows.map((r) => r.id));
expect(ids).toEqual(["rls_linkA"]);
const crossCount = await underTenant("rls_tenantA", async () => (await app.query(`SELECT count(*)::int AS c FROM "FileEntityLink" WHERE "tenantId" = 'rls_tenantB'`)).rows[0].c);
expect(crossCount).toBe(0);
});
});