377 lines
15 KiB
TypeScript
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>
|
|
);
|
|
}
|