fix(gesundheit): Fehlergrund nicht mehr unangemeldet herausgeben

/api/gesundheit steht in der Allowlist des Proxys, damit ein Healthcheck kein
Cookie braucht. Eine Meldung von Prisma oder pg nennt aber Host, Port,
Benutzernamen und Datenbanknamen -- fuer einen Pfad, der ohne Anmeldung
antwortet, ist das zu viel.

Nach aussen bleibt {"status":"fehler"} mit 503, damit Docker und der Reverse
Proxy weiter richtig entscheiden. Die Begruendung geht ins Protokoll des
Prozesses, nach demselben Muster wie in src/server/actions/verzeichnis.ts.

Fuenf Tests, darunter einer fuer die andere Haelfte der Zusage: dass die
Begruendung wirklich geschrieben und nicht verschluckt wird. Gegenprobe
gefahren -- mit der alten Fassung werden drei davon rot.

Closes #39
This commit is contained in:
Florian Wilde
2026-10-04 16:11:28 +02:00
parent 9027229b55
commit 2e8681abf5
5 changed files with 132 additions and 11 deletions
+102
View File
@@ -0,0 +1,102 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
/**
* Der Healthcheck (#039).
*
* Dieser Pfad ist der einzige, der ohne Anmeldung **und** mit Datenbankzugriff
* antwortet. Geprueft wird deshalb nicht, dass er funktioniert — das tun der
* Compose-Stand, `install.sh --test` und jeder e2e-Vorlauf —, sondern dass er im
* Fehlerfall **nichts verraet**. Die Datenbank wird dafuer ersetzt: eine echte
* Verbindung laesst sich nicht so kaputtmachen, dass die Meldung reproduzierbar
* Host, Port und Benutzernamen enthaelt.
*/
const abfrage = vi.fn();
vi.mock("@/lib/db", () => ({
prisma: {
get $queryRaw() {
return abfrage;
},
},
}));
/**
* So sieht die Meldung wirklich aus, wenn `pg` nicht durchkommt — sie nennt
* alles, was ein Angreifer ueber die Datenbank wissen will.
*/
const ECHTE_PG_MELDUNG =
"Can't reach database server at `db-prod.firma.local:5432`. " +
"Authentication failed against database server, the provided database credentials for " +
"`laufzettel_prod` are not valid. Database `laufzettel_betrieb` does not exist.";
const GEHEIMNISSE = [
"db-prod.firma.local",
"5432",
"laufzettel_prod",
"laufzettel_betrieb",
"Authentication failed",
];
async function antwort() {
// Nach jedem Zuruecksetzen der Module neu geholt, damit der Mock greift.
const { GET } = await import("@/app/api/gesundheit/route");
return GET();
}
describe("Healthcheck", () => {
let protokoll: ReturnType<typeof vi.spyOn>;
beforeEach(() => {
vi.resetModules();
abfrage.mockReset();
protokoll = vi.spyOn(console, "error").mockImplementation(() => {});
});
afterEach(() => {
protokoll.mockRestore();
});
it("antwortet mit ok, wenn die Datenbank antwortet", async () => {
abfrage.mockResolvedValue([{ "1": 1 }]);
const a = await antwort();
expect(a.status).toBe(200);
await expect(a.json()).resolves.toEqual({ status: "ok" });
});
it("gibt im Fehlerfall weder Host noch Port noch Benutzernamen heraus", async () => {
abfrage.mockRejectedValue(new Error(ECHTE_PG_MELDUNG));
const a = await antwort();
const text = await a.text();
for (const geheimnis of GEHEIMNISSE) {
expect(text).not.toContain(geheimnis);
}
expect(JSON.parse(text)).toEqual({ status: "fehler" });
});
it("behaelt 503, damit Docker und der Reverse Proxy richtig entscheiden", async () => {
abfrage.mockRejectedValue(new Error(ECHTE_PG_MELDUNG));
expect((await antwort()).status).toBe(503);
});
it("schreibt die Begruendung ins Protokoll, statt sie zu verschlucken", async () => {
abfrage.mockRejectedValue(new Error(ECHTE_PG_MELDUNG));
await antwort();
expect(protokoll).toHaveBeenCalledTimes(1);
const geschrieben = protokoll.mock.calls[0]?.join(" ") ?? "";
expect(geschrieben).toContain("Healthcheck fehlgeschlagen");
// Ohne das waere die Meldung nur weg, nicht aufgehoben.
expect(geschrieben).toContain("db-prod.firma.local:5432");
});
it("nennt auch eine Ausnahme ohne Error-Klasse, ohne sie auszugeben", async () => {
abfrage.mockRejectedValue("nur ein Text");
const a = await antwort();
expect(a.status).toBe(503);
await expect(a.json()).resolves.toEqual({ status: "fehler" });
expect(protokoll.mock.calls[0]?.join(" ")).toContain("unbekannter Fehler");
});
});