Skip to content

ELSTER: Ablaufdatum des Zertifikats aus der Datei lesen (#1366) - #1445

Draft
thomas-baumeister wants to merge 1 commit into
mainfrom
1366-zertifikat-ablaufdatum
Draft

thomas-baumeister wants to merge 1 commit into
mainfrom
1366-zertifikat-ablaufdatum

Conversation

@thomas-baumeister

@thomas-baumeister thomas-baumeister commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Beim Hochladen der ELSTER-Zertifikatsdatei gibt es ein optionales Feld Zertifikats-PIN. Mit der PIN liest Haben das Ablaufdatum aus der Datei, statt dass man „Gültig bis“ abtippen muss; damit greift die Erinnerung 30 Tage vor Ablauf ohne Handarbeit. Ohne PIN oder wenn sie nicht passt, wird wie bisher hochgeladen, und das eingetragene Datum gilt (oder keins, mit dem bestehenden Hinweis „Ablaufdatum nicht angegeben“).

Umgesetzt #1366

Was sich ändert

  • Lesen (server/modules/elster/certificate-expiry.ts): openssl pkcs12 -nokeys -clcerts liest die Zertifikate zu den Schlüsseln der Datei, nicht die einer Zertifizierungsstelle. Die Zertifikate einer PKCS#12-Datei sind mit der PIN verschlüsselt (RFC 7292, Kap. 4.1), ohne PIN geht es nicht. Es zählt das früheste notAfter (RFC 5280, Kap. 4.1.2.5), als Tag in Deutschland (germanDay). Fehlt openssl, passt die PIN nicht oder ist die Datei keine PKCS#12-Datei, gibt es kein Datum und keinen Fehler.
  • PIN: nur für diesen einen Lesevorgang. openssl bekommt die Datei über stdin und die PIN über einen eigenen Kanal (fd 3), nie als Argument, das in jeder Prozessliste stünde. Gespeichert wird sie nicht, auch nicht im Änderungsprotokoll (Test).
  • Speichern (certificate.ts): Mit gelesenem Datum gilt es vor einem eingetragenen, sonst gilt der Eintrag. Das Lesen läuft vor der Transaktion. Die Server Function gibt validUntil und readFromFile zurück.
  • Formular (Einstellungen › ELSTER › ELSTER-Zertifikat): neues Feld „Zertifikats-PIN (optional)“ mit Hinweis, Hinweis an „Gültig bis“. Die Meldung danach nennt das gelesene Datum oder sagt, dass es mit dieser PIN nicht ging und was jetzt gilt (lib/certificate-notice.ts).
  • Image: openssl steht ausdrücklich in apk add im Containerfile. Es lag schon im Image (3.5.7), aber nur über ein anderes Paket.
  • Doku: ELSTER einrichten (Schritt 5), Umsatzsteuer (Zertifikat), Architektur (Modul elster), Entwicklung (Tabelle der fehlenden Werkzeuge: ohne openssl werden die Tests mit selbst erzeugten Zertifikaten übersprungen, das galt schon für Microsoft Graph).

Keine neue Abhängigkeit. Einen Weg über ERiC (EricHoleZertifikatEigenschaften) gäbe es auch. Er ginge aber nur mit eingerichtetem ERiC, bräuchte einen eigenen Vorgang im Worker samt nachgebauter Bibliothek für die Tests, und eric.ts steht schon bei 398 Zeilen. openssl war der Vorschlag im Issue.

Tests

  • certificate-expiry.test.ts (ohne Datenbank, Dateien mit openssl erzeugt): Datum mit PIN; falsche PIN und kaputte Datei ergeben kein Datum; PIN mit Leerzeichen und Zeichen der Shell; CA in der Datei läuft früher ab und zählt nicht; 3DES/SHA-1 wie von älteren Werkzeugen; ohne openssl kein Fehler; frühestes Zertifikat und Tag in Deutschland (notAfter 31.12.2029 23:30 UTC ergibt den 01.01.2030, mit zwei eingebetteten öffentlichen Zertifikaten).
  • certificate.test.ts (Postgres): mit PIN gilt das Datum aus der Datei vor dem eingetragenen, und die PIN steht weder in der Tabelle noch im Änderungsprotokoll; mit falscher PIN gilt der Eintrag, ohne Eintrag bleibt das Datum leer.
  • certificate-notice.test.ts: die drei Meldungen.
  • E2E belege-steuern.spec.ts: lädt statt einer Attrappe eine echte, mit openssl erzeugte Datei mit PIN hoch und erwartet Meldung und „gültig bis …“ in der Liste.

Gegenproben: Ohne -clcerts, mit dem Tag in UTC statt in Deutschland, mit der PIN über die Shell statt fd 3 und ohne Behandlung eines fehlenden openssl schlägt je der passende Test fehl.

Geprüft

Im Dev-Container (Bun 1.4.4, OpenSSL 3.5.7, PostgreSQL 18): Biome für die geänderten Dateien, Modulgrenzen, Seitenabdeckung, Dateigröße, Raster, bun run typecheck, die neuen Tests, die volle Testsuite mit PostgreSQL (12111 bestanden; 29 Fehlschläge in 5 Dateien sind die bekannten des Containers und haben mit der Änderung nichts zu tun: scripts/ci/doku-filter.test.ts und scripts/pr-regeln/pruefen.test.ts ohne git, deploy/backup/backup-status.test.ts ohne psql, die Zeitlimit-Tests in packages/einvoice/src/render-client.test.ts und stammdaten/layouts.test.ts), zensical build --strict.

Übersprungen: E2E nur in der CI (keine Browser von Playwright im Container). Im vollen Lauf übersprungen (217 Tests): echtes ERiC, Authelia, helm, cc für die nachgebaute ERiC-Bibliothek, ERIC_DOKU und die Beispielantworten aus erica. Die vier Fälle des Formulars (mit PIN, falsche PIN mit und ohne Datum, ohne PIN) und die Selektoren des E2E-Schritts habe ich mit Playwright gegen den Dev-Server geprüft.

Bilder

Gleiches Zertifikat (ohne Ablaufdatum hochgeladen), Formular vorher und nachher:

Vorher Nachher
Hell, Desktop
Hell, Handy
Dunkel, Desktop
Dunkel, Handy

Nach dem Hochladen mit PIN („gültig bis“ aus der Datei) und die Meldungen:

Mit PIN Meldung
Hell, Desktop
Dunkel, Desktop (falsche PIN)
Hell, Handy (falsche PIN)
Dunkel, Handy

Das Datumsfeld zeigt mm/dd/yyyy, weil der Browser der Aufnahmen auf Englisch lief; vorher und nachher gleich.

🤖 Generated with Claude Code

…esen

Beim Hochladen der ELSTER-Zertifikatsdatei gibt es ein optionales Feld
„Zertifikats-PIN“. Mit der PIN liest openssl (pkcs12 -nokeys -clcerts)
das früheste notAfter der Zertifikate zum Schlüssel, als Tag in
Deutschland; es gilt vor einem eingetragenen Datum. Die PIN geht über
fd 3 statt als Argument an openssl und wird nicht gespeichert. Ohne PIN
oder wenn sie nicht passt, wird wie bisher hochgeladen.

Quellen: RFC 7292, Kap. 4.1 (EncryptedData), RFC 5280, Kap. 4.1.2.5.

Co-Authored-By: Claude <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant