The open-source app everyone uses to manage agents at work
TypeScript acpxagent-orchestrationagent-skillsagentic-aiai-agentsai-engineeringai-governanceai-toolsautonomous-agentsclaudeclaude-codeclaude-skillscodexhermesllmmcpmulti-agentopenclawproject-managementworkflow-automation
Support Cloud tenant identity bootstrap
Dottaae23e0252696
diff --git a/server/src/__tests__/auth-session-route.test.ts b/server/src/__tests__/auth-session-route.test.tsindex 91eeb8a07f..65f6cbd33a 100644--- a/server/src/__tests__/auth-session-route.test.ts+++ b/server/src/__tests__/auth-session-route.test.ts@@ -1,6 +1,6 @@import express from "express";import request from "supertest";-import { describe, expect, it, vi } from "vitest";+import { afterEach, describe, expect, it, vi } from "vitest";import { actorMiddleware } from "../middleware/auth.js";function createSelectChain(rows: unknown[]) {@@ -25,6 +25,13 @@ function createDb() {}describe("actorMiddleware authenticated session profile", () => {+ const originalCloudTenantToken = process.env.PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN;++ afterEach(() => {+ if (originalCloudTenantToken === undefined) delete process.env.PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN;+ else process.env.PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN = originalCloudTenantToken;+ });+it("preserves the signed-in user name and email on the board actor", async () => {const app = express();app.use(@@ -58,4 +65,72 @@ describe("actorMiddleware authenticated session profile", () => {isInstanceAdmin: false,});});++ it("trusts Cloud tenant identity headers and seeds board access", async () => {+ process.env.PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN = "tenant-token";+ const inserts: Array<{ values: Record<string, unknown> }> = [];+ const db = {+ insert: vi.fn(() => {+ const chain = {+ values(values: Record<string, unknown>) {+ inserts.push({ values });+ return chain;+ },+ onConflictDoUpdate() {+ return chain;+ },+ onConflictDoNothing() {+ return chain;+ },+ returning() {+ return Promise.resolve([{+ companyId: inserts.at(-1)?.values.companyId,+ membershipRole: inserts.at(-1)?.values.membershipRole,+ status: inserts.at(-1)?.values.status,+ }]);+ },+ };+ return chain;+ }),+ select: vi.fn(),+ } as any;+ const app = express();+ app.use(+ actorMiddleware(db, {+ deploymentMode: "authenticated",+ resolveSession: async () => null,+ }),+ );+ app.get("/actor", (req, res) => {+ res.json(req.actor);+ });++ const res = await request(app)+ .get("/actor")+ .set("x-paperclip-cloud-tenant-token", "tenant-token")+ .set("x-paperclip-cloud-user-id", "global-user-1")+ .set("x-paperclip-cloud-user-email", "[email protected]")+ .set("x-paperclip-cloud-user-name", "Stack Owner")+ .set("x-paperclip-cloud-stack-id", "stack-alpha")+ .set("x-paperclip-cloud-paperclip-company-id", "paperclip-stack-alpha")+ .set("x-paperclip-cloud-stack-role", "owner");++ expect(res.status).toBe(200);+ expect(res.body).toMatchObject({+ type: "board",+ userId: "global-user-1",+ userName: "Stack Owner",+ userEmail: "[email protected]",+ source: "cloud_tenant",+ isInstanceAdmin: true,+ memberships: [expect.objectContaining({ membershipRole: "owner", status: "active" })],+ });+ expect(res.body.companyIds[0]).toMatch(/^[0-9a-f-]{36}$/);+ expect(inserts).toHaveLength(4);+ expect(inserts[0]?.values).toMatchObject({+ id: "global-user-1",+ email: "[email protected]",+ emailVerified: true,+ });+ });});diff --git a/server/src/middleware/auth.ts b/server/src/middleware/auth.tsindex 2438aee306..ad0b4289bb 100644--- a/server/src/middleware/auth.ts+++ b/server/src/middleware/auth.ts@@ -1,8 +1,8 @@-import { createHash } from "node:crypto";+import { createHash, timingSafeEqual } from "node:crypto";import type { Request, RequestHandler } from "express";import { and, eq, isNull } from "drizzle-orm";import type { Db } from "@paperclipai/db";-import { agentApiKeys, agents, companyMemberships, instanceUserRoles } from "@paperclipai/db";+import { agentApiKeys, agents, authUsers, companies, companyMemberships, instanceUserRoles } from "@paperclipai/db";import { verifyLocalAgentJwt } from "../agent-auth-jwt.js";import type { DeploymentMode } from "@paperclipai/shared";import type { BetterAuthSessionResult } from "../auth/better-auth.js";@@ -38,6 +38,16 @@ export function actorMiddleware(db: Db, opts: ActorMiddlewareOptions): RequestHaconst authHeader = req.header("authorization");if (!authHeader?.toLowerCase().startsWith("bearer ")) {if (opts.deploymentMode === "authenticated" && opts.resolveSession) {+ const cloudTenantActor = await resolveCloudTenantActor(db, req);+ if (cloudTenantActor) {+ req.actor = {+ ...cloudTenantActor,+ runId: runIdHeader ?? undefined,+ };+ next();+ return;+ }+let session: BetterAuthSessionResult | null = null;try {session = await opts.resolveSession(req);@@ -189,6 +199,149 @@ export function actorMiddleware(db: Db, opts: ActorMiddlewareOptions): RequestHa};}+async function resolveCloudTenantActor(db: Db, req: Request): Promise<Express.Request["actor"] | null> {+ const expectedToken = process.env.PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN?.trim();+ if (!expectedToken) return null;++ const token = req.header("x-paperclip-cloud-tenant-token")?.trim();+ if (!token || !constantTimeStringEqual(token, expectedToken)) return null;++ const userId = requiredCloudHeader(req, "x-paperclip-cloud-user-id");+ const userEmail = requiredCloudHeader(req, "x-paperclip-cloud-user-email").toLowerCase();+ const stackId = requiredCloudHeader(req, "x-paperclip-cloud-stack-id");+ const stackRole = stackMembershipRole(req.header("x-paperclip-cloud-stack-role"));+ const userName = req.header("x-paperclip-cloud-user-name")?.trim() || userEmail;+ const paperclipCompanyId = req.header("x-paperclip-cloud-paperclip-company-id")?.trim();+ const companyId = cloudTenantCompanyId(stackId);+ const companyName = paperclipCompanyId || `${stackId} Paperclip`;+ const now = new Date();++ await db+ .insert(authUsers)+ .values({+ id: userId,+ name: userName,+ email: userEmail,+ emailVerified: true,+ image: null,+ createdAt: now,+ updatedAt: now,+ })+ .onConflictDoUpdate({+ target: authUsers.id,+ set: {+ name: userName,+ email: userEmail,+ emailVerified: true,+ updatedAt: now,+ },+ });++ await db+ .insert(instanceUserRoles)+ .values({+ userId,+ role: "instance_admin",+ updatedAt: now,+ })+ .onConflictDoNothing({+ target: [instanceUserRoles.userId, instanceUserRoles.role],+ });++ await db+ .insert(companies)+ .values({+ id: companyId,+ name: companyName,+ description: `Provisioned by Paperclip Cloud for stack ${stackId}.`,+ status: "active",+ issuePrefix: issuePrefixForCloudStack(stackId),+ updatedAt: now,+ })+ .onConflictDoNothing({+ target: companies.id,+ });++ const membershipRole = stackRole === "owner" || stackRole === "admin" ? "owner" : stackRole;+ const membership = await db+ .insert(companyMemberships)+ .values({+ companyId,+ principalType: "user",+ principalId: userId,+ status: "active",+ membershipRole,+ updatedAt: now,+ })+ .onConflictDoUpdate({+ target: [+ companyMemberships.companyId,+ companyMemberships.principalType,+ companyMemberships.principalId,+ ],+ set: {+ status: "active",+ membershipRole,+ updatedAt: now,+ },+ })+ .returning()+ .then((rows) => rows[0] ?? {+ companyId,+ membershipRole,+ status: "active",+ });++ return {+ type: "board",+ userId,+ userName,+ userEmail,+ companyIds: [companyId],+ memberships: [{+ companyId,+ membershipRole: membership.membershipRole,+ status: membership.status,+ }],+ isInstanceAdmin: true,+ source: "cloud_tenant",+ };+}++function requiredCloudHeader(req: Request, name: string): string {+ const value = req.header(name)?.trim();+ if (!value) {+ throw new Error(`Missing trusted Cloud tenant header ${name}`);+ }+ return value;+}++function stackMembershipRole(value: string | undefined): "owner" | "admin" | "member" | "support" {+ if (value === "owner" || value === "admin" || value === "member" || value === "support") {+ return value;+ }+ throw new Error("Invalid trusted Cloud tenant stack role");+}++function constantTimeStringEqual(left: string, right: string): boolean {+ const leftBuffer = Buffer.from(left);+ const rightBuffer = Buffer.from(right);+ return leftBuffer.length === rightBuffer.length && timingSafeEqual(leftBuffer, rightBuffer);+}++function cloudTenantCompanyId(stackId: string): string {+ const bytes = createHash("sha256").update(`paperclip-cloud-tenant-company:${stackId}`).digest();+ bytes[6] = (bytes[6] & 0x0f) | 0x50;+ bytes[8] = (bytes[8] & 0x3f) | 0x80;+ const hex = bytes.subarray(0, 16).toString("hex");+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;+}++function issuePrefixForCloudStack(stackId: string): string {+ const hash = createHash("sha256").update(stackId).digest("hex").slice(0, 4).toUpperCase();+ return `PC${hash}`;+}+export function requireBoard(req: Express.Request) {return req.actor.type === "board";}diff --git a/server/src/types/express.d.ts b/server/src/types/express.d.tsindex 1915e2ffdb..17f94e752e 100644--- a/server/src/types/express.d.ts+++ b/server/src/types/express.d.ts@@ -19,7 +19,7 @@ declare global {isInstanceAdmin?: boolean;keyId?: string;runId?: string;- source?: "local_implicit" | "session" | "board_key" | "agent_key" | "agent_jwt" | "none";+ source?: "local_implicit" | "session" | "board_key" | "agent_key" | "agent_jwt" | "cloud_tenant" | "none";};}}