SPB Git

Repository Public

AuditScreen.tsx 16.5 KB 230 lines tsx

1"use client";2import Link from "next/link";3import { usePathname, useRouter, useSearchParams } from "next/navigation";4import { Suspense, useState } from "react";5import { transport, type Schemas } from "@/api/client";6import { ApiError, errorFromResponse } from "@/api/errors";7import { useApiList, useApiQuery } from "@/api/query";8import { RowTable, type RowColumn } from "@/features/settings/RowTable";9import { useI18n } from "@/i18n";10import { Page, RequirePermission } from "@/shell/AppShell";11import { hrefFor } from "@/shell/nav";12import { useEvent } from "@/shell/realtime";13import { useSession } from "@/shell/session";14import {15  Banner, Button, CopyButton, DataStamp, Dialog, Drawer, ErrorState, KeyValue, LoadMore, SelectField, Skeleton, SkeletonRows, StateDot, TextField, Tooltip, outcomeTone, useToast,16} from "@/ui";17import { exportFileName, filtersFromParams, filtersToQueryString, isoToUtcInput, utcInputToIso, type AuditFilterKey, type AuditFilters } from "./logic";1819type Entry = Schemas["AuditEntry"];20const LINKABLE = new Set(["node", "service", "alert", "incident", "action", "job", "maintenance_window"]);2122export function AuditScreen() {23  return (24    <RequirePermission permission="audit.read">25      <Suspense fallback={null}><Inner /></Suspense>26    </RequirePermission>27  );28}2930function Inner() {31  const { t, fmt } = useI18n();32  const { can } = useSession();33  const router = useRouter();34  const pathname = usePathname();35  const params = useSearchParams();36  const filters = filtersFromParams(params);37  const [draft, setDraft] = useState<AuditFilters | null>(null);38  const [open, setOpen] = useState<Entry | null>(null);39  const [exporting, setExporting] = useState(false);40  const [fresh, setFresh] = useState(0);41  const form = draft ?? filters;4243  const apply = (f: AuditFilters) => {44    setDraft(null);45    setFresh(0);46    router.replace(pathname + filtersToQueryString(f));47  };48  const outcome = filters.outcome as Schemas["AuditOutcome"] | undefined;49  const list = useApiList("/audit", {50    query: {51      limit: 100,52      ...(filters.action ? { action: filters.action } : {}), ...(filters.actor_id ? { actor_id: filters.actor_id } : {}), ...(filters.target_kind ? { target_kind: filters.target_kind } : {}),53      ...(filters.target_id ? { target_id: filters.target_id } : {}), ...(outcome ? { outcome } : {}), ...(filters.correlation_id ? { correlation_id: filters.correlation_id } : {}),54      ...(filters.from ? { from: filters.from } : {}), ...(filters.to ? { to: filters.to } : {}),55    },56  });57  useEvent("audit.appended", () => setFresh((n) => n + 1));5859  const set = (k: AuditFilterKey, v: string) => setDraft({ ...form, [k]: v });60  const drill = (id: string) => apply({ correlation_id: id });61  const drillAction = filters.correlation_id ? list.items.find((e) => e.target_kind === "action" && e.target_id) : undefined;6263  const columns: RowColumn<Entry>[] = [64    { id: "seq", header: t("audit.col.seq"), mono: true, shrink: true, cell: (e) => e.seq },65    { id: "ts", header: t("audit.col.tsUtc"), mono: true, shrink: true, cell: (e) => <time dateTime={e.ts} title={t("audit.localTime", { time: fmt.dateTime(e.ts, { seconds: true }) })} className="nowrap">{fmt.utc(e.ts)}</time> },66    { id: "actor", header: t("audit.col.actor"), cell: (e) => <span className="row"><span className="mcc-tag">{t(`audit.actorKind.${e.actor_kind}`)}</span><span className="truncate">{e.actor_label}</span></span> },67    { id: "action", header: t("audit.col.action"), mono: true, cell: (e) => <button type="button" className="aud-link mono" onClick={() => setOpen(e)} aria-label={t("audit.openEntry", { seq: e.seq, action: e.action })}>{e.action}</button> },68    { id: "target", header: t("audit.col.target"), hide: "md", cell: (e) => (e.target_kind ? (e.target_id && LINKABLE.has(e.target_kind) ? <Link href={hrefFor(e.target_kind, e.target_id)} className="mono">{e.target_kind}:{e.target_id.slice(0, 8)}</Link> : <span className="mono">{e.target_kind}{e.target_id ? `:${e.target_id.slice(0, 8)}` : ""}</span>) : <span className="faint">{t("common.none")}</span>) },69    { id: "outcome", header: t("audit.col.outcome"), cell: (e) => <StateDot tone={outcomeTone(e.outcome)} label={t(`states.outcome.${e.outcome}`)} /> },70    { id: "detail", header: t("audit.col.detail"), hide: "md", cell: (e) => <span className="aud-detail" title={e.detail}>{e.detail}</span> },71    { id: "ip", header: t("audit.col.ip"), hide: "md", mono: true, cell: (e) => e.ip ?? <span className="faint">{t("audit.notReturned")}</span> },72    { id: "corr", header: t("audit.col.correlation"), hide: "sm", cell: (e) => (73      <span className="row">74        <Tooltip content={t("audit.drill")} placement="end"><button type="button" className="aud-link mono" onClick={() => drill(e.correlation_id)} data-testid="audit-correlation">{e.correlation_id.slice(0, 8)}</button></Tooltip>75        <CopyButton text={e.correlation_id} label={t("errors.copyCorrelation")} />76      </span>77    ) },78  ];7980  return (81    <Page title={t("audit.title")} sub={t("audit.sub")} actions={can("audit.export") ? <Button icon="download" onClick={() => setExporting(true)} data-testid="audit-export">{t("audit.export.open")}</Button> : undefined}>82      <div data-testid="screen-audit" className="stack-lg">83        <Verification />84        <section className="stack" aria-labelledby="aud-entries">85          <div className="section-head"><h2 id="aud-entries">{t("audit.entries")}</h2><DataStamp at={list.ready ? list.updatedAt : undefined} /></div>86          <form className="toolbar aud-filters" onSubmit={(e) => { e.preventDefault(); apply(form); }}>87            <TextField label={t("audit.col.action")} value={form.action ?? ""} onChange={(v) => set("action", v)} mono placeholder="auth.login" spellCheck={false} />88            <SelectField label={t("audit.col.outcome")} value={form.outcome ?? ""} onChange={(v) => set("outcome", v)} options={[{ value: "", label: t("common.all") }, ...(["success", "denied", "failure"] as const).map((o) => ({ value: o, label: t(`states.outcome.${o}`) }))]} />89            <TextField label={t("audit.filter.targetKind")} value={form.target_kind ?? ""} onChange={(v) => set("target_kind", v)} mono spellCheck={false} />90            <TextField label={t("audit.filter.targetId")} value={form.target_id ?? ""} onChange={(v) => set("target_id", v)} mono spellCheck={false} />91            <TextField label={t("audit.filter.actorId")} value={form.actor_id ?? ""} onChange={(v) => set("actor_id", v)} mono spellCheck={false} />92            <TextField label={t("audit.col.correlation")} value={form.correlation_id ?? ""} onChange={(v) => set("correlation_id", v)} mono spellCheck={false} data-testid="audit-filter-correlation" />93            <TextField label={t("audit.filter.fromUtc")} type="datetime-local" value={isoToUtcInput(form.from)} onChange={(v) => set("from", utcInputToIso(v) ?? "")} />94            <TextField label={t("audit.filter.toUtc")} type="datetime-local" value={isoToUtcInput(form.to)} onChange={(v) => set("to", utcInputToIso(v) ?? "")} />95            <Button type="submit" variant="primary" icon="filter" data-testid="audit-filter-apply">{t("common.apply")}</Button>96            <Button onClick={() => apply({})} disabled={Object.keys(filters).length === 0 && draft === null}>{t("common.reset")}</Button>97          </form>98          <p className="mcc-hint">{t("audit.utcNote")}</p>99          {filters.correlation_id ? (100            <Banner tone="info" actions={<Button size="sm" onClick={() => apply({})}>{t("audit.drillClear")}</Button>}>101              <span data-testid="audit-drilldown">{t("audit.drillActive")} <code>{filters.correlation_id}</code></span>102              {drillAction?.target_id ? <> · <Link href={`/actions/${drillAction.target_id}`}>{t("audit.drillAction")}</Link></> : null}103            </Banner>104          ) : null}105          {fresh > 0 ? (106            <Banner tone="info" actions={<Button size="sm" icon="refresh" onClick={() => { setFresh(0); list.refetch(); }}>{t("common.refresh")}</Button>}>107              <span data-testid="audit-new-entries">{t("audit.newEntries", { count: fresh })}</span>108            </Banner>109          ) : null}110          {list.error && !list.ready ? <ErrorState error={list.error} onRetry={list.refetch} /> : !list.ready ? <SkeletonRows rows={10} /> : (111            <RowTable caption={t("audit.entries")} columns={columns} rows={list.items} rowKey={(e) => String(e.seq)} rowProps={(e) => ({ "data-testid": "audit-row", "data-seq": String(e.seq), "data-action": e.action, "data-outcome": e.outcome })} onRowClick={setOpen} empty={<span className="muted">{t("audit.empty")}</span>} />112          )}113          <LoadMore hasMore={list.hasMore} loading={list.loadingMore} onMore={list.loadMore} />114        </section>115      </div>116      <EntryDrawer entry={open} onClose={() => setOpen(null)} onDrill={(id) => { setOpen(null); drill(id); }} />117      {exporting ? <ExportDialog onClose={() => setExporting(false)} initialFrom={filters.from} initialTo={filters.to} /> : null}118    </Page>119  );120}121122function Verification() {123  const { t, fmt } = useI18n();124  const q = useApiQuery("/audit/verify", undefined, { staleTime: 60_000 });125  const v = q.data;126  return (127    <section className="stack" aria-labelledby="aud-chain">128      <div className="section-head">129        <h2 id="aud-chain">{t("audit.chain.title")}</h2>130        <Button size="sm" icon="shield" loading={q.isFetching} onClick={() => void q.refetch()} data-testid="audit-verify">{t("audit.chain.verify")}</Button>131      </div>132      {q.isError && !v ? <ErrorState error={q.error} onRetry={() => void q.refetch()} compact /> : !v ? <Skeleton width="60" label={t("common.loading")} /> : (133        <div className="stack" role="status" data-testid="audit-verify-result" data-ok={String(v.ok)}>134          {v.ok ? (135            <div className="row-wrap"><StateDot tone="ok" label={t("audit.chain.ok")} /><span className="muted">{t("audit.chain.okBody")}</span></div>136          ) : (137            <Banner tone="critical" role="alert"><strong>{t("audit.chain.broken")}</strong> {v.first_broken_seq !== undefined ? t("audit.chain.brokenAt", { seq: v.first_broken_seq }) : ""} {t("audit.chain.brokenBody")}{v.reason ? <span className="mono"> {v.reason}</span> : null}</Banner>138          )}139          <KeyValue inline items={[140            { label: t("audit.chain.checked"), value: <span className="num">{fmt.integer(v.checked_entries)}</span> },141            { label: t("audit.chain.range"), value: v.first_seq !== undefined && v.last_seq !== undefined ? <span className="num mono">{v.first_seq} → {v.last_seq}</span> : <span className="faint">{t("audit.chain.emptyLog")}</span> },142            { label: t("audit.chain.head"), value: v.head_hash ? <span className="row"><code className="aud-hash" title={v.head_hash}>{v.head_hash.slice(0, 16)}…</code><CopyButton text={v.head_hash} /></span> : <span className="faint">{t("audit.chain.emptyLog")}</span> },143            { label: t("audit.chain.verifiedAt"), value: <span className="num">{fmt.utc(v.verified_at)}</span> },144            ...(v.export_public_key ? [{ label: t("audit.chain.exportKey"), value: <span className="row"><code className="aud-hash" title={v.export_public_key}>{v.export_key_id ?? v.export_public_key.slice(0, 16)}</code><CopyButton text={v.export_public_key} label={t("audit.chain.copyExportKey")} /></span> }] : []),145          ]} />146        </div>147      )}148    </section>149  );150}151152function EntryDrawer({ entry, onClose, onDrill }: { entry: Entry | null; onClose: () => void; onDrill: (id: string) => void }) {153  const { t, fmt } = useI18n();154  if (!entry) return null;155  const e = entry;156  return (157    <Drawer open onClose={onClose} title={t("audit.entry.title", { seq: e.seq })} description={e.action} footer={<Button onClick={onClose}>{t("common.close")}</Button>}>158      <KeyValue items={[159        { label: t("audit.col.tsUtc"), value: <span className="num">{fmt.utc(e.ts)}</span> },160        { label: t("audit.entry.local"), value: <span className="num">{fmt.dateTime(e.ts, { seconds: true })}</span> },161        { label: t("audit.col.actor"), value: <span>{t(`audit.actorKind.${e.actor_kind}`)} · {e.actor_label}{e.actor_id ? <span className="faint mono"> · {e.actor_id}</span> : null}</span> },162        { label: t("audit.col.outcome"), value: <StateDot tone={outcomeTone(e.outcome)} label={t(`states.outcome.${e.outcome}`)} /> },163        { label: t("audit.col.target"), value: e.target_kind ? <span className="mono">{e.target_kind}{e.target_id ? `:${e.target_id}` : ""}</span> : <span className="faint">{t("common.none")}</span> },164        { label: t("audit.col.detail"), value: e.detail ? <span className="pre">{e.detail}</span> : <span className="faint">{t("common.none")}</span> },165        { label: t("audit.col.ip"), value: e.ip ? <span className="mono">{e.ip}</span> : <span className="faint">{t("audit.notReturned")}</span> },166        ...(e.session_id ? [{ label: t("audit.entry.session"), value: <span className="mono">{e.session_id}</span> }] : []),167        ...(e.device_id ? [{ label: t("audit.entry.device"), value: <span className="mono">{e.device_id}</span> }] : []),168        { label: t("audit.col.correlation"), value: <span className="row-wrap"><code>{e.correlation_id}</code><CopyButton text={e.correlation_id} label={t("errors.copyCorrelation")} /><Button size="sm" icon="filter" onClick={() => onDrill(e.correlation_id)}>{t("audit.drill")}</Button></span> },169        { label: t("audit.entry.hash"), value: <code className="aud-hash">{e.hash}</code> },170        { label: t("audit.entry.prevHash"), value: <code className="aud-hash">{e.prev_hash}</code> },171      ]} />172      <div className="stack-sm">173        <h3>{t("audit.entry.params")}</h3>174        <pre className="mcc-log" tabIndex={0} aria-label={t("audit.entry.params")}>{JSON.stringify(e.params, null, 2)}</pre>175      </div>176    </Drawer>177  );178}179180function ExportDialog({ onClose, initialFrom, initialTo }: { onClose: () => void; initialFrom?: string | undefined; initialTo?: string | undefined }) {181  const { t } = useI18n();182  const toast = useToast();183  // default range when no filter is set: the last 24 hours (UTC), up to the next full minute184  const [from, setFrom] = useState(() => isoToUtcInput(initialFrom || new Date(Date.now() - 24 * 3600_000).toISOString()));185  const [to, setTo] = useState(() => isoToUtcInput(initialTo || new Date(Math.ceil(Date.now() / 60_000) * 60_000 + 60_000).toISOString()));186  const [busy, setBusy] = useState(false);187  const [error, setError] = useState<ApiError | null>(null);188  const fromIso = utcInputToIso(from);189  const toIso = utcInputToIso(to);190  const invalid = !fromIso || !toIso || Date.parse(fromIso) >= Date.parse(toIso);191192  const run = async () => {193    if (invalid || !fromIso || !toIso) return;194    setBusy(true);195    setError(null);196    try {197      const qs = new URLSearchParams({ from: fromIso, to: toIso, format: "jsonl" });198      // through the shared transport: a `403 step_up_required` opens the passkey dialog and the request is replayed once199      const res = await transport.fetch(new Request(`/api/v1/audit/export?${qs.toString()}`, { credentials: "same-origin", cache: "no-store" }));200      if (!res.ok) throw await errorFromResponse(res);201      const url = URL.createObjectURL(await res.blob());202      const a = document.createElement("a");203      a.href = url;204      a.download = exportFileName(fromIso, toIso);205      document.body.appendChild(a);206      a.click();207      a.remove();208      window.setTimeout(() => URL.revokeObjectURL(url), 1000);209      toast({ tone: "ok", title: t("audit.export.done") });210      onClose();211    } catch (e) {212      setError(e instanceof ApiError ? e : new ApiError({ status: 0, code: "network", message: e instanceof Error ? e.message : "network" }));213    } finally {214      setBusy(false);215    }216  };217218  return (219    <Dialog open onClose={onClose} title={t("audit.export.title")} description={t("audit.export.body")} dismissable={!busy}220      footer={<><Button onClick={onClose} disabled={busy}>{t("common.cancel")}</Button><Button variant="primary" icon="download" loading={busy} disabled={invalid} onClick={() => void run()} data-testid="audit-export-submit">{t("audit.export.submit")}</Button></>}>221      <div className="mcc-form-row">222        <TextField label={t("audit.filter.fromUtc")} type="datetime-local" required value={from} onChange={setFrom} data-testid="audit-export-from" />223        <TextField label={t("audit.filter.toUtc")} type="datetime-local" required value={to} onChange={setTo} error={from && to && invalid ? t("audit.export.invalid") : undefined} data-testid="audit-export-to" />224      </div>225      <p className="mcc-hint">{t("audit.export.stepUp")}</p>226      {error ? <div data-testid="audit-export-error"><ErrorState error={error} compact /></div> : null}227    </Dialog>228  );229}230
Files main
Menu

Theme