import { useTranslation } from "react-i18next"; import { ActionFunctionArgs, Link, LoaderFunctionArgs, redirect, useActionData, useLoaderData } from "react-router"; import { adminGetAllUsers, getUser, getUserTotpStatus, updateUserPassword, UserWithDetails } from "~/utils/db/users.db.server"; import { enforceAdminMfa } from "~/utils/auth/mfa/enforcement.server"; import { checkMfaStepUpState } from "~/utils/auth/mfa/step-up.server"; import { createImpersonationStartedAt, createUserSession, getUserInfo, getUserSession, setLoggedUser, validateCSRFToken } from "~/utils/session.server"; import { getTranslations } from "~/locale/i18next.server"; import { hashPassword } from "~/utils/auth/passwordHasher.server"; import { validatePassword as validatePolicyPassword } from "~/services/auth/password-policy.server"; import { requireAdminMfaForAction } from "~/services/auth/admin-mfa-gate.server"; import UsersTable from "~/components/core/users/UsersTable"; import { deleteUserWithItsTenants } from "~/utils/services/userService"; import { getUserHasPermission } from "~/utils/helpers/PermissionsHelper"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; import { useAdminData } from "~/utils/data/useAdminData"; import InputFilters from "~/components/ui/input/InputFilters"; import { getFiltersFromCurrentUrl, getPaginationFromCurrentUrl } from "~/utils/helpers/RowPaginationHelper"; import { FilterablePropertyDto } from "~/application/dtos/data/FilterablePropertyDto"; import EventsService from "~/modules/events/services/.server/EventsService"; import { adminGetAllTenantsIdsAndNames, getTenant } from "~/utils/db/tenants.db.server"; import { PaginationDto } from "~/application/dtos/data/PaginationDto"; import type { Log } from "@toolctrl/db/prisma-browser"; import { getLastUserLogsByUserIds } from "~/utils/db/logs.db.server"; import { useNavigate, useOutlet } from "react-router"; import { createMetrics } from "~/modules/metrics/services/.server/MetricTracker"; import { serverTimingHeaders } from "~/modules/metrics/utils/defaultHeaders"; import EditPageLayout from "~/components/ui/layouts/EditPageLayout"; import SlideOverWideEmpty from "~/components/ui/slideOvers/SlideOverWideEmpty"; import { AccountDeletedDto } from "~/modules/events/dtos/AccountDeletedDto"; import { UserPasswordUpdatedDto } from "~/modules/events/dtos/UserPasswordUpdatedDto"; import { UserProfileDeletedDto } from "~/modules/events/dtos/UserProfileDeletedDto"; import { useEffect } from "react"; import toast from "react-hot-toast"; import { Button } from "~/components/ui/button"; import { adminPath } from "~/utils/app/CanonicalUrlUtils"; import { createImpersonationAudit } from "@toolctrl/db/impersonation-audit.server"; import { createAuditEvent } from "@toolctrl/db/audit-events.server"; import { extractWebActorIp, extractWebActorUserAgent } from "~/utils/audit/withAuditContext"; import { loadRequiredWebConfig } from "@toolctrl/config"; import { absoluteAppPath, absoluteAppRootPath, type PublicDomainRoutingConfig } from "~/utils/app/CrossHostUrls"; export { serverTimingHeaders as headers }; // export const meta: MetaFunction = ({ data }) => [{ title: data?.title }]; export const meta = ({ data }: { data: LoaderData }) => [{ title: data.title }]; type LoaderData = { title: string; items: UserWithDetails[]; filterableProperties: FilterablePropertyDto[]; pagination: PaginationDto; lastLogs: { userId: string; log: Log }[]; }; export function adminImpersonationRedirectTarget( tenant: { slug?: string | null } | null, routing: PublicDomainRoutingConfig = loadRequiredWebConfig().routing ) { return tenant?.slug ? absoluteAppPath(routing, tenant.slug, "dashboard") : absoluteAppRootPath(routing); } export const loader = async ({ request, params }: LoaderFunctionArgs) => { const { time, getServerTimingHeader } = await createMetrics({ request, params }, "admin.users"); await time(verifyUserHasPermission(request, "admin.users.view"), "verifyUserHasPermission"); let { t } = await getTranslations(request); const filterableProperties: FilterablePropertyDto[] = [ { name: "email", title: t("models.user.email") }, { name: "firstName", title: t("models.user.firstName") }, { name: "lastName", title: t("models.user.lastName") }, { name: "tenantId", title: t("models.tenant.object"), manual: true, options: (await adminGetAllTenantsIdsAndNames()).map((tenant) => { return { value: tenant.id, name: tenant.name, }; }), }, { name: "lastLogin", title: t("admin.accounts.users.filters.hasLoggedIn"), manual: true, options: [ { value: "last-24-hours", // days name: t("app.shared.periods.LAST_24_HOURS"), }, { value: "last-7-days", // days name: t("app.shared.periods.LAST_WEEK"), }, { value: "last-30-days", // days name: t("app.shared.periods.LAST_30_DAYS"), }, { value: "last-3-months", // months name: t("app.shared.periods.LAST_3_MONTHS"), }, { value: "last-6-months", // months name: t("app.shared.periods.LAST_N_MONTHS", { count: 6, formattedCount: "6" }), }, { value: "last-year", // months name: t("app.shared.periods.LAST_YEAR"), }, ], }, { name: "isAdmin", title: "models.user.isAdmin", manual: true, isBoolean: true, hideSearch: true, }, ]; const filters = getFiltersFromCurrentUrl(request, filterableProperties); const urlSearchParams = new URL(request.url).searchParams; const currentPagination = getPaginationFromCurrentUrl(urlSearchParams); const { items, pagination } = await time(adminGetAllUsers(filters, currentPagination), "adminGetAllUsers"); const lastLogsByUserId = await time(getLastUserLogsByUserIds(items.map((user) => user.id)), "getLastUserLogsByUserIds"); const lastLogs: { userId: string; log: Log }[] = items .map((user) => { const log = lastLogsByUserId.get(user.id); return log ? { userId: user.id, log } : null; }) .filter((entry): entry is { userId: string; log: Log } => entry !== null); const data: LoaderData = { title: `${t("models.user.plural")} | ${process.env.APP_NAME}`, items, filterableProperties, pagination, lastLogs, }; return Response.json(data, { headers: getServerTimingHeader() }); }; type ActionData = { error?: string; success?: string; }; const success = (data: ActionData) => Response.json(data, { status: 200 }); const badRequest = (data: ActionData) => Response.json(data, { status: 400 }); export const action = async ({ request }: ActionFunctionArgs) => { await verifyUserHasPermission(request, "admin.users.view"); await validateCSRFToken(request); const userInfo = await getUserInfo(request); const { t } = await getTranslations(request); const form = await request.formData(); const action = form.get("action")?.toString(); const userId = form.get("user-id")?.toString(); const user = await getUser(userId); if (!userId || !user || !action) { return badRequest({ error: t("admin.users.errors.invalidForm") }); } switch (action) { case "impersonate": { await verifyUserHasPermission(request, "admin.users.impersonate"); // Phase 09 #82 — sensitive-action MFA gate (otpauth from #26). // requireAdminMfaForAction wraps the existing enforceAdminMfa / // step-up plumbing under a typed action taxonomy so future audit // events tag the gate consistently. await requireAdminMfaForAction(request, "impersonation.start", userInfo.userId); await requireAdminUsersActionMfa(request, userInfo.userId); const userSession = await setLoggedUser(user); if (!userSession) { return badRequest({ error: t("shared.notFound"), }); } // Reuse the tenant resolved inside setLoggedUser to avoid a duplicate // getTenant() round-trip on every impersonation start. const tenant = userSession.defaultTenant ?? (userSession.defaultTenantId ? await getTenant(userSession.defaultTenantId) : null); await createImpersonationAudit({ actorUserId: userInfo.userId, targetUserId: user.id, tenantId: tenant?.id ?? userSession.defaultTenantId ?? null, action: "start", reason: "admin.users.impersonate", requestPath: new URL(request.url).pathname, }); // Phase 10 Task #67: also emit the consolidated AuditEvent so the // compliance export picks up admin impersonations without joining // the legacy ImpersonationAudit table. ImpersonationAudit remains // for backwards-compat; a future task will retire it. await createAuditEvent({ tenantId: tenant?.id ?? userSession.defaultTenantId ?? null, actorId: userInfo.userId, actorType: "admin", actorIp: extractWebActorIp(request), actorUserAgent: extractWebActorUserAgent(request), action: "admin.impersonation.start", targetType: "user", targetId: user.id, sourceModule: "admin", outcome: "success", dataSensitivity: "confidential", regulatoryScope: ["soc2"], metadata: { requestPath: new URL(request.url).pathname, reason: "admin.users.impersonate" }, }); return createUserSession( { ...userInfo, ...userSession, impersonatingFromUserId: userInfo.userId, impersonatingStartedAt: createImpersonationStartedAt(), }, adminImpersonationRedirectTarget(tenant) ); } case "change-password": { await verifyUserHasPermission(request, "admin.users.changePassword"); const actor = await requireAdminUsersActionMfa(request, userInfo.userId); const passwordNew = form.get("password-new")?.toString(); if (!passwordNew) { return badRequest({ error: t("admin.users.errors.passwordMinLength") }); } if (user?.admin) { return badRequest({ error: t("admin.users.errors.cannotChangeAdminPassword") }); } const policyResult = await validatePolicyPassword(passwordNew, user?.email ? { email: user.email } : {}); if (!policyResult.valid) { const first = policyResult.errors[0]; return badRequest({ error: first ? t(first.code, first.args ?? {}) : t("admin.users.errors.passwordMinLength") }); } const passwordHash = await hashPassword(passwordNew); await updateUserPassword({ passwordHash }, user?.id); await EventsService.create({ request, event: "user.password.updated", tenantId: null, userId: user.id, data: { user: { id: user.id, email: user.email }, fromUser: { id: actor?.id ?? "", email: actor?.email ?? "" }, } satisfies UserPasswordUpdatedDto, }); return success({ success: t("shared.updated") }); } case "delete-user": { await verifyUserHasPermission(request, "admin.users.delete"); // Phase 09 #82 — destructive admin action (delete user + cascading // tenants) goes through the sensitive-action gate before the existing // step-up enforcement. await requireAdminMfaForAction(request, "tenant.delete", userInfo.userId); await requireAdminUsersActionMfa(request, userInfo.userId); try { const { deletedTenants } = await deleteUserWithItsTenants(userId); const deletedAccounts = await Promise.all( deletedTenants.map(async (tenant) => { const data = { tenant: { id: tenant.id, name: tenant.name }, user: { id: user.id, email: user.email }, } satisfies AccountDeletedDto; await EventsService.create({ request, event: "account.deleted", tenantId: null, userId: null, data, }); return data; }) ); await EventsService.create({ request, event: "user.profile.deleted", tenantId: null, userId: null, data: { id: user.id, email: user.email, firstName: user.firstName, lastName: user.lastName, deletedAccounts, } satisfies UserProfileDeletedDto, }); } catch (error) { // eslint-disable-next-line no-console console.error(error); return badRequest({ error: t("shared.unexpectedError"), }); } return success({ success: t("shared.deleted") }); } default: { return badRequest({ error: t("admin.users.errors.invalidForm") }); } } }; async function requireAdminUsersActionMfa(request: Request, actorUserId: string) { const session = await getUserSession(request); const actor = await getUser(actorUserId); const mfaEnforcement = enforceAdminMfa({ requestUrl: request.url, userId: actor?.id, isAdmin: Boolean(actor?.admin), totpStatus: actor ? await getUserTotpStatus(actor.id) : null, stepUp: actor ? checkMfaStepUpState(session, actor.id) : { verified: false, reason: "missing" }, redirectMode: "host-aware", appFallbackPath: absoluteAppRootPath(loadRequiredWebConfig().routing), }); if (mfaEnforcement instanceof Response) { throw mfaEnforcement; } if (!mfaEnforcement.allowed) { throw redirect(mfaEnforcement.redirectTo); } return actor; } export default function AdminUsersRoute() { const { t } = useTranslation(); const data = useLoaderData(); const actionData = useActionData(); const adminData = useAdminData(); const outlet = useOutlet(); const navigate = useNavigate(); useEffect(() => { if (actionData?.success) { toast.success(actionData.success); } else if (actionData?.error) { toast.error(actionData.error); } }, [actionData]); return ( } > { navigate(".", { replace: true }); }} className="sm:max-w-sm" overflowYScroll={true} >
{outlet}
); }