⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
import {
apiRouter,
createRoute,
errorResponse,
jsonResponse,
} from "../openapi";
import {
activeSessionListSchema,
revokedSessionsSchema,
} from "../sessions/response";
import { requireInstancePermission } from "./roles/require-instance-permission";
import { requireManageableUser } from "./roles/require-manageable-user";
import { requireUserSession } from "../utils/require-user-session";
import { adminAuditRequest } from "./audit/admin-audit-request";
import listUserApiKeys from "./controllers/list-user-api-keys";
import listUserSessions from "./controllers/list-user-sessions";
import revokeUserApiKey from "./controllers/revoke-user-api-key";
import revokeUserSession from "./controllers/revoke-user-session";
import revokeUserSessions from "./controllers/revoke-user-sessions";
import {
adminApiKeyListSchema,
adminRevokedApiKeySchema,
adminUserApiKeyParam,
adminUserParam,
adminUserSessionParam,
} from "./user-security-schema";
const forbidden = errorResponse(
"The caller lacks the instance permission or is authenticated with an API key",
);
const listSessionsRoute = createRoute({
method: "get",
operationId: "listAdminUserSessions",
path: "/users/{userId}/sessions",
tags: ["Admin"],
summary: "List a user's sessions",
description:
"List a user's signed-in sessions with device, IP address, and activity. Tokens are never returned. `current` marks the administrator's own session. Requires the `users:sessions` instance permission; API keys are rejected.",
middleware: [
requireUserSession,
requireInstancePermission("users:sessions"),
requireManageableUser,
] as const,
request: { params: adminUserParam },
responses: {
200: jsonResponse("Active sessions", activeSessionListSchema),
403: forbidden,
404: errorResponse("User not found"),
},
});
const revokeSessionRoute = createRoute({
method: "delete",
operationId: "revokeAdminUserSession",
path: "/users/{userId}/sessions/{sessionId}",
tags: ["Admin"],
summary: "Sign out one of a user's sessions",
description:
"End one session immediately, including its realtime connections, and record it in the audit log. The administrator's own current session can't be ended here; sign out instead. Requires the `users:sessions` instance permission; API keys are rejected.",
middleware: [
requireUserSession,
requireInstancePermission("users:sessions"),
requireManageableUser,
] as const,
request: { params: adminUserSessionParam },
responses: {
200: jsonResponse("Session signed out", revokedSessionsSchema),
403: forbidden,
404: errorResponse("User or session not found"),
409: errorResponse("The session is the administrator's current session"),
},
});
const revokeSessionsRoute = createRoute({
method: "delete",
operationId: "revokeAdminUserSessions",
path: "/users/{userId}/sessions",
tags: ["Admin"],
summary: "Sign out all of a user's sessions",
description:
"End every session of a user immediately, including realtime connections, and record it in the audit log. When administrators target themselves, their current session is kept. API keys keep working; revoke them separately. Requires the `users:sessions` instance permission; API keys are rejected.",
middleware: [
requireUserSession,
requireInstancePermission("users:sessions"),
requireManageableUser,
] as const,
request: { params: adminUserParam },
responses: {
200: jsonResponse("Sessions signed out", revokedSessionsSchema),
403: forbidden,
404: errorResponse("User not found"),
},
});
const listApiKeysRoute = createRoute({
method: "get",
operationId: "listAdminUserApiKeys",
path: "/users/{userId}/api-keys",
tags: ["Admin"],
summary: "List a user's API keys",
description:
"List a user's API keys with their name, start, status, and dates. The key and its hash are never returned. Requires the `users:api_keys` instance permission; API keys are rejected.",
middleware: [
requireUserSession,
requireInstancePermission("users:api_keys"),
requireManageableUser,
] as const,
request: { params: adminUserParam },
responses: {
200: jsonResponse("API keys, newest first", adminApiKeyListSchema),
403: forbidden,
404: errorResponse("User not found"),
},
});
const revokeApiKeyRoute = createRoute({
method: "delete",
operationId: "revokeAdminUserApiKey",
path: "/users/{userId}/api-keys/{apiKeyId}",
tags: ["Admin"],
summary: "Revoke a user's API key",
description:
"Delete a user's API key so it stops working immediately, and record it in the audit log. Requires the `users:api_keys` instance permission; API keys are rejected.",
middleware: [
requireUserSession,
requireInstancePermission("users:api_keys"),
requireManageableUser,
] as const,
request: { params: adminUserApiKeyParam },
responses: {
200: jsonResponse("API key revoked", adminRevokedApiKeySchema),
403: forbidden,
404: errorResponse("User or API key not found"),
},
});
export const adminUserSecurityRoutes = apiRouter()
.openapi(listSessionsRoute, async (c) =>
c.json(
await listUserSessions(
c.req.valid("param").userId,
c.get("session")?.id ?? null,
),
200,
),
)
.openapi(revokeSessionRoute, async (c) =>
c.json(
await revokeUserSession(
c.req.valid("param"),
c.get("session")?.id ?? null,
adminAuditRequest(c),
),
200,
),
)
.openapi(revokeSessionsRoute, async (c) =>
c.json(
await revokeUserSessions(
c.req.valid("param").userId,
c.get("session")?.id ?? null,
adminAuditRequest(c),
),
200,
),
)
.openapi(listApiKeysRoute, async (c) =>
c.json(await listUserApiKeys(c.req.valid("param").userId), 200),
)
.openapi(revokeApiKeyRoute, async (c) =>
c.json(
await revokeUserApiKey(c.req.valid("param"), adminAuditRequest(c)),
200,
),
);