From 1ae3f7b1c6b3ff2639cc432eb15710a18c6956d7 Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Thu, 12 Nov 2026 08:21:22 -0800 Subject: [PATCH 1/9] feat(hub): add Copilot connection administration Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- hub/.env.example | 4 + .../cancel-copilot-authorization/index.ts | 14 + .../continue-copilot-authorization/index.ts | 21 ++ .../get-copilot-authorization/index.ts | 11 + .../start-copilot-authorization/index.ts | 21 ++ .../settings-copilot-authorization/index.tsx | 101 +++++++ .../application/hub/routes/settings-routes.ts | 1 + hub/docs/README.md | 1 + hub/docs/authentication.md | 10 + hub/docs/copilot.md | 45 +++ hub/package-lock.json | 32 +-- hub/package.json | 2 +- hub/schema/membership.prisma | 7 +- .../migration.sql | 2 + .../migration.sql | 56 ++++ ...sitive-authorization-operation.enum.prisma | 2 + hub/schema/sensitive-authorization.prisma | 19 +- .../administrator-authorization.db.test.ts | 3 + .../index.ts | 22 +- .../index.ts | 3 + .../index.ts | 15 + .../types.ts | 1 + .../index.ts | 18 +- .../run-admission-transaction/index.ts | 3 + .../run-admission-transaction/types.ts | 1 + .../continue-copilot-authorization/index.ts | 259 ++++++++++++++++++ .../index.ts | 13 + .../index.ts | 3 + .../types.ts | 3 + .../copilot/check-copilot-token/errors.ts | 14 + .../copilot/check-copilot-token/index.ts | 54 ++++ .../index.ts | 21 ++ .../index.ts | 46 ++++ .../get-copilot-connection-state/index.ts | 31 +++ .../lock-copilot-connection-state/index.ts | 20 ++ .../save-copilot-connection-state/index.ts | 34 +++ .../create-security-audit/types.ts | 17 +- .../get-security-audit-data/index.ts | 21 ++ .../parse-security-audit-event/index.ts | 13 + .../parse-security-audit-event/types.ts | 2 + .../cancel-sensitive-authorization/index.ts | 29 +- .../create-sensitive-authorization/index.ts | 17 +- .../index.ts | 7 +- .../get-sensitive-authorization/index.ts | 7 +- .../lock-sensitive-authorization/index.ts | 9 +- .../verify-sensitive-authorization/index.ts | 7 +- .../authorizations/start/rate-limit/index.ts | 10 +- .../routes/api/auth/callback/get/index.ts | 2 + .../index.ts | 90 ++++-- hub/server/routes/api/auth/types.ts | 49 +++- .../authorizations/cancel/post/index.ts | 36 +++ .../authorizations/continue/post/index.ts | 58 ++++ .../authorizations/get/index.ts | 48 ++++ .../authorizations/start/post/index.ts | 88 ++++++ .../present-security-audit/index.ts | 30 ++ 55 files changed, 1369 insertions(+), 84 deletions(-) create mode 100644 hub/client/application/hub/requests/cancel-copilot-authorization/index.ts create mode 100644 hub/client/application/hub/requests/continue-copilot-authorization/index.ts create mode 100644 hub/client/application/hub/requests/get-copilot-authorization/index.ts create mode 100644 hub/client/application/hub/requests/start-copilot-authorization/index.ts create mode 100644 hub/client/application/hub/routes/settings-copilot-authorization/index.tsx create mode 100644 hub/docs/copilot.md create mode 100644 hub/schema/migrations/20261112170000_copilot_connection/migration.sql create mode 100644 hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql create mode 100644 hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts create mode 100644 hub/server/integrations/copilot/check-copilot-token/errors.ts create mode 100644 hub/server/integrations/copilot/check-copilot-token/index.ts create mode 100644 hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts create mode 100644 hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts create mode 100644 hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts create mode 100644 hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts create mode 100644 hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts create mode 100644 hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts create mode 100644 hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts create mode 100644 hub/server/routes/api/copilot-connection/authorizations/get/index.ts create mode 100644 hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts diff --git a/hub/.env.example b/hub/.env.example index 1668dba9a..4655d8d9b 100644 --- a/hub/.env.example +++ b/hub/.env.example @@ -81,3 +81,7 @@ TEST_DATABASE_URL=postgresql://replica:replica@127.0.0.1:5432/postgres # Trust forwarded client addresses only behind this exact protected proxy-chain length. # HUB_TRUSTED_PROXY_HOPS=0 + +# Optional deployment-level Copilot connection. Use a fine-grained personal access token whose +# only account permission is Copilot requests. Hub never stores or returns this value. +# REPLICA_COPILOT_TOKEN= diff --git a/hub/client/application/hub/requests/cancel-copilot-authorization/index.ts b/hub/client/application/hub/requests/cancel-copilot-authorization/index.ts new file mode 100644 index 000000000..df7b73ae9 --- /dev/null +++ b/hub/client/application/hub/requests/cancel-copilot-authorization/index.ts @@ -0,0 +1,14 @@ +import { requestJson } from "../request-json" +import { z } from "zod" + +export function cancelCopilotAuthorization(request: Request, authorizationId: string) { + return requestJson( + new URL("/api/copilot-connection/authorizations/cancel", request.url), + z.undefined(), + { + body: JSON.stringify({ authorizationId }), + method: "POST", + signal: request.signal, + }, + ) +} diff --git a/hub/client/application/hub/requests/continue-copilot-authorization/index.ts b/hub/client/application/hub/requests/continue-copilot-authorization/index.ts new file mode 100644 index 000000000..6c9f36f46 --- /dev/null +++ b/hub/client/application/hub/requests/continue-copilot-authorization/index.ts @@ -0,0 +1,21 @@ +import { copilotContinuationResponseSchema } from "@application/hub/copilot-connection-contracts" + +import { requestJson } from "../request-json" + +export function continueCopilotAuthorization( + request: Request, + input: { + authorizationId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }, +) { + return requestJson( + new URL("/api/copilot-connection/authorizations/continue", request.url), + copilotContinuationResponseSchema, + { + body: JSON.stringify(input), + method: "POST", + signal: request.signal, + }, + ) +} diff --git a/hub/client/application/hub/requests/get-copilot-authorization/index.ts b/hub/client/application/hub/requests/get-copilot-authorization/index.ts new file mode 100644 index 000000000..88dd036cd --- /dev/null +++ b/hub/client/application/hub/requests/get-copilot-authorization/index.ts @@ -0,0 +1,11 @@ +import { copilotAuthorizationResponseSchema } from "@application/hub/copilot-connection-contracts" + +import { requestJson } from "../request-json" + +export function getCopilotAuthorization(request: Request, authorizationId: string) { + return requestJson( + new URL(`/api/copilot-connection/authorizations/${authorizationId}`, request.url), + copilotAuthorizationResponseSchema, + { signal: request.signal }, + ) +} diff --git a/hub/client/application/hub/requests/start-copilot-authorization/index.ts b/hub/client/application/hub/requests/start-copilot-authorization/index.ts new file mode 100644 index 000000000..d7991febc --- /dev/null +++ b/hub/client/application/hub/requests/start-copilot-authorization/index.ts @@ -0,0 +1,21 @@ +import { copilotAuthorizationStartResponseSchema } from "@application/hub/copilot-connection-contracts" + +import { requestJson } from "../request-json" + +export function startCopilotAuthorization( + request: Request, + input: { + confirmed: true + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }, +) { + return requestJson( + new URL("/api/copilot-connection/authorizations/start", request.url), + copilotAuthorizationStartResponseSchema, + { + body: JSON.stringify(input), + method: "POST", + signal: request.signal, + }, + ) +} diff --git a/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx new file mode 100644 index 000000000..e5781496a --- /dev/null +++ b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx @@ -0,0 +1,101 @@ +import { useState } from "react" +import { useNavigate } from "react-router" +import { z } from "zod" + +import { FreshAuthorizationPage } from "@pages/fresh-authorization-page" +import { cancelCopilotAuthorization } from "@application/hub/requests/cancel-copilot-authorization" +import { continueCopilotAuthorization } from "@application/hub/requests/continue-copilot-authorization" +import { getCopilotAuthorization } from "@application/hub/requests/get-copilot-authorization" +import { getCurrentHubSession } from "@application/hub/requests/get-current-hub-session" +import { administratorWorkspace } from "@application/hub/view-models/administrator-workspace" +import { ApiContractError } from "@application/hub/requests/api-contract-error" +import { ApiRequestError } from "@application/hub/requests/api-request-error" + +import type { Route } from "./+types/index" + +const authorizationIdSchema = z.uuid() + +export async function clientLoader({ request }: Pick) { + const authorizationId = authorizationIdSchema.safeParse( + new URL(request.url).searchParams.get("authorizationId"), + ) + if (!authorizationId.success) { + throw new Response("The authorization identifier is invalid.", { status: 400 }) + } + const session = await getCurrentHubSession(request) + if (session.role !== "ADMINISTRATOR") { + throw new Response("Administrator access is required.", { status: 403 }) + } + const { authorization } = await getCopilotAuthorization(request, authorizationId.data) + const connect = authorization.operation === "CONNECT_COPILOT" + return { + authorization, + authorizationId: authorizationId.data, + page: { + administrationWorkspace: administratorWorkspace(session, "copilot"), + productName: "Replica Hub", + pageTitle: connect ? "Complete Copilot connection" : "Complete Copilot disconnection", + heading: connect ? "Complete Copilot connection" : "Complete Copilot disconnection", + description: connect + ? "Your provider verified this session. Continue to check the configured token and connect Copilot, or cancel without changing the connection." + : "Your provider verified this session. Continue to disconnect Copilot, or cancel without changing the connection.", + submitLabel: connect ? "Connect Copilot" : "Disconnect Copilot", + submitPath: request.url, + cancelLabel: "Cancel", + cancelPath: request.url, + authenticityToken: "", + continuation: { id: authorizationId.data, method: "post" }, + }, + } +} + +export function meta() { + return [{ title: "Complete Copilot connection change - Replica Hub" }] +} + +export default function SettingsCopilotAuthorization({ + loaderData, +}: Pick) { + const navigate = useNavigate() + const [result, setResult] = useState<{ pending: boolean; error: string | null }>({ + pending: false, + error: null, + }) + return ( +
{ + if (!(event.target instanceof HTMLFormElement)) return + event.preventDefault() + if (result.pending) return + const form = new FormData(event.target) + const request = new Request(window.location.href) + setResult({ pending: true, error: null }) + const action = + form.get("_method") === "delete" + ? cancelCopilotAuthorization(request, loaderData.authorizationId).then( + () => "cancelled", + ) + : continueCopilotAuthorization(request, { + authorizationId: loaderData.authorizationId, + operation: loaderData.authorization.operation, + }).then((response) => (response.connected ? "connected" : "disconnected")) + void action + .then((outcome) => navigate(`/settings/copilot?result=${outcome}`)) + .catch((error: unknown) => { + if (!(error instanceof ApiRequestError) && !(error instanceof ApiContractError)) { + throw error + } + setResult({ + pending: false, + error: + error instanceof ApiRequestError + ? error.message + : "The API response was invalid. Copilot was not changed.", + }) + }) + }} + > + +
+ ) +} diff --git a/hub/client/application/hub/routes/settings-routes.ts b/hub/client/application/hub/routes/settings-routes.ts index 20dbf8704..dd5d2eec6 100644 --- a/hub/client/application/hub/routes/settings-routes.ts +++ b/hub/client/application/hub/routes/settings-routes.ts @@ -10,6 +10,7 @@ export const settingsWorkspaceRoutes: RouteConfigEntry[] = [ route("settings/canvas", "routes/settings-canvas/index.tsx"), route("settings/canvas/approve", "routes/settings-canvas-approval/index.tsx"), route("settings/copilot", "routes/settings-copilot/index.tsx"), + route("settings/copilot/confirm", "routes/settings-copilot-authorization/index.tsx"), route("settings/github", "routes/settings-github/index.tsx"), route("settings/admins", "routes/settings-admins/index.tsx"), route("settings/admins/:userId/:operation", "routes/settings-admin-confirmation/index.tsx"), diff --git a/hub/docs/README.md b/hub/docs/README.md index 6dd64fbb4..45d0caa3a 100644 --- a/hub/docs/README.md +++ b/hub/docs/README.md @@ -12,6 +12,7 @@ Hub is being rebuilt. The [Hub overview](../README.md) describes what the baseli - [Artifact storage](artifact-storage.md): provider selection and immutable byte storage. - [Database](database.md): Prisma schema conventions, migrations, and the shared client. - [Authentication and Hub sessions](authentication.md): provider-neutral proof, reusable administrator enrollment, admission, browser sessions, and existing-user administrator management. +- [Copilot connection](copilot.md): operator token configuration, fresh administrator authorization, durable connection state, and credential safety. - [Microsoft Entra OIDC](entra-oidc.md): single-tenant application, app-role, client-authentication, and manual setup contract. - [Logging](logging.md): application events, automatic request records, and payload safety. - [Telemetry](telemetry.md): explicit OpenTelemetry spans, safe attributes, and process lifetime. diff --git a/hub/docs/authentication.md b/hub/docs/authentication.md index 1130b635d..11866600b 100644 --- a/hub/docs/authentication.md +++ b/hub/docs/authentication.md @@ -80,6 +80,16 @@ Global session revocation exposes: - `POST /api/session-revocation/authorizations/continue` with the authorization UUID. Success atomically ends all sessions and clears the actor's session cookie. - `POST /api/session-revocation/authorizations/cancel` with the authorization UUID. +The Copilot connection reuses the same sensitive authorization boundary: + +- `GET /api/copilot-connection` returns the deployment connection state to a current administrator. +- `POST /api/copilot-connection/authorizations/start` binds `CONNECT_COPILOT` or `DISCONNECT_COPILOT` to the current session, actor membership, and connection generation. +- `GET /api/copilot-connection/authorizations/:id` returns the verified, unconsumed confirmation. +- `POST /api/copilot-connection/authorizations/continue` consumes the authorization and changes the connection. +- `POST /api/copilot-connection/authorizations/cancel` cancels it. + +The provider callback returns Copilot operations to `/settings/copilot/confirm`. A connection check runs outside the database transaction; the continuation then locks and compares the saved generation before committing, so a delayed result cannot restore or replace newer connection state. + The retained administrator frontend uses `/settings/administrators` for the roster and candidate search. Every selection and confirmation shows the stable membership UUID plus available provider presentation; a missing profile never hides the target identity. It starts authorization through the JSON API, validates the returned provider URL and then leaves the app through native browser navigation. The provider callback returns to `/settings/administrators/confirm?authorizationId=`, where the frontend displays the server-owned operation and targets before continuing or cancelling it through the JSON API. A successful self-removal immediately confirms that Hub ended the current session, removes administrator navigation, and keeps the signed-out completion result visible. The retained security-audit frontend uses `/settings/audit?scope=hub`. It restores the current administrator session, requests 50 records from `/api/security-audits`, and carries the server's opaque `nextCursor` only as the `before` URL parameter. It shows the stable actor membership UUID when available, action, outcome, UTC time, and the API's bounded allowlisted context. Unknown actions remain visible with no additional details. A `403` refreshes the current session before the route reports lost administrator access; malformed API responses and request failures remain visible. Repository audit in mock mode is a provisional fixture, not a production API. diff --git a/hub/docs/copilot.md b/hub/docs/copilot.md new file mode 100644 index 000000000..9ab35b3e2 --- /dev/null +++ b/hub/docs/copilot.md @@ -0,0 +1,45 @@ +# Copilot connection + +A Hub administrator can connect one operator-provided Copilot token for the deployment. Hub checks the token through the Copilot SDK, stores only its SHA-256 digest and connection provenance, and never returns or logs the credential. + +The connection is an administration foundation. No rebuilt Hub product job consumes it yet. + +## Configure the token + +The operator creates a fine-grained personal access token whose only account permission is Copilot requests, stores it as `REPLICA_COPILOT_TOKEN`, and restarts every Hub API and worker process with the same configuration. + +Hub reads the token only from the process environment. The database keeps its digest so future Copilot results can be associated with the configured credential without storing the credential itself. + +## Administrator flow + +1. A current Hub administrator opens `/settings/copilot`. +2. Hub returns the connection state, connector membership, last successful check, and whether a token is configured. +3. The administrator explicitly confirms connect or disconnect. +4. Hub starts fresh authorization through the provider recorded on the current Hub session. +5. The callback verifies the same session and external identity, then returns to `/settings/copilot/confirm`. +6. Continuing a connection checks the configured token with the Copilot SDK before one serializable transaction saves the connection and audits the change. Continuing a disconnection clears the database state without changing the operator's secret. + +The authorization is short-lived, one-use, and bound to the Hub session, operation, actor membership, and connection generation. A connection change after authorization starts or while Copilot checks the token returns a conflict instead of overwriting newer state. + +## Stored state + +Hub stores one global connection record: + +- the membership that connected Copilot; +- the token digest; +- the last successful verification time; +- a generation that orders connection changes; +- an optional refusal time reserved for a Copilot consumer to record a rejected current token. + +Connect, disconnect, page access, and authorization phases write bounded security audits. Audit context contains membership IDs, operations, outcomes, and safe reason codes. It never contains the token or Copilot response payloads. + +## Failure behavior + +- Without `REPLICA_COPILOT_TOKEN`, Hub shows the configuration requirement and does not offer connection. +- A token Copilot refuses produces a denied change and no connection. +- An unavailable Copilot service produces a failed change and no connection. +- A stale, cancelled, expired, reused, or mismatched authorization changes nothing. +- When the connector loses their final effective administrator assignment, the same authority transaction disconnects Copilot and audits the result. +- Disconnecting leaves the token in the operator's secret store. The token owner must revoke it separately when required. + +Token replacement requires a coordinated restart so every process uses the same environment. Do not overlap old-token and new-token Hub processes. The Copilot page detects that the configured digest changed and requires an administrator to check the replacement before Hub records it as verified. diff --git a/hub/package-lock.json b/hub/package-lock.json index 77c7ef2a6..009c78c1d 100644 --- a/hub/package-lock.json +++ b/hub/package-lock.json @@ -11,6 +11,7 @@ "dependencies": { "@azure/identity": "4.13.0", "@azure/storage-blob": "12.33.0", + "@github/copilot-sdk": "1.0.16", "@opentelemetry/api": "1.10.0", "@opentelemetry/context-async-hooks": "3.0.0", "@opentelemetry/exporter-trace-otlp-proto": "0.300.0", @@ -37,7 +38,6 @@ }, "devDependencies": { "@eslint/js": "10.0.1", - "@github/copilot-sdk": "1.0.16", "@react-router/dev": "8.5.0", "@react-router/node": "8.5.0", "@storybook/addon-a11y": "10.6.1", @@ -1381,7 +1381,6 @@ }, "node_modules/@github/copilot-sdk": { "version": "1.0.16", - "dev": true, "license": "MIT", "dependencies": { "koffi": "3.2.1", @@ -1409,7 +1408,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1423,7 +1421,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1437,7 +1434,6 @@ "cpu": [ "arm64" ], - "dev": true, "libc": [ "glibc" ], @@ -1454,7 +1450,6 @@ "cpu": [ "x64" ], - "dev": true, "libc": [ "glibc" ], @@ -1471,7 +1466,6 @@ "cpu": [ "arm64" ], - "dev": true, "libc": [ "musl" ], @@ -1488,7 +1482,6 @@ "cpu": [ "x64" ], - "dev": true, "libc": [ "musl" ], @@ -1505,7 +1498,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1517,7 +1509,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1526,7 +1517,6 @@ }, "node_modules/@github/copilot-sdk/node_modules/zod": { "version": "4.3.6", - "dev": true, "license": "MIT", "funding": { "url": "https://github.com/sponsors/colinhacks" @@ -1750,7 +1740,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1767,7 +1756,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1784,7 +1772,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1801,7 +1788,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1818,7 +1804,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1835,7 +1820,6 @@ "cpu": [ "ia32" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1852,7 +1836,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1869,7 +1852,6 @@ "cpu": [ "arm" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1886,7 +1868,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1903,7 +1884,6 @@ "cpu": [ "ia32" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1920,7 +1900,6 @@ "cpu": [ "loong64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1937,7 +1916,6 @@ "cpu": [ "riscv64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1954,7 +1932,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1971,7 +1948,6 @@ "cpu": [ "ia32" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1988,7 +1964,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -2005,7 +1980,6 @@ "cpu": [ "arm64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -2022,7 +1996,6 @@ "cpu": [ "ia32" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -2037,7 +2010,6 @@ "cpu": [ "x64" ], - "dev": true, "license": "MIT", "optional": true, "os": [ @@ -7440,7 +7412,6 @@ }, "node_modules/koffi": { "version": "3.2.1", - "dev": true, "hasInstallScript": true, "license": "MIT", "funding": { @@ -10053,7 +10024,6 @@ }, "node_modules/vscode-jsonrpc": { "version": "8.2.1", - "dev": true, "license": "MIT", "engines": { "node": ">=14.0.0" diff --git a/hub/package.json b/hub/package.json index f73e05a37..12c3b2993 100644 --- a/hub/package.json +++ b/hub/package.json @@ -53,6 +53,7 @@ "dependencies": { "@azure/identity": "4.13.0", "@azure/storage-blob": "12.33.0", + "@github/copilot-sdk": "1.0.16", "@opentelemetry/api": "1.10.0", "@opentelemetry/context-async-hooks": "3.0.0", "@opentelemetry/exporter-trace-otlp-proto": "0.300.0", @@ -79,7 +80,6 @@ }, "devDependencies": { "@eslint/js": "10.0.1", - "@github/copilot-sdk": "1.0.16", "@react-router/dev": "8.5.0", "@react-router/node": "8.5.0", "@storybook/addon-a11y": "10.6.1", diff --git a/hub/schema/membership.prisma b/hub/schema/membership.prisma index d186d3828..3fcfb99eb 100644 --- a/hub/schema/membership.prisma +++ b/hub/schema/membership.prisma @@ -4,9 +4,10 @@ model Membership { userId String @unique @map("user_id") @db.Uuid // Relations - user User @relation(fields: [userId], references: [id], onDelete: Restrict) - assignments MembershipAssignment[] - sessions HubSession[] + user User @relation(fields: [userId], references: [id], onDelete: Restrict) + assignments MembershipAssignment[] + copilotConnections CopilotConnectionState[] + sessions HubSession[] sensitiveAuthorizations SensitiveAuthorization[] copilotConnections CopilotConnection[] diff --git a/hub/schema/migrations/20261112170000_copilot_connection/migration.sql b/hub/schema/migrations/20261112170000_copilot_connection/migration.sql new file mode 100644 index 000000000..648f6b45a --- /dev/null +++ b/hub/schema/migrations/20261112170000_copilot_connection/migration.sql @@ -0,0 +1,2 @@ +ALTER TYPE "SensitiveAuthorizationOperation" ADD VALUE 'CONNECT_COPILOT'; +ALTER TYPE "SensitiveAuthorizationOperation" ADD VALUE 'DISCONNECT_COPILOT'; diff --git a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql new file mode 100644 index 000000000..0d2577db9 --- /dev/null +++ b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql @@ -0,0 +1,56 @@ +ALTER TABLE "sensitive_authorizations" +ADD COLUMN "expected_copilot_generation" BIGINT; + +CREATE TABLE "copilot_connection_states" ( + "id" UUID NOT NULL, + "connected_by_membership_id" UUID, + "key" VARCHAR(20) NOT NULL DEFAULT 'global', + "generation" BIGINT NOT NULL DEFAULT 0, + "token_digest" CHAR(64), + "verified_at" TIMESTAMPTZ(3), + "refused_at" TIMESTAMPTZ(3), + "created_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updated_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT "copilot_connection_states_pkey" PRIMARY KEY ("id"), + CONSTRAINT "copilot_connection_states_key_check" CHECK ("key" = 'global'), + CONSTRAINT "copilot_connection_states_generation_check" CHECK ("generation" >= 0), + CONSTRAINT "copilot_connection_states_digest_check" CHECK ( + "token_digest" IS NULL OR "token_digest" ~ '^[0-9a-f]{64}$' + ), + CONSTRAINT "copilot_connection_states_connection_check" CHECK ( + ( + "connected_by_membership_id" IS NULL + AND "token_digest" IS NULL + AND "verified_at" IS NULL + AND "refused_at" IS NULL + ) + OR ( + "connected_by_membership_id" IS NOT NULL + AND "token_digest" IS NOT NULL + AND "verified_at" IS NOT NULL + ) + ) +); + +CREATE UNIQUE INDEX "copilot_connection_states_key_key" ON "copilot_connection_states"("key"); + +ALTER TABLE "copilot_connection_states" +ADD CONSTRAINT "copilot_connection_states_connected_by_membership_id_fkey" +FOREIGN KEY ("connected_by_membership_id") REFERENCES "memberships"("id") +ON DELETE RESTRICT ON UPDATE CASCADE; + +ALTER TABLE "sensitive_authorizations" +ADD CONSTRAINT "sensitive_authorizations_copilot_generation_check" CHECK ( + ( + "operation" IN ('CONNECT_COPILOT', 'DISCONNECT_COPILOT') + AND "expected_copilot_generation" IS NOT NULL + ) + OR ( + "operation" NOT IN ('CONNECT_COPILOT', 'DISCONNECT_COPILOT') + AND "expected_copilot_generation" IS NULL + ) +); + +INSERT INTO "copilot_connection_states" ("id", "key") +VALUES ('00000000-0000-4000-8000-000000000003', 'global'); diff --git a/hub/schema/sensitive-authorization-operation.enum.prisma b/hub/schema/sensitive-authorization-operation.enum.prisma index a86738377..384804d79 100644 --- a/hub/schema/sensitive-authorization-operation.enum.prisma +++ b/hub/schema/sensitive-authorization-operation.enum.prisma @@ -1,5 +1,7 @@ enum SensitiveAuthorizationOperation { + CONNECT_COPILOT DESIGNATE_ADMINISTRATORS + DISCONNECT_COPILOT END_ALL_HUB_SESSIONS REVOKE_ADMINISTRATOR } diff --git a/hub/schema/sensitive-authorization.prisma b/hub/schema/sensitive-authorization.prisma index 604766fc3..d61d3ebcb 100644 --- a/hub/schema/sensitive-authorization.prisma +++ b/hub/schema/sensitive-authorization.prisma @@ -6,18 +6,19 @@ model SensitiveAuthorization { externalIdentityId String @map("external_identity_id") @db.Uuid // Relations - hubSession HubSession @relation(fields: [hubSessionId], references: [id], onDelete: Restrict) - actorMembership Membership @relation(fields: [actorMembershipId], references: [id], onDelete: Restrict) - externalIdentity ExternalIdentity @relation(fields: [externalIdentityId], references: [id], onDelete: Restrict) + hubSession HubSession @relation(fields: [hubSessionId], references: [id], onDelete: Restrict) + actorMembership Membership @relation(fields: [actorMembershipId], references: [id], onDelete: Restrict) + externalIdentity ExternalIdentity @relation(fields: [externalIdentityId], references: [id], onDelete: Restrict) authorizationAttempt AuthorizationAttempt? // Attribute columns - operation SensitiveAuthorizationOperation - targetMembershipIds String[] @map("target_membership_ids") @db.Uuid - expiresAt DateTime @map("expires_at") @db.Timestamptz(3) - verifiedAt DateTime? @map("verified_at") @db.Timestamptz(3) - continuedAt DateTime? @map("continued_at") @db.Timestamptz(3) - cancelledAt DateTime? @map("cancelled_at") @db.Timestamptz(3) + operation SensitiveAuthorizationOperation + targetMembershipIds String[] @map("target_membership_ids") @db.Uuid + expectedCopilotGeneration BigInt? @map("expected_copilot_generation") + expiresAt DateTime @map("expires_at") @db.Timestamptz(3) + verifiedAt DateTime? @map("verified_at") @db.Timestamptz(3) + continuedAt DateTime? @map("continued_at") @db.Timestamptz(3) + cancelledAt DateTime? @map("cancelled_at") @db.Timestamptz(3) // Timestamp columns createdAt DateTime @default(now()) @map("created_at") @db.Timestamptz(3) diff --git a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts index afc1321ec..42fd6bbc2 100644 --- a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts +++ b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts @@ -407,18 +407,21 @@ describe("administrator authorization persistence", () => { cancelSensitiveAuthorization(prisma, { hubSessionId: randomUUID(), id: fixture.authorizationId, + scope: "administrator", }), ).resolves.toBeNull() await expect( cancelSensitiveAuthorization(prisma, { hubSessionId: fixture.hubSessionId, id: fixture.authorizationId, + scope: "administrator", }), ).resolves.toMatchObject({ id: fixture.authorizationId }) await expect( cancelSensitiveAuthorization(prisma, { hubSessionId: fixture.hubSessionId, id: fixture.authorizationId, + scope: "administrator", }), ).resolves.toBeNull() await expect( diff --git a/hub/server/domains/administrator-authorization/verify-administrator-authorization/index.ts b/hub/server/domains/administrator-authorization/verify-administrator-authorization/index.ts index 711453d3d..ce5b22852 100644 --- a/hub/server/domains/administrator-authorization/verify-administrator-authorization/index.ts +++ b/hub/server/domains/administrator-authorization/verify-administrator-authorization/index.ts @@ -34,13 +34,25 @@ export async function verifyAdministratorAuthorization( getAuthorizationAuditData(id: string): Promise<{ actorMembershipId: string expired: boolean - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetCount: number } | null> runTransaction: AdministratorAuthorizationVerificationTransaction writeAudit(event: CreateSecurityAuditEvent): Promise }, -): Promise { +): Promise< + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" + | null +> { const parsed = inputSchema.parse(rawInput) const input = { ...parsed, @@ -110,7 +122,7 @@ export async function verifyAdministratorAuthorization( type: "administrator_authorization", }) } - return false + return null } } const verified = await repositories.verifySensitiveAuthorization({ @@ -135,7 +147,7 @@ export async function verifyAdministratorAuthorization( type: "administrator_authorization", }) } - return false + return null } await repositories.createSecurityAudit({ actorMembershipId: verified.actorMembershipId, @@ -146,7 +158,7 @@ export async function verifyAdministratorAuthorization( targetCount: verified.targetCount, type: "administrator_authorization", }) - return true + return verified.operation }), (error) => error instanceof AdmissionTransactionConflictError, ) diff --git a/hub/server/domains/administrator-management/create-administrator-management-repositories/index.ts b/hub/server/domains/administrator-management/create-administrator-management-repositories/index.ts index f75c9e423..68a1bafc7 100644 --- a/hub/server/domains/administrator-management/create-administrator-management-repositories/index.ts +++ b/hub/server/domains/administrator-management/create-administrator-management-repositories/index.ts @@ -9,6 +9,7 @@ import { revokeAdministratorAssignment } from "../../../repositories/membership- import { lockAdministratorManagementTargets } from "../../../repositories/memberships/lock-administrator-management-targets/index.ts" import { lockEffectiveAdministrators } from "../../../repositories/memberships/lock-effective-administrators/index.ts" import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { disconnectCopilotConnectionForMembership } from "../../../repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts" import type { AdministratorManagementRepositories } from "../run-administrator-management-transaction/types.ts" export function createAdministratorManagementRepositories( @@ -17,6 +18,8 @@ export function createAdministratorManagementRepositories( return { createAssignment: (input) => createAdministratorAssignment(transaction, input), createSecurityAudit: (input) => createSecurityAudit(transaction, input), + disconnectCopilotConnection: (membershipId) => + disconnectCopilotConnectionForMembership(transaction, membershipId), endOpenSessions: (membershipId) => endOpenHubSessionsForMembership(transaction, membershipId), lockActiveAssignment: (membershipId) => lockActiveAdministratorAssignment(transaction, membershipId), diff --git a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts index c1bc5e0d7..308ffdeb0 100644 --- a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts +++ b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts @@ -35,6 +35,21 @@ export async function revokeHubAdministratorWithRepositories( if (remainingAdministrators.length === 0) { throw new AdministratorManagementDeniedError("last_administrator") } + if ( + !remainingAdministrators.some( + ({ membershipId }) => membershipId === input.targetMembershipId, + ) && + (await repositories.disconnectCopilotConnection?.(input.targetMembershipId)) + ) { + await repositories.createSecurityAudit({ + actorMembershipId: input.actorMembershipId, + id: createId(), + operation: "disconnect", + outcome: "success", + reason: "connector_role_removed", + type: "copilot_connection", + }) + } await repositories.createSecurityAudit({ actorMembershipId: input.actorMembershipId, assignmentId: assignment.id, diff --git a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts index 9fd71c855..e7e040ded 100644 --- a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts +++ b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts @@ -8,6 +8,7 @@ export interface AdministratorManagementRepositories { membershipId: string }): Promise<{ id: string }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise + disconnectCopilotConnection?(membershipId: string): Promise endOpenSessions(membershipId: string): Promise> lockActiveAssignment(membershipId: string): Promise<{ id: string } | null> lockEffectiveAdministratorAssignments(membershipIds: string[]): Promise> diff --git a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts index 17fb641f7..992fa5800 100644 --- a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts +++ b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts @@ -135,6 +135,20 @@ export async function applyProviderAssignmentEvidence( } } const assignments = await dependencies.repositories.lockActiveAssignments(membershipId) + const administrator = assignments.some((assignment) => assignment.role === "ADMINISTRATOR") + if ( + !administrator && + (await dependencies.repositories.disconnectCopilotConnection?.(membershipId)) + ) { + await dependencies.repositories.createSecurityAudit({ + actorMembershipId: membershipId, + id: dependencies.createId(), + operation: "disconnect", + outcome: "success", + reason: "connector_role_removed", + type: "copilot_connection", + }) + } if (!assignments.length) { return { denied: true, @@ -144,8 +158,6 @@ export async function applyProviderAssignmentEvidence( return { denied: false, membershipId, - role: assignments.some((assignment) => assignment.role === "ADMINISTRATOR") - ? "ADMINISTRATOR" - : "MEMBER", + role: administrator ? "ADMINISTRATOR" : "MEMBER", } } diff --git a/hub/server/domains/admission/run-admission-transaction/index.ts b/hub/server/domains/admission/run-admission-transaction/index.ts index 87758b750..aee352ab5 100644 --- a/hub/server/domains/admission/run-admission-transaction/index.ts +++ b/hub/server/domains/admission/run-admission-transaction/index.ts @@ -8,6 +8,7 @@ import { endOpenHubSessionsForMembership } from "../../../repositories/hub-sessi import { createProviderAssignment } from "../../../repositories/membership-assignments/create-provider-assignment/index.ts" import { createOrRestoreBootstrapAssignment } from "../../../repositories/membership-assignments/create-or-restore-bootstrap-assignment/index.ts" import { endProviderAssignment } from "../../../repositories/membership-assignments/end-provider-assignment/index.ts" +import { disconnectCopilotConnectionForMembership } from "../../../repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts" import { lockActiveMembershipAssignments } from "../../../repositories/membership-assignments/lock-active-membership-assignments/index.ts" import { lockActiveProviderAssignment } from "../../../repositories/membership-assignments/lock-active-provider-assignment/index.ts" import { createMembership } from "../../../repositories/memberships/create-membership/index.ts" @@ -36,6 +37,8 @@ export function runAdmissionTransaction( createHubSession: (input) => createHubSession(transaction, input), createOrRestoreMembership: (input) => createOrRestoreMembership(transaction, input), createSecurityAudit: (input) => createSecurityAudit(transaction, input), + disconnectCopilotConnection: (membershipId) => + disconnectCopilotConnectionForMembership(transaction, membershipId), endProviderAssignment: (input) => endProviderAssignment(transaction, input), endOpenHubSessionsForMembership: (membershipId) => endOpenHubSessionsForMembership(transaction, membershipId), diff --git a/hub/server/domains/admission/run-admission-transaction/types.ts b/hub/server/domains/admission/run-admission-transaction/types.ts index 426d91e6e..6796224b2 100644 --- a/hub/server/domains/admission/run-admission-transaction/types.ts +++ b/hub/server/domains/admission/run-admission-transaction/types.ts @@ -36,6 +36,7 @@ export interface AdmissionRepositories { transition: "created" | "restored" | "unchanged" }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise + disconnectCopilotConnection?(membershipId: string): Promise endProviderAssignment(input: { id: string; lifecycle: "SUPERSEDED" | "REVOKED" }): Promise endOpenHubSessionsForMembership(membershipId: string): Promise> lockActiveAssignments(membershipId: string): Promise< diff --git a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts new file mode 100644 index 000000000..b8b267991 --- /dev/null +++ b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts @@ -0,0 +1,259 @@ +import { createHash, randomUUID } from "node:crypto" +import { z } from "zod" +import { Prisma } from "../../../generated/prisma/client.ts" + +import { CopilotTokenCheckError } from "../../../integrations/copilot/check-copilot-token/errors.ts" +import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { lockCopilotConnectionState } from "../../../repositories/copilot-connection-state/lock-copilot-connection-state/index.ts" +import { saveCopilotConnectionState } from "../../../repositories/copilot-connection-state/save-copilot-connection-state/index.ts" +import { lockLiveHubSession } from "../../../repositories/hub-sessions/lock-live-hub-session/index.ts" +import { lockEffectiveAdministratorProviders } from "../../../repositories/authentication-providers/lock-effective-administrator-providers/index.ts" +import { lockEffectiveAdministrators } from "../../../repositories/memberships/lock-effective-administrators/index.ts" +import { lockSensitiveAuthorization } from "../../../repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts" +import { markSensitiveAuthorizationContinued } from "../../../repositories/sensitive-authorizations/mark-sensitive-authorization-continued/index.ts" +import { CopilotConnectionDeniedError, CopilotConnectionUnavailableError } from "../errors.ts" + +const inputSchema = z + .object({ + authorizationId: z.uuid(), + hubSessionId: z.uuid(), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), + token: z.string().min(1).optional(), + }) + .strict() + +export async function continueCopilotAuthorization( + database: PrismaClientLike, + rawInput: unknown, + checkToken: (token: string) => Promise, +) { + const input = inputSchema.parse(rawInput) + try { + await requireCurrentAuthorization(database, input) + } catch (error) { + if ( + error instanceof CopilotConnectionDeniedError && + (error.reason === "connection_changed" || error.reason === "not_connected") + ) { + await recordFailure(database, input, error.reason, "denied") + } + throw error + } + let tokenDigest: string | undefined + if (input.operation === "CONNECT_COPILOT") { + if (!input.token) { + const reason = await recordFailure(database, input, "no_token", "denied") + if (reason === "unavailable") { + throw new CopilotConnectionUnavailableError("Copilot could not check the configured token.") + } + throw new CopilotConnectionDeniedError(reason) + } + try { + await checkToken(input.token) + tokenDigest = createHash("sha256").update(input.token).digest("hex") + } catch (error) { + const reason = + error instanceof CopilotTokenCheckError && error.reason === "refused" + ? "refused" + : "unavailable" + const recordedReason = await recordFailure( + database, + input, + reason, + reason === "refused" ? "denied" : "failure", + ) + if (recordedReason !== "unavailable") { + throw new CopilotConnectionDeniedError(recordedReason) + } + throw new CopilotConnectionUnavailableError("Copilot could not check the configured token.", { + cause: error, + }) + } + } + + try { + return await database.$transaction( + async (transaction) => { + const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) + if ( + !authorization || + authorization.hubSessionId !== input.hubSessionId || + authorization.operation !== input.operation || + authorization.targetMembershipIds.length !== 1 || + authorization.targetMembershipIds[0] !== authorization.actorMembershipId || + authorization.cancelledAt || + authorization.continuedAt || + authorization.expired || + !authorization.verifiedAt || + !(await lockLiveHubSession(transaction, input.hubSessionId)) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + await lockEffectiveAdministratorProviders(transaction) + const administrators = await lockEffectiveAdministrators(transaction) + if ( + !administrators.some( + ({ membershipId }) => membershipId === authorization.actorMembershipId, + ) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + const state = await lockCopilotConnectionState(transaction) + if ( + !state || + authorization.expectedCopilotGeneration === null || + state.generation !== authorization.expectedCopilotGeneration + ) { + throw new CopilotConnectionDeniedError("connection_changed") + } + if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { + throw new CopilotConnectionDeniedError("not_connected") + } + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) + await saveCopilotConnectionState( + transaction, + input.operation === "CONNECT_COPILOT" + ? { + membershipId: authorization.actorMembershipId, + operation: "connect", + tokenDigest: tokenDigest!, + } + : { operation: "disconnect" }, + ) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + id: randomUUID(), + operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", + outcome: "success", + type: "copilot_connection", + }) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + authorizationId: input.authorizationId, + id: randomUUID(), + operation: input.operation, + phase: "completed", + targetCount: 1, + type: "administrator_authorization", + }) + return { connected: input.operation === "CONNECT_COPILOT" } + }, + { isolationLevel: Prisma.TransactionIsolationLevel.Serializable }, + ) + } catch (error) { + if ( + error instanceof CopilotConnectionDeniedError && + (error.reason === "connection_changed" || error.reason === "not_connected") + ) { + await recordFailure(database, input, error.reason, "denied") + } + throw error + } +} + +interface PrismaClientLike { + $transaction( + operation: (transaction: Prisma.TransactionClient) => Promise, + options?: { isolationLevel?: Prisma.TransactionIsolationLevel }, + ): Promise +} + +async function requireCurrentAuthorization( + database: PrismaClientLike, + input: z.infer, +) { + await database.$transaction(async (transaction) => { + const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) + if ( + !authorization || + authorization.hubSessionId !== input.hubSessionId || + authorization.operation !== input.operation || + authorization.targetMembershipIds.length !== 1 || + authorization.targetMembershipIds[0] !== authorization.actorMembershipId || + authorization.cancelledAt || + authorization.continuedAt || + authorization.expired || + !authorization.verifiedAt || + !(await lockLiveHubSession(transaction, input.hubSessionId)) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + await lockEffectiveAdministratorProviders(transaction) + const administrators = await lockEffectiveAdministrators(transaction) + if ( + !administrators.some(({ membershipId }) => membershipId === authorization.actorMembershipId) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + const state = await lockCopilotConnectionState(transaction) + if ( + !state || + authorization.expectedCopilotGeneration === null || + state.generation !== authorization.expectedCopilotGeneration + ) { + throw new CopilotConnectionDeniedError("connection_changed") + } + if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { + throw new CopilotConnectionDeniedError("not_connected") + } + }) +} + +async function recordFailure( + database: PrismaClientLike, + input: z.infer, + reason: "connection_changed" | "no_token" | "not_connected" | "refused" | "unavailable", + outcome: "denied" | "failure", +): Promise< + | "authorization_unavailable" + | "connection_changed" + | "no_token" + | "not_connected" + | "refused" + | "unavailable" +> { + return database.$transaction(async (transaction) => { + const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) + if ( + !authorization || + authorization.hubSessionId !== input.hubSessionId || + authorization.operation !== input.operation || + authorization.cancelledAt || + authorization.continuedAt || + authorization.expired || + !authorization.verifiedAt || + !(await lockLiveHubSession(transaction, input.hubSessionId)) + ) { + return "authorization_unavailable" + } + const state = await lockCopilotConnectionState(transaction) + let recordedReason = reason + if ( + !state || + authorization.expectedCopilotGeneration === null || + state.generation !== authorization.expectedCopilotGeneration + ) { + recordedReason = "connection_changed" + } + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + id: randomUUID(), + operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", + outcome, + reason: recordedReason, + type: "copilot_connection", + }) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + authorizationId: input.authorizationId, + id: randomUUID(), + operation: input.operation, + phase: "denied", + reason: recordedReason, + targetCount: 1, + type: "administrator_authorization", + }) + return recordedReason + }) +} diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.ts index 3c4aab3b6..fc0b50e58 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.ts @@ -173,6 +173,19 @@ export async function reconcileAuthenticationProviders( providerKey: provider.key, }) } + const disconnected = + await repositories.disconnectCopilotConnectionWithoutEffectiveAdministrator?.() + if (disconnected) { + await repositories.createSecurityAudit({ + actorMembershipId: null, + connectorMembershipId: disconnected.membershipId, + id: dependencies.createId(), + operation: "disconnect", + outcome: "success", + reason: "connector_role_removed", + type: "copilot_connection", + }) + } } return result }), diff --git a/hub/server/domains/identity/run-provider-revision-transaction/index.ts b/hub/server/domains/identity/run-provider-revision-transaction/index.ts index c5cfa1f57..32916ca3a 100644 --- a/hub/server/domains/identity/run-provider-revision-transaction/index.ts +++ b/hub/server/domains/identity/run-provider-revision-transaction/index.ts @@ -7,6 +7,7 @@ import { findAuthenticationProvider } from "../../../repositories/authentication import { lockAuthenticationProvidersForReconciliation } from "../../../repositories/authentication-providers/lock-authentication-providers-for-reconciliation/index.ts" import { selectAuthenticationProviderRevision } from "../../../repositories/authentication-providers/select-authentication-provider-revision/index.ts" import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { disconnectCopilotConnectionWithoutEffectiveAdministrator } from "../../../repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts" import { incrementSessionRevocationState } from "../../../repositories/session-revocation-states/increment-session-revocation-state/index.ts" import { classifyPrismaTransactionError } from "../../../integrations/prisma/classify-transaction-error/index.ts" import { IdentityTransactionConflictError } from "../errors.ts" @@ -29,6 +30,8 @@ export function runProviderRevisionTransaction( createAuthenticationProviderRevision: (input) => createAuthenticationProviderRevision(transaction, input), createSecurityAudit: (input) => createSecurityAudit(transaction, input), + disconnectCopilotConnectionWithoutEffectiveAdministrator: () => + disconnectCopilotConnectionWithoutEffectiveAdministrator(transaction), disableAuthenticationProvider: (providerId) => disableAuthenticationProvider(transaction, providerId), enableAuthenticationProvider: (input) => enableAuthenticationProvider(transaction, input), diff --git a/hub/server/domains/identity/run-provider-revision-transaction/types.ts b/hub/server/domains/identity/run-provider-revision-transaction/types.ts index f7b8d2b95..110101f76 100644 --- a/hub/server/domains/identity/run-provider-revision-transaction/types.ts +++ b/hub/server/domains/identity/run-provider-revision-transaction/types.ts @@ -37,6 +37,9 @@ export interface ProviderRevisionRepositories { } export interface AuthenticationProviderReconciliationRepositories extends ProviderRevisionRepositories { + disconnectCopilotConnectionWithoutEffectiveAdministrator?(): Promise<{ + membershipId: string + } | null> disableAuthenticationProvider(providerId: string): Promise enableAuthenticationProvider(input: { providerId: string; revisionId: string }): Promise incrementSessionRevocation(): Promise<{ revision: number } | null> diff --git a/hub/server/integrations/copilot/check-copilot-token/errors.ts b/hub/server/integrations/copilot/check-copilot-token/errors.ts new file mode 100644 index 000000000..3430496c8 --- /dev/null +++ b/hub/server/integrations/copilot/check-copilot-token/errors.ts @@ -0,0 +1,14 @@ +export class CopilotTokenCheckError extends Error { + readonly reason: "refused" | "unavailable" + + constructor(reason: "refused" | "unavailable", options?: ErrorOptions) { + super( + reason === "refused" + ? "Copilot refused the configured token." + : "Copilot could not check the configured token.", + options, + ) + this.name = "CopilotTokenCheckError" + this.reason = reason + } +} diff --git a/hub/server/integrations/copilot/check-copilot-token/index.ts b/hub/server/integrations/copilot/check-copilot-token/index.ts new file mode 100644 index 000000000..ea60b047d --- /dev/null +++ b/hub/server/integrations/copilot/check-copilot-token/index.ts @@ -0,0 +1,54 @@ +import { mkdtemp, rm } from "node:fs/promises" +import { tmpdir } from "node:os" +import path from "node:path" + +import { CopilotTokenCheckError } from "./errors.ts" + +const checkTimeoutMilliseconds = 20_000 + +function classify(error: unknown): "refused" | "unavailable" { + const message = String(error instanceof Error ? error.message : error).slice(0, 500) + return /\b40[13]\b|unauthori[sz]ed|forbidden|authenticat|not signed in|no copilot|subscription|access denied/i.test( + message, + ) + ? "refused" + : "unavailable" +} + +export async function checkCopilotToken(token: string): Promise { + const sdk = await import("@github/copilot-sdk").catch((error: unknown) => { + throw new CopilotTokenCheckError("unavailable", { cause: error }) + }) + const home = await mkdtemp(path.join(tmpdir(), "replica-hub-copilot-")) + const client = new sdk.CopilotClient({ + baseDirectory: home, + gitHubToken: token, + logLevel: "error", + mode: "empty", + useLoggedInUser: false, + }) + let timeout: ReturnType | undefined + try { + await Promise.race([ + (async () => { + await client.start() + const authentication = await client.getAuthStatus() + if (!authentication?.isAuthenticated) throw new CopilotTokenCheckError("refused") + await client.listModels() + })(), + new Promise((_resolve, reject) => { + timeout = setTimeout( + () => reject(new CopilotTokenCheckError("unavailable")), + checkTimeoutMilliseconds, + ) + }), + ]) + } catch (error) { + if (error instanceof CopilotTokenCheckError) throw error + throw new CopilotTokenCheckError(classify(error), { cause: error }) + } finally { + if (timeout) clearTimeout(timeout) + await client.stop().catch(() => undefined) + await rm(home, { force: true, recursive: true }) + } +} diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts new file mode 100644 index 000000000..eafda866e --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts @@ -0,0 +1,21 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function disconnectCopilotConnectionForMembership( + database: Pick, + membershipId: string, +): Promise { + const rows = await database.$queryRaw>` + UPDATE "copilot_connection_states" + SET + "connected_by_membership_id" = NULL, + "token_digest" = NULL, + "verified_at" = NULL, + "refused_at" = NULL, + "generation" = "generation" + 1, + "updated_at" = clock_timestamp() + WHERE "key" = 'global' + AND "connected_by_membership_id" = ${membershipId}::uuid + RETURNING "id" + ` + return rows.length === 1 +} diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts new file mode 100644 index 000000000..348e08cc4 --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts @@ -0,0 +1,46 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function disconnectCopilotConnectionWithoutEffectiveAdministrator( + database: Pick, +): Promise<{ membershipId: string } | null> { + const rows = await database.$queryRaw>` + WITH disconnected AS ( + SELECT connection."id", connection."connected_by_membership_id" + FROM "copilot_connection_states" connection + WHERE connection."key" = 'global' + AND connection."connected_by_membership_id" IS NOT NULL + AND NOT EXISTS ( + SELECT 1 + FROM "membership_assignments" assignment + LEFT JOIN "authentication_provider_revisions" revision + ON revision."id" = assignment."provider_revision_id" + LEFT JOIN "authentication_providers" provider + ON provider."id" = revision."provider_id" + WHERE assignment."membership_id" = connection."connected_by_membership_id" + AND assignment."lifecycle" = 'ACTIVE' + AND assignment."role" = 'ADMINISTRATOR' + AND ( + assignment."source" IN ('BOOTSTRAP', 'HUB_ADMINISTRATOR') + OR ( + assignment."source" = 'AUTHENTICATION_PROVIDER' + AND provider."enabled" = true + AND provider."selected_revision_id" = assignment."provider_revision_id" + ) + ) + ) + FOR UPDATE OF connection + ) + UPDATE "copilot_connection_states" connection + SET + "connected_by_membership_id" = NULL, + "token_digest" = NULL, + "verified_at" = NULL, + "refused_at" = NULL, + "generation" = "generation" + 1, + "updated_at" = clock_timestamp() + FROM disconnected + WHERE connection."id" = disconnected."id" + RETURNING disconnected."connected_by_membership_id" AS "membershipId" + ` + return rows[0] ?? null +} diff --git a/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts new file mode 100644 index 000000000..4e79713ce --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts @@ -0,0 +1,31 @@ +import type { PrismaClient } from "../../../generated/prisma/client.ts" + +export async function getCopilotConnectionState( + database: Pick, +) { + const state = await database.copilotConnectionState.findUniqueOrThrow({ + where: { key: "global" }, + include: { + connectedByMembership: { + include: { + user: { include: { profile: true } }, + }, + }, + }, + }) + return { + connected: state.connectedByMembershipId !== null, + connectedAt: state.connectedByMembershipId ? state.updatedAt : null, + connectedBy: state.connectedByMembership + ? { + login: state.connectedByMembership.user.profile?.login ?? null, + membershipId: state.connectedByMembership.id, + name: state.connectedByMembership.user.profile?.name ?? null, + } + : null, + generation: state.generation, + refusedAt: state.refusedAt, + tokenDigest: state.tokenDigest, + verifiedAt: state.verifiedAt, + } +} diff --git a/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts new file mode 100644 index 000000000..049b52a4e --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts @@ -0,0 +1,20 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function lockCopilotConnectionState( + database: Pick, +) { + const rows = await database.$queryRaw< + Array<{ + connectedByMembershipId: string | null + generation: bigint + }> + >` + SELECT + "connected_by_membership_id" AS "connectedByMembershipId", + "generation" + FROM "copilot_connection_states" + WHERE "key" = 'global' + FOR UPDATE + ` + return rows[0] ?? null +} diff --git a/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts new file mode 100644 index 000000000..783dec560 --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts @@ -0,0 +1,34 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function saveCopilotConnectionState( + database: Pick, + input: + | { operation: "connect"; membershipId: string; tokenDigest: string } + | { operation: "disconnect" }, +) { + if (input.operation === "connect") { + await database.$executeRaw` + UPDATE "copilot_connection_states" + SET + "connected_by_membership_id" = ${input.membershipId}::uuid, + "token_digest" = ${input.tokenDigest}, + "verified_at" = clock_timestamp(), + "refused_at" = NULL, + "generation" = "generation" + 1, + "updated_at" = clock_timestamp() + WHERE "key" = 'global' + ` + return + } + await database.$executeRaw` + UPDATE "copilot_connection_states" + SET + "connected_by_membership_id" = NULL, + "token_digest" = NULL, + "verified_at" = NULL, + "refused_at" = NULL, + "generation" = "generation" + 1, + "updated_at" = clock_timestamp() + WHERE "key" = 'global' + ` +} diff --git a/hub/server/repositories/security-audits/create-security-audit/types.ts b/hub/server/repositories/security-audits/create-security-audit/types.ts index 6b1c4963a..c5d7d2c36 100644 --- a/hub/server/repositories/security-audits/create-security-audit/types.ts +++ b/hub/server/repositories/security-audits/create-security-audit/types.ts @@ -86,12 +86,26 @@ export interface AdministratorAuthorizationAudit extends SecurityAuditEvent { type: "administrator_authorization" actorMembershipId: string authorizationId: string - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" phase: "requested" | "verified" | "completed" | "denied" | "expired" | "cancelled" reason?: string targetCount: number } +export interface CopilotConnectionAudit extends SecurityAuditEvent { + type: "copilot_connection" + actorMembershipId: string | null + connectorMembershipId?: string + operation: "connect" | "disconnect" | "view" + outcome: "success" | "denied" | "failure" + reason?: string +} + export interface AllHubSessionsEndedAudit extends SecurityAuditEvent { type: "all_hub_sessions_ended" actorMembershipId: string @@ -225,6 +239,7 @@ export type CreateSecurityAuditEvent = | AdministratorManagementDeniedAudit | AdministratorManagementFailedAudit | AdministratorAuthorizationAudit + | CopilotConnectionAudit | AllHubSessionsEndedAudit | AllHubSessionsEndFailedAudit | AdmissionDeniedAudit diff --git a/hub/server/repositories/security-audits/get-security-audit-data/index.ts b/hub/server/repositories/security-audits/get-security-audit-data/index.ts index d68b01344..3b5c1935d 100644 --- a/hub/server/repositories/security-audits/get-security-audit-data/index.ts +++ b/hub/server/repositories/security-audits/get-security-audit-data/index.ts @@ -110,6 +110,27 @@ export function getSecurityAuditData( targetCount: event.targetCount, }, } + case "copilot_connection": + return { + id: event.id, + action: `copilot.connection.${event.operation}`, + outcome: + event.outcome === "success" + ? SecurityAuditOutcome.SUCCESS + : event.outcome === "denied" + ? SecurityAuditOutcome.DENIED + : SecurityAuditOutcome.FAILURE, + targetType: "copilot_connection", + targetId: "global", + context: { + actorMembershipId: event.actorMembershipId, + ...(event.connectorMembershipId + ? { connectorMembershipId: event.connectorMembershipId } + : {}), + operation: event.operation, + ...(event.reason ? { reason: event.reason } : {}), + }, + } case "all_hub_sessions_ended": return { id: event.id, diff --git a/hub/server/repositories/security-audits/parse-security-audit-event/index.ts b/hub/server/repositories/security-audits/parse-security-audit-event/index.ts index 9e42d678f..46e2e3a99 100644 --- a/hub/server/repositories/security-audits/parse-security-audit-event/index.ts +++ b/hub/server/repositories/security-audits/parse-security-audit-event/index.ts @@ -65,7 +65,9 @@ const eventSchema = z.discriminatedUnion("type", [ authorizationId: z.uuid(), id: z.uuid(), operation: z.enum([ + "CONNECT_COPILOT", "DESIGNATE_ADMINISTRATORS", + "DISCONNECT_COPILOT", "END_ALL_HUB_SESSIONS", "REVOKE_ADMINISTRATOR", ]), @@ -75,6 +77,17 @@ const eventSchema = z.discriminatedUnion("type", [ type: z.literal("administrator_authorization"), }) .strict(), + z + .object({ + actorMembershipId: z.uuid().nullable(), + connectorMembershipId: z.uuid().optional(), + id: z.uuid(), + operation: z.enum(["connect", "disconnect", "view"]), + outcome: z.enum(["success", "denied", "failure"]), + reason: z.string().min(1).max(100).optional(), + type: z.literal("copilot_connection"), + }) + .strict(), z .object({ id: z.uuid(), diff --git a/hub/server/repositories/security-audits/parse-security-audit-event/types.ts b/hub/server/repositories/security-audits/parse-security-audit-event/types.ts index 107de7793..4df5db4a1 100644 --- a/hub/server/repositories/security-audits/parse-security-audit-event/types.ts +++ b/hub/server/repositories/security-audits/parse-security-audit-event/types.ts @@ -22,6 +22,7 @@ import type { AdministratorManagementDeniedAudit, AdministratorManagementFailedAudit, AdministratorAuthorizationAudit, + CopilotConnectionAudit, AllHubSessionsEndFailedAudit, AllHubSessionsEndedAudit, SessionCreatedAudit, @@ -43,6 +44,7 @@ export type ParsedSecurityAuditEvent = | AdministratorManagementDeniedAudit | AdministratorManagementFailedAudit | AdministratorAuthorizationAudit + | CopilotConnectionAudit | AllHubSessionsEndFailedAudit | AllHubSessionsEndedAudit | SessionCreatedAudit diff --git a/hub/server/repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts index 421eebfc8..15b9e2e4e 100644 --- a/hub/server/repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts @@ -2,13 +2,18 @@ import type { Prisma } from "../../../generated/prisma/client.ts" export async function cancelSensitiveAuthorization( database: Pick, - input: { id: string; hubSessionId: string }, + input: { id: string; hubSessionId: string; scope: "administrator" | "copilot" | "sessions" }, ) { const rows = await database.$queryRaw< Array<{ actorMembershipId: string id: string - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetCount: number }> >` @@ -22,6 +27,26 @@ export async function cancelSensitiveAuthorization( "authentication_providers" provider WHERE "sensitive_authorizations"."id" = ${input.id}::uuid AND "sensitive_authorizations"."hub_session_id" = ${input.hubSessionId}::uuid + AND ( + ( + ${input.scope} = 'administrator' + AND "sensitive_authorizations"."operation" IN ( + 'DESIGNATE_ADMINISTRATORS', + 'REVOKE_ADMINISTRATOR' + ) + ) + OR ( + ${input.scope} = 'copilot' + AND "sensitive_authorizations"."operation" IN ( + 'CONNECT_COPILOT', + 'DISCONNECT_COPILOT' + ) + ) + OR ( + ${input.scope} = 'sessions' + AND "sensitive_authorizations"."operation" = 'END_ALL_HUB_SESSIONS' + ) + ) AND session."id" = "sensitive_authorizations"."hub_session_id" AND session."ended_at" IS NULL AND session."expires_at" > clock_timestamp() diff --git a/hub/server/repositories/sensitive-authorizations/create-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/create-sensitive-authorization/index.ts index a3459b1bd..4b0c6d16d 100644 --- a/hub/server/repositories/sensitive-authorizations/create-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/create-sensitive-authorization/index.ts @@ -5,18 +5,29 @@ import type { Prisma } from "../../../generated/prisma/client.ts" const inputSchema = z .object({ actorMembershipId: z.uuid(), + expectedCopilotGeneration: z.bigint().nonnegative().optional(), externalIdentityId: z.uuid(), hubSessionId: z.uuid(), id: z.uuid(), lifetimeSeconds: z.number().int().min(60).max(600), - operation: z.enum(["DESIGNATE_ADMINISTRATORS", "END_ALL_HUB_SESSIONS", "REVOKE_ADMINISTRATOR"]), + operation: z.enum([ + "CONNECT_COPILOT", + "DESIGNATE_ADMINISTRATORS", + "DISCONNECT_COPILOT", + "END_ALL_HUB_SESSIONS", + "REVOKE_ADMINISTRATOR", + ]), targetMembershipIds: z.array(z.uuid()).max(50), }) .strict() .superRefine((value, context) => { const targetCount = value.targetMembershipIds.length + const copilot = + value.operation === "CONNECT_COPILOT" || value.operation === "DISCONNECT_COPILOT" if ( + copilot !== (value.expectedCopilotGeneration !== undefined) || (value.operation === "END_ALL_HUB_SESSIONS" && targetCount !== 0) || + (copilot && targetCount !== 1) || (value.operation === "DESIGNATE_ADMINISTRATORS" && targetCount === 0) || (value.operation === "REVOKE_ADMINISTRATOR" && targetCount !== 1) ) { @@ -35,7 +46,8 @@ export async function createSensitiveAuthorization( const rows = await database.$queryRaw>` INSERT INTO "sensitive_authorizations" ( "id", "hub_session_id", "actor_membership_id", "external_identity_id", - "operation", "target_membership_ids", "expires_at", "created_at", "updated_at" + "operation", "target_membership_ids", "expected_copilot_generation", + "expires_at", "created_at", "updated_at" ) SELECT ${parsed.id}::uuid, @@ -44,6 +56,7 @@ export async function createSensitiveAuthorization( session."external_identity_id", ${parsed.operation}::"SensitiveAuthorizationOperation", ${parsed.targetMembershipIds}::uuid[], + ${parsed.expectedCopilotGeneration ?? null}::bigint, clock_timestamp() + make_interval(secs => ${parsed.lifetimeSeconds}), clock_timestamp(), clock_timestamp() diff --git a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts index 96c55eb50..9e45314f2 100644 --- a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts +++ b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts @@ -9,7 +9,12 @@ export async function getSensitiveAuthorizationAuditData( actorMembershipId: string expiresAt: Date expired: boolean - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetCount: number }> >` diff --git a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization/index.ts index f938d2683..0941444f3 100644 --- a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization/index.ts @@ -10,7 +10,12 @@ export async function getSensitiveAuthorization( login: string | null membershipId: string | null name: string | null - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" provider: string | null verifiedAt: Date }> diff --git a/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts index 2394e2cb4..ca664c3af 100644 --- a/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts @@ -8,11 +8,17 @@ export async function lockSensitiveAuthorization( Array<{ actorMembershipId: string cancelledAt: Date | null + expectedCopilotGeneration: bigint | null continuedAt: Date | null expiresAt: Date expired: boolean hubSessionId: string - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetMembershipIds: string[] verifiedAt: Date | null }> @@ -22,6 +28,7 @@ export async function lockSensitiveAuthorization( "actor_membership_id" AS "actorMembershipId", "operation", "target_membership_ids" AS "targetMembershipIds", + "expected_copilot_generation" AS "expectedCopilotGeneration", "expires_at" AS "expiresAt", "expires_at" <= clock_timestamp() AS "expired", "verified_at" AS "verifiedAt", diff --git a/hub/server/repositories/sensitive-authorizations/verify-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/verify-sensitive-authorization/index.ts index 24bcea3ef..0487d6670 100644 --- a/hub/server/repositories/sensitive-authorizations/verify-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/verify-sensitive-authorization/index.ts @@ -13,7 +13,12 @@ export async function verifySensitiveAuthorization( Array<{ actorMembershipId: string id: string - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetCount: number }> >` diff --git a/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts b/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts index 937efdf72..e7505377d 100644 --- a/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts +++ b/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts @@ -1,11 +1,17 @@ import { createHash } from "node:crypto" import type { RequestHandler } from "express" -import type { AdministratorRouteDependencies } from "../../../../auth/types.ts" +import type { + AdministratorRouteDependencies, + CopilotConnectionRouteDependencies, +} from "../../../../auth/types.ts" import { readAdministratorSession } from "../../../read-administrator-session/index.ts" export function rateLimit( - dependencies: Pick, + dependencies: Pick< + AdministratorRouteDependencies | CopilotConnectionRouteDependencies, + "findSession" | "start" + >, ): RequestHandler { return async (request, response, next) => { try { diff --git a/hub/server/routes/api/auth/callback/get/index.ts b/hub/server/routes/api/auth/callback/get/index.ts index 7945bfe81..bdc7e6cf8 100644 --- a/hub/server/routes/api/auth/callback/get/index.ts +++ b/hub/server/routes/api/auth/callback/get/index.ts @@ -80,6 +80,8 @@ export function get(dependencies: AuthenticationCallbackDependencies): RequestHa 303, operation === "END_ALL_HUB_SESSIONS" ? `/settings/sessions/confirm?authorizationId=${completed.sensitiveAuthorizationId}` + : operation === "CONNECT_COPILOT" || operation === "DISCONNECT_COPILOT" + ? `/settings/copilot/confirm?authorizationId=${completed.sensitiveAuthorizationId}` : `/settings/administrators/confirm?authorizationId=${completed.sensitiveAuthorizationId}`, ) return diff --git a/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts b/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts index 98b281031..34bebf9b4 100644 --- a/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts +++ b/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts @@ -1,4 +1,4 @@ -import { randomUUID } from "node:crypto" +import { createHash, randomUUID } from "node:crypto" import { admitAuthenticationProof } from "../../../../domains/admission/admit-authentication-proof/index.ts" import { checkAuthenticationRateLimit } from "../../../../domains/admission/check-authentication-rate-limit/index.ts" @@ -30,9 +30,11 @@ import { continueAdministratorAuthorization } from "../../../../domains/administ import { AdministratorAuthorizationDeniedError } from "../../../../domains/administrator-authorization/errors.ts" import { verifyAdministratorAuthorization } from "../../../../domains/administrator-authorization/verify-administrator-authorization/index.ts" import { runAdministratorAuthorizationVerificationTransaction } from "../../../../domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts" +import { continueCopilotAuthorization } from "../../../../domains/copilot-connection/continue-copilot-authorization/index.ts" import { endAllHubSessions } from "../../../../domains/session-revocation/end-all-hub-sessions/index.ts" import { listEffectiveAdministrators } from "../../../../domains/administrator-management/list-effective-administrators/index.ts" import { prisma } from "../../../../integrations/prisma/index.ts" +import { checkCopilotToken } from "../../../../integrations/copilot/check-copilot-token/index.ts" import { findLatestAuthenticationProviderRevision } from "../../../../repositories/authentication-providers/find-latest-authentication-provider-revision/index.ts" import { getAuthenticationProofState } from "../../../../repositories/authentication-providers/get-authentication-proof-state/index.ts" import { findCurrentSessionProfile } from "../../../../repositories/user-profiles/find-current-session-profile/index.ts" @@ -46,6 +48,7 @@ import { findAdministratorHubSession } from "../../../../repositories/hub-sessio import { searchAdministratorCandidates } from "../../../../repositories/memberships/search-administrator-candidates/index.ts" import { getSessionRevocationStatus } from "../../../../repositories/session-revocation-states/get-session-revocation-status/index.ts" import { cancelSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts" +import { getCopilotConnectionState } from "../../../../repositories/copilot-connection-state/get-copilot-connection-state/index.ts" import { createSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/create-sensitive-authorization/index.ts" import { getSensitiveAuthorizationAuditData } from "../../../../repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts" import { getSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/get-sensitive-authorization/index.ts" @@ -342,12 +345,12 @@ export async function createAuthenticationRouteDependencies( writeAudit: (event) => createSecurityAudit(prisma, event), }, ) - if (!verified) return false + if (!verified) return null const authorization = await getSensitiveAuthorizationAuditData( prisma, input.sensitiveAuthorizationId, ) - return authorization?.operation ?? false + return authorization?.operation ?? null }, admit: (input) => admitAuthenticationProof( @@ -371,11 +374,15 @@ export async function createAuthenticationRouteDependencies( const github = githubContext ? createProviderDependencies(githubContext) : undefined const entra = entraContext ? createProviderDependencies(entraContext) : undefined const local = localContext ? createProviderDependencies(localContext) : undefined - async function cancelAuthorization(input: { authorizationId: string; hubSessionId: string }) { + async function cancelAuthorization( + input: { authorizationId: string; hubSessionId: string }, + scope: "administrator" | "copilot" | "sessions", + ) { return prisma.$transaction(async (transaction) => { const cancelled = await cancelSensitiveAuthorization(transaction, { id: input.authorizationId, hubSessionId: input.hubSessionId, + scope, }) if (!cancelled) return false await createSecurityAudit(transaction, { @@ -390,10 +397,31 @@ export async function createAuthenticationRouteDependencies( return true }) } + function findSession(sessionDigest: string) { + return findAdministratorHubSession(prisma, sessionDigest) + } + function getAuthorization(input: { authorizationId: string; hubSessionId: string }) { + return getSensitiveAuthorization(prisma, { + hubSessionId: input.hubSessionId, + id: input.authorizationId, + }) + } + async function getCurrentCopilotState() { + const state = await getCopilotConnectionState(prisma) + const currentDigest = environment.REPLICA_COPILOT_TOKEN + ? createHash("sha256").update(environment.REPLICA_COPILOT_TOKEN).digest("hex") + : null + const tokenMatches = currentDigest !== null && state.tokenDigest === currentDigest + return { + ...state, + refusedAt: tokenMatches ? state.refusedAt : null, + tokenNeedsCheck: state.connected && currentDigest !== null && !tokenMatches, + } + } return { administrators: { applicationOrigin: sharedContext.applicationOrigin, - cancel: cancelAuthorization, + cancel: (input) => cancelAuthorization(input, "administrator"), continue: (input) => continueAdministratorAuthorization(prisma, { hubSessionId: input.hubSessionId, @@ -401,12 +429,8 @@ export async function createAuthenticationRouteDependencies( operation: input.operation, targetMembershipIds: input.targetMembershipIds, }), - findSession: (sessionDigest) => findAdministratorHubSession(prisma, sessionDigest), - getAuthorization: (input) => - getSensitiveAuthorization(prisma, { - hubSessionId: input.hubSessionId, - id: input.authorizationId, - }), + findSession, + getAuthorization, list: (input) => listEffectiveAdministrators(prisma, input), listSecurityAudits: (input) => listSecurityAudits(prisma, input), search: (input) => searchAdministratorCandidates(prisma, input), @@ -416,6 +440,40 @@ export async function createAuthenticationRouteDependencies( local: local?.administratorAuthorization, }, }, + copilotConnection: { + applicationOrigin: sharedContext.applicationOrigin, + cancel: (input) => cancelAuthorization(input, "copilot"), + continue: (input) => + continueCopilotAuthorization( + prisma, + { + authorizationId: input.authorizationId, + hubSessionId: input.hubSessionId, + operation: input.operation, + ...(environment.REPLICA_COPILOT_TOKEN + ? { token: environment.REPLICA_COPILOT_TOKEN } + : {}), + }, + checkCopilotToken, + ), + findSession, + getAuthorization, + getState: getCurrentCopilotState, + recordView: (actorMembershipId) => + createSecurityAudit(prisma, { + actorMembershipId, + id: randomUUID(), + operation: "view", + outcome: "success", + type: "copilot_connection", + }), + start: { + entra: entra?.administratorAuthorization, + github: github?.administratorAuthorization, + local: local?.administratorAuthorization, + }, + tokenConfigured: Boolean(environment.REPLICA_COPILOT_TOKEN), + }, currentSession: { restore: async (sessionDigest) => { const session = await restoreHubSession(sessionDigest, { @@ -437,14 +495,10 @@ export async function createAuthenticationRouteDependencies( local, sessionRevocation: { applicationOrigin: sharedContext.applicationOrigin, - cancel: cancelAuthorization, + cancel: (input) => cancelAuthorization(input, "sessions"), continue: (input) => endAllHubSessions(prisma, input), - findSession: (sessionDigest) => findAdministratorHubSession(prisma, sessionDigest), - getAuthorization: (input) => - getSensitiveAuthorization(prisma, { - hubSessionId: input.hubSessionId, - id: input.authorizationId, - }), + findSession, + getAuthorization, getStatus: () => getSessionRevocationStatus(prisma), secureCookie: sharedContext.secureCookie, start: { diff --git a/hub/server/routes/api/auth/types.ts b/hub/server/routes/api/auth/types.ts index 9d29741a7..580e3a9eb 100644 --- a/hub/server/routes/api/auth/types.ts +++ b/hub/server/routes/api/auth/types.ts @@ -48,7 +48,14 @@ export interface AuthenticationCallbackDependencies extends RateLimitDependencie } sessionDigest: string sensitiveAuthorizationId: string - }): Promise<"DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" | false> + }): Promise< + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" + | null + > admit(input: { proof: AuthenticationProofResult providerAssignment?: { @@ -83,6 +90,7 @@ export interface SignOutDependencies { export interface AuthenticationRouteDependencies { administrators?: AdministratorRouteDependencies + copilotConnection?: CopilotConnectionRouteDependencies currentSession: CurrentSessionDependencies entra?: ProviderAuthenticationRouteDependencies github?: ProviderAuthenticationRouteDependencies @@ -91,6 +99,30 @@ export interface AuthenticationRouteDependencies { signOut: SignOutDependencies } +export interface CopilotConnectionRouteDependencies { + applicationOrigin: string + cancel(input: { authorizationId: string; hubSessionId: string }): Promise + continue(input: { + authorizationId: string + hubSessionId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }): Promise<{ connected: boolean }> + findSession: AdministratorRouteDependencies["findSession"] + getAuthorization: AdministratorRouteDependencies["getAuthorization"] + getState(): Promise<{ + connected: boolean + connectedAt: Date | null + connectedBy: { login: string | null; membershipId: string; name: string | null } | null + generation: bigint + refusedAt: Date | null + tokenNeedsCheck: boolean + verifiedAt: Date | null + }> + recordView(actorMembershipId: string): Promise + start: AdministratorRouteDependencies["start"] + tokenConfigured: boolean +} + export interface ProviderAuthenticationRouteDependencies { administratorAuthorization?: StartAdministratorAuthorizationDependencies administratorEnrollment: StartAdministratorEnrollmentDependencies @@ -103,9 +135,15 @@ export interface StartAdministratorAuthorizationDependencies extends RateLimitDe secureCookie: boolean start(input: { actorMembershipId: string + expectedCopilotGeneration?: bigint externalIdentityId: string hubSessionId: string - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targetMembershipIds: string[] }): Promise<{ authorizationId: string @@ -132,7 +170,12 @@ export interface AdministratorRouteDependencies { } | null> getAuthorization(input: { authorizationId: string; hubSessionId: string }): Promise<{ expiresAt: Date - operation: "DESIGNATE_ADMINISTRATORS" | "END_ALL_HUB_SESSIONS" | "REVOKE_ADMINISTRATOR" + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" targets: Array<{ login: string | null membershipId: string diff --git a/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts new file mode 100644 index 000000000..ece4810c2 --- /dev/null +++ b/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts @@ -0,0 +1,36 @@ +import type { RequestHandler } from "express" +import { z } from "zod" + +import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" +import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" + +const bodySchema = z.object({ authorizationId: z.uuid() }).strict() + +export function post(dependencies: CopilotConnectionRouteDependencies): RequestHandler { + return async (request, response, next) => { + response.locals.omitLogPayload = true + const body = bodySchema.safeParse(request.body) + if (!body.success) { + response.status(400).json({ error: "The Copilot authorization cancellation is invalid." }) + return + } + try { + const session = await readAdministratorSession(request, dependencies) + if (!session) { + response.status(403).json({ error: "Administrator access is required." }) + return + } + const cancelled = await dependencies.cancel({ + authorizationId: body.data.authorizationId, + hubSessionId: session.id, + }) + if (!cancelled) { + response.status(410).json({ error: "This Copilot authorization is unavailable." }) + return + } + response.status(204).end() + } catch (error) { + next(error) + } + } +} diff --git a/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts new file mode 100644 index 000000000..5cb8dea4e --- /dev/null +++ b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts @@ -0,0 +1,58 @@ +import type { RequestHandler } from "express" +import { z } from "zod" + +import { + CopilotConnectionDeniedError, + CopilotConnectionUnavailableError, +} from "../../../../../../domains/copilot-connection/errors.ts" +import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" +import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" + +const bodySchema = z + .object({ + authorizationId: z.uuid(), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), + }) + .strict() + +export function post(dependencies: CopilotConnectionRouteDependencies): RequestHandler { + return async (request, response, next) => { + response.locals.omitLogPayload = true + const body = bodySchema.safeParse(request.body) + if (!body.success) { + response.status(400).json({ error: "The Copilot authorization continuation is invalid." }) + return + } + try { + const session = await readAdministratorSession(request, dependencies) + if (!session) { + response.status(403).json({ error: "Administrator access is required." }) + return + } + const result = await dependencies.continue({ + authorizationId: body.data.authorizationId, + hubSessionId: session.id, + operation: body.data.operation, + }) + response.json(result) + } catch (error) { + if (error instanceof CopilotConnectionDeniedError) { + const message = { + authorization_unavailable: "This Copilot authorization is no longer available.", + connection_changed: "The Copilot connection changed. Review it before trying again.", + no_token: "Hub has no configured Copilot token.", + not_connected: "Copilot is not connected.", + refused: + "Copilot refused the configured token. Check its Copilot access and permissions.", + }[error.reason] + response.status(409).json({ error: message }) + return + } + if (error instanceof CopilotConnectionUnavailableError) { + response.status(503).json({ error: "Copilot could not check the configured token." }) + return + } + next(error) + } + } +} diff --git a/hub/server/routes/api/copilot-connection/authorizations/get/index.ts b/hub/server/routes/api/copilot-connection/authorizations/get/index.ts new file mode 100644 index 000000000..85f516724 --- /dev/null +++ b/hub/server/routes/api/copilot-connection/authorizations/get/index.ts @@ -0,0 +1,48 @@ +import type { RequestHandler } from "express" +import { z } from "zod" + +import type { CopilotConnectionRouteDependencies } from "../../../auth/types.ts" +import { readAdministratorSession } from "../../../administrators/read-administrator-session/index.ts" + +const idSchema = z.uuid() + +export function get(dependencies: CopilotConnectionRouteDependencies): RequestHandler { + return async (request, response, next) => { + try { + const id = idSchema.safeParse(request.params.id) + if (!id.success) { + response.status(400).json({ error: "The authorization identifier is invalid." }) + return + } + const session = await readAdministratorSession(request, dependencies) + if (!session) { + response.status(403).json({ error: "Administrator access is required." }) + return + } + const authorization = (await dependencies.getAuthorization({ + authorizationId: id.data, + hubSessionId: session.id, + })) as { + expiresAt: Date + operation: string + verifiedAt: Date + } | null + if ( + !authorization || + !["CONNECT_COPILOT", "DISCONNECT_COPILOT"].includes(authorization.operation) + ) { + response.status(410).json({ error: "This Copilot authorization is unavailable." }) + return + } + response.json({ + authorization: { + expiresAt: authorization.expiresAt.toISOString(), + operation: authorization.operation, + verifiedAt: authorization.verifiedAt.toISOString(), + }, + }) + } catch (error) { + next(error) + } + } +} diff --git a/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts new file mode 100644 index 000000000..64f01d482 --- /dev/null +++ b/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts @@ -0,0 +1,88 @@ +import type { RequestHandler } from "express" +import { z } from "zod" + +import { AdministratorAuthorizationDeniedError } from "../../../../../../domains/administrator-authorization/errors.ts" +import { browserAuthenticationCookieName } from "../../../../../../integrations/express/browser-authentication-cookie-name/index.ts" +import { createAuthenticationCookie } from "../../../../../../integrations/express/create-authentication-cookie/index.ts" +import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" +import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" + +const bodySchema = z + .object({ + confirmed: z.literal(true), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), + }) + .strict() + +export function post(dependencies: CopilotConnectionRouteDependencies): RequestHandler { + return async (request, response, next) => { + response.locals.omitLogPayload = true + try { + const session = await readAdministratorSession(request, dependencies) + if (!session) { + response.status(403).json({ error: "Administrator access is required." }) + return + } + const body = bodySchema.safeParse(request.body) + if (!body.success) { + response.status(400).json({ error: "Confirm the Copilot connection change explicitly." }) + return + } + const state = await dependencies.getState() + if ( + (body.data.operation === "CONNECT_COPILOT" && + state.connected && + !state.refusedAt && + !state.tokenNeedsCheck) || + (body.data.operation === "DISCONNECT_COPILOT" && !state.connected) + ) { + response.status(409).json({ error: "The Copilot connection changed. Review it again." }) + return + } + if (body.data.operation === "CONNECT_COPILOT" && !dependencies.tokenConfigured) { + response.status(409).json({ error: "Hub has no configured Copilot token." }) + return + } + const provider = + session.providerKey === "github" + ? dependencies.start.github + : session.providerKey === "entra" + ? dependencies.start.entra + : session.providerKey === "local" + ? dependencies.start.local + : undefined + if (!provider) { + response.status(409).json({ error: "The session authentication provider is unavailable." }) + return + } + const started = await provider.start({ + actorMembershipId: session.membershipId, + expectedCopilotGeneration: state.generation, + externalIdentityId: session.externalIdentityId, + hubSessionId: session.id, + operation: body.data.operation, + targetMembershipIds: [session.membershipId], + }) + response.setHeader( + "Set-Cookie", + createAuthenticationCookie({ + expiresAt: started.expiresAt, + name: browserAuthenticationCookieName, + secure: provider.secureCookie, + value: started.browserBinding, + }), + ) + response.json({ + authorizationId: started.authorizationId, + authorizationUrl: started.authorizationUrl, + expiresAt: started.expiresAt.toISOString(), + }) + } catch (error) { + if (error instanceof AdministratorAuthorizationDeniedError) { + response.status(403).json({ error: "Administrator access is required." }) + return + } + next(error) + } + } +} diff --git a/hub/server/routes/api/security-audits/present-security-audit/index.ts b/hub/server/routes/api/security-audits/present-security-audit/index.ts index b36a7e87a..3594a3c5c 100644 --- a/hub/server/routes/api/security-audits/present-security-audit/index.ts +++ b/hub/server/routes/api/security-audits/present-security-audit/index.ts @@ -51,6 +51,12 @@ function actorFor(record: SecurityAuditListRecord) { const parsed = actorContextSchema.safeParse(record.context) return parsed.success ? { membershipId: parsed.data.actorMembershipId } : null } + case "copilot.connection.connect": + case "copilot.connection.disconnect": + case "copilot.connection.view": { + const parsed = actorContextSchema.safeParse(record.context) + return parsed.success ? { membershipId: parsed.data.actorMembershipId } : null + } case "session.created": { const parsed = membershipContextSchema.safeParse(record.context) return parsed.success ? { membershipId: parsed.data.membershipId } : null @@ -171,7 +177,9 @@ function contextFor(record: SecurityAuditListRecord): Record Date: Thu, 12 Nov 2026 08:21:29 -0800 Subject: [PATCH 2/9] test(hub): cover Copilot connection administration Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../hub/routes/administrator-flow.test.tsx | 117 ++++++++++++++++++ .../administrator-management.db.test.ts | 58 +++++++++ .../admission/provider-role-loss.db.test.ts | 67 +++++++++- .../index.test.ts | 37 ++++++ hub/server/routes/api/auth/index.test.ts | 37 +++++- 5 files changed, 311 insertions(+), 5 deletions(-) diff --git a/hub/client/application/hub/routes/administrator-flow.test.tsx b/hub/client/application/hub/routes/administrator-flow.test.tsx index 0f21f7044..c95ba4932 100644 --- a/hub/client/application/hub/routes/administrator-flow.test.tsx +++ b/hub/client/application/hub/routes/administrator-flow.test.tsx @@ -111,6 +111,27 @@ function administrator(login = "octocat", membershipId = actorMembershipId) { } } +function workspace() { + return http.get(`${window.location.origin}/api/workspace`, () => + HttpResponse.json({ + viewer: { + id: "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa", + provider: "github", + login: "octocat", + name: "The Octocat", + avatarUrl: null, + }, + capabilities: { + createPrototypes: false, + reviewPrototypes: false, + manageSharing: false, + administerHub: true, + }, + repositories: [], + }), + ) +} + describe("administrator frontend integration", () => { it("does not intercept account-menu sign-out on the Copilot page", async () => { const connect = vi.fn() @@ -767,4 +788,100 @@ describe("administrator frontend integration", () => { expect(`${router.state.location.pathname}${router.state.location.search}`).toBe(canonicalPath) }) }) + + describe("Copilot connection frontend integration", () => { + it("loads the real connection API and starts the confirmed provider authorization", async () => { + const bodies: unknown[] = [] + await renderApplication("/settings/copilot", [ + authenticatedSession(), + workspace(), + http.get(`${window.location.origin}/api/copilot-connection`, () => + HttpResponse.json({ + connected: false, + connectedAt: null, + connectedBy: null, + refusedAt: null, + tokenConfigured: true, + tokenNeedsCheck: false, + verifiedAt: null, + }), + ), + http.post( + `${window.location.origin}/api/copilot-connection/authorizations/start`, + async ({ request }) => { + bodies.push(await request.json()) + return HttpResponse.json({ + authorizationId, + authorizationUrl: "https://github.com/login/oauth/authorize", + expiresAt: "2026-11-09T20:06:00.000Z", + }) + }, + ), + ]) + + fireEvent.click( + await screen.findByRole("checkbox", { + name: /confirm connecting Copilot for this Hub/i, + }), + ) + fireEvent.click(screen.getByRole("button", { name: "Connect Copilot" })) + + await vi.waitFor(() => + expect(bodies).toEqual([{ confirmed: true, operation: "CONNECT_COPILOT" }]), + ) + expect(navigateToExternalUrl).toHaveBeenCalledWith("https://github.com/login/oauth/authorize") + }) + + it("continues the server-owned callback operation and returns to the live connection page", async () => { + const continuationBodies: unknown[] = [] + const router = await renderApplication( + `/settings/copilot/confirm?authorizationId=${authorizationId}`, + [ + authenticatedSession(), + workspace(), + http.get( + `${window.location.origin}/api/copilot-connection/authorizations/${authorizationId}`, + () => + HttpResponse.json({ + authorization: { + operation: "DISCONNECT_COPILOT", + verifiedAt: "2026-11-09T20:01:00.000Z", + expiresAt: "2026-11-09T20:06:00.000Z", + }, + }), + ), + http.post( + `${window.location.origin}/api/copilot-connection/authorizations/continue`, + async ({ request }) => { + continuationBodies.push(await request.json()) + return HttpResponse.json({ connected: false }) + }, + ), + http.get(`${window.location.origin}/api/copilot-connection`, () => + HttpResponse.json({ + connected: false, + connectedAt: null, + connectedBy: null, + refusedAt: null, + tokenConfigured: true, + tokenNeedsCheck: false, + verifiedAt: null, + }), + ), + ], + ) + + fireEvent.click(await screen.findByRole("button", { name: "Disconnect Copilot" })) + + await vi.waitFor(() => + expect(continuationBodies).toEqual([{ authorizationId, operation: "DISCONNECT_COPILOT" }]), + ) + await vi.waitFor(() => { + expect(`${router.state.location.pathname}${router.state.location.search}`).toBe( + "/settings/copilot?result=disconnected", + ) + }) + expect(await screen.findByText("Copilot is disconnected.")).toBeVisible() + }) + }) }) diff --git a/hub/server/domains/administrator-management/administrator-management.db.test.ts b/hub/server/domains/administrator-management/administrator-management.db.test.ts index d7938d071..266021c1c 100644 --- a/hub/server/domains/administrator-management/administrator-management.db.test.ts +++ b/hub/server/domains/administrator-management/administrator-management.db.test.ts @@ -341,6 +341,15 @@ describe("administrator management", () => { membershipId: target.membershipId, source: "HUB_ADMINISTRATOR", }) + await prisma.copilotConnectionState.update({ + data: { + connectedByMembershipId: target.membershipId, + generation: 1n, + tokenDigest: "c".repeat(64), + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) await revokeHubAdministrator( { @@ -370,6 +379,12 @@ describe("administrator management", () => { ({ membershipId }) => membershipId, ), ).toContain(target.membershipId) + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { connectedByMembershipId: true }, + where: { key: "global" }, + }), + ).resolves.toEqual({ connectedByMembershipId: target.membershipId }) await expect( revokeHubAdministrator( { @@ -384,6 +399,49 @@ describe("administrator management", () => { ]) }) + it("disconnects Copilot when administrator-managed revocation removes the connector's final authority", async () => { + const actor = await createMembership({}) + const connector = await createMembership({}) + await createAssignment({ + externalIdentityId: actor.externalIdentityId!, + membershipId: actor.membershipId, + source: "BOOTSTRAP", + }) + await createAssignment({ + externalIdentityId: connector.externalIdentityId!, + membershipId: connector.membershipId, + source: "HUB_ADMINISTRATOR", + }) + await prisma.copilotConnectionState.update({ + data: { + connectedByMembershipId: connector.membershipId, + generation: 1n, + tokenDigest: "c".repeat(64), + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) + + await revokeHubAdministrator( + { + actorMembershipId: actor.membershipId, + targetMembershipId: connector.membershipId, + }, + dependencies(), + ) + + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { connectedByMembershipId: true, generation: true, tokenDigest: true }, + where: { key: "global" }, + }), + ).resolves.toEqual({ + connectedByMembershipId: null, + generation: 2n, + tokenDigest: null, + }) + }) + it("rereads live actor authority before designation", async () => { const staleActor = await createMembership({}) const target = await createMembership({}) diff --git a/hub/server/domains/admission/provider-role-loss.db.test.ts b/hub/server/domains/admission/provider-role-loss.db.test.ts index 5bf2e7ce9..35d40d833 100644 --- a/hub/server/domains/admission/provider-role-loss.db.test.ts +++ b/hub/server/domains/admission/provider-role-loss.db.test.ts @@ -92,7 +92,10 @@ async function createProviderRoleSession() { } } -function revokeProviderRole(records: Awaited>) { +function applyProviderRole( + records: Awaited>, + role: "MEMBER" | null, +) { return admitAuthenticationProof( { proof: { @@ -100,10 +103,10 @@ function revokeProviderRole(records: Awaited>) { + return applyProviderRole(records, null) +} + describe("provider role-loss admission", () => { it("commits revocation, session termination, and denial audit together", async () => { const records = await createProviderRoleSession() @@ -180,4 +187,58 @@ describe("provider role-loss admission", () => { }), ).toBe(0) }) + + it.each([ + ["downgrades the connector to member", "MEMBER" as const, false, null], + ["removes the connector's provider authority", null, false, null], + ["retains another administrator source", null, true, "connected"], + ])( + "%s and updates the Copilot connection", + async (_case, role, withRemainingAdministratorSource, expectedConnection) => { + const records = await createProviderRoleSession() + await prisma.membershipAssignment.update({ + data: { role: "ADMINISTRATOR" }, + where: { id: records.assignmentId }, + }) + if (withRemainingAdministratorSource) { + await prisma.membershipAssignment.create({ + data: { + externalIdentityId: records.externalIdentityId, + id: randomUUID(), + membershipId: records.membershipId, + role: "ADMINISTRATOR", + source: "BOOTSTRAP", + }, + }) + } + await prisma.copilotConnectionState.update({ + data: { + connectedByMembershipId: records.membershipId, + generation: 1n, + tokenDigest: "c".repeat(64), + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) + + const admission = applyProviderRole(records, role) + if (role === null && !withRemainingAdministratorSource) { + await expect(admission).rejects.toMatchObject({ reason: "authority_missing" }) + } else { + await expect(admission).resolves.toMatchObject({ + role: withRemainingAdministratorSource ? "ADMINISTRATOR" : "MEMBER", + }) + } + + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { connectedByMembershipId: true, generation: true }, + where: { key: "global" }, + }), + ).resolves.toEqual({ + connectedByMembershipId: expectedConnection === "connected" ? records.membershipId : null, + generation: expectedConnection === "connected" ? 1n : 2n, + }) + }, + ) }) diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts index 97a9894ea..85eddcc5e 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts @@ -22,6 +22,7 @@ function repositories( createAuthenticationProvider: vi.fn(), createAuthenticationProviderRevision: vi.fn(), createSecurityAudit: vi.fn(), + disconnectCopilotConnectionWithoutEffectiveAdministrator: vi.fn().mockResolvedValue(null), disableAuthenticationProvider: vi.fn(), enableAuthenticationProvider: vi.fn(), findAuthenticationProvider: vi.fn(), @@ -201,6 +202,42 @@ describe("reconcileAuthenticationProviders()", () => { ) }) + it("disconnects Copilot when provider removal ends the connector's final administrator source", async () => { + const records = repositories([ + { + configurationDigest: "a".repeat(64), + enabled: true, + id: randomUUID(), + key: "github", + revision: 1, + revisionId: randomUUID(), + }, + ]) + const membershipId = randomUUID() + records.incrementSessionRevocation.mockResolvedValue({ revision: 1 }) + records.disconnectCopilotConnectionWithoutEffectiveAdministrator.mockResolvedValue({ + membershipId, + }) + + await reconcileAuthenticationProviders([], { + createId: randomUUID, + runTransaction: (operation) => operation(records), + writeAudit: vi.fn(), + }) + + expect(records.disconnectCopilotConnectionWithoutEffectiveAdministrator).toHaveBeenCalledOnce() + expect(records.createSecurityAudit).toHaveBeenCalledWith( + expect.objectContaining({ + actorMembershipId: null, + connectorMembershipId: membershipId, + operation: "disconnect", + outcome: "success", + reason: "connector_role_removed", + type: "copilot_connection", + }), + ) + }) + it("writes one terminal retry-exhaustion audit after the bounded transaction policy", async () => { const writeAudit = vi.fn() const runTransaction = vi.fn().mockRejectedValue(new IdentityTransactionConflictError()) diff --git a/hub/server/routes/api/auth/index.test.ts b/hub/server/routes/api/auth/index.test.ts index 90f5bab4f..22b6b0b20 100644 --- a/hub/server/routes/api/auth/index.test.ts +++ b/hub/server/routes/api/auth/index.test.ts @@ -375,7 +375,40 @@ describe("authenticationRoutes()", () => { }) }) - it("denies administrator authorization when callback verification returns false", async () => { + it("routes verified Copilot authorization to its confirmation page", async () => { + const { admitSession, completeProof, dependencies, verifyAdministratorAuthorization } = + routeDependencies() + const sensitiveAuthorizationId = "00000000-0000-4000-8000-000000000020" + completeProof.mockResolvedValue({ + purpose: "ADMINISTRATOR_MANAGEMENT", + sensitiveAuthorizationId, + proof: { + authorizationAttemptId: "00000000-0000-4000-8000-000000000010", + externalIdentityId: "00000000-0000-4000-8000-000000000012", + }, + }) + verifyAdministratorAuthorization.mockResolvedValue("CONNECT_COPILOT") + + await withServer(dependencies, async (baseUrl) => { + const response = await fetch( + `${baseUrl}/api/auth/github/callback?code=provider-code&state=${"s".repeat(32)}`, + { + headers: { + cookie: `hub_auth_browser=${"b".repeat(32)}; hub_session=retained-session`, + }, + redirect: "manual", + }, + ) + + expect(response.status).toBe(303) + expect(response.headers.get("location")).toBe( + `/settings/copilot/confirm?authorizationId=${sensitiveAuthorizationId}`, + ) + expect(admitSession).not.toHaveBeenCalled() + }) + }) + + it("denies administrator authorization when callback verification returns null", async () => { const { admitSession, completeProof, dependencies, verifyAdministratorAuthorization } = routeDependencies() completeProof.mockResolvedValue({ @@ -386,7 +419,7 @@ describe("authenticationRoutes()", () => { externalIdentityId: "00000000-0000-4000-8000-000000000012", }, }) - verifyAdministratorAuthorization.mockResolvedValue(false) + verifyAdministratorAuthorization.mockResolvedValue(null) await withServer(dependencies, async (baseUrl) => { const response = await fetch( From 9b53b7f421b4edd9de96ce2c9a9de77640484702 Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Thu, 12 Nov 2026 08:23:18 -0800 Subject: [PATCH 3/9] test(hub): reset Copilot connection database state Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../administrator-authorization.db.test.ts | 4 ++-- .../domains/admission/provider-role-loss.db.test.ts | 10 +++------- 2 files changed, 5 insertions(+), 9 deletions(-) diff --git a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts index 42fd6bbc2..a2c523f3a 100644 --- a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts +++ b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts @@ -179,7 +179,7 @@ describe("administrator authorization persistence", () => { }, verificationDependencies(), ), - ).resolves.toBe(true) + ).resolves.toBe("DESIGNATE_ADMINISTRATORS") const verified = await prisma.sensitiveAuthorization.findUniqueOrThrow({ select: { verifiedAt: true }, where: { id: fixture.authorizationId }, @@ -278,7 +278,7 @@ describe("administrator authorization persistence", () => { }, verificationDependencies(), ), - ).resolves.toBe(false) + ).resolves.toBeNull() await expect( prisma.membershipAssignment.findUniqueOrThrow({ select: { lifecycle: true }, diff --git a/hub/server/domains/admission/provider-role-loss.db.test.ts b/hub/server/domains/admission/provider-role-loss.db.test.ts index 35d40d833..ae0120de0 100644 --- a/hub/server/domains/admission/provider-role-loss.db.test.ts +++ b/hub/server/domains/admission/provider-role-loss.db.test.ts @@ -7,7 +7,7 @@ import { withFailingSecurityAudit } from "../../../test/database/with-failing-se import { admitAuthenticationProof } from "./admit-authentication-proof" import { runAdmissionTransaction } from "./run-admission-transaction" -async function createProviderRoleSession() { +async function createProviderRoleSession(role: "MEMBER" | "ADMINISTRATOR" = "MEMBER") { const providerId = randomUUID() const providerRevisionId = randomUUID() const userId = randomUUID() @@ -52,7 +52,7 @@ async function createProviderRoleSession() { membershipId, providerAssignmentSubject: "22222222-2222-4222-8222-222222222222", providerRevisionId, - role: "MEMBER", + role, source: "AUTHENTICATION_PROVIDER", }, }) @@ -195,11 +195,7 @@ describe("provider role-loss admission", () => { ])( "%s and updates the Copilot connection", async (_case, role, withRemainingAdministratorSource, expectedConnection) => { - const records = await createProviderRoleSession() - await prisma.membershipAssignment.update({ - data: { role: "ADMINISTRATOR" }, - where: { id: records.assignmentId }, - }) + const records = await createProviderRoleSession("ADMINISTRATOR") if (withRemainingAdministratorSource) { await prisma.membershipAssignment.create({ data: { From f3bb882d1f997f9b400c1aa713f23a6bad9ba4aa Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Thu, 12 Nov 2026 08:24:34 -0800 Subject: [PATCH 4/9] refactor(hub): use Prisma for Copilot state writes Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../index.ts | 27 +++++------- .../save-copilot-connection-state/index.ts | 44 +++++++++---------- 2 files changed, 33 insertions(+), 38 deletions(-) diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts index eafda866e..32a33fb43 100644 --- a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts @@ -1,21 +1,18 @@ import type { Prisma } from "../../../generated/prisma/client.ts" export async function disconnectCopilotConnectionForMembership( - database: Pick, + database: Pick, membershipId: string, ): Promise { - const rows = await database.$queryRaw>` - UPDATE "copilot_connection_states" - SET - "connected_by_membership_id" = NULL, - "token_digest" = NULL, - "verified_at" = NULL, - "refused_at" = NULL, - "generation" = "generation" + 1, - "updated_at" = clock_timestamp() - WHERE "key" = 'global' - AND "connected_by_membership_id" = ${membershipId}::uuid - RETURNING "id" - ` - return rows.length === 1 + const result = await database.copilotConnectionState.updateMany({ + data: { + connectedByMembershipId: null, + generation: { increment: 1 }, + refusedAt: null, + tokenDigest: null, + verifiedAt: null, + }, + where: { connectedByMembershipId: membershipId, key: "global" }, + }) + return result.count === 1 } diff --git a/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts index 783dec560..2981fd1d6 100644 --- a/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts +++ b/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts @@ -1,34 +1,32 @@ import type { Prisma } from "../../../generated/prisma/client.ts" export async function saveCopilotConnectionState( - database: Pick, + database: Pick, input: | { operation: "connect"; membershipId: string; tokenDigest: string } | { operation: "disconnect" }, ) { if (input.operation === "connect") { - await database.$executeRaw` - UPDATE "copilot_connection_states" - SET - "connected_by_membership_id" = ${input.membershipId}::uuid, - "token_digest" = ${input.tokenDigest}, - "verified_at" = clock_timestamp(), - "refused_at" = NULL, - "generation" = "generation" + 1, - "updated_at" = clock_timestamp() - WHERE "key" = 'global' - ` + await database.copilotConnectionState.update({ + data: { + connectedByMembershipId: input.membershipId, + generation: { increment: 1 }, + refusedAt: null, + tokenDigest: input.tokenDigest, + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) return } - await database.$executeRaw` - UPDATE "copilot_connection_states" - SET - "connected_by_membership_id" = NULL, - "token_digest" = NULL, - "verified_at" = NULL, - "refused_at" = NULL, - "generation" = "generation" + 1, - "updated_at" = clock_timestamp() - WHERE "key" = 'global' - ` + await database.copilotConnectionState.update({ + data: { + connectedByMembershipId: null, + generation: { increment: 1 }, + refusedAt: null, + tokenDigest: null, + verifiedAt: null, + }, + where: { key: "global" }, + }) } From e8bc12b1b8fc0e5a80967a4bc0eacf65913882df Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Thu, 12 Nov 2026 12:41:04 -0800 Subject: [PATCH 5/9] fix(hub): align Copilot connection lifecycle Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../index.test.ts | 49 +++++++++++++++++++ .../index.ts | 26 +++++----- 2 files changed, 62 insertions(+), 13 deletions(-) diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts index 85eddcc5e..a93e8a5ef 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts @@ -238,6 +238,55 @@ describe("reconcileAuthenticationProviders()", () => { ) }) + it("disconnects Copilot when provider revision replacement ends the connector's authority", async () => { + const providerId = randomUUID() + const records = repositories([ + { + configurationDigest: "a".repeat(64), + enabled: true, + id: providerId, + key: "github", + revision: 1, + revisionId: randomUUID(), + }, + ]) + const membershipId = randomUUID() + records.createAuthenticationProviderRevision.mockResolvedValue({ + configurationDigest: "b".repeat(64), + id: randomUUID(), + providerId, + revision: 2, + }) + records.disconnectCopilotConnectionWithoutEffectiveAdministrator.mockResolvedValue({ + membershipId, + }) + + await reconcileAuthenticationProviders( + [ + { + canonicalPublicConfiguration: '{"provider":"github","revision":2}', + providerKey: "github", + revision: 2, + }, + ], + { + createId: randomUUID, + runTransaction: (operation) => operation(records), + writeAudit: vi.fn(), + }, + ) + + expect(records.disconnectCopilotConnectionWithoutEffectiveAdministrator).toHaveBeenCalledOnce() + expect(records.createSecurityAudit).toHaveBeenCalledWith( + expect.objectContaining({ + connectorMembershipId: membershipId, + operation: "disconnect", + reason: "connector_role_removed", + type: "copilot_connection", + }), + ) + }) + it("writes one terminal retry-exhaustion audit after the bounded transaction policy", async () => { const writeAudit = vi.fn() const runTransaction = vi.fn().mockRejectedValue(new IdentityTransactionConflictError()) diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.ts index fc0b50e58..2d6832a9d 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.ts @@ -173,19 +173,19 @@ export async function reconcileAuthenticationProviders( providerKey: provider.key, }) } - const disconnected = - await repositories.disconnectCopilotConnectionWithoutEffectiveAdministrator?.() - if (disconnected) { - await repositories.createSecurityAudit({ - actorMembershipId: null, - connectorMembershipId: disconnected.membershipId, - id: dependencies.createId(), - operation: "disconnect", - outcome: "success", - reason: "connector_role_removed", - type: "copilot_connection", - }) - } + } + const disconnected = + await repositories.disconnectCopilotConnectionWithoutEffectiveAdministrator?.() + if (disconnected) { + await repositories.createSecurityAudit({ + actorMembershipId: null, + connectorMembershipId: disconnected.membershipId, + id: dependencies.createId(), + operation: "disconnect", + outcome: "success", + reason: "connector_role_removed", + type: "copilot_connection", + }) } return result }), From 9aab42c97b634b07994f77bfbf837719552a07aa Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Thu, 12 Nov 2026 13:30:17 -0800 Subject: [PATCH 6/9] fix(hub): address Copilot connection review Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../hub/routes/administrator-flow.test.tsx | 31 ++ .../settings-copilot-authorization/index.tsx | 1 + hub/docs/copilot.md | 2 +- .../migration.sql | 38 +- hub/schema/sensitive-authorization.prisma | 2 + hub/server/create-app/index.ts | 2 +- .../administrator-authorization.db.test.ts | 28 + .../index.ts | 3 + .../index.test.ts | 1 + .../index.ts | 2 +- .../revoke-hub-administrator/index.test.ts | 1 + .../types.ts | 2 +- .../admit-authentication-proof/index.test.ts | 1 + .../index.ts | 5 +- .../run-admission-transaction/types.ts | 2 +- .../continue-copilot-authorization/index.ts | 511 +++++++++++------- .../index.ts | 2 +- .../types.ts | 2 +- .../copilot/check-copilot-token/index.test.ts | 140 +++++ .../index.db.test.ts | 159 ++++++ .../index.ts | 45 ++ .../index.ts | 16 + .../index.ts | 21 + .../lock-sensitive-authorization/index.ts | 4 + .../authorizations/continue/post/index.ts | 1 + 25 files changed, 816 insertions(+), 206 deletions(-) create mode 100644 hub/server/integrations/copilot/check-copilot-token/index.test.ts create mode 100644 hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts create mode 100644 hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts create mode 100644 hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts create mode 100644 hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts diff --git a/hub/client/application/hub/routes/administrator-flow.test.tsx b/hub/client/application/hub/routes/administrator-flow.test.tsx index c95ba4932..fb088a71d 100644 --- a/hub/client/application/hub/routes/administrator-flow.test.tsx +++ b/hub/client/application/hub/routes/administrator-flow.test.tsx @@ -883,5 +883,36 @@ describe("administrator frontend integration", () => { }) expect(await screen.findByText("Copilot is disconnected.")).toBeVisible() }) + + it("does not intercept sign-out from the Copilot confirmation page", async () => { + const continuations = vi.fn() + await renderApplication(`/settings/copilot/confirm?authorizationId=${authorizationId}`, [ + authenticatedSession(), + workspace(), + http.get( + `${window.location.origin}/api/copilot-connection/authorizations/${authorizationId}`, + () => + HttpResponse.json({ + authorization: { + operation: "CONNECT_COPILOT", + verifiedAt: "2026-11-09T20:01:00.000Z", + expiresAt: "2026-11-09T20:06:00.000Z", + }, + }), + ), + http.post( + `${window.location.origin}/api/copilot-connection/authorizations/continue`, + continuations, + ), + ]) + + const signOutForm = document.querySelector( + 'form[action="/api/auth/session/sign-out"]', + ) + if (!signOutForm) throw new Error("Sign out must belong to a form.") + + expect(fireEvent.submit(signOutForm)).toBe(true) + expect(continuations).not.toHaveBeenCalled() + }) }) }) diff --git a/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx index e5781496a..aa8bb7d3d 100644 --- a/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx +++ b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx @@ -65,6 +65,7 @@ export default function SettingsCopilotAuthorization({
{ if (!(event.target instanceof HTMLFormElement)) return + if (event.target.action !== loaderData.page.submitPath) return event.preventDefault() if (result.pending) return const form = new FormData(event.target) diff --git a/hub/docs/copilot.md b/hub/docs/copilot.md index 9ab35b3e2..728160b8a 100644 --- a/hub/docs/copilot.md +++ b/hub/docs/copilot.md @@ -19,7 +19,7 @@ Hub reads the token only from the process environment. The database keeps its di 5. The callback verifies the same session and external identity, then returns to `/settings/copilot/confirm`. 6. Continuing a connection checks the configured token with the Copilot SDK before one serializable transaction saves the connection and audits the change. Continuing a disconnection clears the database state without changing the operator's secret. -The authorization is short-lived, one-use, and bound to the Hub session, operation, actor membership, and connection generation. A connection change after authorization starts or while Copilot checks the token returns a conflict instead of overwriting newer state. +The authorization is short-lived, one-use, and bound to the Hub session, operation, actor membership, and connection generation. Continuing atomically claims it before starting the SDK, so duplicate submissions do not start duplicate checks. Hub permits at most four deployment token checks at once and releases that capacity only after the SDK call ends; an abandoned claim expires after 30 seconds. A connection change after authorization starts or while Copilot checks the token returns a conflict instead of overwriting newer state. ## Stored state diff --git a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql index 0d2577db9..77e1ff699 100644 --- a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql +++ b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql @@ -1,5 +1,7 @@ ALTER TABLE "sensitive_authorizations" -ADD COLUMN "expected_copilot_generation" BIGINT; +ADD COLUMN "expected_copilot_generation" BIGINT, +ADD COLUMN "check_started_at" TIMESTAMPTZ(3), +ADD COLUMN "check_finished_at" TIMESTAMPTZ(3); CREATE TABLE "copilot_connection_states" ( "id" UUID NOT NULL, @@ -52,5 +54,39 @@ ADD CONSTRAINT "sensitive_authorizations_copilot_generation_check" CHECK ( ) ); +CREATE OR REPLACE FUNCTION protect_sensitive_authorization() +RETURNS trigger +LANGUAGE plpgsql +AS $$ +BEGIN + IF TG_OP = 'DELETE' THEN + RAISE EXCEPTION 'Sensitive authorization history cannot be deleted.'; + END IF; + IF TG_OP = 'UPDATE' AND ( + NEW."id" <> OLD."id" + OR NEW."hub_session_id" <> OLD."hub_session_id" + OR NEW."actor_membership_id" <> OLD."actor_membership_id" + OR NEW."external_identity_id" <> OLD."external_identity_id" + OR NEW."operation" <> OLD."operation" + OR NEW."target_membership_ids" <> OLD."target_membership_ids" + OR NEW."expected_copilot_generation" IS DISTINCT FROM OLD."expected_copilot_generation" + OR NEW."expires_at" <> OLD."expires_at" + OR OLD."check_started_at" IS NOT NULL + AND NEW."check_started_at" IS DISTINCT FROM OLD."check_started_at" + OR OLD."check_finished_at" IS NOT NULL + AND NEW."check_finished_at" IS DISTINCT FROM OLD."check_finished_at" + OR OLD."verified_at" IS NOT NULL AND NEW."verified_at" IS DISTINCT FROM OLD."verified_at" + OR OLD."continued_at" IS NOT NULL AND NEW."continued_at" IS DISTINCT FROM OLD."continued_at" + OR OLD."cancelled_at" IS NOT NULL AND NEW."cancelled_at" IS DISTINCT FROM OLD."cancelled_at" + ) THEN + RAISE EXCEPTION 'Sensitive authorization binding and completed transitions are immutable.'; + END IF; + IF TG_OP = 'UPDATE' AND NEW."updated_at" <= OLD."updated_at" THEN + RAISE EXCEPTION 'Sensitive authorization updates must advance updated_at.'; + END IF; + RETURN NEW; +END; +$$; + INSERT INTO "copilot_connection_states" ("id", "key") VALUES ('00000000-0000-4000-8000-000000000003', 'global'); diff --git a/hub/schema/sensitive-authorization.prisma b/hub/schema/sensitive-authorization.prisma index d61d3ebcb..bd67c9815 100644 --- a/hub/schema/sensitive-authorization.prisma +++ b/hub/schema/sensitive-authorization.prisma @@ -16,6 +16,8 @@ model SensitiveAuthorization { targetMembershipIds String[] @map("target_membership_ids") @db.Uuid expectedCopilotGeneration BigInt? @map("expected_copilot_generation") expiresAt DateTime @map("expires_at") @db.Timestamptz(3) + checkStartedAt DateTime? @map("check_started_at") @db.Timestamptz(3) + checkFinishedAt DateTime? @map("check_finished_at") @db.Timestamptz(3) verifiedAt DateTime? @map("verified_at") @db.Timestamptz(3) continuedAt DateTime? @map("continued_at") @db.Timestamptz(3) cancelledAt DateTime? @map("cancelled_at") @db.Timestamptz(3) diff --git a/hub/server/create-app/index.ts b/hub/server/create-app/index.ts index 6b6a0624f..fc6212923 100644 --- a/hub/server/create-app/index.ts +++ b/hub/server/create-app/index.ts @@ -28,8 +28,8 @@ export function createApp({ [ "/api/auth", "/api/administrators", - "/api/session-revocation", "/api/copilot-connection", + "/api/session-revocation", "/api/security-audits", "/api/workspace", "/api/repositories", diff --git a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts index a2c523f3a..43a81dc3a 100644 --- a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts +++ b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts @@ -255,6 +255,15 @@ describe("administrator authorization persistence", () => { targetMembershipIds: [membershipId], }, }) + await prisma.copilotConnectionState.update({ + data: { + connectedByMembershipId: membershipId, + generation: 1n, + tokenDigest: "c".repeat(64), + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) const authorizationAttemptId = await createConsumedAuthorizationAttempt({ authorizationId, providerRevisionId, @@ -290,6 +299,25 @@ describe("administrator authorization persistence", () => { where: { id: hubSessionId }, }) expect(endedProviderSession.endedAt).toBeInstanceOf(Date) + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { connectedByMembershipId: true, generation: true }, + where: { key: "global" }, + }), + ).resolves.toEqual({ connectedByMembershipId: null, generation: 2n }) + await expect( + prisma.securityAudit.findFirstOrThrow({ + select: { context: true }, + where: { action: "copilot.connection.disconnect" }, + }), + ).resolves.toEqual({ + context: { + actorMembershipId: null, + connectorMembershipId: membershipId, + operation: "disconnect", + reason: "connector_role_removed", + }, + }) }) it("binds one-use continuation to the exact session, operation, and ordered targets", async () => { diff --git a/hub/server/domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts b/hub/server/domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts index 772eb4f88..0bc327115 100644 --- a/hub/server/domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts +++ b/hub/server/domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts @@ -15,6 +15,7 @@ import { createOrRestoreMembership } from "../../../repositories/memberships/cre import { lockMembership } from "../../../repositories/memberships/lock-membership/index.ts" import { claimProviderEvidence } from "../../../repositories/provider-evidence-states/claim-provider-evidence/index.ts" import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { disconnectCopilotConnectionForMembership } from "../../../repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts" import { lockSessionRevocationState } from "../../../repositories/session-revocation-states/lock-session-revocation-state/index.ts" import { getSensitiveAuthorizationAuditData } from "../../../repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts" import { verifySensitiveAuthorization } from "../../../repositories/sensitive-authorizations/verify-sensitive-authorization/index.ts" @@ -42,6 +43,8 @@ export function runAdministratorAuthorizationVerificationTransaction( }, createOrRestoreMembership: (input) => createOrRestoreMembership(transaction, input), createSecurityAudit: (input) => createSecurityAudit(transaction, input), + disconnectCopilotConnection: (membershipId) => + disconnectCopilotConnectionForMembership(transaction, membershipId), endProviderAssignment: (input) => endProviderAssignment(transaction, input), endOpenHubSessionsForMembership: (membershipId) => endOpenHubSessionsForMembership(transaction, membershipId), diff --git a/hub/server/domains/administrator-management/designate-hub-administrators/index.test.ts b/hub/server/domains/administrator-management/designate-hub-administrators/index.test.ts index 09fc8e3d7..d9e452281 100644 --- a/hub/server/domains/administrator-management/designate-hub-administrators/index.test.ts +++ b/hub/server/domains/administrator-management/designate-hub-administrators/index.test.ts @@ -87,6 +87,7 @@ describe("designateHubAdministrators()", () => { const records = { createAssignment: vi.fn().mockResolvedValue({ id: randomUUID() }), createSecurityAudit: vi.fn().mockResolvedValue(undefined), + disconnectCopilotConnection: vi.fn().mockResolvedValue(false), endOpenSessions: vi.fn().mockResolvedValue([]), lockActiveAssignment: vi.fn(), lockEffectiveAdministratorAssignments: vi.fn().mockResolvedValue([]), diff --git a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts index 308ffdeb0..b151b6cce 100644 --- a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts +++ b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts @@ -39,7 +39,7 @@ export async function revokeHubAdministratorWithRepositories( !remainingAdministrators.some( ({ membershipId }) => membershipId === input.targetMembershipId, ) && - (await repositories.disconnectCopilotConnection?.(input.targetMembershipId)) + (await repositories.disconnectCopilotConnection(input.targetMembershipId)) ) { await repositories.createSecurityAudit({ actorMembershipId: input.actorMembershipId, diff --git a/hub/server/domains/administrator-management/revoke-hub-administrator/index.test.ts b/hub/server/domains/administrator-management/revoke-hub-administrator/index.test.ts index 74f7f8157..b606c553f 100644 --- a/hub/server/domains/administrator-management/revoke-hub-administrator/index.test.ts +++ b/hub/server/domains/administrator-management/revoke-hub-administrator/index.test.ts @@ -55,6 +55,7 @@ describe("revokeHubAdministrator()", () => { const records = { createAssignment: vi.fn(), createSecurityAudit: vi.fn().mockResolvedValue(undefined), + disconnectCopilotConnection: vi.fn().mockResolvedValue(false), endOpenSessions: vi.fn().mockResolvedValue([]), lockActiveAssignment: vi.fn().mockResolvedValue({ id: assignmentId }), lockEffectiveAdministratorAssignments: vi.fn().mockResolvedValue([]), diff --git a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts index e7e040ded..f43eba668 100644 --- a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts +++ b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts @@ -8,7 +8,7 @@ export interface AdministratorManagementRepositories { membershipId: string }): Promise<{ id: string }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise - disconnectCopilotConnection?(membershipId: string): Promise + disconnectCopilotConnection(membershipId: string): Promise endOpenSessions(membershipId: string): Promise> lockActiveAssignment(membershipId: string): Promise<{ id: string } | null> lockEffectiveAdministratorAssignments(membershipIds: string[]): Promise> diff --git a/hub/server/domains/admission/admit-authentication-proof/index.test.ts b/hub/server/domains/admission/admit-authentication-proof/index.test.ts index 118dbfe42..5946e1020 100644 --- a/hub/server/domains/admission/admit-authentication-proof/index.test.ts +++ b/hub/server/domains/admission/admit-authentication-proof/index.test.ts @@ -35,6 +35,7 @@ function repositories(overrides: Partial = {}) { transition: "created", }), createSecurityAudit: vi.fn().mockResolvedValue(undefined), + disconnectCopilotConnection: vi.fn().mockResolvedValue(false), endProviderAssignment: vi.fn().mockResolvedValue(undefined), endOpenHubSessionsForMembership: vi.fn().mockResolvedValue([]), lockActiveAssignments: vi diff --git a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts index 992fa5800..e4141d3ae 100644 --- a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts +++ b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts @@ -138,10 +138,11 @@ export async function applyProviderAssignmentEvidence( const administrator = assignments.some((assignment) => assignment.role === "ADMINISTRATOR") if ( !administrator && - (await dependencies.repositories.disconnectCopilotConnection?.(membershipId)) + (await dependencies.repositories.disconnectCopilotConnection(membershipId)) ) { await dependencies.repositories.createSecurityAudit({ - actorMembershipId: membershipId, + actorMembershipId: null, + connectorMembershipId: membershipId, id: dependencies.createId(), operation: "disconnect", outcome: "success", diff --git a/hub/server/domains/admission/run-admission-transaction/types.ts b/hub/server/domains/admission/run-admission-transaction/types.ts index 6796224b2..dab86379d 100644 --- a/hub/server/domains/admission/run-admission-transaction/types.ts +++ b/hub/server/domains/admission/run-admission-transaction/types.ts @@ -36,7 +36,7 @@ export interface AdmissionRepositories { transition: "created" | "restored" | "unchanged" }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise - disconnectCopilotConnection?(membershipId: string): Promise + disconnectCopilotConnection(membershipId: string): Promise endProviderAssignment(input: { id: string; lifecycle: "SUPERSEDED" | "REVOKED" }): Promise endOpenHubSessionsForMembership(membershipId: string): Promise> lockActiveAssignments(membershipId: string): Promise< diff --git a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts index b8b267991..5c7c83fe0 100644 --- a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts +++ b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts @@ -3,16 +3,27 @@ import { z } from "zod" import { Prisma } from "../../../generated/prisma/client.ts" import { CopilotTokenCheckError } from "../../../integrations/copilot/check-copilot-token/errors.ts" -import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { classifyPrismaTransactionError } from "../../../integrations/prisma/classify-transaction-error/index.ts" +import { lockEffectiveAdministratorProviders } from "../../../repositories/authentication-providers/lock-effective-administrator-providers/index.ts" import { lockCopilotConnectionState } from "../../../repositories/copilot-connection-state/lock-copilot-connection-state/index.ts" import { saveCopilotConnectionState } from "../../../repositories/copilot-connection-state/save-copilot-connection-state/index.ts" import { lockLiveHubSession } from "../../../repositories/hub-sessions/lock-live-hub-session/index.ts" -import { lockEffectiveAdministratorProviders } from "../../../repositories/authentication-providers/lock-effective-administrator-providers/index.ts" import { lockEffectiveAdministrators } from "../../../repositories/memberships/lock-effective-administrators/index.ts" +import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" +import { claimCopilotAuthorizationCheck } from "../../../repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts" +import { finishCopilotAuthorizationCheck } from "../../../repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts" +import { finishCopilotAuthorizationWithFailure } from "../../../repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts" +import { isSensitiveAuthorizationCurrent } from "../../../repositories/sensitive-authorizations/is-sensitive-authorization-current/index.ts" import { lockSensitiveAuthorization } from "../../../repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts" import { markSensitiveAuthorizationContinued } from "../../../repositories/sensitive-authorizations/mark-sensitive-authorization-continued/index.ts" -import { CopilotConnectionDeniedError, CopilotConnectionUnavailableError } from "../errors.ts" +import { runWithBoundedRetries } from "../../identity/run-with-bounded-retries/index.ts" +import { + CopilotConnectionDeniedError, + CopilotConnectionTransactionConflictError, + CopilotConnectionUnavailableError, +} from "../errors.ts" +const maximumConcurrentChecks = 4 const inputSchema = z .object({ authorizationId: z.uuid(), @@ -22,38 +33,314 @@ const inputSchema = z }) .strict() -export async function continueCopilotAuthorization( +interface PrismaClientLike { + $transaction( + operation: (transaction: Prisma.TransactionClient) => Promise, + options?: { isolationLevel?: Prisma.TransactionIsolationLevel }, + ): Promise +} + +type Input = z.infer +type FailureReason = + | "authorization_unavailable" + | "connection_changed" + | "no_token" + | "not_connected" + | "refused" + | "retry_exhausted" + | "unavailable" + +function isConflict(error: unknown) { + return error instanceof CopilotConnectionTransactionConflictError +} + +async function runSerializable( database: PrismaClientLike, - rawInput: unknown, - checkToken: (token: string) => Promise, + operation: (transaction: Prisma.TransactionClient) => Promise, ) { - const input = inputSchema.parse(rawInput) + return runWithBoundedRetries( + () => + database + .$transaction(operation, { + isolationLevel: Prisma.TransactionIsolationLevel.Serializable, + }) + .catch((error: unknown) => { + if (classifyPrismaTransactionError(error) === "retryable") { + throw new CopilotConnectionTransactionConflictError({ cause: error }) + } + throw error + }), + isConflict, + ) +} + +function authorizationMatches( + authorization: Awaited>, + input: Input, +): authorization is NonNullable>> { + return ( + authorization !== null && + authorization.hubSessionId === input.hubSessionId && + authorization.operation === input.operation && + authorization.targetMembershipIds.length === 1 && + authorization.targetMembershipIds[0] === authorization.actorMembershipId + ) +} + +async function lockCurrentAuthorization(transaction: Prisma.TransactionClient, input: Input) { + const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) + if ( + !authorizationMatches(authorization, input) || + authorization.cancelledAt || + authorization.continuedAt || + authorization.expired || + !authorization.verifiedAt || + !(await lockLiveHubSession(transaction, input.hubSessionId)) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + await lockEffectiveAdministratorProviders(transaction) + const administrators = await lockEffectiveAdministrators(transaction) + if ( + !administrators.some(({ membershipId }) => membershipId === authorization.actorMembershipId) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + const state = await lockCopilotConnectionState(transaction) + if ( + !state || + authorization.expectedCopilotGeneration === null || + state.generation !== authorization.expectedCopilotGeneration + ) { + throw new CopilotConnectionDeniedError("connection_changed") + } + if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { + throw new CopilotConnectionDeniedError("not_connected") + } + return authorization +} + +async function claimCheck(database: PrismaClientLike, input: Input) { try { - await requireCurrentAuthorization(database, input) + await runSerializable(database, async (transaction) => { + const authorization = await lockCurrentAuthorization(transaction, input) + if (authorization.checkStartedAt) { + throw new CopilotConnectionDeniedError("check_in_progress") + } + if ( + !(await isSensitiveAuthorizationCurrent(transaction, { + authorizationId: input.authorizationId, + hubSessionId: input.hubSessionId, + })) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + if ( + !(await claimCopilotAuthorizationCheck(transaction, { + id: input.authorizationId, + maximumConcurrentChecks, + })) + ) { + throw new CopilotConnectionUnavailableError( + "Too many Copilot token checks are already running.", + ) + } + }) } catch (error) { - if ( - error instanceof CopilotConnectionDeniedError && - (error.reason === "connection_changed" || error.reason === "not_connected") - ) { - await recordFailure(database, input, error.reason, "denied") + if (isConflict(error)) { + await recordFailure(database, input, "retry_exhausted", "failure") + throw new CopilotConnectionUnavailableError("The Copilot connection check could not start.", { + cause: error, + }) + } + throw error + } +} + +async function applyConnectionChange( + database: PrismaClientLike, + input: Input, + tokenDigest: string | undefined, +) { + try { + return await runSerializable(database, async (transaction) => { + const authorization = await lockCurrentAuthorization(transaction, input) + if (!authorization.checkStartedAt) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + if ( + !(await isSensitiveAuthorizationCurrent(transaction, { + authorizationId: input.authorizationId, + hubSessionId: input.hubSessionId, + })) + ) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) + await saveCopilotConnectionState( + transaction, + input.operation === "CONNECT_COPILOT" + ? { + membershipId: authorization.actorMembershipId, + operation: "connect", + tokenDigest: tokenDigest!, + } + : { operation: "disconnect" }, + ) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + id: randomUUID(), + operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", + outcome: "success", + type: "copilot_connection", + }) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + authorizationId: input.authorizationId, + id: randomUUID(), + operation: input.operation, + phase: "completed", + targetCount: 1, + type: "administrator_authorization", + }) + return { connected: input.operation === "CONNECT_COPILOT" } + }) + } catch (error) { + if (isConflict(error)) { + await recordFailure(database, input, "retry_exhausted", "failure") + throw new CopilotConnectionUnavailableError( + "The Copilot connection change could not be completed.", + { cause: error }, + ) + } + throw error + } +} + +async function finishCheck(database: PrismaClientLike, input: Input) { + try { + await runSerializable(database, async (transaction) => { + if (!(await finishCopilotAuthorizationCheck(transaction, input.authorizationId))) { + throw new CopilotConnectionDeniedError("authorization_unavailable") + } + }) + } catch (error) { + if (isConflict(error)) { + await recordFailure(database, input, "retry_exhausted", "failure") + throw new CopilotConnectionUnavailableError( + "The Copilot connection check could not release its capacity.", + { cause: error }, + ) + } + throw error + } +} + +async function recordFailure( + database: PrismaClientLike, + input: Input, + reason: FailureReason, + outcome: "denied" | "failure", +): Promise< + | "authorization_unavailable" + | "connection_changed" + | "no_token" + | "not_connected" + | "refused" + | "retry_exhausted" + | "unavailable" +> { + try { + return await runSerializable(database, async (transaction) => { + const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) + if ( + !authorizationMatches(authorization, input) || + authorization.cancelledAt || + authorization.continuedAt + ) { + return "authorization_unavailable" + } + const state = await lockCopilotConnectionState(transaction) + let recordedReason = reason + if ( + !state || + authorization.expectedCopilotGeneration === null || + state.generation !== authorization.expectedCopilotGeneration + ) { + recordedReason = "connection_changed" + } + if (authorization.checkStartedAt) { + if (authorization.checkFinishedAt) { + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) + } else if ( + !(await finishCopilotAuthorizationWithFailure(transaction, input.authorizationId)) + ) { + return "authorization_unavailable" + } + } else { + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) + } + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + id: randomUUID(), + operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", + outcome, + reason: recordedReason, + type: "copilot_connection", + }) + await createSecurityAudit(transaction, { + actorMembershipId: authorization.actorMembershipId, + authorizationId: input.authorizationId, + id: randomUUID(), + operation: input.operation, + phase: authorization.expired ? "expired" : "denied", + reason: recordedReason, + targetCount: 1, + type: "administrator_authorization", + }) + return recordedReason + }) + } catch (error) { + if (isConflict(error)) { + throw new CopilotConnectionUnavailableError( + "The Copilot connection failure could not be recorded.", + { cause: error }, + ) } throw error } +} + +export async function continueCopilotAuthorization( + database: PrismaClientLike, + rawInput: unknown, + checkToken: (token: string) => Promise, +) { + const input = inputSchema.parse(rawInput) + await claimCheck(database, input) + let tokenDigest: string | undefined if (input.operation === "CONNECT_COPILOT") { if (!input.token) { + await finishCheck(database, input) const reason = await recordFailure(database, input, "no_token", "denied") - if (reason === "unavailable") { - throw new CopilotConnectionUnavailableError("Copilot could not check the configured token.") - } - throw new CopilotConnectionDeniedError(reason) + throw new CopilotConnectionDeniedError( + reason === "retry_exhausted" || reason === "unavailable" + ? "authorization_unavailable" + : reason, + ) } + let checkError: unknown try { await checkToken(input.token) tokenDigest = createHash("sha256").update(input.token).digest("hex") } catch (error) { + checkError = error + } + await finishCheck(database, input) + if (checkError) { const reason = - error instanceof CopilotTokenCheckError && error.reason === "refused" + checkError instanceof CopilotTokenCheckError && checkError.reason === "refused" ? "refused" : "unavailable" const recordedReason = await recordFailure( @@ -63,197 +350,29 @@ export async function continueCopilotAuthorization( reason === "refused" ? "denied" : "failure", ) if (recordedReason !== "unavailable") { - throw new CopilotConnectionDeniedError(recordedReason) + throw new CopilotConnectionDeniedError( + recordedReason === "retry_exhausted" ? "authorization_unavailable" : recordedReason, + ) } throw new CopilotConnectionUnavailableError("Copilot could not check the configured token.", { - cause: error, + cause: checkError, }) } + } else { + await finishCheck(database, input) } try { - return await database.$transaction( - async (transaction) => { - const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) - if ( - !authorization || - authorization.hubSessionId !== input.hubSessionId || - authorization.operation !== input.operation || - authorization.targetMembershipIds.length !== 1 || - authorization.targetMembershipIds[0] !== authorization.actorMembershipId || - authorization.cancelledAt || - authorization.continuedAt || - authorization.expired || - !authorization.verifiedAt || - !(await lockLiveHubSession(transaction, input.hubSessionId)) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - await lockEffectiveAdministratorProviders(transaction) - const administrators = await lockEffectiveAdministrators(transaction) - if ( - !administrators.some( - ({ membershipId }) => membershipId === authorization.actorMembershipId, - ) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - const state = await lockCopilotConnectionState(transaction) - if ( - !state || - authorization.expectedCopilotGeneration === null || - state.generation !== authorization.expectedCopilotGeneration - ) { - throw new CopilotConnectionDeniedError("connection_changed") - } - if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { - throw new CopilotConnectionDeniedError("not_connected") - } - await markSensitiveAuthorizationContinued(transaction, input.authorizationId) - await saveCopilotConnectionState( - transaction, - input.operation === "CONNECT_COPILOT" - ? { - membershipId: authorization.actorMembershipId, - operation: "connect", - tokenDigest: tokenDigest!, - } - : { operation: "disconnect" }, - ) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - id: randomUUID(), - operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", - outcome: "success", - type: "copilot_connection", - }) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - authorizationId: input.authorizationId, - id: randomUUID(), - operation: input.operation, - phase: "completed", - targetCount: 1, - type: "administrator_authorization", - }) - return { connected: input.operation === "CONNECT_COPILOT" } - }, - { isolationLevel: Prisma.TransactionIsolationLevel.Serializable }, - ) + return await applyConnectionChange(database, input, tokenDigest) } catch (error) { if ( error instanceof CopilotConnectionDeniedError && - (error.reason === "connection_changed" || error.reason === "not_connected") + (error.reason === "connection_changed" || + error.reason === "not_connected" || + error.reason === "authorization_unavailable") ) { await recordFailure(database, input, error.reason, "denied") } throw error } } - -interface PrismaClientLike { - $transaction( - operation: (transaction: Prisma.TransactionClient) => Promise, - options?: { isolationLevel?: Prisma.TransactionIsolationLevel }, - ): Promise -} - -async function requireCurrentAuthorization( - database: PrismaClientLike, - input: z.infer, -) { - await database.$transaction(async (transaction) => { - const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) - if ( - !authorization || - authorization.hubSessionId !== input.hubSessionId || - authorization.operation !== input.operation || - authorization.targetMembershipIds.length !== 1 || - authorization.targetMembershipIds[0] !== authorization.actorMembershipId || - authorization.cancelledAt || - authorization.continuedAt || - authorization.expired || - !authorization.verifiedAt || - !(await lockLiveHubSession(transaction, input.hubSessionId)) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - await lockEffectiveAdministratorProviders(transaction) - const administrators = await lockEffectiveAdministrators(transaction) - if ( - !administrators.some(({ membershipId }) => membershipId === authorization.actorMembershipId) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - const state = await lockCopilotConnectionState(transaction) - if ( - !state || - authorization.expectedCopilotGeneration === null || - state.generation !== authorization.expectedCopilotGeneration - ) { - throw new CopilotConnectionDeniedError("connection_changed") - } - if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { - throw new CopilotConnectionDeniedError("not_connected") - } - }) -} - -async function recordFailure( - database: PrismaClientLike, - input: z.infer, - reason: "connection_changed" | "no_token" | "not_connected" | "refused" | "unavailable", - outcome: "denied" | "failure", -): Promise< - | "authorization_unavailable" - | "connection_changed" - | "no_token" - | "not_connected" - | "refused" - | "unavailable" -> { - return database.$transaction(async (transaction) => { - const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) - if ( - !authorization || - authorization.hubSessionId !== input.hubSessionId || - authorization.operation !== input.operation || - authorization.cancelledAt || - authorization.continuedAt || - authorization.expired || - !authorization.verifiedAt || - !(await lockLiveHubSession(transaction, input.hubSessionId)) - ) { - return "authorization_unavailable" - } - const state = await lockCopilotConnectionState(transaction) - let recordedReason = reason - if ( - !state || - authorization.expectedCopilotGeneration === null || - state.generation !== authorization.expectedCopilotGeneration - ) { - recordedReason = "connection_changed" - } - await markSensitiveAuthorizationContinued(transaction, input.authorizationId) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - id: randomUUID(), - operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", - outcome, - reason: recordedReason, - type: "copilot_connection", - }) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - authorizationId: input.authorizationId, - id: randomUUID(), - operation: input.operation, - phase: "denied", - reason: recordedReason, - targetCount: 1, - type: "administrator_authorization", - }) - return recordedReason - }) -} diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.ts index 2d6832a9d..f406aad8a 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.ts @@ -175,7 +175,7 @@ export async function reconcileAuthenticationProviders( } } const disconnected = - await repositories.disconnectCopilotConnectionWithoutEffectiveAdministrator?.() + await repositories.disconnectCopilotConnectionWithoutEffectiveAdministrator() if (disconnected) { await repositories.createSecurityAudit({ actorMembershipId: null, diff --git a/hub/server/domains/identity/run-provider-revision-transaction/types.ts b/hub/server/domains/identity/run-provider-revision-transaction/types.ts index 110101f76..68bd5460c 100644 --- a/hub/server/domains/identity/run-provider-revision-transaction/types.ts +++ b/hub/server/domains/identity/run-provider-revision-transaction/types.ts @@ -37,7 +37,7 @@ export interface ProviderRevisionRepositories { } export interface AuthenticationProviderReconciliationRepositories extends ProviderRevisionRepositories { - disconnectCopilotConnectionWithoutEffectiveAdministrator?(): Promise<{ + disconnectCopilotConnectionWithoutEffectiveAdministrator(): Promise<{ membershipId: string } | null> disableAuthenticationProvider(providerId: string): Promise diff --git a/hub/server/integrations/copilot/check-copilot-token/index.test.ts b/hub/server/integrations/copilot/check-copilot-token/index.test.ts new file mode 100644 index 000000000..cfe598c9f --- /dev/null +++ b/hub/server/integrations/copilot/check-copilot-token/index.test.ts @@ -0,0 +1,140 @@ +import { access } from "node:fs/promises" +import { beforeEach, describe, expect, it, vi } from "vitest" + +interface ClientStub { + getAuthStatus: ReturnType + listModels: ReturnType + start: ReturnType + stop: ReturnType +} + +function clientStub(overrides: Partial = {}): ClientStub { + return { + getAuthStatus: vi.fn().mockResolvedValue({ isAuthenticated: true }), + listModels: vi.fn().mockResolvedValue([]), + start: vi.fn().mockResolvedValue(undefined), + stop: vi.fn().mockResolvedValue(undefined), + ...overrides, + } +} + +async function loadCheck(client: ClientStub) { + const CopilotClient = vi.fn(function (options: unknown) { + return Object.assign(client, { options }) + }) + vi.doMock("@github/copilot-sdk", () => ({ CopilotClient })) + const { checkCopilotToken } = await import(".") + return { checkCopilotToken, CopilotClient } +} + +async function expectRemoved(home: string) { + await expect(access(home)).rejects.toMatchObject({ code: "ENOENT" }) +} + +describe("checkCopilotToken()", () => { + beforeEach(() => { + vi.doUnmock("@github/copilot-sdk") + }) + + it("checks an authenticated token with an isolated SDK home and releases every resource", async () => { + let home = "" + const client = clientStub({ + start: vi.fn(async function (this: ClientStub & { options: { baseDirectory: string } }) { + home = this.options.baseDirectory + await expect(access(home)).resolves.toBeUndefined() + }), + }) + const { checkCopilotToken, CopilotClient } = await loadCheck(client) + + await expect(checkCopilotToken("operator-token")).resolves.toBeUndefined() + + expect(CopilotClient).toHaveBeenCalledWith({ + baseDirectory: home, + gitHubToken: "operator-token", + logLevel: "error", + mode: "empty", + useLoggedInUser: false, + }) + expect(client.start).toHaveBeenCalledOnce() + expect(client.getAuthStatus).toHaveBeenCalledOnce() + expect(client.listModels).toHaveBeenCalledOnce() + expect(client.stop).toHaveBeenCalledOnce() + await expectRemoved(home) + }) + + it("reports an unauthenticated SDK session as refused and still cleans up", async () => { + const client = clientStub({ + getAuthStatus: vi.fn().mockResolvedValue({ isAuthenticated: false }), + }) + const { checkCopilotToken, CopilotClient } = await loadCheck(client) + + await expect(checkCopilotToken("refused-token")).rejects.toMatchObject({ + reason: "refused", + }) + + expect(client.listModels).not.toHaveBeenCalled() + expect(client.stop).toHaveBeenCalledOnce() + await expectRemoved( + (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) + .options.baseDirectory, + ) + }) + + it.each([ + ["an authorization error", new Error("401 Unauthorized"), "refused"], + ["a service error", new Error("service unavailable"), "unavailable"], + ] as const)("classifies %s and releases the SDK client", async (_case, failure, reason) => { + const client = clientStub({ listModels: vi.fn().mockRejectedValue(failure) }) + const { checkCopilotToken, CopilotClient } = await loadCheck(client) + + await expect(checkCopilotToken("operator-token")).rejects.toMatchObject({ reason }) + + expect(client.stop).toHaveBeenCalledOnce() + await expectRemoved( + (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) + .options.baseDirectory, + ) + }) + + it("times out an unresponsive SDK and releases the client and temporary home", async () => { + vi.useFakeTimers() + let markStarted: (() => void) | undefined + const started = new Promise((resolve) => { + markStarted = resolve + }) + const client = clientStub({ + start: vi.fn(() => { + markStarted!() + return new Promise(() => undefined) + }), + }) + const { checkCopilotToken, CopilotClient } = await loadCheck(client) + + const result = expect(checkCopilotToken("operator-token")).rejects.toMatchObject({ + reason: "unavailable", + }) + await started + await vi.advanceTimersByTimeAsync(20_000) + await result + + expect(client.stop).toHaveBeenCalledOnce() + await expectRemoved( + (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) + .options.baseDirectory, + ) + }) + + it("reports an SDK import failure without constructing a client", async () => { + vi.doMock("@github/copilot-sdk", () => { + throw new Error("SDK failed to load") + }) + const { checkCopilotToken } = await import(".") + + await expect(checkCopilotToken("operator-token")).rejects.toEqual( + expect.objectContaining({ + name: "CopilotTokenCheckError", + reason: "unavailable", + }), + ) + }) +}) diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts new file mode 100644 index 000000000..13fde8483 --- /dev/null +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts @@ -0,0 +1,159 @@ +import { randomUUID } from "node:crypto" +import { describe, expect, it } from "vitest" + +import { reconcileAuthenticationProviders } from "../../../domains/identity/reconcile-authentication-providers" +import { runProviderRevisionTransaction } from "../../../domains/identity/run-provider-revision-transaction" +import { prisma } from "../../../integrations/prisma" +import { createSecurityAudit } from "../../security-audits/create-security-audit" + +function providerCandidate(revision: number) { + return { + canonicalPublicConfiguration: JSON.stringify({ clientId: `github-client-${revision}` }), + providerKey: "github", + revision, + } +} + +function reconcile(revision: number | null) { + return reconcileAuthenticationProviders(revision === null ? [] : [providerCandidate(revision)], { + createId: randomUUID, + runTransaction: (operation) => runProviderRevisionTransaction(prisma, operation), + writeAudit: (event) => createSecurityAudit(prisma, event), + }) +} + +async function createConnectedProviderAdministrator(withIndependentAdministratorSource = false) { + const [provider] = await reconcile(1) + const userId = randomUUID() + const externalIdentityId = randomUUID() + const membershipId = randomUUID() + await prisma.$transaction(async (transaction) => { + await transaction.user.create({ data: { id: userId } }) + await transaction.externalIdentity.create({ + data: { + id: externalIdentityId, + issuer: "https://github.com", + provider: "github", + subject: randomUUID(), + userId, + }, + }) + await transaction.membership.create({ data: { id: membershipId, userId } }) + await transaction.membershipAssignment.create({ + data: { + externalIdentityId, + id: randomUUID(), + membershipId, + providerAssignmentSubject: randomUUID(), + providerRevisionId: provider!.revisionId, + role: "ADMINISTRATOR", + source: "AUTHENTICATION_PROVIDER", + }, + }) + if (withIndependentAdministratorSource) { + await transaction.membershipAssignment.create({ + data: { + externalIdentityId, + id: randomUUID(), + membershipId, + role: "ADMINISTRATOR", + source: "BOOTSTRAP", + }, + }) + } + await transaction.copilotConnectionState.update({ + data: { + connectedByMembershipId: membershipId, + generation: 7n, + tokenDigest: "a".repeat(64), + verifiedAt: new Date(), + }, + where: { key: "global" }, + }) + }) + return { membershipId, provider } +} + +async function expectAutomaticDisconnection(membershipId: string) { + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { + connectedByMembershipId: true, + generation: true, + tokenDigest: true, + verifiedAt: true, + }, + where: { key: "global" }, + }), + ).resolves.toEqual({ + connectedByMembershipId: null, + generation: 8n, + tokenDigest: null, + verifiedAt: null, + }) + await expect( + prisma.securityAudit.findFirstOrThrow({ + select: { action: true, context: true, outcome: true }, + where: { action: "copilot.connection.disconnect" }, + }), + ).resolves.toEqual({ + action: "copilot.connection.disconnect", + context: { + actorMembershipId: null, + connectorMembershipId: membershipId, + operation: "disconnect", + reason: "connector_role_removed", + }, + outcome: "SUCCESS", + }) +} + +describe("disconnectCopilotConnectionWithoutEffectiveAdministrator()", () => { + it("disconnects after provider removal returns no configured providers", async () => { + const { membershipId } = await createConnectedProviderAdministrator() + + await expect(reconcile(null)).resolves.toEqual([]) + + await expectAutomaticDisconnection(membershipId) + }) + + it("disconnects when revision replacement makes the connector's provider assignment stale", async () => { + const { membershipId, provider } = await createConnectedProviderAdministrator() + + await expect(reconcile(2)).resolves.toEqual([ + expect.objectContaining({ + providerId: provider!.providerId, + providerKey: "github", + revision: 2, + }), + ]) + + await expectAutomaticDisconnection(membershipId) + }) + + it("preserves the connection when provider removal leaves an independent administrator source", async () => { + const { membershipId } = await createConnectedProviderAdministrator(true) + + await expect(reconcile(null)).resolves.toEqual([]) + + await expect( + prisma.copilotConnectionState.findUniqueOrThrow({ + select: { + connectedByMembershipId: true, + generation: true, + tokenDigest: true, + }, + where: { key: "global" }, + }), + ).resolves.toEqual({ + connectedByMembershipId: membershipId, + generation: 7n, + tokenDigest: "a".repeat(64), + }) + await expect( + prisma.securityAudit.count({ + where: { action: "copilot.connection.disconnect" }, + }), + ).resolves.toBe(0) + }) +}) diff --git a/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts b/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts new file mode 100644 index 000000000..290b35369 --- /dev/null +++ b/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts @@ -0,0 +1,45 @@ +import { z } from "zod" + +import type { Prisma } from "../../../generated/prisma/client.ts" + +const inputSchema = z + .object({ + id: z.uuid(), + maximumConcurrentChecks: z.number().int().min(1).max(20), + }) + .strict() + +export async function claimCopilotAuthorizationCheck( + database: Pick, + input: z.input, +): Promise { + const parsed = inputSchema.parse(input) + const rows = await database.$queryRaw>` + WITH capacity AS ( + SELECT pg_advisory_xact_lock(hashtext('replica_copilot_authorization_checks')) + ) + UPDATE "sensitive_authorizations" + SET "check_started_at" = clock_timestamp(), "updated_at" = clock_timestamp() + FROM capacity + WHERE "id" = ${parsed.id}::uuid + AND "operation" IN ('CONNECT_COPILOT', 'DISCONNECT_COPILOT') + AND "verified_at" IS NOT NULL + AND "check_started_at" IS NULL + AND "continued_at" IS NULL + AND "cancelled_at" IS NULL + AND "expires_at" > clock_timestamp() + AND ( + "operation" = 'DISCONNECT_COPILOT' + OR ( + SELECT count(*) + FROM "sensitive_authorizations" + WHERE "operation" = 'CONNECT_COPILOT' + AND "check_started_at" IS NOT NULL + AND "check_finished_at" IS NULL + AND "check_started_at" > clock_timestamp() - interval '30 seconds' + ) < ${parsed.maximumConcurrentChecks} + ) + RETURNING "id" + ` + return rows.length === 1 +} diff --git a/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts b/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts new file mode 100644 index 000000000..76b84bb5a --- /dev/null +++ b/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts @@ -0,0 +1,16 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function finishCopilotAuthorizationCheck( + database: Pick, + id: string, +): Promise { + const result = await database.sensitiveAuthorization.updateMany({ + data: { checkFinishedAt: new Date() }, + where: { + checkFinishedAt: null, + checkStartedAt: { not: null }, + id, + }, + }) + return result.count === 1 +} diff --git a/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts b/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts new file mode 100644 index 000000000..9f2b8ef70 --- /dev/null +++ b/hub/server/repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts @@ -0,0 +1,21 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function finishCopilotAuthorizationWithFailure( + database: Pick, + id: string, +): Promise { + const finishedAt = new Date() + const result = await database.sensitiveAuthorization.updateMany({ + data: { + checkFinishedAt: finishedAt, + continuedAt: finishedAt, + }, + where: { + checkFinishedAt: null, + checkStartedAt: { not: null }, + continuedAt: null, + id, + }, + }) + return result.count === 1 +} diff --git a/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts index ca664c3af..5636748a1 100644 --- a/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts +++ b/hub/server/repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts @@ -9,6 +9,8 @@ export async function lockSensitiveAuthorization( actorMembershipId: string cancelledAt: Date | null expectedCopilotGeneration: bigint | null + checkFinishedAt: Date | null + checkStartedAt: Date | null continuedAt: Date | null expiresAt: Date expired: boolean @@ -32,6 +34,8 @@ export async function lockSensitiveAuthorization( "expires_at" AS "expiresAt", "expires_at" <= clock_timestamp() AS "expired", "verified_at" AS "verifiedAt", + "check_finished_at" AS "checkFinishedAt", + "check_started_at" AS "checkStartedAt", "continued_at" AS "continuedAt", "cancelled_at" AS "cancelledAt" FROM "sensitive_authorizations" diff --git a/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts index 5cb8dea4e..e3a0d5551 100644 --- a/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts +++ b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts @@ -39,6 +39,7 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH if (error instanceof CopilotConnectionDeniedError) { const message = { authorization_unavailable: "This Copilot authorization is no longer available.", + check_in_progress: "This Copilot authorization is already being continued.", connection_changed: "The Copilot connection changed. Review it before trying again.", no_token: "Hub has no configured Copilot token.", not_connected: "Copilot is not connected.", From b595987c2ca9d922133c43e067b6594c4c3675d9 Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Fri, 13 Nov 2026 09:29:38 -0800 Subject: [PATCH 7/9] fix(hub): preserve sensitive authorization targets Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../migration.sql | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql index 77e1ff699..9fb1ba530 100644 --- a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql +++ b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql @@ -54,6 +54,25 @@ ADD CONSTRAINT "sensitive_authorizations_copilot_generation_check" CHECK ( ) ); +ALTER TABLE "sensitive_authorizations" +DROP CONSTRAINT "sensitive_authorizations_targets_check"; + +ALTER TABLE "sensitive_authorizations" +ADD CONSTRAINT "sensitive_authorizations_targets_check" CHECK ( + ( + "operation" = 'END_ALL_HUB_SESSIONS' + AND cardinality("target_membership_ids") = 0 + ) + OR ( + "operation" IN ('CONNECT_COPILOT', 'DISCONNECT_COPILOT', 'REVOKE_ADMINISTRATOR') + AND cardinality("target_membership_ids") = 1 + ) + OR ( + "operation" = 'DESIGNATE_ADMINISTRATORS' + AND cardinality("target_membership_ids") BETWEEN 1 AND 50 + ) +); + CREATE OR REPLACE FUNCTION protect_sensitive_authorization() RETURNS trigger LANGUAGE plpgsql From 833cfb1acf542c868a0092f3a26f71125b20408c Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Fri, 13 Nov 2026 09:34:29 -0800 Subject: [PATCH 8/9] style(hub): format authorization callback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- hub/server/routes/api/auth/callback/get/index.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hub/server/routes/api/auth/callback/get/index.ts b/hub/server/routes/api/auth/callback/get/index.ts index bdc7e6cf8..2eec845d8 100644 --- a/hub/server/routes/api/auth/callback/get/index.ts +++ b/hub/server/routes/api/auth/callback/get/index.ts @@ -82,7 +82,7 @@ export function get(dependencies: AuthenticationCallbackDependencies): RequestHa ? `/settings/sessions/confirm?authorizationId=${completed.sensitiveAuthorizationId}` : operation === "CONNECT_COPILOT" || operation === "DISCONNECT_COPILOT" ? `/settings/copilot/confirm?authorizationId=${completed.sensitiveAuthorizationId}` - : `/settings/administrators/confirm?authorizationId=${completed.sensitiveAuthorizationId}`, + : `/settings/administrators/confirm?authorizationId=${completed.sensitiveAuthorizationId}`, ) return } From bc98a97c3cd7f2b8da565d99caa1897ed2e6a471 Mon Sep 17 00:00:00 2001 From: Ben Thomas Date: Fri, 13 Nov 2026 10:57:19 -0800 Subject: [PATCH 9/9] fix(hub): integrate Copilot authorization with learning Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- hub/.env.example | 4 - .../hub/copilot-connection-contracts/index.ts | 25 ++ .../change-copilot-connection/index.ts | 18 - .../hub/routes/administrator-flow.test.tsx | 177 +------- .../settings-copilot-authorization/index.tsx | 2 +- .../hub/routes/settings-copilot/index.tsx | 111 ++--- hub/docs/copilot.md | 46 +- hub/package-lock.json | 32 +- hub/package.json | 2 +- hub/schema/membership.prisma | 3 +- .../migration.sql | 43 +- .../administrator-authorization.db.test.ts | 19 +- .../administrator-management.db.test.ts | 29 +- .../index.ts | 17 +- .../types.ts | 4 +- .../index.ts | 14 +- .../admission/provider-role-loss.db.test.ts | 24 +- .../run-admission-transaction/types.ts | 4 +- .../connect-copilot/index.ts | 31 ++ .../index.test.ts | 38 ++ .../continue-copilot-authorization/index.ts | 391 ++--------------- .../disconnect-copilot/index.ts | 33 +- .../domains/copilot-connection/types.ts | 17 +- .../index.test.ts | 18 +- .../index.ts | 6 +- .../types.ts | 2 + hub/server/index.test.ts | 16 +- hub/server/index.ts | 1 + .../copilot/check-copilot-token/errors.ts | 14 - .../copilot/check-copilot-token/index.test.ts | 140 ------ .../copilot/check-copilot-token/index.ts | 54 --- .../index.ts | 22 +- .../index.db.test.ts | 55 +-- .../index.ts | 42 +- .../get-copilot-connection-state/index.ts | 31 -- .../lock-copilot-connection-state/index.ts | 20 - .../save-copilot-connection-state/index.ts | 32 -- .../create-security-audit/types.ts | 10 - .../get-security-audit-data/index.ts | 21 - .../parse-security-audit-event/index.ts | 11 - .../parse-security-audit-event/types.ts | 2 - .../index.ts | 30 +- .../index.db.test.ts | 90 ++++ .../index.ts | 34 ++ .../index.ts | 2 + .../authorizations/start/rate-limit/index.ts | 10 +- .../index.ts | 52 +-- hub/server/routes/api/auth/types.ts | 26 +- .../authorizations/cancel/post/index.ts | 16 +- .../authorizations/continue/post/index.ts | 44 +- .../authorizations/get/index.ts | 16 +- .../authorizations/start/post/index.ts | 34 +- .../copilot-connection/connect/post/index.ts | 62 --- .../index.ts | 116 +++-- .../disconnect/delete/index.ts | 40 -- .../api/copilot-connection/index.test.ts | 409 ++++++++++-------- .../routes/api/copilot-connection/types.ts | 52 ++- .../present-security-audit/index.ts | 28 -- hub/server/routes/index.ts | 27 +- hub/server/run-api/index.test.ts | 41 +- hub/server/run-api/index.ts | 8 +- 61 files changed, 1068 insertions(+), 1650 deletions(-) delete mode 100644 hub/client/application/hub/requests/change-copilot-connection/index.ts create mode 100644 hub/server/domains/copilot-connection/continue-copilot-authorization/index.test.ts delete mode 100644 hub/server/integrations/copilot/check-copilot-token/errors.ts delete mode 100644 hub/server/integrations/copilot/check-copilot-token/index.test.ts delete mode 100644 hub/server/integrations/copilot/check-copilot-token/index.ts delete mode 100644 hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts delete mode 100644 hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts delete mode 100644 hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts create mode 100644 hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.db.test.ts create mode 100644 hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.ts delete mode 100644 hub/server/routes/api/copilot-connection/connect/post/index.ts delete mode 100644 hub/server/routes/api/copilot-connection/disconnect/delete/index.ts diff --git a/hub/.env.example b/hub/.env.example index 4655d8d9b..1668dba9a 100644 --- a/hub/.env.example +++ b/hub/.env.example @@ -81,7 +81,3 @@ TEST_DATABASE_URL=postgresql://replica:replica@127.0.0.1:5432/postgres # Trust forwarded client addresses only behind this exact protected proxy-chain length. # HUB_TRUSTED_PROXY_HOPS=0 - -# Optional deployment-level Copilot connection. Use a fine-grained personal access token whose -# only account permission is Copilot requests. Hub never stores or returns this value. -# REPLICA_COPILOT_TOKEN= diff --git a/hub/client/application/hub/copilot-connection-contracts/index.ts b/hub/client/application/hub/copilot-connection-contracts/index.ts index e5912ef49..2ffaf5d2e 100644 --- a/hub/client/application/hub/copilot-connection-contracts/index.ts +++ b/hub/client/application/hub/copilot-connection-contracts/index.ts @@ -17,3 +17,28 @@ export const copilotConnectionStatusSchema = z verifiedAt: z.iso.datetime({ offset: true }).nullable(), }) .strict() + +export const copilotAuthorizationStartResponseSchema = z + .object({ + authorizationId: z.uuid(), + authorizationUrl: z.url({ protocol: /^https?$/ }), + expiresAt: z.iso.datetime({ offset: true }), + }) + .strict() + +export const copilotAuthorizationResponseSchema = z + .object({ + authorization: z + .object({ + expiresAt: z.iso.datetime({ offset: true }), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), + verifiedAt: z.iso.datetime({ offset: true }), + }) + .strict(), + }) + .strict() + +export const copilotContinuationResponseSchema = z.union([ + z.object({ connectionId: z.uuid() }).strict(), + z.object({ disconnected: z.literal(true) }).strict(), +]) diff --git a/hub/client/application/hub/requests/change-copilot-connection/index.ts b/hub/client/application/hub/requests/change-copilot-connection/index.ts deleted file mode 100644 index adf9a81cd..000000000 --- a/hub/client/application/hub/requests/change-copilot-connection/index.ts +++ /dev/null @@ -1,18 +0,0 @@ -import { z } from "zod" - -import { requestJson } from "../request-json" - -export function changeCopilotConnection(request: Request, operation: "connect" | "disconnect") { - return requestJson( - new URL( - operation === "connect" ? "/api/copilot-connection/connect" : "/api/copilot-connection", - request.url, - ), - z.undefined(), - { - body: JSON.stringify({ confirmed: true }), - method: operation === "connect" ? "POST" : "DELETE", - signal: request.signal, - }, - ) -} diff --git a/hub/client/application/hub/routes/administrator-flow.test.tsx b/hub/client/application/hub/routes/administrator-flow.test.tsx index fb088a71d..ad2f74751 100644 --- a/hub/client/application/hub/routes/administrator-flow.test.tsx +++ b/hub/client/application/hub/routes/administrator-flow.test.tsx @@ -1,5 +1,5 @@ import type { RouteConfigEntry } from "@react-router/dev/routes" -import { act, fireEvent, render, screen, waitFor, within } from "@testing-library/react" +import { act, fireEvent, render, screen, within } from "@testing-library/react" import { http, HttpResponse } from "msw" import { setupServer } from "msw/node" import type { ComponentType } from "react" @@ -134,8 +134,7 @@ function workspace() { describe("administrator frontend integration", () => { it("does not intercept account-menu sign-out on the Copilot page", async () => { - const connect = vi.fn() - const disconnect = vi.fn() + const startAuthorization = vi.fn() await renderApplication("/settings/copilot", [ authenticatedSession(), http.get(`${window.location.origin}/api/copilot-connection`, () => @@ -148,8 +147,10 @@ describe("administrator frontend integration", () => { verifiedAt: null, }), ), - http.post(`${window.location.origin}/api/copilot-connection/connect`, connect), - http.delete(`${window.location.origin}/api/copilot-connection`, disconnect), + http.post( + `${window.location.origin}/api/copilot-connection/authorizations/start`, + startAuthorization, + ), ]) await screen.findByRole("heading", { name: "Copilot is not connected" }) @@ -159,157 +160,7 @@ describe("administrator frontend integration", () => { if (!signOutForm) throw new Error("Sign out must belong to a form.") expect(fireEvent.submit(signOutForm)).toBe(true) - expect(connect).not.toHaveBeenCalled() - expect(disconnect).not.toHaveBeenCalled() - }, 10_000) - - it("allows an administrator to disconnect an inactive saved Copilot connection", async () => { - const disconnect = vi.fn(() => new HttpResponse(null, { status: 204 })) - await renderApplication("/settings/copilot", [ - authenticatedSession(), - http.get(`${window.location.origin}/api/copilot-connection`, () => - HttpResponse.json({ - configured: true, - connected: false, - savedConnection: true, - connectedBy: null, - refusedAt: "2026-11-11T13:00:00.000Z", - verifiedAt: null, - }), - ), - http.delete(`${window.location.origin}/api/copilot-connection`, disconnect), - ]) - - expect(await screen.findByRole("button", { name: "Disconnect Copilot" })).toBeVisible() - fireEvent.click( - screen.getByRole("checkbox", { - name: "I understand and confirm disconnecting Copilot for this Hub.", - }), - ) - fireEvent.click(screen.getByRole("button", { name: "Disconnect Copilot" })) - - await waitFor(() => expect(disconnect).toHaveBeenCalledTimes(1)) - }, 10_000) - - it("revalidates a connected page after Copilot refuses a recheck", async () => { - let refused = false - let statusRequests = 0 - await renderApplication("/settings/copilot", [ - authenticatedSession(), - http.get(`${window.location.origin}/api/copilot-connection`, () => { - statusRequests += 1 - return HttpResponse.json({ - configured: true, - connected: !refused, - savedConnection: true, - connectedBy: refused - ? null - : { - login: "octocat", - membershipId: actorMembershipId, - name: "The Octocat", - }, - refusedAt: refused ? "2026-11-11T13:00:00.000Z" : null, - verifiedAt: "2026-11-10T23:00:00.000Z", - }) - }), - http.post(`${window.location.origin}/api/copilot-connection/connect`, () => { - refused = true - return HttpResponse.json( - { error: "Copilot refused the configured credential." }, - { status: 422 }, - ) - }), - ]) - - expect(await screen.findByRole("heading", { name: "Copilot is connected" })).toBeVisible() - fireEvent.click( - screen.getByRole("checkbox", { - name: "I understand and confirm connecting Copilot for this Hub.", - }), - ) - fireEvent.click(screen.getByRole("button", { name: "Check Copilot connection" })) - - expect(await screen.findByText("Copilot refused the configured credential.")).toBeVisible() - expect(await screen.findByRole("heading", { name: "Copilot is not connected" })).toBeVisible() - expect(screen.getByText(/Copilot refused the configured credential on/)).toBeVisible() - expect(screen.getByRole("button", { name: "Check and connect Copilot" })).toBeVisible() - expect(screen.getByRole("button", { name: "Disconnect Copilot" })).toBeVisible() - expect(statusRequests).toBeGreaterThan(1) - }, 10_000) - - it("uses the real Copilot status and mutation APIs with visible action results", async () => { - const mutations: Array<{ body: unknown; method: string; path: string }> = [] - let connected = false - await renderApplication("/settings/copilot", [ - authenticatedSession(), - http.get(`${window.location.origin}/api/copilot-connection`, () => - HttpResponse.json({ - configured: true, - connected, - savedConnection: connected, - connectedBy: connected - ? { - login: "octocat", - membershipId: actorMembershipId, - name: "The Octocat", - } - : null, - refusedAt: null, - verifiedAt: connected ? "2026-11-10T23:00:00.000Z" : null, - }), - ), - http.post(`${window.location.origin}/api/copilot-connection/connect`, async ({ request }) => { - mutations.push({ - body: await request.json(), - method: request.method, - path: new URL(request.url).pathname, - }) - connected = true - return new HttpResponse(null, { status: 204 }) - }), - http.delete(`${window.location.origin}/api/copilot-connection`, async ({ request }) => { - mutations.push({ - body: await request.json(), - method: request.method, - path: new URL(request.url).pathname, - }) - return HttpResponse.json({ error: "Copilot is temporarily unavailable." }, { status: 503 }) - }), - ]) - - expect(await screen.findByRole("heading", { name: "Copilot is not connected" })).toBeVisible() - fireEvent.click( - screen.getByRole("checkbox", { - name: "I understand and confirm connecting Copilot for this Hub.", - }), - ) - fireEvent.click(screen.getByRole("button", { name: "Connect Copilot" })) - - expect(await screen.findByText("Copilot connected.")).toBeVisible() - expect(await screen.findByRole("heading", { name: "Copilot is connected" })).toBeVisible() - fireEvent.click( - screen.getByRole("checkbox", { - name: "I understand and confirm disconnecting Copilot for this Hub.", - }), - ) - fireEvent.click(screen.getByRole("button", { name: "Disconnect Copilot" })) - - expect(await screen.findByText("Copilot is temporarily unavailable.")).toBeVisible() - await waitFor(() => - expect(mutations).toEqual([ - { - body: { confirmed: true }, - method: "POST", - path: "/api/copilot-connection/connect", - }, - { - body: { confirmed: true }, - method: "DELETE", - path: "/api/copilot-connection", - }, - ]), - ) + expect(startAuthorization).not.toHaveBeenCalled() }, 10_000) it("uses the real administrator contract and retains its opaque cursor", async () => { @@ -797,12 +648,11 @@ describe("administrator frontend integration", () => { workspace(), http.get(`${window.location.origin}/api/copilot-connection`, () => HttpResponse.json({ + configured: true, connected: false, - connectedAt: null, + savedConnection: false, connectedBy: null, refusedAt: null, - tokenConfigured: true, - tokenNeedsCheck: false, verifiedAt: null, }), ), @@ -854,17 +704,16 @@ describe("administrator frontend integration", () => { `${window.location.origin}/api/copilot-connection/authorizations/continue`, async ({ request }) => { continuationBodies.push(await request.json()) - return HttpResponse.json({ connected: false }) + return HttpResponse.json({ disconnected: true }) }, ), http.get(`${window.location.origin}/api/copilot-connection`, () => HttpResponse.json({ + configured: true, connected: false, - connectedAt: null, + savedConnection: false, connectedBy: null, refusedAt: null, - tokenConfigured: true, - tokenNeedsCheck: false, verifiedAt: null, }), ), @@ -881,7 +730,7 @@ describe("administrator frontend integration", () => { "/settings/copilot?result=disconnected", ) }) - expect(await screen.findByText("Copilot is disconnected.")).toBeVisible() + expect(await screen.findByRole("heading", { name: "Copilot is not connected" })).toBeVisible() }) it("does not intercept sign-out from the Copilot confirmation page", async () => { diff --git a/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx index aa8bb7d3d..14d5bf68b 100644 --- a/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx +++ b/hub/client/application/hub/routes/settings-copilot-authorization/index.tsx @@ -79,7 +79,7 @@ export default function SettingsCopilotAuthorization({ : continueCopilotAuthorization(request, { authorizationId: loaderData.authorizationId, operation: loaderData.authorization.operation, - }).then((response) => (response.connected ? "connected" : "disconnected")) + }).then((response) => ("connectionId" in response ? "connected" : "disconnected")) void action .then((outcome) => navigate(`/settings/copilot?result=${outcome}`)) .catch((error: unknown) => { diff --git a/hub/client/application/hub/routes/settings-copilot/index.tsx b/hub/client/application/hub/routes/settings-copilot/index.tsx index e6c219f57..235ab444a 100644 --- a/hub/client/application/hub/routes/settings-copilot/index.tsx +++ b/hub/client/application/hub/routes/settings-copilot/index.tsx @@ -1,16 +1,14 @@ -import { useEffect, useRef } from "react" -import { data, useFetcher, useLocation, useRevalidator } from "react-router" +import { useState } from "react" import { CopilotConnectionPage } from "@pages/copilot-connection-page" import type { CopilotConnectionPageData } from "@pages/copilot-connection-page/types" import { ApiContractError } from "@application/hub/requests/api-contract-error" import { ApiRequestError } from "@application/hub/requests/api-request-error" -import { changeCopilotConnection } from "@application/hub/requests/change-copilot-connection" import { getCopilotConnection } from "@application/hub/requests/get-copilot-connection" import { getCurrentHubSession } from "@application/hub/requests/get-current-hub-session" +import { startCopilotAuthorization } from "@application/hub/requests/start-copilot-authorization" +import { navigateToExternalUrl } from "@application/hub/navigate-to-external-url" import { SettingsRouteScreen } from "@application/hub/screens/settings-route-screen" -import { SettingsFormBoundary } from "@application/hub/screens/settings-form-boundary" -import type { SettingsActionResult } from "@application/hub/settings-contracts/types" import { copilotConnectionPageData } from "@application/hub/view-models/copilot-connection-page-data" import { settingsController } from "../settings-controller" @@ -42,39 +40,10 @@ export async function clientLoader( export async function clientAction(args: Parameters[0]) { if (isMockMode()) return controller.clientAction(args) - if (args.request.method.toUpperCase() !== "POST") { - throw new Response("Method not allowed.", { status: 405, headers: { Allow: "POST" } }) - } - try { - const form = await args.request.formData() - if (form.get("confirmed") !== "1") { - return data( - { saved: false, error: "Confirm the Copilot connection change." }, - { status: 400 }, - ) - } - const operation = form.get("_method") === "delete" ? "disconnect" : "connect" - await changeCopilotConnection(args.request, operation) - return data({ - saved: true, - notice: `Copilot ${operation === "connect" ? "connected" : "disconnected"}.`, - revision: 0, - }) - } catch (error) { - if (error instanceof ApiRequestError) { - return data( - { saved: false, error: error.message }, - { status: error.status >= 400 && error.status <= 599 ? error.status : 503 }, - ) - } - if (error instanceof ApiContractError) { - return data( - { saved: false, error: "The API response was invalid. No change was saved." }, - { status: 502 }, - ) - } - throw error - } + throw new Response("Use fresh authorization to change the Copilot connection.", { + status: 405, + headers: { Allow: "GET" }, + }) } export function meta({ loaderData }: { loaderData?: SettingsRouteData | RealCopilotRouteData }) { @@ -96,35 +65,49 @@ export default function SettingsCopilot({ } function RealCopilotConnection({ page }: { page: CopilotConnectionPageData }) { - const fetcher = useFetcher() - const location = useLocation() - const revalidator = useRevalidator() - const revalidatedResult = useRef(undefined) - const busy = fetcher.state !== "idle" || revalidator.state !== "idle" - const result = fetcher.data - useEffect(() => { - if (!result || revalidatedResult.current === result) return - revalidatedResult.current = result - void revalidator.revalidate() - }, [result, revalidator]) + const [submission, setSubmission] = useState<{ pending: boolean; error: string | null }>({ + pending: false, + error: null, + }) return ( - { - if (busy) return - void fetcher.submit(input, { - method: "post", - action: `${location.pathname}${location.search}`, +
{ + if (!(event.target instanceof HTMLFormElement)) return + const action = new URL(event.target.action, window.location.href) + if (action.pathname !== "/settings/copilot") return + event.preventDefault() + if (submission.pending) return + const form = new FormData(event.target) + if (form.get("confirmed") !== "1") { + setSubmission({ + pending: false, + error: "Confirm the Copilot connection change.", + }) + return + } + const operation = + form.get("_method") === "delete" ? "DISCONNECT_COPILOT" : "CONNECT_COPILOT" + setSubmission({ pending: true, error: null }) + void startCopilotAuthorization(new Request(window.location.href), { + confirmed: true, + operation, }) - }} - shouldIntercept={(form) => { - const action = new URL(form.action, window.location.href) - return action.pathname === "/settings/copilot" + .then((started) => navigateToExternalUrl(started.authorizationUrl)) + .catch((error: unknown) => { + if (!(error instanceof ApiRequestError) && !(error instanceof ApiContractError)) { + throw error + } + setSubmission({ + pending: false, + error: + error instanceof ApiRequestError + ? error.message + : "The API response was invalid. Provider authorization could not start.", + }) + }) }} > - - + +
) } diff --git a/hub/docs/copilot.md b/hub/docs/copilot.md index 728160b8a..cb6e108b2 100644 --- a/hub/docs/copilot.md +++ b/hub/docs/copilot.md @@ -1,45 +1,39 @@ # Copilot connection -A Hub administrator can connect one operator-provided Copilot token for the deployment. Hub checks the token through the Copilot SDK, stores only its SHA-256 digest and connection provenance, and never returns or logs the credential. +A Hub administrator can connect one deployment-wide Copilot credential for learning work. Hub obtains the credential from the configured provider, verifies it through the separate `replica-learning copilot status` command, and stores only the provider key, stable provider-configuration digest, connector membership, verification time, and connection generation. It never stores, returns, or logs the credential. -The connection is an administration foundation. No rebuilt Hub product job consumes it yet. +## Configure a provider -## Configure the token +No Copilot credential provider is enabled by default. Simple and local deployments can explicitly select one: -The operator creates a fine-grained personal access token whose only account permission is Copilot requests, stores it as `REPLICA_COPILOT_TOKEN`, and restarts every Hub API and worker process with the same configuration. +- `REPLICA_COPILOT_AUTHENTICATION=ambient-cli` uses the Copilot account signed in where Hub runs. +- `REPLICA_COPILOT_AUTHENTICATION=environment-token` reads `REPLICA_COPILOT_TOKEN` from the deployment secret store. -Hub reads the token only from the process environment. The database keeps its digest so future Copilot results can be associated with the configured credential without storing the credential itself. +These providers attribute usage to the represented individual identity. Production deployments should supply a governed provider through the same provider boundary. Restart every Hub API and worker process together after changing provider configuration. + +See [Learning foundation](learning-foundation.md) for the command boundary, storage configuration, and current learning lifecycle. ## Administrator flow 1. A current Hub administrator opens `/settings/copilot`. -2. Hub returns the connection state, connector membership, last successful check, and whether a token is configured. +2. Hub returns the saved connection, connector membership, last successful check, refusal state, and whether a provider is configured. 3. The administrator explicitly confirms connect or disconnect. 4. Hub starts fresh authorization through the provider recorded on the current Hub session. 5. The callback verifies the same session and external identity, then returns to `/settings/copilot/confirm`. -6. Continuing a connection checks the configured token with the Copilot SDK before one serializable transaction saves the connection and audits the change. Continuing a disconnection clears the database state without changing the operator's secret. - -The authorization is short-lived, one-use, and bound to the Hub session, operation, actor membership, and connection generation. Continuing atomically claims it before starting the SDK, so duplicate submissions do not start duplicate checks. Hub permits at most four deployment token checks at once and releases that capacity only after the SDK call ends; an abandoned claim expires after 30 seconds. A connection change after authorization starts or while Copilot checks the token returns a conflict instead of overwriting newer state. - -## Stored state - -Hub stores one global connection record: +6. Continuing a connection verifies the credential through `replica-learning` before one serializable transaction saves the connection and audits the change. Continuing a disconnection removes the saved connection without changing the provider's credential. -- the membership that connected Copilot; -- the token digest; -- the last successful verification time; -- a generation that orders connection changes; -- an optional refusal time reserved for a Copilot consumer to record a rejected current token. +The authorization is short-lived, one-use, and bound to the Hub session, operation, actor membership, and connection generation. Continuing atomically claims it before starting verification, so duplicate submissions do not start duplicate checks. Hub permits at most four deployment checks at once and releases that capacity after the command ends. An abandoned claim stops consuming deployment capacity after 30 seconds, but remains used; the administrator starts a new fresh authorization to retry. A connection change after authorization starts or while Copilot answers returns a conflict instead of overwriting newer state. -Connect, disconnect, page access, and authorization phases write bounded security audits. Audit context contains membership IDs, operations, outcomes, and safe reason codes. It never contains the token or Copilot response payloads. +Connect, disconnect, page access, and authorization phases write bounded security audits. Audit context contains membership IDs, operations, outcomes, provider keys, and safe reason codes. It never contains credentials or Copilot response payloads. -## Failure behavior +## Failure and authority behavior -- Without `REPLICA_COPILOT_TOKEN`, Hub shows the configuration requirement and does not offer connection. -- A token Copilot refuses produces a denied change and no connection. -- An unavailable Copilot service produces a failed change and no connection. +- Without a configured provider, Hub shows the configuration requirement and does not offer connection. +- A refused credential produces a denied change and records refusal state without saving a connection. +- An unavailable command or Copilot service produces a failed change and no connection. - A stale, cancelled, expired, reused, or mismatched authorization changes nothing. -- When the connector loses their final effective administrator assignment, the same authority transaction disconnects Copilot and audits the result. -- Disconnecting leaves the token in the operator's secret store. The token owner must revoke it separately when required. +- When the connector loses their final effective administrator assignment, the same authority transaction disconnects Copilot, advances the connection generation, and audits the automatic change. +- Ending all Hub sessions cancels open sensitive authorizations but intentionally leaves the Copilot connection unchanged. +- Disconnecting leaves the credential in its provider. The operator must revoke or remove it separately when required. -Token replacement requires a coordinated restart so every process uses the same environment. Do not overlap old-token and new-token Hub processes. The Copilot page detects that the configured digest changed and requires an administrator to check the replacement before Hub records it as verified. +Changing provider configuration changes its stable digest. Hub requires a new successful administrator connection before learning work can use the replacement credential. diff --git a/hub/package-lock.json b/hub/package-lock.json index 009c78c1d..77c7ef2a6 100644 --- a/hub/package-lock.json +++ b/hub/package-lock.json @@ -11,7 +11,6 @@ "dependencies": { "@azure/identity": "4.13.0", "@azure/storage-blob": "12.33.0", - "@github/copilot-sdk": "1.0.16", "@opentelemetry/api": "1.10.0", "@opentelemetry/context-async-hooks": "3.0.0", "@opentelemetry/exporter-trace-otlp-proto": "0.300.0", @@ -38,6 +37,7 @@ }, "devDependencies": { "@eslint/js": "10.0.1", + "@github/copilot-sdk": "1.0.16", "@react-router/dev": "8.5.0", "@react-router/node": "8.5.0", "@storybook/addon-a11y": "10.6.1", @@ -1381,6 +1381,7 @@ }, "node_modules/@github/copilot-sdk": { "version": "1.0.16", + "dev": true, "license": "MIT", "dependencies": { "koffi": "3.2.1", @@ -1408,6 +1409,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1421,6 +1423,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1434,6 +1437,7 @@ "cpu": [ "arm64" ], + "dev": true, "libc": [ "glibc" ], @@ -1450,6 +1454,7 @@ "cpu": [ "x64" ], + "dev": true, "libc": [ "glibc" ], @@ -1466,6 +1471,7 @@ "cpu": [ "arm64" ], + "dev": true, "libc": [ "musl" ], @@ -1482,6 +1488,7 @@ "cpu": [ "x64" ], + "dev": true, "libc": [ "musl" ], @@ -1498,6 +1505,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1509,6 +1517,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1517,6 +1526,7 @@ }, "node_modules/@github/copilot-sdk/node_modules/zod": { "version": "4.3.6", + "dev": true, "license": "MIT", "funding": { "url": "https://github.com/sponsors/colinhacks" @@ -1740,6 +1750,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1756,6 +1767,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1772,6 +1784,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1788,6 +1801,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1804,6 +1818,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1820,6 +1835,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1836,6 +1852,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1852,6 +1869,7 @@ "cpu": [ "arm" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1868,6 +1886,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1884,6 +1903,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1900,6 +1920,7 @@ "cpu": [ "loong64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1916,6 +1937,7 @@ "cpu": [ "riscv64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1932,6 +1954,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1948,6 +1971,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1964,6 +1988,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1980,6 +2005,7 @@ "cpu": [ "arm64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -1996,6 +2022,7 @@ "cpu": [ "ia32" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -2010,6 +2037,7 @@ "cpu": [ "x64" ], + "dev": true, "license": "MIT", "optional": true, "os": [ @@ -7412,6 +7440,7 @@ }, "node_modules/koffi": { "version": "3.2.1", + "dev": true, "hasInstallScript": true, "license": "MIT", "funding": { @@ -10024,6 +10053,7 @@ }, "node_modules/vscode-jsonrpc": { "version": "8.2.1", + "dev": true, "license": "MIT", "engines": { "node": ">=14.0.0" diff --git a/hub/package.json b/hub/package.json index 12c3b2993..f73e05a37 100644 --- a/hub/package.json +++ b/hub/package.json @@ -53,7 +53,6 @@ "dependencies": { "@azure/identity": "4.13.0", "@azure/storage-blob": "12.33.0", - "@github/copilot-sdk": "1.0.16", "@opentelemetry/api": "1.10.0", "@opentelemetry/context-async-hooks": "3.0.0", "@opentelemetry/exporter-trace-otlp-proto": "0.300.0", @@ -80,6 +79,7 @@ }, "devDependencies": { "@eslint/js": "10.0.1", + "@github/copilot-sdk": "1.0.16", "@react-router/dev": "8.5.0", "@react-router/node": "8.5.0", "@storybook/addon-a11y": "10.6.1", diff --git a/hub/schema/membership.prisma b/hub/schema/membership.prisma index 3fcfb99eb..10f52ec08 100644 --- a/hub/schema/membership.prisma +++ b/hub/schema/membership.prisma @@ -6,10 +6,9 @@ model Membership { // Relations user User @relation(fields: [userId], references: [id], onDelete: Restrict) assignments MembershipAssignment[] - copilotConnections CopilotConnectionState[] sessions HubSession[] sensitiveAuthorizations SensitiveAuthorization[] - copilotConnections CopilotConnection[] + copilotConnections CopilotConnection[] // Attribute columns lifecycle MembershipLifecycle @default(ACTIVE) diff --git a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql index 9fb1ba530..69db17c75 100644 --- a/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql +++ b/hub/schema/migrations/20261112170100_copilot_connection_state/migration.sql @@ -3,45 +3,6 @@ ADD COLUMN "expected_copilot_generation" BIGINT, ADD COLUMN "check_started_at" TIMESTAMPTZ(3), ADD COLUMN "check_finished_at" TIMESTAMPTZ(3); -CREATE TABLE "copilot_connection_states" ( - "id" UUID NOT NULL, - "connected_by_membership_id" UUID, - "key" VARCHAR(20) NOT NULL DEFAULT 'global', - "generation" BIGINT NOT NULL DEFAULT 0, - "token_digest" CHAR(64), - "verified_at" TIMESTAMPTZ(3), - "refused_at" TIMESTAMPTZ(3), - "created_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - "updated_at" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, - - CONSTRAINT "copilot_connection_states_pkey" PRIMARY KEY ("id"), - CONSTRAINT "copilot_connection_states_key_check" CHECK ("key" = 'global'), - CONSTRAINT "copilot_connection_states_generation_check" CHECK ("generation" >= 0), - CONSTRAINT "copilot_connection_states_digest_check" CHECK ( - "token_digest" IS NULL OR "token_digest" ~ '^[0-9a-f]{64}$' - ), - CONSTRAINT "copilot_connection_states_connection_check" CHECK ( - ( - "connected_by_membership_id" IS NULL - AND "token_digest" IS NULL - AND "verified_at" IS NULL - AND "refused_at" IS NULL - ) - OR ( - "connected_by_membership_id" IS NOT NULL - AND "token_digest" IS NOT NULL - AND "verified_at" IS NOT NULL - ) - ) -); - -CREATE UNIQUE INDEX "copilot_connection_states_key_key" ON "copilot_connection_states"("key"); - -ALTER TABLE "copilot_connection_states" -ADD CONSTRAINT "copilot_connection_states_connected_by_membership_id_fkey" -FOREIGN KEY ("connected_by_membership_id") REFERENCES "memberships"("id") -ON DELETE RESTRICT ON UPDATE CASCADE; - ALTER TABLE "sensitive_authorizations" ADD CONSTRAINT "sensitive_authorizations_copilot_generation_check" CHECK ( ( @@ -90,6 +51,7 @@ BEGIN OR NEW."target_membership_ids" <> OLD."target_membership_ids" OR NEW."expected_copilot_generation" IS DISTINCT FROM OLD."expected_copilot_generation" OR NEW."expires_at" <> OLD."expires_at" + OR NEW."created_at" <> OLD."created_at" OR OLD."check_started_at" IS NOT NULL AND NEW."check_started_at" IS DISTINCT FROM OLD."check_started_at" OR OLD."check_finished_at" IS NOT NULL @@ -106,6 +68,3 @@ BEGIN RETURN NEW; END; $$; - -INSERT INTO "copilot_connection_states" ("id", "key") -VALUES ('00000000-0000-4000-8000-000000000003', 'global'); diff --git a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts index 43a81dc3a..5d41c02af 100644 --- a/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts +++ b/hub/server/domains/administrator-authorization/administrator-authorization.db.test.ts @@ -255,14 +255,14 @@ describe("administrator authorization persistence", () => { targetMembershipIds: [membershipId], }, }) - await prisma.copilotConnectionState.update({ + await prisma.copilotConnection.create({ data: { connectedByMembershipId: membershipId, - generation: 1n, - tokenDigest: "c".repeat(64), + credentialDigest: "c".repeat(64), + credentialProvider: "environment_token", + id: randomUUID(), verifiedAt: new Date(), }, - where: { key: "global" }, }) const authorizationAttemptId = await createConsumedAuthorizationAttempt({ authorizationId, @@ -300,21 +300,20 @@ describe("administrator authorization persistence", () => { }) expect(endedProviderSession.endedAt).toBeInstanceOf(Date) await expect( - prisma.copilotConnectionState.findUniqueOrThrow({ - select: { connectedByMembershipId: true, generation: true }, + prisma.copilotConnection.findUnique({ where: { key: "global" }, }), - ).resolves.toEqual({ connectedByMembershipId: null, generation: 2n }) + ).resolves.toBeNull() await expect( prisma.securityAudit.findFirstOrThrow({ select: { context: true }, - where: { action: "copilot.connection.disconnect" }, + where: { action: "copilot.connection.disconnected" }, }), ).resolves.toEqual({ context: { actorMembershipId: null, - connectorMembershipId: membershipId, - operation: "disconnect", + credentialProvider: "environment_token", + phase: "disconnected", reason: "connector_role_removed", }, }) diff --git a/hub/server/domains/administrator-management/administrator-management.db.test.ts b/hub/server/domains/administrator-management/administrator-management.db.test.ts index 266021c1c..d7dd5c7a0 100644 --- a/hub/server/domains/administrator-management/administrator-management.db.test.ts +++ b/hub/server/domains/administrator-management/administrator-management.db.test.ts @@ -341,14 +341,14 @@ describe("administrator management", () => { membershipId: target.membershipId, source: "HUB_ADMINISTRATOR", }) - await prisma.copilotConnectionState.update({ + await prisma.copilotConnection.create({ data: { connectedByMembershipId: target.membershipId, - generation: 1n, - tokenDigest: "c".repeat(64), + credentialDigest: "c".repeat(64), + credentialProvider: "environment_token", + id: randomUUID(), verifiedAt: new Date(), }, - where: { key: "global" }, }) await revokeHubAdministrator( @@ -380,7 +380,7 @@ describe("administrator management", () => { ), ).toContain(target.membershipId) await expect( - prisma.copilotConnectionState.findUniqueOrThrow({ + prisma.copilotConnection.findUniqueOrThrow({ select: { connectedByMembershipId: true }, where: { key: "global" }, }), @@ -412,14 +412,14 @@ describe("administrator management", () => { membershipId: connector.membershipId, source: "HUB_ADMINISTRATOR", }) - await prisma.copilotConnectionState.update({ + await prisma.copilotConnection.create({ data: { connectedByMembershipId: connector.membershipId, - generation: 1n, - tokenDigest: "c".repeat(64), + credentialDigest: "c".repeat(64), + credentialProvider: "environment_token", + id: randomUUID(), verifiedAt: new Date(), }, - where: { key: "global" }, }) await revokeHubAdministrator( @@ -430,15 +430,18 @@ describe("administrator management", () => { dependencies(), ) + await expect( + prisma.copilotConnection.findUnique({ + where: { key: "global" }, + }), + ).resolves.toBeNull() await expect( prisma.copilotConnectionState.findUniqueOrThrow({ - select: { connectedByMembershipId: true, generation: true, tokenDigest: true }, + select: { generation: true }, where: { key: "global" }, }), ).resolves.toEqual({ - connectedByMembershipId: null, - generation: 2n, - tokenDigest: null, + generation: 1n, }) }) diff --git a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts index b151b6cce..e144a78e1 100644 --- a/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts +++ b/hub/server/domains/administrator-management/revoke-hub-administrator-with-repositories/index.ts @@ -35,17 +35,18 @@ export async function revokeHubAdministratorWithRepositories( if (remainingAdministrators.length === 0) { throw new AdministratorManagementDeniedError("last_administrator") } - if ( - !remainingAdministrators.some( - ({ membershipId }) => membershipId === input.targetMembershipId, - ) && - (await repositories.disconnectCopilotConnection(input.targetMembershipId)) - ) { + const disconnected = !remainingAdministrators.some( + ({ membershipId }) => membershipId === input.targetMembershipId, + ) + ? await repositories.disconnectCopilotConnection(input.targetMembershipId) + : null + if (disconnected) { await repositories.createSecurityAudit({ actorMembershipId: input.actorMembershipId, + connectionId: disconnected.connectionId, + credentialProvider: disconnected.credentialProvider, id: createId(), - operation: "disconnect", - outcome: "success", + phase: "disconnected", reason: "connector_role_removed", type: "copilot_connection", }) diff --git a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts index f43eba668..5803c618f 100644 --- a/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts +++ b/hub/server/domains/administrator-management/run-administrator-management-transaction/types.ts @@ -8,7 +8,9 @@ export interface AdministratorManagementRepositories { membershipId: string }): Promise<{ id: string }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise - disconnectCopilotConnection(membershipId: string): Promise + disconnectCopilotConnection( + membershipId: string, + ): Promise<{ connectionId: string; credentialProvider: string } | null> endOpenSessions(membershipId: string): Promise> lockActiveAssignment(membershipId: string): Promise<{ id: string } | null> lockEffectiveAdministratorAssignments(membershipIds: string[]): Promise> diff --git a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts index e4141d3ae..f1155f935 100644 --- a/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts +++ b/hub/server/domains/admission/apply-provider-assignment-evidence/index.ts @@ -136,16 +136,16 @@ export async function applyProviderAssignmentEvidence( } const assignments = await dependencies.repositories.lockActiveAssignments(membershipId) const administrator = assignments.some((assignment) => assignment.role === "ADMINISTRATOR") - if ( - !administrator && - (await dependencies.repositories.disconnectCopilotConnection(membershipId)) - ) { + const disconnected = administrator + ? null + : await dependencies.repositories.disconnectCopilotConnection(membershipId) + if (disconnected) { await dependencies.repositories.createSecurityAudit({ actorMembershipId: null, - connectorMembershipId: membershipId, + connectionId: disconnected.connectionId, + credentialProvider: disconnected.credentialProvider, id: dependencies.createId(), - operation: "disconnect", - outcome: "success", + phase: "disconnected", reason: "connector_role_removed", type: "copilot_connection", }) diff --git a/hub/server/domains/admission/provider-role-loss.db.test.ts b/hub/server/domains/admission/provider-role-loss.db.test.ts index ae0120de0..c1d7b3ee6 100644 --- a/hub/server/domains/admission/provider-role-loss.db.test.ts +++ b/hub/server/domains/admission/provider-role-loss.db.test.ts @@ -207,14 +207,14 @@ describe("provider role-loss admission", () => { }, }) } - await prisma.copilotConnectionState.update({ + await prisma.copilotConnection.create({ data: { connectedByMembershipId: records.membershipId, - generation: 1n, - tokenDigest: "c".repeat(64), + credentialDigest: "c".repeat(64), + credentialProvider: "environment_token", + id: randomUUID(), verifiedAt: new Date(), }, - where: { key: "global" }, }) const admission = applyProviderRole(records, role) @@ -226,15 +226,15 @@ describe("provider role-loss admission", () => { }) } - await expect( - prisma.copilotConnectionState.findUniqueOrThrow({ - select: { connectedByMembershipId: true, generation: true }, - where: { key: "global" }, - }), - ).resolves.toEqual({ - connectedByMembershipId: expectedConnection === "connected" ? records.membershipId : null, - generation: expectedConnection === "connected" ? 1n : 2n, + const connection = await prisma.copilotConnection.findUnique({ + select: { connectedByMembershipId: true }, + where: { key: "global" }, }) + expect(connection).toEqual( + expectedConnection === "connected" + ? { connectedByMembershipId: records.membershipId } + : null, + ) }, ) }) diff --git a/hub/server/domains/admission/run-admission-transaction/types.ts b/hub/server/domains/admission/run-admission-transaction/types.ts index dab86379d..da645c03d 100644 --- a/hub/server/domains/admission/run-admission-transaction/types.ts +++ b/hub/server/domains/admission/run-admission-transaction/types.ts @@ -36,7 +36,9 @@ export interface AdmissionRepositories { transition: "created" | "restored" | "unchanged" }> createSecurityAudit(input: CreateSecurityAuditEvent): Promise - disconnectCopilotConnection(membershipId: string): Promise + disconnectCopilotConnection( + membershipId: string, + ): Promise<{ connectionId: string; credentialProvider: string } | null> endProviderAssignment(input: { id: string; lifecycle: "SUPERSEDED" | "REVOKED" }): Promise endOpenHubSessionsForMembership(membershipId: string): Promise> lockActiveAssignments(membershipId: string): Promise< diff --git a/hub/server/domains/copilot-connection/connect-copilot/index.ts b/hub/server/domains/copilot-connection/connect-copilot/index.ts index 63898622d..399b819ac 100644 --- a/hub/server/domains/copilot-connection/connect-copilot/index.ts +++ b/hub/server/domains/copilot-connection/connect-copilot/index.ts @@ -18,13 +18,17 @@ const statusSchema = z export async function connectCopilot( { + authorizationId, credentialProvider, + hubSessionId, sessionDigest, }: { + authorizationId?: string credentialProvider: { configurationDigest: string | null key: CopilotCredentialProviderKey } + hubSessionId?: string sessionDigest: string }, { @@ -143,6 +147,33 @@ export async function connectCopilot( "The Copilot connection changed while Hub checked the credential.", ) } + if ( + authorizationId && + (!hubSessionId || + !repositories.continueAuthorization || + !(await repositories.continueAuthorization({ + actorMembershipId: session.membershipId, + authorizationId, + hubSessionId, + operation: "CONNECT_COPILOT", + }))) + ) { + throw new CopilotConnectionError( + "not_authorized", + "The Copilot authorization is no longer available.", + ) + } + if (authorizationId) { + await repositories.writeAudit({ + actorMembershipId: session.membershipId, + authorizationId, + id: createId(), + operation: "CONNECT_COPILOT", + phase: "completed", + targetCount: 1, + type: "administrator_authorization", + }) + } const connectionId = createId() await repositories.replaceConnection({ connectedByMembershipId: session.membershipId, diff --git a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.test.ts b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.test.ts new file mode 100644 index 000000000..a97d50411 --- /dev/null +++ b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.test.ts @@ -0,0 +1,38 @@ +import { randomUUID } from "node:crypto" +import { describe, expect, it, vi } from "vitest" + +import type { Prisma } from "../../../generated/prisma/client" +import { continueCopilotAuthorization } from "." + +describe("continueCopilotAuthorization()", () => { + it("accepts runtime fields while forwarding only the authorization binding", async () => { + const transaction = { $queryRaw: vi.fn().mockResolvedValue([{ id: randomUUID() }]) } + const database: Parameters[0] = { + $transaction: (operation: (value: Prisma.TransactionClient) => Promise) => + operation(transaction as unknown as Prisma.TransactionClient), + } + const mutate = vi.fn().mockResolvedValue({ disconnected: true }) + const authorizationId = randomUUID() + const hubSessionId = randomUUID() + + await expect( + continueCopilotAuthorization( + database, + { + authorizationId, + hubSessionId, + operation: "DISCONNECT_COPILOT", + sessionDigest: "a".repeat(64), + signal: AbortSignal.abort(), + }, + mutate, + ), + ).resolves.toEqual({ disconnected: true }) + + expect(mutate).toHaveBeenCalledWith({ + authorizationId, + hubSessionId, + operation: "DISCONNECT_COPILOT", + }) + }) +}) diff --git a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts index 5c7c83fe0..c760bc27e 100644 --- a/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts +++ b/hub/server/domains/copilot-connection/continue-copilot-authorization/index.ts @@ -1,378 +1,79 @@ -import { createHash, randomUUID } from "node:crypto" +import { randomUUID } from "node:crypto" import { z } from "zod" -import { Prisma } from "../../../generated/prisma/client.ts" +import type { Prisma } from "../../../generated/prisma/client.ts" -import { CopilotTokenCheckError } from "../../../integrations/copilot/check-copilot-token/errors.ts" -import { classifyPrismaTransactionError } from "../../../integrations/prisma/classify-transaction-error/index.ts" -import { lockEffectiveAdministratorProviders } from "../../../repositories/authentication-providers/lock-effective-administrator-providers/index.ts" -import { lockCopilotConnectionState } from "../../../repositories/copilot-connection-state/lock-copilot-connection-state/index.ts" -import { saveCopilotConnectionState } from "../../../repositories/copilot-connection-state/save-copilot-connection-state/index.ts" -import { lockLiveHubSession } from "../../../repositories/hub-sessions/lock-live-hub-session/index.ts" -import { lockEffectiveAdministrators } from "../../../repositories/memberships/lock-effective-administrators/index.ts" import { createSecurityAudit } from "../../../repositories/security-audits/create-security-audit/index.ts" import { claimCopilotAuthorizationCheck } from "../../../repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts" import { finishCopilotAuthorizationCheck } from "../../../repositories/sensitive-authorizations/finish-copilot-authorization-check/index.ts" -import { finishCopilotAuthorizationWithFailure } from "../../../repositories/sensitive-authorizations/finish-copilot-authorization-with-failure/index.ts" -import { isSensitiveAuthorizationCurrent } from "../../../repositories/sensitive-authorizations/is-sensitive-authorization-current/index.ts" -import { lockSensitiveAuthorization } from "../../../repositories/sensitive-authorizations/lock-sensitive-authorization/index.ts" +import { getSensitiveAuthorizationAuditData } from "../../../repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts" import { markSensitiveAuthorizationContinued } from "../../../repositories/sensitive-authorizations/mark-sensitive-authorization-continued/index.ts" -import { runWithBoundedRetries } from "../../identity/run-with-bounded-retries/index.ts" -import { - CopilotConnectionDeniedError, - CopilotConnectionTransactionConflictError, - CopilotConnectionUnavailableError, -} from "../errors.ts" +import { CopilotConnectionError } from "../errors.ts" const maximumConcurrentChecks = 4 -const inputSchema = z - .object({ - authorizationId: z.uuid(), - hubSessionId: z.uuid(), - operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), - token: z.string().min(1).optional(), - }) - .strict() +const inputSchema = z.object({ + authorizationId: z.uuid(), + hubSessionId: z.uuid(), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), +}) -interface PrismaClientLike { +interface Database { $transaction( operation: (transaction: Prisma.TransactionClient) => Promise, - options?: { isolationLevel?: Prisma.TransactionIsolationLevel }, ): Promise } -type Input = z.infer -type FailureReason = - | "authorization_unavailable" - | "connection_changed" - | "no_token" - | "not_connected" - | "refused" - | "retry_exhausted" - | "unavailable" - -function isConflict(error: unknown) { - return error instanceof CopilotConnectionTransactionConflictError -} - -async function runSerializable( - database: PrismaClientLike, - operation: (transaction: Prisma.TransactionClient) => Promise, +export async function continueCopilotAuthorization( + database: Database, + rawInput: unknown, + mutate: (input: { + authorizationId: string + hubSessionId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }) => Promise, ) { - return runWithBoundedRetries( - () => - database - .$transaction(operation, { - isolationLevel: Prisma.TransactionIsolationLevel.Serializable, - }) - .catch((error: unknown) => { - if (classifyPrismaTransactionError(error) === "retryable") { - throw new CopilotConnectionTransactionConflictError({ cause: error }) - } - throw error - }), - isConflict, - ) -} - -function authorizationMatches( - authorization: Awaited>, - input: Input, -): authorization is NonNullable>> { - return ( - authorization !== null && - authorization.hubSessionId === input.hubSessionId && - authorization.operation === input.operation && - authorization.targetMembershipIds.length === 1 && - authorization.targetMembershipIds[0] === authorization.actorMembershipId + const input = inputSchema.parse(rawInput) + const claimed = await database.$transaction((transaction) => + claimCopilotAuthorizationCheck(transaction, { + id: input.authorizationId, + hubSessionId: input.hubSessionId, + maximumConcurrentChecks, + operation: input.operation, + }), ) -} - -async function lockCurrentAuthorization(transaction: Prisma.TransactionClient, input: Input) { - const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) - if ( - !authorizationMatches(authorization, input) || - authorization.cancelledAt || - authorization.continuedAt || - authorization.expired || - !authorization.verifiedAt || - !(await lockLiveHubSession(transaction, input.hubSessionId)) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - await lockEffectiveAdministratorProviders(transaction) - const administrators = await lockEffectiveAdministrators(transaction) - if ( - !administrators.some(({ membershipId }) => membershipId === authorization.actorMembershipId) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - const state = await lockCopilotConnectionState(transaction) - if ( - !state || - authorization.expectedCopilotGeneration === null || - state.generation !== authorization.expectedCopilotGeneration - ) { - throw new CopilotConnectionDeniedError("connection_changed") + if (!claimed) { + throw new CopilotConnectionError( + "connection_changed", + "The Copilot authorization is no longer available.", + ) } - if (input.operation === "DISCONNECT_COPILOT" && !state.connectedByMembershipId) { - throw new CopilotConnectionDeniedError("not_connected") - } - return authorization -} - -async function claimCheck(database: PrismaClientLike, input: Input) { try { - await runSerializable(database, async (transaction) => { - const authorization = await lockCurrentAuthorization(transaction, input) - if (authorization.checkStartedAt) { - throw new CopilotConnectionDeniedError("check_in_progress") - } - if ( - !(await isSensitiveAuthorizationCurrent(transaction, { - authorizationId: input.authorizationId, - hubSessionId: input.hubSessionId, - })) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - if ( - !(await claimCopilotAuthorizationCheck(transaction, { - id: input.authorizationId, - maximumConcurrentChecks, - })) - ) { - throw new CopilotConnectionUnavailableError( - "Too many Copilot token checks are already running.", - ) - } - }) + return await mutate(input) } catch (error) { - if (isConflict(error)) { - await recordFailure(database, input, "retry_exhausted", "failure") - throw new CopilotConnectionUnavailableError("The Copilot connection check could not start.", { - cause: error, - }) - } - throw error - } -} - -async function applyConnectionChange( - database: PrismaClientLike, - input: Input, - tokenDigest: string | undefined, -) { - try { - return await runSerializable(database, async (transaction) => { - const authorization = await lockCurrentAuthorization(transaction, input) - if (!authorization.checkStartedAt) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - if ( - !(await isSensitiveAuthorizationCurrent(transaction, { - authorizationId: input.authorizationId, - hubSessionId: input.hubSessionId, - })) - ) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - await markSensitiveAuthorizationContinued(transaction, input.authorizationId) - await saveCopilotConnectionState( + await database.$transaction(async (transaction) => { + await finishCopilotAuthorizationCheck(transaction, input.authorizationId) + const authorization = await getSensitiveAuthorizationAuditData( transaction, - input.operation === "CONNECT_COPILOT" - ? { - membershipId: authorization.actorMembershipId, - operation: "connect", - tokenDigest: tokenDigest!, - } - : { operation: "disconnect" }, + input.authorizationId, ) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - id: randomUUID(), - operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", - outcome: "success", - type: "copilot_connection", - }) - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - authorizationId: input.authorizationId, - id: randomUUID(), - operation: input.operation, - phase: "completed", - targetCount: 1, - type: "administrator_authorization", - }) - return { connected: input.operation === "CONNECT_COPILOT" } - }) - } catch (error) { - if (isConflict(error)) { - await recordFailure(database, input, "retry_exhausted", "failure") - throw new CopilotConnectionUnavailableError( - "The Copilot connection change could not be completed.", - { cause: error }, - ) - } - throw error - } -} - -async function finishCheck(database: PrismaClientLike, input: Input) { - try { - await runSerializable(database, async (transaction) => { - if (!(await finishCopilotAuthorizationCheck(transaction, input.authorizationId))) { - throw new CopilotConnectionDeniedError("authorization_unavailable") - } - }) - } catch (error) { - if (isConflict(error)) { - await recordFailure(database, input, "retry_exhausted", "failure") - throw new CopilotConnectionUnavailableError( - "The Copilot connection check could not release its capacity.", - { cause: error }, - ) - } - throw error - } -} - -async function recordFailure( - database: PrismaClientLike, - input: Input, - reason: FailureReason, - outcome: "denied" | "failure", -): Promise< - | "authorization_unavailable" - | "connection_changed" - | "no_token" - | "not_connected" - | "refused" - | "retry_exhausted" - | "unavailable" -> { - try { - return await runSerializable(database, async (transaction) => { - const authorization = await lockSensitiveAuthorization(transaction, input.authorizationId) - if ( - !authorizationMatches(authorization, input) || - authorization.cancelledAt || - authorization.continuedAt - ) { - return "authorization_unavailable" - } - const state = await lockCopilotConnectionState(transaction) - let recordedReason = reason - if ( - !state || - authorization.expectedCopilotGeneration === null || - state.generation !== authorization.expectedCopilotGeneration - ) { - recordedReason = "connection_changed" - } - if (authorization.checkStartedAt) { - if (authorization.checkFinishedAt) { - await markSensitiveAuthorizationContinued(transaction, input.authorizationId) - } else if ( - !(await finishCopilotAuthorizationWithFailure(transaction, input.authorizationId)) - ) { - return "authorization_unavailable" - } - } else { - await markSensitiveAuthorizationContinued(transaction, input.authorizationId) - } - await createSecurityAudit(transaction, { - actorMembershipId: authorization.actorMembershipId, - id: randomUUID(), - operation: input.operation === "CONNECT_COPILOT" ? "connect" : "disconnect", - outcome, - reason: recordedReason, - type: "copilot_connection", - }) + if (!authorization || authorization.continued) return + await markSensitiveAuthorizationContinued(transaction, input.authorizationId) await createSecurityAudit(transaction, { actorMembershipId: authorization.actorMembershipId, authorizationId: input.authorizationId, id: randomUUID(), - operation: input.operation, + operation: authorization.operation, phase: authorization.expired ? "expired" : "denied", - reason: recordedReason, - targetCount: 1, + reason: error instanceof CopilotConnectionError ? error.code : "transaction_error", + targetCount: authorization.targetCount, type: "administrator_authorization", }) - return recordedReason }) - } catch (error) { - if (isConflict(error)) { - throw new CopilotConnectionUnavailableError( - "The Copilot connection failure could not be recorded.", - { cause: error }, - ) - } throw error - } -} - -export async function continueCopilotAuthorization( - database: PrismaClientLike, - rawInput: unknown, - checkToken: (token: string) => Promise, -) { - const input = inputSchema.parse(rawInput) - await claimCheck(database, input) - - let tokenDigest: string | undefined - if (input.operation === "CONNECT_COPILOT") { - if (!input.token) { - await finishCheck(database, input) - const reason = await recordFailure(database, input, "no_token", "denied") - throw new CopilotConnectionDeniedError( - reason === "retry_exhausted" || reason === "unavailable" - ? "authorization_unavailable" - : reason, - ) - } - let checkError: unknown - try { - await checkToken(input.token) - tokenDigest = createHash("sha256").update(input.token).digest("hex") - } catch (error) { - checkError = error - } - await finishCheck(database, input) - if (checkError) { - const reason = - checkError instanceof CopilotTokenCheckError && checkError.reason === "refused" - ? "refused" - : "unavailable" - const recordedReason = await recordFailure( - database, - input, - reason, - reason === "refused" ? "denied" : "failure", + } finally { + await database + .$transaction((transaction) => + finishCopilotAuthorizationCheck(transaction, input.authorizationId), ) - if (recordedReason !== "unavailable") { - throw new CopilotConnectionDeniedError( - recordedReason === "retry_exhausted" ? "authorization_unavailable" : recordedReason, - ) - } - throw new CopilotConnectionUnavailableError("Copilot could not check the configured token.", { - cause: checkError, - }) - } - } else { - await finishCheck(database, input) - } - - try { - return await applyConnectionChange(database, input, tokenDigest) - } catch (error) { - if ( - error instanceof CopilotConnectionDeniedError && - (error.reason === "connection_changed" || - error.reason === "not_connected" || - error.reason === "authorization_unavailable") - ) { - await recordFailure(database, input, error.reason, "denied") - } - throw error + .catch(() => undefined) } } diff --git a/hub/server/domains/copilot-connection/disconnect-copilot/index.ts b/hub/server/domains/copilot-connection/disconnect-copilot/index.ts index 0fc23213f..fd2411d89 100644 --- a/hub/server/domains/copilot-connection/disconnect-copilot/index.ts +++ b/hub/server/domains/copilot-connection/disconnect-copilot/index.ts @@ -2,7 +2,11 @@ import { CopilotConnectionError } from "../errors.ts" import type { CopilotConnectionTransactionRepositories } from "../types.ts" export async function disconnectCopilot( - { sessionDigest }: { sessionDigest: string }, + { + authorizationId, + hubSessionId, + sessionDigest, + }: { authorizationId?: string; hubSessionId?: string; sessionDigest: string }, { createId, runTransaction, @@ -23,6 +27,33 @@ export async function disconnectCopilot( if (!connection || !(await repositories.deleteConnection())) { throw new CopilotConnectionError("not_connected", "Copilot is not connected.") } + if ( + authorizationId && + (!hubSessionId || + !repositories.continueAuthorization || + !(await repositories.continueAuthorization({ + actorMembershipId: session.membershipId, + authorizationId, + hubSessionId, + operation: "DISCONNECT_COPILOT", + }))) + ) { + throw new CopilotConnectionError( + "not_authorized", + "The Copilot authorization is no longer available.", + ) + } + if (authorizationId) { + await repositories.writeAudit({ + actorMembershipId: session.membershipId, + authorizationId, + id: createId(), + operation: "DISCONNECT_COPILOT", + phase: "completed", + targetCount: 1, + type: "administrator_authorization", + }) + } await repositories.clearRefusal() await repositories.advanceState() await repositories.writeAudit({ diff --git a/hub/server/domains/copilot-connection/types.ts b/hub/server/domains/copilot-connection/types.ts index 81e3423d8..6f197294d 100644 --- a/hub/server/domains/copilot-connection/types.ts +++ b/hub/server/domains/copilot-connection/types.ts @@ -6,6 +6,12 @@ export interface CopilotConnectionSnapshot { export interface CopilotConnectionTransactionRepositories { advanceState: () => Promise clearRefusal: () => Promise + continueAuthorization?: (input: { + actorMembershipId: string + authorizationId: string + hubSessionId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }) => Promise deleteConnection: () => Promise lockAdministratorSession: (sessionDigest: string) => Promise<{ membershipId: string } | null> getConnection: () => Promise<{ @@ -26,13 +32,6 @@ export interface CopilotConnectionTransactionRepositories { credentialProvider: string refusedAt: Date }) => Promise - writeAudit: (input: { - actorMembershipId: string | null - connectionId?: string - credentialProvider: string - id: string - phase: "connected" | "disconnected" | "denied" | "failed" - reason?: string - type: "copilot_connection" - }) => Promise + writeAudit: (input: CreateSecurityAuditEvent) => Promise } +import type { CreateSecurityAuditEvent } from "../../repositories/security-audits/create-security-audit/types.ts" diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts index a93e8a5ef..1450c3910 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.test.ts @@ -214,8 +214,11 @@ describe("reconcileAuthenticationProviders()", () => { }, ]) const membershipId = randomUUID() + const connectionId = randomUUID() records.incrementSessionRevocation.mockResolvedValue({ revision: 1 }) records.disconnectCopilotConnectionWithoutEffectiveAdministrator.mockResolvedValue({ + connectionId, + credentialProvider: "environment_token", membershipId, }) @@ -229,9 +232,9 @@ describe("reconcileAuthenticationProviders()", () => { expect(records.createSecurityAudit).toHaveBeenCalledWith( expect.objectContaining({ actorMembershipId: null, - connectorMembershipId: membershipId, - operation: "disconnect", - outcome: "success", + connectionId, + credentialProvider: "environment_token", + phase: "disconnected", reason: "connector_role_removed", type: "copilot_connection", }), @@ -251,6 +254,7 @@ describe("reconcileAuthenticationProviders()", () => { }, ]) const membershipId = randomUUID() + const connectionId = randomUUID() records.createAuthenticationProviderRevision.mockResolvedValue({ configurationDigest: "b".repeat(64), id: randomUUID(), @@ -258,6 +262,8 @@ describe("reconcileAuthenticationProviders()", () => { revision: 2, }) records.disconnectCopilotConnectionWithoutEffectiveAdministrator.mockResolvedValue({ + connectionId, + credentialProvider: "environment_token", membershipId, }) @@ -279,8 +285,10 @@ describe("reconcileAuthenticationProviders()", () => { expect(records.disconnectCopilotConnectionWithoutEffectiveAdministrator).toHaveBeenCalledOnce() expect(records.createSecurityAudit).toHaveBeenCalledWith( expect.objectContaining({ - connectorMembershipId: membershipId, - operation: "disconnect", + actorMembershipId: null, + connectionId, + credentialProvider: "environment_token", + phase: "disconnected", reason: "connector_role_removed", type: "copilot_connection", }), diff --git a/hub/server/domains/identity/reconcile-authentication-providers/index.ts b/hub/server/domains/identity/reconcile-authentication-providers/index.ts index f406aad8a..ced7ea258 100644 --- a/hub/server/domains/identity/reconcile-authentication-providers/index.ts +++ b/hub/server/domains/identity/reconcile-authentication-providers/index.ts @@ -179,10 +179,10 @@ export async function reconcileAuthenticationProviders( if (disconnected) { await repositories.createSecurityAudit({ actorMembershipId: null, - connectorMembershipId: disconnected.membershipId, + connectionId: disconnected.connectionId, + credentialProvider: disconnected.credentialProvider, id: dependencies.createId(), - operation: "disconnect", - outcome: "success", + phase: "disconnected", reason: "connector_role_removed", type: "copilot_connection", }) diff --git a/hub/server/domains/identity/run-provider-revision-transaction/types.ts b/hub/server/domains/identity/run-provider-revision-transaction/types.ts index 68bd5460c..12ab8f12d 100644 --- a/hub/server/domains/identity/run-provider-revision-transaction/types.ts +++ b/hub/server/domains/identity/run-provider-revision-transaction/types.ts @@ -38,6 +38,8 @@ export interface ProviderRevisionRepositories { export interface AuthenticationProviderReconciliationRepositories extends ProviderRevisionRepositories { disconnectCopilotConnectionWithoutEffectiveAdministrator(): Promise<{ + connectionId: string + credentialProvider: string membershipId: string } | null> disableAuthenticationProvider(providerId: string): Promise diff --git a/hub/server/index.test.ts b/hub/server/index.test.ts index 19746b026..8b1127bd1 100644 --- a/hub/server/index.test.ts +++ b/hub/server/index.test.ts @@ -124,7 +124,9 @@ describe("server runtime", () => { }) it("passes resolved local defaults to authentication composition", async () => { + const administrators = {} const authentication = { + administrators, currentSession: {}, local: { administratorEnrollment: {}, @@ -175,7 +177,11 @@ describe("server runtime", () => { }) expect(Buffer.from(environment.HUB_AUTHENTICATION_ENCRYPTION_KEY!, "base64")).toHaveLength(32) expect(Buffer.from(environment.HUB_BOOTSTRAP_SECRET!, "base64url")).toHaveLength(32) - expect(createCopilotConnectionRouteDependencies).toHaveBeenCalledWith(environment, logger) + expect(createCopilotConnectionRouteDependencies).toHaveBeenCalledWith( + environment, + logger, + administrators, + ) expect(runApi).toHaveBeenCalledWith( expect.objectContaining({ authentication, copilotConnection, product }), ) @@ -254,7 +260,9 @@ describe("server runtime", () => { const disableAuthenticationProviders = vi.fn() const product = { listRepositories: vi.fn(), findRepositoryIndex: vi.fn() } const createProductRouteDependencies = vi.fn().mockReturnValue(product) + const administrators = {} const authentication = { + administrators, currentSession: {}, github: { signIn: {}, @@ -290,7 +298,11 @@ describe("server runtime", () => { expect(createAuthenticationRouteDependencies).toHaveBeenCalledWith(process.env) expect(createProductRouteDependencies).toHaveBeenCalledOnce() - expect(createCopilotConnectionRouteDependencies).toHaveBeenCalledWith(process.env, logger) + expect(createCopilotConnectionRouteDependencies).toHaveBeenCalledWith( + process.env, + logger, + administrators, + ) expect(disableAuthenticationProviders).not.toHaveBeenCalled() expect(runApi).toHaveBeenCalledWith( expect.objectContaining({ authentication, copilotConnection, product }), diff --git a/hub/server/index.ts b/hub/server/index.ts index 6c86f4160..93eb5ca13 100644 --- a/hub/server/index.ts +++ b/hub/server/index.ts @@ -90,6 +90,7 @@ try { copilotConnection = await createCopilotConnectionRouteDependencies( authenticationEnvironment, logger, + authentication.administrators, ) } else { await disableAuthenticationProviders() diff --git a/hub/server/integrations/copilot/check-copilot-token/errors.ts b/hub/server/integrations/copilot/check-copilot-token/errors.ts deleted file mode 100644 index 3430496c8..000000000 --- a/hub/server/integrations/copilot/check-copilot-token/errors.ts +++ /dev/null @@ -1,14 +0,0 @@ -export class CopilotTokenCheckError extends Error { - readonly reason: "refused" | "unavailable" - - constructor(reason: "refused" | "unavailable", options?: ErrorOptions) { - super( - reason === "refused" - ? "Copilot refused the configured token." - : "Copilot could not check the configured token.", - options, - ) - this.name = "CopilotTokenCheckError" - this.reason = reason - } -} diff --git a/hub/server/integrations/copilot/check-copilot-token/index.test.ts b/hub/server/integrations/copilot/check-copilot-token/index.test.ts deleted file mode 100644 index cfe598c9f..000000000 --- a/hub/server/integrations/copilot/check-copilot-token/index.test.ts +++ /dev/null @@ -1,140 +0,0 @@ -import { access } from "node:fs/promises" -import { beforeEach, describe, expect, it, vi } from "vitest" - -interface ClientStub { - getAuthStatus: ReturnType - listModels: ReturnType - start: ReturnType - stop: ReturnType -} - -function clientStub(overrides: Partial = {}): ClientStub { - return { - getAuthStatus: vi.fn().mockResolvedValue({ isAuthenticated: true }), - listModels: vi.fn().mockResolvedValue([]), - start: vi.fn().mockResolvedValue(undefined), - stop: vi.fn().mockResolvedValue(undefined), - ...overrides, - } -} - -async function loadCheck(client: ClientStub) { - const CopilotClient = vi.fn(function (options: unknown) { - return Object.assign(client, { options }) - }) - vi.doMock("@github/copilot-sdk", () => ({ CopilotClient })) - const { checkCopilotToken } = await import(".") - return { checkCopilotToken, CopilotClient } -} - -async function expectRemoved(home: string) { - await expect(access(home)).rejects.toMatchObject({ code: "ENOENT" }) -} - -describe("checkCopilotToken()", () => { - beforeEach(() => { - vi.doUnmock("@github/copilot-sdk") - }) - - it("checks an authenticated token with an isolated SDK home and releases every resource", async () => { - let home = "" - const client = clientStub({ - start: vi.fn(async function (this: ClientStub & { options: { baseDirectory: string } }) { - home = this.options.baseDirectory - await expect(access(home)).resolves.toBeUndefined() - }), - }) - const { checkCopilotToken, CopilotClient } = await loadCheck(client) - - await expect(checkCopilotToken("operator-token")).resolves.toBeUndefined() - - expect(CopilotClient).toHaveBeenCalledWith({ - baseDirectory: home, - gitHubToken: "operator-token", - logLevel: "error", - mode: "empty", - useLoggedInUser: false, - }) - expect(client.start).toHaveBeenCalledOnce() - expect(client.getAuthStatus).toHaveBeenCalledOnce() - expect(client.listModels).toHaveBeenCalledOnce() - expect(client.stop).toHaveBeenCalledOnce() - await expectRemoved(home) - }) - - it("reports an unauthenticated SDK session as refused and still cleans up", async () => { - const client = clientStub({ - getAuthStatus: vi.fn().mockResolvedValue({ isAuthenticated: false }), - }) - const { checkCopilotToken, CopilotClient } = await loadCheck(client) - - await expect(checkCopilotToken("refused-token")).rejects.toMatchObject({ - reason: "refused", - }) - - expect(client.listModels).not.toHaveBeenCalled() - expect(client.stop).toHaveBeenCalledOnce() - await expectRemoved( - (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) - .options.baseDirectory, - ) - }) - - it.each([ - ["an authorization error", new Error("401 Unauthorized"), "refused"], - ["a service error", new Error("service unavailable"), "unavailable"], - ] as const)("classifies %s and releases the SDK client", async (_case, failure, reason) => { - const client = clientStub({ listModels: vi.fn().mockRejectedValue(failure) }) - const { checkCopilotToken, CopilotClient } = await loadCheck(client) - - await expect(checkCopilotToken("operator-token")).rejects.toMatchObject({ reason }) - - expect(client.stop).toHaveBeenCalledOnce() - await expectRemoved( - (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) - .options.baseDirectory, - ) - }) - - it("times out an unresponsive SDK and releases the client and temporary home", async () => { - vi.useFakeTimers() - let markStarted: (() => void) | undefined - const started = new Promise((resolve) => { - markStarted = resolve - }) - const client = clientStub({ - start: vi.fn(() => { - markStarted!() - return new Promise(() => undefined) - }), - }) - const { checkCopilotToken, CopilotClient } = await loadCheck(client) - - const result = expect(checkCopilotToken("operator-token")).rejects.toMatchObject({ - reason: "unavailable", - }) - await started - await vi.advanceTimersByTimeAsync(20_000) - await result - - expect(client.stop).toHaveBeenCalledOnce() - await expectRemoved( - (CopilotClient.mock.results[0]!.value as ClientStub & { options: { baseDirectory: string } }) - .options.baseDirectory, - ) - }) - - it("reports an SDK import failure without constructing a client", async () => { - vi.doMock("@github/copilot-sdk", () => { - throw new Error("SDK failed to load") - }) - const { checkCopilotToken } = await import(".") - - await expect(checkCopilotToken("operator-token")).rejects.toEqual( - expect.objectContaining({ - name: "CopilotTokenCheckError", - reason: "unavailable", - }), - ) - }) -}) diff --git a/hub/server/integrations/copilot/check-copilot-token/index.ts b/hub/server/integrations/copilot/check-copilot-token/index.ts deleted file mode 100644 index ea60b047d..000000000 --- a/hub/server/integrations/copilot/check-copilot-token/index.ts +++ /dev/null @@ -1,54 +0,0 @@ -import { mkdtemp, rm } from "node:fs/promises" -import { tmpdir } from "node:os" -import path from "node:path" - -import { CopilotTokenCheckError } from "./errors.ts" - -const checkTimeoutMilliseconds = 20_000 - -function classify(error: unknown): "refused" | "unavailable" { - const message = String(error instanceof Error ? error.message : error).slice(0, 500) - return /\b40[13]\b|unauthori[sz]ed|forbidden|authenticat|not signed in|no copilot|subscription|access denied/i.test( - message, - ) - ? "refused" - : "unavailable" -} - -export async function checkCopilotToken(token: string): Promise { - const sdk = await import("@github/copilot-sdk").catch((error: unknown) => { - throw new CopilotTokenCheckError("unavailable", { cause: error }) - }) - const home = await mkdtemp(path.join(tmpdir(), "replica-hub-copilot-")) - const client = new sdk.CopilotClient({ - baseDirectory: home, - gitHubToken: token, - logLevel: "error", - mode: "empty", - useLoggedInUser: false, - }) - let timeout: ReturnType | undefined - try { - await Promise.race([ - (async () => { - await client.start() - const authentication = await client.getAuthStatus() - if (!authentication?.isAuthenticated) throw new CopilotTokenCheckError("refused") - await client.listModels() - })(), - new Promise((_resolve, reject) => { - timeout = setTimeout( - () => reject(new CopilotTokenCheckError("unavailable")), - checkTimeoutMilliseconds, - ) - }), - ]) - } catch (error) { - if (error instanceof CopilotTokenCheckError) throw error - throw new CopilotTokenCheckError(classify(error), { cause: error }) - } finally { - if (timeout) clearTimeout(timeout) - await client.stop().catch(() => undefined) - await rm(home, { force: true, recursive: true }) - } -} diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts index 32a33fb43..0e5d96972 100644 --- a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-for-membership/index.ts @@ -1,18 +1,18 @@ import type { Prisma } from "../../../generated/prisma/client.ts" export async function disconnectCopilotConnectionForMembership( - database: Pick, + database: Pick, membershipId: string, -): Promise { - const result = await database.copilotConnectionState.updateMany({ - data: { - connectedByMembershipId: null, - generation: { increment: 1 }, - refusedAt: null, - tokenDigest: null, - verifiedAt: null, - }, +): Promise<{ connectionId: string; credentialProvider: string } | null> { + const connection = await database.copilotConnection.findFirst({ + select: { credentialProvider: true, id: true }, where: { connectedByMembershipId: membershipId, key: "global" }, }) - return result.count === 1 + if (!connection) return null + await database.copilotConnection.delete({ where: { id: connection.id } }) + await database.copilotConnectionState.update({ + data: { generation: { increment: 1 } }, + where: { key: "global" }, + }) + return { connectionId: connection.id, credentialProvider: connection.credentialProvider } } diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts index 13fde8483..54c27ea9c 100644 --- a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.db.test.ts @@ -61,47 +61,42 @@ async function createConnectedProviderAdministrator(withIndependentAdministrator }, }) } - await transaction.copilotConnectionState.update({ + await transaction.copilotConnection.create({ data: { connectedByMembershipId: membershipId, - generation: 7n, - tokenDigest: "a".repeat(64), + credentialDigest: "a".repeat(64), + credentialProvider: "environment_token", + id: randomUUID(), verifiedAt: new Date(), }, - where: { key: "global" }, }) }) return { membershipId, provider } } -async function expectAutomaticDisconnection(membershipId: string) { +async function expectAutomaticDisconnection() { + await expect( + prisma.copilotConnection.findUnique({ + where: { key: "global" }, + }), + ).resolves.toBeNull() await expect( prisma.copilotConnectionState.findUniqueOrThrow({ - select: { - connectedByMembershipId: true, - generation: true, - tokenDigest: true, - verifiedAt: true, - }, + select: { generation: true }, where: { key: "global" }, }), - ).resolves.toEqual({ - connectedByMembershipId: null, - generation: 8n, - tokenDigest: null, - verifiedAt: null, - }) + ).resolves.toEqual({ generation: 1n }) await expect( prisma.securityAudit.findFirstOrThrow({ select: { action: true, context: true, outcome: true }, - where: { action: "copilot.connection.disconnect" }, + where: { action: "copilot.connection.disconnected" }, }), ).resolves.toEqual({ - action: "copilot.connection.disconnect", + action: "copilot.connection.disconnected", context: { actorMembershipId: null, - connectorMembershipId: membershipId, - operation: "disconnect", + credentialProvider: "environment_token", + phase: "disconnected", reason: "connector_role_removed", }, outcome: "SUCCESS", @@ -110,15 +105,15 @@ async function expectAutomaticDisconnection(membershipId: string) { describe("disconnectCopilotConnectionWithoutEffectiveAdministrator()", () => { it("disconnects after provider removal returns no configured providers", async () => { - const { membershipId } = await createConnectedProviderAdministrator() + await createConnectedProviderAdministrator() await expect(reconcile(null)).resolves.toEqual([]) - await expectAutomaticDisconnection(membershipId) + await expectAutomaticDisconnection() }) it("disconnects when revision replacement makes the connector's provider assignment stale", async () => { - const { membershipId, provider } = await createConnectedProviderAdministrator() + const { provider } = await createConnectedProviderAdministrator() await expect(reconcile(2)).resolves.toEqual([ expect.objectContaining({ @@ -128,7 +123,7 @@ describe("disconnectCopilotConnectionWithoutEffectiveAdministrator()", () => { }), ]) - await expectAutomaticDisconnection(membershipId) + await expectAutomaticDisconnection() }) it("preserves the connection when provider removal leaves an independent administrator source", async () => { @@ -137,22 +132,20 @@ describe("disconnectCopilotConnectionWithoutEffectiveAdministrator()", () => { await expect(reconcile(null)).resolves.toEqual([]) await expect( - prisma.copilotConnectionState.findUniqueOrThrow({ + prisma.copilotConnection.findUniqueOrThrow({ select: { connectedByMembershipId: true, - generation: true, - tokenDigest: true, + credentialDigest: true, }, where: { key: "global" }, }), ).resolves.toEqual({ connectedByMembershipId: membershipId, - generation: 7n, - tokenDigest: "a".repeat(64), + credentialDigest: "a".repeat(64), }) await expect( prisma.securityAudit.count({ - where: { action: "copilot.connection.disconnect" }, + where: { action: "copilot.connection.disconnected" }, }), ).resolves.toBe(0) }) diff --git a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts index 348e08cc4..62f0f9fb8 100644 --- a/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts +++ b/hub/server/repositories/copilot-connection-state/disconnect-copilot-connection-without-effective-administrator/index.ts @@ -2,13 +2,21 @@ import type { Prisma } from "../../../generated/prisma/client.ts" export async function disconnectCopilotConnectionWithoutEffectiveAdministrator( database: Pick, -): Promise<{ membershipId: string } | null> { - const rows = await database.$queryRaw>` +): Promise<{ + connectionId: string + credentialProvider: string + membershipId: string +} | null> { + const rows = await database.$queryRaw< + Array<{ + connectionId: string + credentialProvider: string + membershipId: string + }> + >` WITH disconnected AS ( - SELECT connection."id", connection."connected_by_membership_id" - FROM "copilot_connection_states" connection + DELETE FROM "copilot_connections" connection WHERE connection."key" = 'global' - AND connection."connected_by_membership_id" IS NOT NULL AND NOT EXISTS ( SELECT 1 FROM "membership_assignments" assignment @@ -28,19 +36,21 @@ export async function disconnectCopilotConnectionWithoutEffectiveAdministrator( ) ) ) - FOR UPDATE OF connection + RETURNING + connection."id", + connection."connected_by_membership_id", + connection."credential_provider" + ), + advanced AS ( + UPDATE "copilot_connection_states" + SET "generation" = "generation" + 1, "updated_at" = clock_timestamp() + WHERE "key" = 'global' AND EXISTS (SELECT 1 FROM disconnected) ) - UPDATE "copilot_connection_states" connection - SET - "connected_by_membership_id" = NULL, - "token_digest" = NULL, - "verified_at" = NULL, - "refused_at" = NULL, - "generation" = "generation" + 1, - "updated_at" = clock_timestamp() + SELECT + disconnected."id" AS "connectionId", + disconnected."connected_by_membership_id" AS "membershipId", + disconnected."credential_provider" AS "credentialProvider" FROM disconnected - WHERE connection."id" = disconnected."id" - RETURNING disconnected."connected_by_membership_id" AS "membershipId" ` return rows[0] ?? null } diff --git a/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts deleted file mode 100644 index 4e79713ce..000000000 --- a/hub/server/repositories/copilot-connection-state/get-copilot-connection-state/index.ts +++ /dev/null @@ -1,31 +0,0 @@ -import type { PrismaClient } from "../../../generated/prisma/client.ts" - -export async function getCopilotConnectionState( - database: Pick, -) { - const state = await database.copilotConnectionState.findUniqueOrThrow({ - where: { key: "global" }, - include: { - connectedByMembership: { - include: { - user: { include: { profile: true } }, - }, - }, - }, - }) - return { - connected: state.connectedByMembershipId !== null, - connectedAt: state.connectedByMembershipId ? state.updatedAt : null, - connectedBy: state.connectedByMembership - ? { - login: state.connectedByMembership.user.profile?.login ?? null, - membershipId: state.connectedByMembership.id, - name: state.connectedByMembership.user.profile?.name ?? null, - } - : null, - generation: state.generation, - refusedAt: state.refusedAt, - tokenDigest: state.tokenDigest, - verifiedAt: state.verifiedAt, - } -} diff --git a/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts deleted file mode 100644 index 049b52a4e..000000000 --- a/hub/server/repositories/copilot-connection-state/lock-copilot-connection-state/index.ts +++ /dev/null @@ -1,20 +0,0 @@ -import type { Prisma } from "../../../generated/prisma/client.ts" - -export async function lockCopilotConnectionState( - database: Pick, -) { - const rows = await database.$queryRaw< - Array<{ - connectedByMembershipId: string | null - generation: bigint - }> - >` - SELECT - "connected_by_membership_id" AS "connectedByMembershipId", - "generation" - FROM "copilot_connection_states" - WHERE "key" = 'global' - FOR UPDATE - ` - return rows[0] ?? null -} diff --git a/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts b/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts deleted file mode 100644 index 2981fd1d6..000000000 --- a/hub/server/repositories/copilot-connection-state/save-copilot-connection-state/index.ts +++ /dev/null @@ -1,32 +0,0 @@ -import type { Prisma } from "../../../generated/prisma/client.ts" - -export async function saveCopilotConnectionState( - database: Pick, - input: - | { operation: "connect"; membershipId: string; tokenDigest: string } - | { operation: "disconnect" }, -) { - if (input.operation === "connect") { - await database.copilotConnectionState.update({ - data: { - connectedByMembershipId: input.membershipId, - generation: { increment: 1 }, - refusedAt: null, - tokenDigest: input.tokenDigest, - verifiedAt: new Date(), - }, - where: { key: "global" }, - }) - return - } - await database.copilotConnectionState.update({ - data: { - connectedByMembershipId: null, - generation: { increment: 1 }, - refusedAt: null, - tokenDigest: null, - verifiedAt: null, - }, - where: { key: "global" }, - }) -} diff --git a/hub/server/repositories/security-audits/create-security-audit/types.ts b/hub/server/repositories/security-audits/create-security-audit/types.ts index c5d7d2c36..fdb11f4a1 100644 --- a/hub/server/repositories/security-audits/create-security-audit/types.ts +++ b/hub/server/repositories/security-audits/create-security-audit/types.ts @@ -97,15 +97,6 @@ export interface AdministratorAuthorizationAudit extends SecurityAuditEvent { targetCount: number } -export interface CopilotConnectionAudit extends SecurityAuditEvent { - type: "copilot_connection" - actorMembershipId: string | null - connectorMembershipId?: string - operation: "connect" | "disconnect" | "view" - outcome: "success" | "denied" | "failure" - reason?: string -} - export interface AllHubSessionsEndedAudit extends SecurityAuditEvent { type: "all_hub_sessions_ended" actorMembershipId: string @@ -253,4 +244,3 @@ export type CreateSecurityAuditEvent = | AuthenticationProviderLifecycleAudit | AuthenticationProvidersReconcileFailedAudit | SessionRevocationAdvancedAudit - | CopilotConnectionAudit diff --git a/hub/server/repositories/security-audits/get-security-audit-data/index.ts b/hub/server/repositories/security-audits/get-security-audit-data/index.ts index 3b5c1935d..d68b01344 100644 --- a/hub/server/repositories/security-audits/get-security-audit-data/index.ts +++ b/hub/server/repositories/security-audits/get-security-audit-data/index.ts @@ -110,27 +110,6 @@ export function getSecurityAuditData( targetCount: event.targetCount, }, } - case "copilot_connection": - return { - id: event.id, - action: `copilot.connection.${event.operation}`, - outcome: - event.outcome === "success" - ? SecurityAuditOutcome.SUCCESS - : event.outcome === "denied" - ? SecurityAuditOutcome.DENIED - : SecurityAuditOutcome.FAILURE, - targetType: "copilot_connection", - targetId: "global", - context: { - actorMembershipId: event.actorMembershipId, - ...(event.connectorMembershipId - ? { connectorMembershipId: event.connectorMembershipId } - : {}), - operation: event.operation, - ...(event.reason ? { reason: event.reason } : {}), - }, - } case "all_hub_sessions_ended": return { id: event.id, diff --git a/hub/server/repositories/security-audits/parse-security-audit-event/index.ts b/hub/server/repositories/security-audits/parse-security-audit-event/index.ts index 46e2e3a99..7aea3bb62 100644 --- a/hub/server/repositories/security-audits/parse-security-audit-event/index.ts +++ b/hub/server/repositories/security-audits/parse-security-audit-event/index.ts @@ -77,17 +77,6 @@ const eventSchema = z.discriminatedUnion("type", [ type: z.literal("administrator_authorization"), }) .strict(), - z - .object({ - actorMembershipId: z.uuid().nullable(), - connectorMembershipId: z.uuid().optional(), - id: z.uuid(), - operation: z.enum(["connect", "disconnect", "view"]), - outcome: z.enum(["success", "denied", "failure"]), - reason: z.string().min(1).max(100).optional(), - type: z.literal("copilot_connection"), - }) - .strict(), z .object({ id: z.uuid(), diff --git a/hub/server/repositories/security-audits/parse-security-audit-event/types.ts b/hub/server/repositories/security-audits/parse-security-audit-event/types.ts index 4df5db4a1..9f7d4cb42 100644 --- a/hub/server/repositories/security-audits/parse-security-audit-event/types.ts +++ b/hub/server/repositories/security-audits/parse-security-audit-event/types.ts @@ -27,7 +27,6 @@ import type { AllHubSessionsEndedAudit, SessionCreatedAudit, SessionEndedAudit, - CopilotConnectionAudit, } from "../create-security-audit/types.ts" export type ParsedSecurityAuditEvent = @@ -66,4 +65,3 @@ export type ParsedSecurityAuditEvent = providerKeys: ProviderKey[] }) | SessionRevocationAdvancedAudit - | CopilotConnectionAudit diff --git a/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts b/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts index 290b35369..91953d6ab 100644 --- a/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts +++ b/hub/server/repositories/sensitive-authorizations/claim-copilot-authorization-check/index.ts @@ -5,7 +5,9 @@ import type { Prisma } from "../../../generated/prisma/client.ts" const inputSchema = z .object({ id: z.uuid(), + hubSessionId: z.uuid(), maximumConcurrentChecks: z.number().int().min(1).max(20), + operation: z.enum(["CONNECT_COPILOT", "DISCONNECT_COPILOT"]), }) .strict() @@ -18,18 +20,24 @@ export async function claimCopilotAuthorizationCheck( WITH capacity AS ( SELECT pg_advisory_xact_lock(hashtext('replica_copilot_authorization_checks')) ) - UPDATE "sensitive_authorizations" + UPDATE "sensitive_authorizations" authorization SET "check_started_at" = clock_timestamp(), "updated_at" = clock_timestamp() - FROM capacity - WHERE "id" = ${parsed.id}::uuid - AND "operation" IN ('CONNECT_COPILOT', 'DISCONNECT_COPILOT') - AND "verified_at" IS NOT NULL - AND "check_started_at" IS NULL - AND "continued_at" IS NULL - AND "cancelled_at" IS NULL - AND "expires_at" > clock_timestamp() + FROM capacity, "hub_sessions" session, "copilot_connection_states" state + WHERE authorization."id" = ${parsed.id}::uuid + AND authorization."hub_session_id" = ${parsed.hubSessionId}::uuid + AND authorization."operation" = ${parsed.operation}::"SensitiveAuthorizationOperation" + AND authorization."expected_copilot_generation" = state."generation" + AND state."key" = 'global' + AND authorization."verified_at" IS NOT NULL + AND authorization."check_started_at" IS NULL + AND authorization."continued_at" IS NULL + AND authorization."cancelled_at" IS NULL + AND authorization."expires_at" > clock_timestamp() + AND session."id" = authorization."hub_session_id" + AND session."ended_at" IS NULL + AND session."expires_at" > clock_timestamp() AND ( - "operation" = 'DISCONNECT_COPILOT' + authorization."operation" = 'DISCONNECT_COPILOT' OR ( SELECT count(*) FROM "sensitive_authorizations" @@ -39,7 +47,7 @@ export async function claimCopilotAuthorizationCheck( AND "check_started_at" > clock_timestamp() - interval '30 seconds' ) < ${parsed.maximumConcurrentChecks} ) - RETURNING "id" + RETURNING authorization."id" ` return rows.length === 1 } diff --git a/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.db.test.ts b/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.db.test.ts new file mode 100644 index 000000000..91f911b5e --- /dev/null +++ b/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.db.test.ts @@ -0,0 +1,90 @@ +import { randomUUID } from "node:crypto" +import { describe, expect, it } from "vitest" + +import { prisma } from "../../../integrations/prisma" +import { continueCopilotSensitiveAuthorization } from "." + +async function createAuthorization(expectedCopilotGeneration: bigint) { + const userId = randomUUID() + const membershipId = randomUUID() + const externalIdentityId = randomUUID() + const hubSessionId = randomUUID() + const authorizationId = randomUUID() + await prisma.$transaction(async (transaction) => { + await transaction.user.create({ data: { id: userId } }) + await transaction.membership.create({ data: { id: membershipId, userId } }) + await transaction.externalIdentity.create({ + data: { + id: externalIdentityId, + issuer: "https://github.com", + provider: "github", + subject: randomUUID(), + userId, + }, + }) + await transaction.hubSession.create({ + data: { + digest: randomUUID().replaceAll("-", "").repeat(2), + expiresAt: new Date(Date.now() + 60_000), + externalIdentityId, + id: hubSessionId, + membershipId, + revocationRevision: 0, + }, + }) + await transaction.sensitiveAuthorization.create({ + data: { + actorMembershipId: membershipId, + expectedCopilotGeneration, + expiresAt: new Date(Date.now() + 60_000), + externalIdentityId, + hubSessionId, + id: authorizationId, + operation: "DISCONNECT_COPILOT", + targetMembershipIds: [membershipId], + verifiedAt: new Date(), + }, + }) + }) + return { authorizationId, hubSessionId, membershipId } +} + +describe("continueCopilotSensitiveAuthorization()", () => { + it("rejects an authorization after the locked Copilot generation changes", async () => { + const state = await prisma.copilotConnectionState.findUniqueOrThrow({ + where: { key: "global" }, + }) + const authorization = await createAuthorization(state.generation) + await prisma.copilotConnectionState.update({ + data: { generation: { increment: 1 } }, + where: { key: "global" }, + }) + + await expect( + prisma.$transaction((transaction) => + continueCopilotSensitiveAuthorization(transaction, { + actorMembershipId: authorization.membershipId, + authorizationId: authorization.authorizationId, + hubSessionId: authorization.hubSessionId, + operation: "DISCONNECT_COPILOT", + }), + ), + ).resolves.toBe(false) + }) + + it("preserves sensitive authorization creation time as immutable history", async () => { + const state = await prisma.copilotConnectionState.findUniqueOrThrow({ + where: { key: "global" }, + }) + const authorization = await createAuthorization(state.generation) + + await expect( + prisma.$executeRaw` + UPDATE "sensitive_authorizations" + SET "created_at" = "created_at" - interval '1 second', + "updated_at" = clock_timestamp() + WHERE "id" = ${authorization.authorizationId}::uuid + `, + ).rejects.toThrow("Sensitive authorization binding and completed transitions are immutable.") + }) +}) diff --git a/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.ts b/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.ts new file mode 100644 index 000000000..8545d4ae3 --- /dev/null +++ b/hub/server/repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.ts @@ -0,0 +1,34 @@ +import type { Prisma } from "../../../generated/prisma/client.ts" + +export async function continueCopilotSensitiveAuthorization( + database: Pick, + input: { + actorMembershipId: string + authorizationId: string + hubSessionId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + }, +): Promise { + const rows = await database.$queryRaw>` + UPDATE "sensitive_authorizations" AS sensitive_authorization + SET "continued_at" = clock_timestamp(), "updated_at" = clock_timestamp() + FROM "hub_sessions" session, "copilot_connection_states" state + WHERE sensitive_authorization."id" = ${input.authorizationId}::uuid + AND sensitive_authorization."hub_session_id" = ${input.hubSessionId}::uuid + AND sensitive_authorization."actor_membership_id" = ${input.actorMembershipId}::uuid + AND sensitive_authorization."operation" = ${input.operation}::"SensitiveAuthorizationOperation" + AND sensitive_authorization."expected_copilot_generation" = state."generation" + AND state."key" = 'global' + AND cardinality(sensitive_authorization."target_membership_ids") = 1 + AND sensitive_authorization."target_membership_ids"[1] = ${input.actorMembershipId}::uuid + AND sensitive_authorization."verified_at" IS NOT NULL + AND sensitive_authorization."continued_at" IS NULL + AND sensitive_authorization."cancelled_at" IS NULL + AND sensitive_authorization."expires_at" > clock_timestamp() + AND session."id" = sensitive_authorization."hub_session_id" + AND session."ended_at" IS NULL + AND session."expires_at" > clock_timestamp() + RETURNING sensitive_authorization."id" + ` + return rows.length === 1 +} diff --git a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts index 9e45314f2..78a6f6aae 100644 --- a/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts +++ b/hub/server/repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts @@ -7,6 +7,7 @@ export async function getSensitiveAuthorizationAuditData( const rows = await database.$queryRaw< Array<{ actorMembershipId: string + continued: boolean expiresAt: Date expired: boolean operation: @@ -23,6 +24,7 @@ export async function getSensitiveAuthorizationAuditData( "operation", "expires_at" AS "expiresAt", "expires_at" <= clock_timestamp() AS "expired", + "continued_at" IS NOT NULL AS "continued", cardinality("target_membership_ids") AS "targetCount" FROM "sensitive_authorizations" WHERE "id" = ${id}::uuid diff --git a/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts b/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts index e7505377d..937efdf72 100644 --- a/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts +++ b/hub/server/routes/api/administrators/authorizations/start/rate-limit/index.ts @@ -1,17 +1,11 @@ import { createHash } from "node:crypto" import type { RequestHandler } from "express" -import type { - AdministratorRouteDependencies, - CopilotConnectionRouteDependencies, -} from "../../../../auth/types.ts" +import type { AdministratorRouteDependencies } from "../../../../auth/types.ts" import { readAdministratorSession } from "../../../read-administrator-session/index.ts" export function rateLimit( - dependencies: Pick< - AdministratorRouteDependencies | CopilotConnectionRouteDependencies, - "findSession" | "start" - >, + dependencies: Pick, ): RequestHandler { return async (request, response, next) => { try { diff --git a/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts b/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts index 34bebf9b4..184af4231 100644 --- a/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts +++ b/hub/server/routes/api/auth/create-authentication-route-dependencies/index.ts @@ -1,4 +1,4 @@ -import { createHash, randomUUID } from "node:crypto" +import { randomUUID } from "node:crypto" import { admitAuthenticationProof } from "../../../../domains/admission/admit-authentication-proof/index.ts" import { checkAuthenticationRateLimit } from "../../../../domains/admission/check-authentication-rate-limit/index.ts" @@ -30,11 +30,9 @@ import { continueAdministratorAuthorization } from "../../../../domains/administ import { AdministratorAuthorizationDeniedError } from "../../../../domains/administrator-authorization/errors.ts" import { verifyAdministratorAuthorization } from "../../../../domains/administrator-authorization/verify-administrator-authorization/index.ts" import { runAdministratorAuthorizationVerificationTransaction } from "../../../../domains/administrator-authorization/run-administrator-authorization-verification-transaction/index.ts" -import { continueCopilotAuthorization } from "../../../../domains/copilot-connection/continue-copilot-authorization/index.ts" import { endAllHubSessions } from "../../../../domains/session-revocation/end-all-hub-sessions/index.ts" import { listEffectiveAdministrators } from "../../../../domains/administrator-management/list-effective-administrators/index.ts" import { prisma } from "../../../../integrations/prisma/index.ts" -import { checkCopilotToken } from "../../../../integrations/copilot/check-copilot-token/index.ts" import { findLatestAuthenticationProviderRevision } from "../../../../repositories/authentication-providers/find-latest-authentication-provider-revision/index.ts" import { getAuthenticationProofState } from "../../../../repositories/authentication-providers/get-authentication-proof-state/index.ts" import { findCurrentSessionProfile } from "../../../../repositories/user-profiles/find-current-session-profile/index.ts" @@ -48,7 +46,6 @@ import { findAdministratorHubSession } from "../../../../repositories/hub-sessio import { searchAdministratorCandidates } from "../../../../repositories/memberships/search-administrator-candidates/index.ts" import { getSessionRevocationStatus } from "../../../../repositories/session-revocation-states/get-session-revocation-status/index.ts" import { cancelSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/cancel-sensitive-authorization/index.ts" -import { getCopilotConnectionState } from "../../../../repositories/copilot-connection-state/get-copilot-connection-state/index.ts" import { createSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/create-sensitive-authorization/index.ts" import { getSensitiveAuthorizationAuditData } from "../../../../repositories/sensitive-authorizations/get-sensitive-authorization-audit-data/index.ts" import { getSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/get-sensitive-authorization/index.ts" @@ -406,22 +403,11 @@ export async function createAuthenticationRouteDependencies( id: input.authorizationId, }) } - async function getCurrentCopilotState() { - const state = await getCopilotConnectionState(prisma) - const currentDigest = environment.REPLICA_COPILOT_TOKEN - ? createHash("sha256").update(environment.REPLICA_COPILOT_TOKEN).digest("hex") - : null - const tokenMatches = currentDigest !== null && state.tokenDigest === currentDigest - return { - ...state, - refusedAt: tokenMatches ? state.refusedAt : null, - tokenNeedsCheck: state.connected && currentDigest !== null && !tokenMatches, - } - } return { administrators: { applicationOrigin: sharedContext.applicationOrigin, cancel: (input) => cancelAuthorization(input, "administrator"), + cancelCopilot: (input) => cancelAuthorization(input, "copilot"), continue: (input) => continueAdministratorAuthorization(prisma, { hubSessionId: input.hubSessionId, @@ -440,40 +426,6 @@ export async function createAuthenticationRouteDependencies( local: local?.administratorAuthorization, }, }, - copilotConnection: { - applicationOrigin: sharedContext.applicationOrigin, - cancel: (input) => cancelAuthorization(input, "copilot"), - continue: (input) => - continueCopilotAuthorization( - prisma, - { - authorizationId: input.authorizationId, - hubSessionId: input.hubSessionId, - operation: input.operation, - ...(environment.REPLICA_COPILOT_TOKEN - ? { token: environment.REPLICA_COPILOT_TOKEN } - : {}), - }, - checkCopilotToken, - ), - findSession, - getAuthorization, - getState: getCurrentCopilotState, - recordView: (actorMembershipId) => - createSecurityAudit(prisma, { - actorMembershipId, - id: randomUUID(), - operation: "view", - outcome: "success", - type: "copilot_connection", - }), - start: { - entra: entra?.administratorAuthorization, - github: github?.administratorAuthorization, - local: local?.administratorAuthorization, - }, - tokenConfigured: Boolean(environment.REPLICA_COPILOT_TOKEN), - }, currentSession: { restore: async (sessionDigest) => { const session = await restoreHubSession(sessionDigest, { diff --git a/hub/server/routes/api/auth/types.ts b/hub/server/routes/api/auth/types.ts index 580e3a9eb..8230d6f27 100644 --- a/hub/server/routes/api/auth/types.ts +++ b/hub/server/routes/api/auth/types.ts @@ -90,7 +90,6 @@ export interface SignOutDependencies { export interface AuthenticationRouteDependencies { administrators?: AdministratorRouteDependencies - copilotConnection?: CopilotConnectionRouteDependencies currentSession: CurrentSessionDependencies entra?: ProviderAuthenticationRouteDependencies github?: ProviderAuthenticationRouteDependencies @@ -99,30 +98,6 @@ export interface AuthenticationRouteDependencies { signOut: SignOutDependencies } -export interface CopilotConnectionRouteDependencies { - applicationOrigin: string - cancel(input: { authorizationId: string; hubSessionId: string }): Promise - continue(input: { - authorizationId: string - hubSessionId: string - operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" - }): Promise<{ connected: boolean }> - findSession: AdministratorRouteDependencies["findSession"] - getAuthorization: AdministratorRouteDependencies["getAuthorization"] - getState(): Promise<{ - connected: boolean - connectedAt: Date | null - connectedBy: { login: string | null; membershipId: string; name: string | null } | null - generation: bigint - refusedAt: Date | null - tokenNeedsCheck: boolean - verifiedAt: Date | null - }> - recordView(actorMembershipId: string): Promise - start: AdministratorRouteDependencies["start"] - tokenConfigured: boolean -} - export interface ProviderAuthenticationRouteDependencies { administratorAuthorization?: StartAdministratorAuthorizationDependencies administratorEnrollment: StartAdministratorEnrollmentDependencies @@ -156,6 +131,7 @@ export interface StartAdministratorAuthorizationDependencies extends RateLimitDe export interface AdministratorRouteDependencies { applicationOrigin: string cancel(input: { authorizationId: string; hubSessionId: string }): Promise + cancelCopilot?(input: { authorizationId: string; hubSessionId: string }): Promise continue(input: { authorizationId: string hubSessionId: string diff --git a/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts index ece4810c2..b62ecf166 100644 --- a/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts +++ b/hub/server/routes/api/copilot-connection/authorizations/cancel/post/index.ts @@ -1,8 +1,8 @@ import type { RequestHandler } from "express" import { z } from "zod" -import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" -import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" +import type { CopilotConnectionRouteDependencies } from "../../../types.ts" +import { readSessionDigest } from "../../../read-session-digest/index.ts" const bodySchema = z.object({ authorizationId: z.uuid() }).strict() @@ -15,12 +15,20 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH return } try { - const session = await readAdministratorSession(request, dependencies) + const sessionDigest = readSessionDigest(request) + const session = + sessionDigest && dependencies.authorization + ? await dependencies.authorization.findSession(sessionDigest) + : null if (!session) { response.status(403).json({ error: "Administrator access is required." }) return } - const cancelled = await dependencies.cancel({ + if (!dependencies.authorization) { + response.status(404).json({ error: "Copilot authorization is unavailable." }) + return + } + const cancelled = await dependencies.authorization.cancel({ authorizationId: body.data.authorizationId, hubSessionId: session.id, }) diff --git a/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts index e3a0d5551..01c76b55a 100644 --- a/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts +++ b/hub/server/routes/api/copilot-connection/authorizations/continue/post/index.ts @@ -1,12 +1,9 @@ import type { RequestHandler } from "express" import { z } from "zod" -import { - CopilotConnectionDeniedError, - CopilotConnectionUnavailableError, -} from "../../../../../../domains/copilot-connection/errors.ts" -import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" -import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" +import { CopilotConnectionError } from "../../../../../../domains/copilot-connection/errors.ts" +import type { CopilotConnectionRouteDependencies } from "../../../types.ts" +import { readSessionDigest } from "../../../read-session-digest/index.ts" const bodySchema = z .object({ @@ -23,34 +20,27 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH response.status(400).json({ error: "The Copilot authorization continuation is invalid." }) return } + const sessionDigest = readSessionDigest(request) + const session = + sessionDigest && dependencies.authorization && dependencies.continueAuthorization + ? await dependencies.authorization.findSession(sessionDigest) + : null + if (!sessionDigest || !session || !dependencies.continueAuthorization) { + response.status(403).json({ error: "Administrator access is required." }) + return + } try { - const session = await readAdministratorSession(request, dependencies) - if (!session) { - response.status(403).json({ error: "Administrator access is required." }) - return - } - const result = await dependencies.continue({ + const result = await dependencies.continueAuthorization({ authorizationId: body.data.authorizationId, hubSessionId: session.id, operation: body.data.operation, + sessionDigest, + signal: request.signal, }) response.json(result) } catch (error) { - if (error instanceof CopilotConnectionDeniedError) { - const message = { - authorization_unavailable: "This Copilot authorization is no longer available.", - check_in_progress: "This Copilot authorization is already being continued.", - connection_changed: "The Copilot connection changed. Review it before trying again.", - no_token: "Hub has no configured Copilot token.", - not_connected: "Copilot is not connected.", - refused: - "Copilot refused the configured token. Check its Copilot access and permissions.", - }[error.reason] - response.status(409).json({ error: message }) - return - } - if (error instanceof CopilotConnectionUnavailableError) { - response.status(503).json({ error: "Copilot could not check the configured token." }) + if (error instanceof CopilotConnectionError) { + response.status(error.code === "unavailable" ? 503 : 409).json({ error: error.message }) return } next(error) diff --git a/hub/server/routes/api/copilot-connection/authorizations/get/index.ts b/hub/server/routes/api/copilot-connection/authorizations/get/index.ts index 85f516724..403db8108 100644 --- a/hub/server/routes/api/copilot-connection/authorizations/get/index.ts +++ b/hub/server/routes/api/copilot-connection/authorizations/get/index.ts @@ -1,8 +1,8 @@ import type { RequestHandler } from "express" import { z } from "zod" -import type { CopilotConnectionRouteDependencies } from "../../../auth/types.ts" -import { readAdministratorSession } from "../../../administrators/read-administrator-session/index.ts" +import type { CopilotConnectionRouteDependencies } from "../../types.ts" +import { readSessionDigest } from "../../read-session-digest/index.ts" const idSchema = z.uuid() @@ -14,12 +14,20 @@ export function get(dependencies: CopilotConnectionRouteDependencies): RequestHa response.status(400).json({ error: "The authorization identifier is invalid." }) return } - const session = await readAdministratorSession(request, dependencies) + const sessionDigest = readSessionDigest(request) + const session = + sessionDigest && dependencies.authorization + ? await dependencies.authorization.findSession(sessionDigest) + : null if (!session) { response.status(403).json({ error: "Administrator access is required." }) return } - const authorization = (await dependencies.getAuthorization({ + if (!dependencies.authorization) { + response.status(404).json({ error: "Copilot authorization is unavailable." }) + return + } + const authorization = (await dependencies.authorization.getAuthorization({ authorizationId: id.data, hubSessionId: session.id, })) as { diff --git a/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts b/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts index 64f01d482..7ddf35dde 100644 --- a/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts +++ b/hub/server/routes/api/copilot-connection/authorizations/start/post/index.ts @@ -4,8 +4,8 @@ import { z } from "zod" import { AdministratorAuthorizationDeniedError } from "../../../../../../domains/administrator-authorization/errors.ts" import { browserAuthenticationCookieName } from "../../../../../../integrations/express/browser-authentication-cookie-name/index.ts" import { createAuthenticationCookie } from "../../../../../../integrations/express/create-authentication-cookie/index.ts" -import type { CopilotConnectionRouteDependencies } from "../../../../auth/types.ts" -import { readAdministratorSession } from "../../../../administrators/read-administrator-session/index.ts" +import type { CopilotConnectionRouteDependencies } from "../../../types.ts" +import { readSessionDigest } from "../../../read-session-digest/index.ts" const bodySchema = z .object({ @@ -18,7 +18,11 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH return async (request, response, next) => { response.locals.omitLogPayload = true try { - const session = await readAdministratorSession(request, dependencies) + const sessionDigest = readSessionDigest(request) + const session = + sessionDigest && dependencies.authorization + ? await dependencies.authorization.findSession(sessionDigest) + : null if (!session) { response.status(403).json({ error: "Administrator access is required." }) return @@ -28,28 +32,26 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH response.status(400).json({ error: "Confirm the Copilot connection change explicitly." }) return } - const state = await dependencies.getState() - if ( - (body.data.operation === "CONNECT_COPILOT" && - state.connected && - !state.refusedAt && - !state.tokenNeedsCheck) || - (body.data.operation === "DISCONNECT_COPILOT" && !state.connected) - ) { + if (!dependencies.authorization || !dependencies.getGeneration) { + response.status(404).json({ error: "Copilot authorization is unavailable." }) + return + } + const state = await dependencies.status() + if (body.data.operation === "DISCONNECT_COPILOT" && !state.savedConnection) { response.status(409).json({ error: "The Copilot connection changed. Review it again." }) return } - if (body.data.operation === "CONNECT_COPILOT" && !dependencies.tokenConfigured) { + if (body.data.operation === "CONNECT_COPILOT" && !state.configured) { response.status(409).json({ error: "Hub has no configured Copilot token." }) return } const provider = session.providerKey === "github" - ? dependencies.start.github + ? dependencies.authorization.start.github : session.providerKey === "entra" - ? dependencies.start.entra + ? dependencies.authorization.start.entra : session.providerKey === "local" - ? dependencies.start.local + ? dependencies.authorization.start.local : undefined if (!provider) { response.status(409).json({ error: "The session authentication provider is unavailable." }) @@ -57,7 +59,7 @@ export function post(dependencies: CopilotConnectionRouteDependencies): RequestH } const started = await provider.start({ actorMembershipId: session.membershipId, - expectedCopilotGeneration: state.generation, + expectedCopilotGeneration: await dependencies.getGeneration(), externalIdentityId: session.externalIdentityId, hubSessionId: session.id, operation: body.data.operation, diff --git a/hub/server/routes/api/copilot-connection/connect/post/index.ts b/hub/server/routes/api/copilot-connection/connect/post/index.ts deleted file mode 100644 index 4570e3c22..000000000 --- a/hub/server/routes/api/copilot-connection/connect/post/index.ts +++ /dev/null @@ -1,62 +0,0 @@ -import type { RequestHandler } from "express" -import { z } from "zod" - -import { CopilotConnectionError } from "../../../../../domains/copilot-connection/errors.ts" -import { LearningCommandError } from "../../../../../integrations/learning/run-learning-command/errors.ts" -import { readSessionDigest } from "../../read-session-digest/index.ts" -import type { CopilotConnectionRouteDependencies } from "../../types.ts" - -const bodySchema = z.object({ confirmed: z.literal(true) }).strict() -const reportedFailureCodes = new Set([ - "cancelled", - "invalid_request", - "learning_failed", - "not_installed", - "output_too_large", - "timeout", - "unreadable_output", -]) - -export function post(dependencies: CopilotConnectionRouteDependencies): RequestHandler { - return async (request, response, next) => { - try { - if (!bodySchema.safeParse(request.body).success) { - response.status(400).json({ error: "Confirm the Copilot connection change." }) - return - } - const sessionDigest = readSessionDigest(request) - if (!sessionDigest || !(await dependencies.findSession(sessionDigest))) { - response.status(403).json({ error: "Administrator access is required." }) - return - } - await dependencies.connect({ sessionDigest }) - response.status(204).end() - } catch (error) { - if (error instanceof CopilotConnectionError) { - const status = - error.code === "not_authorized" - ? 403 - : error.code === "busy" - ? 409 - : error.code === "credential_missing" - ? 409 - : error.code === "connection_changed" - ? 409 - : error.code === "credential_refused" - ? 422 - : 503 - if (status === 503) { - const failureCode = - error.cause instanceof LearningCommandError && - reportedFailureCodes.has(error.cause.code) - ? error.cause.code - : "unknown" - dependencies.reportFailure(failureCode) - } - response.status(status).json({ error: error.message }) - return - } - next(error) - } - } -} diff --git a/hub/server/routes/api/copilot-connection/create-copilot-connection-route-dependencies/index.ts b/hub/server/routes/api/copilot-connection/create-copilot-connection-route-dependencies/index.ts index 71f7929d9..3e15ab7d6 100644 --- a/hub/server/routes/api/copilot-connection/create-copilot-connection-route-dependencies/index.ts +++ b/hub/server/routes/api/copilot-connection/create-copilot-connection-route-dependencies/index.ts @@ -3,6 +3,7 @@ import type { Logger } from "pino" import type { Prisma } from "../../../../generated/prisma/client.ts" import { connectCopilot } from "../../../../domains/copilot-connection/connect-copilot/index.ts" +import { continueCopilotAuthorization } from "../../../../domains/copilot-connection/continue-copilot-authorization/index.ts" import { disconnectCopilot } from "../../../../domains/copilot-connection/disconnect-copilot/index.ts" import { getCopilotConnectionStatus } from "../../../../domains/copilot-connection/get-copilot-connection-status/index.ts" import { readCopilotConnectionSnapshot } from "../../../../domains/copilot-connection/read-copilot-connection-snapshot/index.ts" @@ -25,12 +26,15 @@ import { findAdministratorHubSession } from "../../../../repositories/hub-sessio import { lockAdministratorHubSession } from "../../../../repositories/hub-sessions/lock-administrator-hub-session/index.ts" import { isEffectiveAdministrator } from "../../../../repositories/memberships/is-effective-administrator/index.ts" import { createSecurityAudit } from "../../../../repositories/security-audits/create-security-audit/index.ts" +import { continueCopilotSensitiveAuthorization } from "../../../../repositories/sensitive-authorizations/continue-copilot-sensitive-authorization/index.ts" import type { CopilotConnectionTransactionRepositories } from "../../../../domains/copilot-connection/types.ts" import type { CopilotConnectionRouteDependencies } from "../types.ts" +import type { AdministratorRouteDependencies } from "../../auth/types.ts" export async function createCopilotConnectionRouteDependencies( environment: NodeJS.ProcessEnv, - logger: Logger, + _logger?: Logger, + authorization?: AdministratorRouteDependencies, ): Promise { const configuration = await readLearningConfiguration(environment) const applicationOrigin = environment.HUB_APPLICATION_ORIGIN @@ -48,6 +52,7 @@ export async function createCopilotConnectionRouteDependencies( return { advanceState: () => advanceCopilotConnectionState(transaction), clearRefusal: () => clearCopilotCredentialRefusal(transaction), + continueAuthorization: (input) => continueCopilotSensitiveAuthorization(transaction, input), deleteConnection: () => deleteCopilotConnection(transaction), lockAdministratorSession: (digest) => lockAdministratorHubSession(transaction, digest), getConnection: () => getCopilotConnection(transaction), @@ -67,49 +72,76 @@ export async function createCopilotConnectionRouteDependencies( return { applicationOrigin, + authorization: authorization + ? { + cancel: (input) => (authorization.cancelCopilot ?? authorization.cancel)(input), + findSession: (sessionDigest) => authorization.findSession(sessionDigest), + getAuthorization: (input) => authorization.getAuthorization(input), + start: authorization.start, + } + : undefined, + continueAuthorization: (input) => + continueCopilotAuthorization(prisma, input, ({ authorizationId, operation }) => + operation === "CONNECT_COPILOT" + ? withCopilotConnectionCheck(() => + connectCopilot( + { + authorizationId, + credentialProvider: configuration.copilotCredentialProvider, + hubSessionId: input.hubSessionId, + sessionDigest: input.sessionDigest, + }, + { + check: async () => { + const credential = await configuration.copilotCredentialProvider.getCredential() + if (!credential) { + throw new Error("The configured Copilot credential is unavailable.") + } + return runLearningCommand(["copilot", "status"], { + cliPath: configuration.cliPath, + githubToken: credential.githubToken, + nodePath: configuration.nodePath, + signal: input.signal, + }) + }, + createId: randomUUID, + findAdministratorSession: findSession, + now: () => new Date(), + readSnapshot: () => + readCopilotConnectionSnapshot({ + getConnection: () => getCopilotConnection(prisma), + getState: () => getCopilotConnectionState(prisma), + }), + recordFailure: (failure) => + recordCopilotConnectionFailure(failure, { + createId: randomUUID, + runTransaction, + }), + recordRefusal: (refusal) => + recordCopilotConnectionRefusal(refusal, { + createId: randomUUID, + runTransaction, + }), + runTransaction, + writeAudit: (event) => createSecurityAudit(prisma, event), + }, + ), + ) + : disconnectCopilot( + { + authorizationId, + hubSessionId: input.hubSessionId, + sessionDigest: input.sessionDigest, + }, + { createId: randomUUID, runTransaction }, + ), + ), findSession, - reportFailure: (code) => { - logger.warn({ copilotFailureCode: code }, "Copilot connection check failed") + getGeneration: async () => { + const state = await getCopilotConnectionState(prisma) + if (!state) throw new Error("The Copilot connection state is unavailable.") + return state.generation }, - connect: ({ sessionDigest, signal }) => - withCopilotConnectionCheck(() => - connectCopilot( - { - credentialProvider: configuration.copilotCredentialProvider, - sessionDigest, - }, - { - check: async () => { - const credential = await configuration.copilotCredentialProvider.getCredential() - if (!credential) { - throw new Error("The configured Copilot credential is unavailable.") - } - return runLearningCommand(["copilot", "status"], { - cliPath: configuration.cliPath, - githubToken: credential.githubToken, - nodePath: configuration.nodePath, - signal, - }) - }, - createId: randomUUID, - findAdministratorSession: findSession, - now: () => new Date(), - readSnapshot: () => - readCopilotConnectionSnapshot({ - getConnection: () => getCopilotConnection(prisma), - getState: () => getCopilotConnectionState(prisma), - }), - recordFailure: (input) => - recordCopilotConnectionFailure(input, { createId: randomUUID, runTransaction }), - recordRefusal: (input) => - recordCopilotConnectionRefusal(input, { createId: randomUUID, runTransaction }), - runTransaction, - writeAudit: (event) => createSecurityAudit(prisma, event), - }, - ), - ), - disconnect: ({ sessionDigest }) => - disconnectCopilot({ sessionDigest }, { createId: randomUUID, runTransaction }), status: async () => { const connection = await getCopilotConnection(prisma) const state = await getCopilotConnectionState(prisma) diff --git a/hub/server/routes/api/copilot-connection/disconnect/delete/index.ts b/hub/server/routes/api/copilot-connection/disconnect/delete/index.ts deleted file mode 100644 index 740f9954c..000000000 --- a/hub/server/routes/api/copilot-connection/disconnect/delete/index.ts +++ /dev/null @@ -1,40 +0,0 @@ -import type { RequestHandler } from "express" -import { z } from "zod" - -import { CopilotConnectionError } from "../../../../../domains/copilot-connection/errors.ts" -import { readSessionDigest } from "../../read-session-digest/index.ts" -import type { CopilotConnectionRouteDependencies } from "../../types.ts" - -const bodySchema = z.object({ confirmed: z.literal(true) }).strict() - -export function delete_(dependencies: CopilotConnectionRouteDependencies): RequestHandler { - return async (request, response, next) => { - try { - if (!bodySchema.safeParse(request.body).success) { - response.status(400).json({ error: "Confirm the Copilot connection change." }) - return - } - const sessionDigest = readSessionDigest(request) - if (!sessionDigest || !(await dependencies.findSession(sessionDigest))) { - response.status(403).json({ error: "Administrator access is required." }) - return - } - await dependencies.disconnect({ sessionDigest }) - response.status(204).end() - } catch (error) { - if (error instanceof CopilotConnectionError) { - response - .status( - error.code === "not_authorized" - ? 403 - : error.code === "not_connected" || error.code === "connection_changed" - ? 409 - : 503, - ) - .json({ error: error.message }) - return - } - next(error) - } - } -} diff --git a/hub/server/routes/api/copilot-connection/index.test.ts b/hub/server/routes/api/copilot-connection/index.test.ts index ed8adaa7a..bf4fe56c2 100644 --- a/hub/server/routes/api/copilot-connection/index.test.ts +++ b/hub/server/routes/api/copilot-connection/index.test.ts @@ -5,36 +5,92 @@ import type { AddressInfo } from "node:net" import { describe, expect, it, vi } from "vitest" import { createApp } from "../../../create-app" -import { CopilotConnectionError } from "../../../domains/copilot-connection/errors" -import { LearningCommandError } from "../../../integrations/learning/run-learning-command/errors" +import type { + AuthenticationRouteDependencies, + StartAdministratorAuthorizationDependencies, +} from "../auth/types" import type { CopilotConnectionRouteDependencies } from "./types" const applicationOrigin = "http://127.0.0.1:5173" const sessionValue = "current-session" +const session = { + externalIdentityId: randomUUID(), + id: randomUUID(), + membershipId: randomUUID(), + providerKey: "github", +} -function dependencies(): CopilotConnectionRouteDependencies { - return { +function startDependencies() { + const start = vi.fn().mockResolvedValue({ + authorizationId: randomUUID(), + authorizationUrl: "https://github.com/login/oauth/authorize", + browserBinding: "browser-binding-with-required-length", + expiresAt: new Date("2030-01-01T00:00:00Z"), + }) + const dependencies: StartAdministratorAuthorizationDependencies = { applicationOrigin, - connect: vi.fn().mockResolvedValue(undefined), - disconnect: vi.fn().mockResolvedValue(undefined), - findSession: vi.fn().mockResolvedValue({ membershipId: randomUUID() }), - reportFailure: vi.fn(), - status: vi.fn().mockResolvedValue({ - configured: true, - connected: false, - savedConnection: false, - connectedBy: null, - refusedAt: null, - verifiedAt: null, - }), + checkRateLimit: vi.fn().mockResolvedValue({ allowed: true, auditFailed: false }), + secureCookie: false, + start, + } + return { dependencies, start } +} + +function routeDependencies() { + const cancel = vi.fn().mockResolvedValue(true) + const continueAuthorization = vi + .fn>() + .mockResolvedValue({ connectionId: randomUUID() }) + const findSession = vi.fn().mockResolvedValue(session) + const getAuthorization = vi.fn().mockResolvedValue({ + expiresAt: new Date("2030-01-01T00:00:00Z"), + operation: "CONNECT_COPILOT", + verifiedAt: new Date("2029-12-31T23:59:00Z"), + }) + const status = vi.fn().mockResolvedValue({ + configured: true, + connected: false, + savedConnection: false, + connectedBy: null, + refusedAt: null, + verifiedAt: null, + }) + const github = startDependencies() + const copilotConnection: CopilotConnectionRouteDependencies = { + applicationOrigin, + authorization: { + cancel, + findSession, + getAuthorization, + start: { github: github.dependencies }, + }, + continueAuthorization, + findSession, + getGeneration: vi.fn().mockResolvedValue(7n), + status, + } + const authentication: AuthenticationRouteDependencies = { + currentSession: { restore: vi.fn() }, + signOut: { applicationOrigin, end: vi.fn(), secureCookie: false }, + } + return { + authentication, + cancel, + continueAuthorization, + copilotConnection, + findSession, + getAuthorization, + status, + github, } } async function withServer( + authentication: AuthenticationRouteDependencies, copilotConnection: CopilotConnectionRouteDependencies, operation: (baseUrl: string) => Promise, ) { - const server = createServer(createApp({ copilotConnection })) + const server = createServer(createApp({ authentication, copilotConnection })) server.listen(0, "127.0.0.1") await once(server, "listening") try { @@ -47,217 +103,218 @@ async function withServer( } } -function mutationHeaders() { - return { - "content-type": "application/json", - cookie: `hub_session=${sessionValue}`, - origin: applicationOrigin, - } +function sessionHeaders(headers: Record = {}) { + return { cookie: `hub_session=${sessionValue}`, ...headers } } describe("copilotConnectionRoutes()", () => { - it("reports saved connection presence separately from active connected state", async () => { - const copilotConnection = dependencies() - vi.mocked(copilotConnection.status).mockResolvedValueOnce({ + it("requires a live effective administrator before exposing connection state", async () => { + const { authentication, copilotConnection, findSession, status } = routeDependencies() + findSession.mockResolvedValueOnce(null) + + await withServer(authentication, copilotConnection, async (baseUrl) => { + const response = await fetch(`${baseUrl}/api/copilot-connection`, { + headers: sessionHeaders(), + }) + + expect(response.status).toBe(403) + expect(findSession).toHaveBeenCalledWith( + createHash("sha256").update(sessionValue).digest("hex"), + ) + expect(status).not.toHaveBeenCalled() + }) + }) + + it("returns connection provenance without returning the operator token or digest", async () => { + const { authentication, copilotConnection, status } = routeDependencies() + const verifiedAt = new Date("2029-12-30T12:00:01Z") + status.mockResolvedValueOnce({ configured: true, - connected: false, + connected: true, savedConnection: true, - connectedBy: null, - refusedAt: new Date("2026-11-11T13:00:00.000Z"), - verifiedAt: null, + connectedBy: { + login: "octocat", + membershipId: session.membershipId, + name: "The Octocat", + }, + refusedAt: null, + verifiedAt, }) - await withServer(copilotConnection, async (baseUrl) => { + await withServer(authentication, copilotConnection, async (baseUrl) => { const response = await fetch(`${baseUrl}/api/copilot-connection`, { - headers: { cookie: `hub_session=${sessionValue}` }, + headers: sessionHeaders(), }) + const body: unknown = await response.json() expect(response.status).toBe(200) - await expect(response.json()).resolves.toEqual({ + expect(response.headers.get("cache-control")).toBe("no-store") + expect(body).toEqual({ configured: true, - connected: false, + connected: true, savedConnection: true, - connectedBy: null, - refusedAt: "2026-11-11T13:00:00.000Z", - verifiedAt: null, + connectedBy: { + login: "octocat", + membershipId: session.membershipId, + name: "The Octocat", + }, + refusedAt: null, + verifiedAt: verifiedAt.toISOString(), }) }) }) - it.each([ - ["connect", "POST", "/api/copilot-connection/connect"], - ["disconnect", "DELETE", "/api/copilot-connection"], - ] as const)("requires a live administrator session before %s", async (_name, method, path) => { - const copilotConnection = dependencies() - vi.mocked(copilotConnection.findSession).mockResolvedValueOnce(null) + it("requires explicit confirmation and binds fresh authorization to the saved generation", async () => { + const { authentication, copilotConnection, github } = routeDependencies() - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}${path}`, { - method, - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), + await withServer(authentication, copilotConnection, async (baseUrl) => { + const denied = await fetch(`${baseUrl}/api/copilot-connection/authorizations/start`, { + method: "POST", + headers: sessionHeaders({ "content-type": "application/json", origin: applicationOrigin }), + body: JSON.stringify({ operation: "CONNECT_COPILOT" }), }) - expect(response.status).toBe(403) - expect(copilotConnection.findSession).toHaveBeenCalledWith( - createHash("sha256").update(sessionValue).digest("hex"), - ) - expect(copilotConnection.connect).not.toHaveBeenCalled() - expect(copilotConnection.disconnect).not.toHaveBeenCalled() - }) - }) - - it.each([ - ["connect", "POST", "/api/copilot-connection/connect"], - ["disconnect", "DELETE", "/api/copilot-connection"], - ] as const)("requires explicit confirmation to %s", async (_name, method, path) => { - const copilotConnection = dependencies() + expect(denied.status).toBe(400) + expect(github.start).not.toHaveBeenCalled() - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}${path}`, { - method, - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: false }), + const response = await fetch(`${baseUrl}/api/copilot-connection/authorizations/start`, { + method: "POST", + headers: sessionHeaders({ "content-type": "application/json", origin: applicationOrigin }), + body: JSON.stringify({ confirmed: true, operation: "CONNECT_COPILOT" }), }) - expect(response.status).toBe(400) - expect(copilotConnection.findSession).not.toHaveBeenCalled() - expect(copilotConnection.connect).not.toHaveBeenCalled() - expect(copilotConnection.disconnect).not.toHaveBeenCalled() + expect(response.status).toBe(200) + expect(github.start).toHaveBeenCalledWith({ + actorMembershipId: session.membershipId, + expectedCopilotGeneration: 7n, + externalIdentityId: session.externalIdentityId, + hubSessionId: session.id, + operation: "CONNECT_COPILOT", + targetMembershipIds: [session.membershipId], + }) }) }) it.each([ - ["connect", "POST", "/api/copilot-connection/connect"], - ["disconnect", "DELETE", "/api/copilot-connection"], - ] as const)( - "rejects cross-origin %s before parsing its mutation body", - async (_name, method, path) => { - const copilotConnection = dependencies() - - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}${path}`, { - method, - headers: { - "content-type": "application/json", - cookie: `hub_session=${sessionValue}`, - origin: "https://attacker.example", - }, - body: "{", - }) - - expect(response.status).toBe(403) - expect(copilotConnection.findSession).not.toHaveBeenCalled() - expect(copilotConnection.connect).not.toHaveBeenCalled() - expect(copilotConnection.disconnect).not.toHaveBeenCalled() - }) - }, - ) - - it("passes the live session digest to explicit connection mutations", async () => { - const copilotConnection = dependencies() - const digest = createHash("sha256").update(sessionValue).digest("hex") + [ + "rechecks a healthy saved connection", + "CONNECT_COPILOT" as const, + { connected: true, savedConnection: true }, + ], + [ + "disconnects an inactive saved connection", + "DISCONNECT_COPILOT" as const, + { connected: false, savedConnection: true }, + ], + ])("%s", async (_label, operation, statusOverride) => { + const { authentication, copilotConnection, github, status } = routeDependencies() + status.mockResolvedValue({ + configured: true, + connectedBy: null, + refusedAt: null, + verifiedAt: new Date(), + ...statusOverride, + }) - await withServer(copilotConnection, async (baseUrl) => { - const connectResponse = await fetch(`${baseUrl}/api/copilot-connection/connect`, { + await withServer(authentication, copilotConnection, async (baseUrl) => { + const response = await fetch(`${baseUrl}/api/copilot-connection/authorizations/start`, { method: "POST", - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), - }) - const disconnectResponse = await fetch(`${baseUrl}/api/copilot-connection`, { - method: "DELETE", - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), + headers: sessionHeaders({ "content-type": "application/json", origin: applicationOrigin }), + body: JSON.stringify({ confirmed: true, operation }), }) - expect(connectResponse.status).toBe(204) - expect(disconnectResponse.status).toBe(204) - expect(copilotConnection.connect).toHaveBeenCalledWith({ sessionDigest: digest }) - expect(copilotConnection.disconnect).toHaveBeenCalledWith({ sessionDigest: digest }) + expect(response.status).toBe(200) + expect(github.start).toHaveBeenCalledWith( + expect.objectContaining({ + operation, + }), + ) }) }) - it("returns conflict when the connection changes during disconnect", async () => { - const copilotConnection = dependencies() - vi.mocked(copilotConnection.disconnect).mockRejectedValue( - new CopilotConnectionError( - "connection_changed", - "The Copilot connection changed during this request.", - ), - ) + it("uses the local session provider for fresh authorization", async () => { + const { authentication, copilotConnection } = routeDependencies() + const local = startDependencies() + copilotConnection.authorization!.findSession = vi.fn().mockResolvedValue({ + ...session, + providerKey: "local", + }) + copilotConnection.authorization!.start.local = local.dependencies - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}/api/copilot-connection`, { - method: "DELETE", - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), + await withServer(authentication, copilotConnection, async (baseUrl) => { + const response = await fetch(`${baseUrl}/api/copilot-connection/authorizations/start`, { + method: "POST", + headers: sessionHeaders({ + "content-type": "application/json", + origin: applicationOrigin, + }), + body: JSON.stringify({ confirmed: true, operation: "CONNECT_COPILOT" }), }) - expect(response.status).toBe(409) - await expect(response.json()).resolves.toEqual({ - error: "The Copilot connection changed during this request.", - }) + expect(response.status).toBe(200) + expect(local.start).toHaveBeenCalledWith( + expect.objectContaining({ + actorMembershipId: session.membershipId, + operation: "CONNECT_COPILOT", + }), + ) }) }) - it("returns conflict when another connection check is already running", async () => { - const copilotConnection = dependencies() - vi.mocked(copilotConnection.connect).mockRejectedValue( - new CopilotConnectionError("busy", "Another Copilot connection check is still running."), - ) + it("continues and cancels only through the current administrator session", async () => { + const { authentication, cancel, continueAuthorization, copilotConnection } = routeDependencies() + const authorizationId = randomUUID() - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}/api/copilot-connection/connect`, { + await withServer(authentication, copilotConnection, async (baseUrl) => { + const continued = await fetch(`${baseUrl}/api/copilot-connection/authorizations/continue`, { + method: "POST", + headers: sessionHeaders({ + "content-type": "application/json", + origin: applicationOrigin, + }), + body: JSON.stringify({ authorizationId, operation: "DISCONNECT_COPILOT" }), + }) + const cancelled = await fetch(`${baseUrl}/api/copilot-connection/authorizations/cancel`, { method: "POST", - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), + headers: sessionHeaders({ "content-type": "application/json", origin: applicationOrigin }), + body: JSON.stringify({ authorizationId }), }) - expect(response.status).toBe(409) - await expect(response.json()).resolves.toEqual({ - error: "Another Copilot connection check is still running.", + expect(continued.status).toBe(200) + expect(continueAuthorization).toHaveBeenCalledOnce() + const continuation = continueAuthorization.mock.calls[0]![0] + expect(continuation).toMatchObject({ + authorizationId, + hubSessionId: session.id, + operation: "DISCONNECT_COPILOT", + sessionDigest: createHash("sha256").update(sessionValue).digest("hex"), }) + expect(continuation.signal).toBeInstanceOf(AbortSignal) + expect(cancelled.status).toBe(204) + expect(cancel).toHaveBeenCalledWith({ authorizationId, hubSessionId: session.id }) }) }) - it.each([ - [ - "the allowlisted command failure", - new CopilotConnectionError("unavailable", "Hub could not check Copilot.", { - cause: new LearningCommandError("timeout", "private command output"), - }), - "timeout", - ], - [ - "an unknown cause", - new CopilotConnectionError("unavailable", "Hub could not check Copilot.", { - cause: new Error("private command output"), - }), - "unknown", - ], - [ - "an unrecognized command failure", - new CopilotConnectionError("unavailable", "Hub could not check Copilot.", { - cause: new LearningCommandError("private_provider_detail", "private command output"), - }), - "unknown", - ], - ])("reports %s without exposing the raw error", async (_label, error, expectedCode) => { - const copilotConnection = dependencies() - vi.mocked(copilotConnection.connect).mockRejectedValue(error) + it("applies the authorization parser limit before case-insensitive route handling", async () => { + const { authentication, copilotConnection, github } = routeDependencies() - await withServer(copilotConnection, async (baseUrl) => { - const response = await fetch(`${baseUrl}/api/copilot-connection/connect`, { + await withServer(authentication, copilotConnection, async (baseUrl) => { + const response = await fetch(`${baseUrl}/API/COPILOT-CONNECTION/AUTHORIZATIONS/START`, { method: "POST", - headers: mutationHeaders(), - body: JSON.stringify({ confirmed: true }), + headers: sessionHeaders({ + "content-type": "application/json", + origin: applicationOrigin, + }), + body: JSON.stringify({ + confirmed: true, + operation: "CONNECT_COPILOT", + padding: "x".repeat(5_000), + }), }) - expect(response.status).toBe(503) - expect(copilotConnection.reportFailure).toHaveBeenCalledWith(expectedCode) - expect(JSON.stringify(vi.mocked(copilotConnection.reportFailure).mock.calls)).not.toContain( - "private command output", - ) + expect(response.status).toBe(413) + expect(response.headers.get("cache-control")).toBe("no-store") + expect(github.start).not.toHaveBeenCalled() }) }) }) diff --git a/hub/server/routes/api/copilot-connection/types.ts b/hub/server/routes/api/copilot-connection/types.ts index 3f8ef59ec..2656d1fa2 100644 --- a/hub/server/routes/api/copilot-connection/types.ts +++ b/hub/server/routes/api/copilot-connection/types.ts @@ -1,9 +1,55 @@ export interface CopilotConnectionRouteDependencies { applicationOrigin: string - connect: (input: { sessionDigest: string; signal?: AbortSignal }) => Promise - disconnect: (input: { sessionDigest: string }) => Promise + authorization?: { + cancel(input: { authorizationId: string; hubSessionId: string }): Promise + findSession: (sessionDigest: string) => Promise<{ + externalIdentityId: string + id: string + membershipId: string + providerKey: string + } | null> + getAuthorization(input: { authorizationId: string; hubSessionId: string }): Promise + start: Partial< + Record< + "entra" | "github" | "local", + { + applicationOrigin: string + secureCookie: boolean + checkRateLimit( + operation: "start" | "callback", + subjectDigest: string, + ): Promise<{ allowed: boolean; auditFailed: boolean }> + start(input: { + actorMembershipId: string + expectedCopilotGeneration?: bigint + externalIdentityId: string + hubSessionId: string + operation: + | "CONNECT_COPILOT" + | "DESIGNATE_ADMINISTRATORS" + | "DISCONNECT_COPILOT" + | "END_ALL_HUB_SESSIONS" + | "REVOKE_ADMINISTRATOR" + targetMembershipIds: string[] + }): Promise<{ + authorizationId: string + authorizationUrl: string + browserBinding: string + expiresAt: Date + }> + } + > + > + } + continueAuthorization?(input: { + authorizationId: string + hubSessionId: string + operation: "CONNECT_COPILOT" | "DISCONNECT_COPILOT" + sessionDigest: string + signal?: AbortSignal + }): Promise findSession: (sessionDigest: string) => Promise<{ membershipId: string } | null> - reportFailure: (code: string) => void + getGeneration?: () => Promise status: () => Promise<{ configured: boolean connected: boolean diff --git a/hub/server/routes/api/security-audits/present-security-audit/index.ts b/hub/server/routes/api/security-audits/present-security-audit/index.ts index 3594a3c5c..997104619 100644 --- a/hub/server/routes/api/security-audits/present-security-audit/index.ts +++ b/hub/server/routes/api/security-audits/present-security-audit/index.ts @@ -51,12 +51,6 @@ function actorFor(record: SecurityAuditListRecord) { const parsed = actorContextSchema.safeParse(record.context) return parsed.success ? { membershipId: parsed.data.actorMembershipId } : null } - case "copilot.connection.connect": - case "copilot.connection.disconnect": - case "copilot.connection.view": { - const parsed = actorContextSchema.safeParse(record.context) - return parsed.success ? { membershipId: parsed.data.actorMembershipId } : null - } case "session.created": { const parsed = membershipContextSchema.safeParse(record.context) return parsed.success ? { membershipId: parsed.data.membershipId } : null @@ -199,28 +193,6 @@ function contextFor(record: SecurityAuditListRecord): Record { it("cancels a Copilot check and waits for its cleanup during shutdown", async () => { const cleanup = deferred() const started = deferred() - async function connect({ + async function continueAuthorization({ signal, - }: Parameters[0]) { + }: Parameters>[0]) { if (!signal) throw new Error("The API lifecycle signal is required.") started.resolve(signal) if (!signal.aborted) { @@ -144,12 +144,21 @@ describe("runApi()", () => { } const copilotConnection: CopilotConnectionRouteDependencies = { applicationOrigin: "http://127.0.0.1:5173", - connect: vi.fn(connect), - disconnect: vi.fn(), + authorization: { + cancel: vi.fn(), + findSession: vi.fn().mockResolvedValue({ + externalIdentityId: "github:1", + id: "22222222-2222-4222-8222-222222222222", + membershipId: "11111111-1111-4111-8111-111111111111", + providerKey: "github", + }), + getAuthorization: vi.fn(), + start: {}, + }, + continueAuthorization: vi.fn(continueAuthorization), findSession: vi.fn().mockResolvedValue({ membershipId: "11111111-1111-4111-8111-111111111111", }), - reportFailure: vi.fn(), status: vi.fn().mockResolvedValue({ configured: true, connected: false, @@ -162,15 +171,21 @@ describe("runApi()", () => { const { server, running, signal } = await startApi({ port: 0, copilotConnection }) await once(server, "listening") const { port } = server.address() as AddressInfo - const response = fetch(`http://127.0.0.1:${port}/api/copilot-connection/connect`, { - method: "POST", - headers: { - "content-type": "application/json", - cookie: "hub_session=current-session", - origin: copilotConnection.applicationOrigin, + const response = fetch( + `http://127.0.0.1:${port}/api/copilot-connection/authorizations/continue`, + { + method: "POST", + headers: { + "content-type": "application/json", + cookie: "hub_session=current-session", + origin: copilotConnection.applicationOrigin, + }, + body: JSON.stringify({ + authorizationId: "33333333-3333-4333-8333-333333333333", + operation: "CONNECT_COPILOT", + }), }, - body: JSON.stringify({ confirmed: true }), - }) + ) const operationSignal = await started.promise let settled = false void running.finally(() => { diff --git a/hub/server/run-api/index.ts b/hub/server/run-api/index.ts index 18194b6aa..058223b73 100644 --- a/hub/server/run-api/index.ts +++ b/hub/server/run-api/index.ts @@ -58,7 +58,13 @@ export async function runApi({ copilotConnection: copilotConnection ? { ...copilotConnection, - connect: (input) => copilotConnection.connect({ ...input, signal: operations.signal }), + continueAuthorization: copilotConnection.continueAuthorization + ? (input) => + copilotConnection.continueAuthorization!({ + ...input, + signal: operations.signal, + }) + : undefined, } : undefined, product,