From ce71058b4d6c354f1bbbe7ca2e5938e18cd82dd1 Mon Sep 17 00:00:00 2001 From: "Claude (KI)" Date: Tue, 6 Oct 2026 11:13:51 +0200 Subject: [PATCH] =?UTF-8?q?CSV-Export:=20Formelanf=C3=A4nge=20auch=20in=20?= =?UTF-8?q?der=20Domain-Aufstellung=20neutralisieren=20(#77)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Der Browser-Export der Domain-Aufstellung quotierte nur Anführungszeichen; Kundennamen/Notizen mit führendem =,+,-,@ wurden in Excel als Formel ausgeführt. Gemeinsame Regel in @kc/platform/csv (auch CR), von Audit- und Rechnungsexport genutzt; Web nutzt dieselbe Regel für Textzellen, Beträge bleiben Zahlen. Co-Authored-By: Claude Opus 5.5 --- apps/api/src/modules/audit/index.ts | 3 +-- apps/api/src/modules/invoices/index.ts | 3 +-- apps/web/src/components/DomainRecords.tsx | 7 ++++--- apps/web/src/lib/csv.ts | 8 ++++++++ packages/platform/src/csv.ts | 9 +++++++++ packages/platform/test/csv.test.ts | 14 ++++++++++++++ 6 files changed, 37 insertions(+), 7 deletions(-) create mode 100644 apps/web/src/lib/csv.ts create mode 100644 packages/platform/src/csv.ts create mode 100644 packages/platform/test/csv.test.ts diff --git a/apps/api/src/modules/audit/index.ts b/apps/api/src/modules/audit/index.ts index cac1e3c..c14edd0 100644 --- a/apps/api/src/modules/audit/index.ts +++ b/apps/api/src/modules/audit/index.ts @@ -5,13 +5,12 @@ import { audit, verifyAuditChain, purgeAuditRetention } from '../../core/audit.j import { clientIp, requirePermission } from '../../core/auth.js'; import { badRequest } from '../../core/errors.js'; import type { KcModule } from '../../core/module.js'; +import { csvCell } from '@kc/platform/csv'; const AUDIT_SQL = 'SELECT id, ts, actor_type, actor_id, org_id, action, resource_type, resource_id, result, error_class, correlation_id, ip, before_json, after_json FROM audit_events'; const listQuery = z.object({ action: z.string().max(100).optional(), actor: z.string().uuid().optional(), org: z.string().uuid().optional(), from: z.string().date().optional(), to: z.string().date().optional() }); // Formel-Injection-Schutz wie im Rechnungs-CSV-Export (apps/api/src/modules/invoices/index.ts) - hier lokal // dupliziert statt importiert, damit Module weiterhin ohne Querverweise aufeinander auskommen. -const csvSafe = (s: string) => (/^[=+\-@\t]/.test(s) ? `'${s}` : s); -const csvCell = (s: string) => { const v = csvSafe(s); return /[;"\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v; }; export const auditModule: KcModule = { name: 'audit', diff --git a/apps/api/src/modules/invoices/index.ts b/apps/api/src/modules/invoices/index.ts index 3a5611c..f45ecda 100644 --- a/apps/api/src/modules/invoices/index.ts +++ b/apps/api/src/modules/invoices/index.ts @@ -17,6 +17,7 @@ import { can, canInOrg } from '../../core/policy.js'; import type { KcModule } from '../../core/module.js'; import { config } from '../../core/config.js'; import { renderInvoicePdf, type CompanySettings, type InvoiceForPdf } from './pdf.js'; +import { csvSafe, csvCell } from '@kc/platform/csv'; /** Kaufmännisches Runden (halb auf), wie in @kc/platform/pricing – hier lokal, weil Rechnungspositionen * (Freitext, Dezimalmenge) sich nicht in das Produkt-Preisschema von calculatePrice pressen lassen. */ @@ -96,8 +97,6 @@ function exportFilter(q: z.infer): { sql: string; params: un const csvNum = (cents: number) => (cents / 100).toFixed(2).replace('.', ','); // Formel-Injection-Schutz (CSV): Zellen, die mit =, +, -, @ oder Tab beginnen, werden von Excel/Sheets sonst als Formel // ausgeführt. Firmenname/Notiz stammen aus vom Kunden bzw. Personal eingegebenen Feldern – daher immer entschärfen. -const csvSafe = (s: string): string => (/^[=+\-@\t]/.test(s) ? `'${s}` : s); -const csvCell = (s: string): string => { const v = csvSafe(s); return /[;"\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v; }; const csvDate = (d: unknown) => (d ? new Date(d as string).toISOString().slice(0, 10) : ''); const STATUS_LABEL: Record = { open: 'Offen', paid: 'Bezahlt', cancelled: 'Storniert' }; diff --git a/apps/web/src/components/DomainRecords.tsx b/apps/web/src/components/DomainRecords.tsx index 1dde4df..8705778 100644 --- a/apps/web/src/components/DomainRecords.tsx +++ b/apps/web/src/components/DomainRecords.tsx @@ -5,18 +5,19 @@ import { useSearchParams } from 'next/navigation'; import { api, errMsg } from '@/lib/api'; import { useSession } from '@/lib/session'; import { Alert, Empty, Field, eur } from '@/components/ui'; +import { csvText, csvValue } from '@/lib/csv'; interface Rec { id: string; domain: string; tld: string; orgId: string | null; customer: string | null; customerNumber: string | null; source: string; termMonths: number | null; costNetCents: number | null; costGrossCents: number | null; setupCostCents: number; sellNetCents: number | null; taxBp: number; sellGrossCents: number | null; profitNetCents: number | null; procurement: 'open' | 'ordered' | 'external'; orderedAt: string | null; note: string | null } interface Res { id: string; name: string; type: string; orgId: string | null } const PROC = { open: 'Bei KCS zu bestellen', ordered: 'Bei KCS bestellt', external: 'Anderer Anbieter' } as const; const money = (c: number | null) => c === null ? '–' : eur(c); const csvNum = (c: number | null) => c === null ? '' : (c / 100).toFixed(2).replace('.', ','); -const csvCell = (v: string | number | null) => `"${String(v ?? '').replace(/"/g, '""')}"`; /** CSV für Excel (Semikolon, UTF-8 mit BOM): Bestellliste bzw. Gesamtaufstellung. */ function download(rows: Rec[], name: string) { const head = ['Domain', 'Endung', 'Laufzeit (Monate)', 'Kunde', 'Kundennr.', 'EK brutto', 'EK netto', 'Setup EK brutto', 'VK brutto', 'VK netto', 'USt %', 'Gewinn netto', 'Status', 'bestellt am', 'Notiz']; - const lines = rows.map((r) => [r.domain, r.tld, r.termMonths, r.customer, r.customerNumber, csvNum(r.costGrossCents), csvNum(r.costNetCents), csvNum(r.setupCostCents), csvNum(r.sellGrossCents), csvNum(r.sellNetCents), r.taxBp / 100, csvNum(r.profitNetCents), PROC[r.procurement], r.orderedAt ? new Date(r.orderedAt).toLocaleDateString('de-DE') : '', r.note].map(csvCell).join(';')); - const url = URL.createObjectURL(new Blob(['' + [head.map(csvCell).join(';'), ...lines].join('\r\n')], { type: 'text/csv;charset=utf-8' })); + // Texte (Domain, Kunde, Notiz …) neutralisiert, Beträge/Zahlen als Werte. + const lines = rows.map((r) => [csvText(r.domain), csvText(r.tld), csvValue(r.termMonths), csvText(r.customer), csvText(r.customerNumber), csvValue(csvNum(r.costGrossCents)), csvValue(csvNum(r.costNetCents)), csvValue(csvNum(r.setupCostCents)), csvValue(csvNum(r.sellGrossCents)), csvValue(csvNum(r.sellNetCents)), csvValue(r.taxBp / 100), csvValue(csvNum(r.profitNetCents)), csvText(PROC[r.procurement]), csvText(r.orderedAt ? new Date(r.orderedAt).toLocaleDateString('de-DE') : ''), csvText(r.note)].join(';')); + const url = URL.createObjectURL(new Blob(['' + [head.map(csvText).join(';'), ...lines].join('\r\n')], { type: 'text/csv;charset=utf-8' })); const a = document.createElement('a'); a.href = url; a.download = name; document.body.appendChild(a); a.click(); a.remove(); URL.revokeObjectURL(url); } export function DomainRecords({ orgId }: { orgId?: string }) { diff --git a/apps/web/src/lib/csv.ts b/apps/web/src/lib/csv.ts new file mode 100644 index 0000000..1bb8486 --- /dev/null +++ b/apps/web/src/lib/csv.ts @@ -0,0 +1,8 @@ +/** + * CSV-Zellen für den Excel-Export im Browser. Gleiche Regel wie @kc/platform/csv (dort getestet): Textzellen, die mit + * = + - @ Tab oder CR beginnen, bekommen ein führendes Apostroph, damit Excel sie nicht als Formel ausführt. + * Zahlenzellen (Beträge) nur quotieren, nicht neutralisieren – sonst würde aus "-1,50" Text. + */ +const quote = (s: string) => `"${s.replace(/"/g, '""')}"`; +export const csvText = (v: string | null | undefined): string => { const s = v ?? ''; return quote(/^[=+\-@\t\r]/.test(s) ? `'${s}` : s); }; +export const csvValue = (v: string | number | null | undefined): string => quote(String(v ?? '')); diff --git a/packages/platform/src/csv.ts b/packages/platform/src/csv.ts new file mode 100644 index 0000000..989dcb8 --- /dev/null +++ b/packages/platform/src/csv.ts @@ -0,0 +1,9 @@ +/** + * CSV-Zellen für Excel/LibreOffice (Semikolon-getrennt). Textzellen aus Nutzereingaben (Kundennamen, Notizen, + * Audit-Aktionen …) dürfen beim Öffnen nie als Formel ausgewertet werden: Zellen, die mit = + - @ Tab oder CR + * beginnen, bekommen ein führendes Apostroph (OWASP „CSV Injection“). Zahlen bewusst NICHT durch csvSafe schicken – + * ein negativer Betrag wie "-1,50" soll eine Zahl bleiben. + */ +export const csvSafe = (s: string): string => (/^[=+\-@\t\r]/.test(s) ? `'${s}` : s); +/** Textzelle: neutralisiert und nur bei Bedarf in Anführungszeichen. */ +export const csvCell = (s: string): string => { const v = csvSafe(s); return /[;"\r\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v; }; diff --git a/packages/platform/test/csv.test.ts b/packages/platform/test/csv.test.ts new file mode 100644 index 0000000..0bde0c3 --- /dev/null +++ b/packages/platform/test/csv.test.ts @@ -0,0 +1,14 @@ +import { describe, expect, it } from 'vitest'; +import { csvCell, csvSafe } from '../src/csv.js'; + +describe('CSV-Zellen (Formel-Injection)', () => { + it('neutralisiert Formelanfänge in Textzellen', () => { + for (const s of ['=1+1', '+49 123', '-2+3', '@SUM(A1)', '\t=1', '\r=1']) expect(csvSafe(s).startsWith("'")).toBe(true); + expect(csvCell('=HYPERLINK("http://x")')).toBe(`"'=HYPERLINK(""http://x"")"`); + expect(csvCell('Kunde A; GmbH')).toBe('"Kunde A; GmbH"'); + }); + it('lässt normale Texte unverändert', () => { + expect(csvCell('Musterfirma GmbH')).toBe('Musterfirma GmbH'); + expect(csvCell('')).toBe(''); + }); +});