Files
HiveGrid-Wireframes/hivegrid-cloud/apps/web/app/routes/admin/accounts/users.tsx
T

377 lines
15 KiB
TypeScript

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<typeof loader> = ({ 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<LoaderData>();
const actionData = useActionData<ActionData>();
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 (
<EditPageLayout
title={t("models.user.plural")}
buttons={
<>
<InputFilters size="sm" filters={data.filterableProperties} />
<Button asChild type="button" variant="default" size="sm">
<Link to="new">{t("shared.new")}</Link>
</Button>
</>
}
>
<UsersTable
items={data.items}
canImpersonate={getUserHasPermission(adminData, "admin.users.impersonate")}
canChangePassword={getUserHasPermission(adminData, "admin.users.changePassword")}
canDelete={getUserHasPermission(adminData, "admin.users.delete")}
canSetUserRoles={adminData.isSuperAdmin}
pagination={data.pagination}
lastLogs={data.lastLogs}
/>
<SlideOverWideEmpty
open={!!outlet}
onClose={() => {
navigate(".", { replace: true });
}}
className="sm:max-w-sm"
overflowYScroll={true}
>
<div className="-mx-1 -mt-3">
<div className="space-y-4">{outlet}</div>
</div>
</SlideOverWideEmpty>
</EditPageLayout>
);
}