Repository Public
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