62 lines
4.3 KiB
Markdown
62 lines
4.3 KiB
Markdown
# EXT-09 · E-Signatur: gehärtete SES-Eigenbau (kein externer Provider)
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Architektur-Entscheidung / Setup |
|
|
| **Owner** | Raffael |
|
|
| **Cycle/Fenster** | v1 — Umsetzung in P16 (AK-P16d) |
|
|
| **Status** | Done (2026-06-28) — Entscheidungs-/Setup-Scope erfüllt; Bau ausgelagert nach AK-P16d |
|
|
|
|
## Entscheidung (2026-06-21) — siehe [[AD-25]]
|
|
Default = HiveGrid baut die Signatur (Angebote/Aufträge/Abnahmen) **selbst als gehärtete SES** — souverän, günstig,
|
|
rechtlich ausreichend. **PandaDoc bleibt als optionale BYOK-Anbindung** ([[EXT-17]]): Tenant mit eigenem Account
|
|
trägt seinen Key ein (Opt-in). AD-25 ersetzt die frühere Annahme, PandaDoc sei der alleinige Provider.
|
|
**Yousign/Skribble/DocuSeal fallen weg; PandaDoc nur noch als Opt-in-Adapter, nicht als Default.**
|
|
|
|
**Warum (Kurzfassung, Details in AD-25):**
|
|
- **Rechtlich:** SHK-Dokumente formfrei/Textform → SES genügt (auch Verbraucherbauvertrag §650i = Textform). Einziger QES-Pflichtfall: Bauvertragskündigung §650h (selten → EXT-17/v2).
|
|
- **Praxis:** Marktstandard = SES-Touch vor Ort + Fern-Link; alle Handwerker-Tools machen SES, kein AES/QES-Druck.
|
|
- **Souveränität:** US-Provider = CLOUD Act (bricht „100 % EU"); EU-Provider/OSS geprüft → Eigenbau gewinnt.
|
|
|
|
## Was zu bauen ist (gehärtete SES — praktisch auf AES-Beweisniveau)
|
|
1. **Touch-Signatur vor Ort** (Canvas → ins Angebots-/Abnahme-PDF) + **Fern-Link-Signatur** (remote annehmen)
|
|
2. **OTP-Identifizierung** (E-Mail; SMS als stärkere Zwei-Kanal-Option)
|
|
3. **PDF-Versiegelung** (PAdES mit HiveGrid-Organisations-Zertifikat → Änderung bricht Signatur)
|
|
4. **Zeitstempel** (TSA, RFC 3161; nicht-qualifiziert genügt)
|
|
5. **Audit-Trail** über M001 (Link/Öffnen/OTP/Signatur: wer, wann, IP, Gerät, Geo, PDF-Hash; append-only)
|
|
6. **Completion-Certificate** als PDF-Anhang (sichtbare Beweis-Doku)
|
|
7. **Einmal-Link** (personengebunden) + expliziter **„Intent to sign"**
|
|
|
|
## Architektur
|
|
- Signatur über **`defineAdapter`** (Apps-Engine, provider-agnostisch). v1-Adapter: **`ses-selfhosted`** (Default) + **`pandadoc-byok`** (optional, Tenant-Key → [[EXT-17]]).
|
|
- Spätere Stufen ohne Fachcode-Umbau: **AES** (Yousign managed oder EU-DSS-Library/Java-Sidecar self-hosted), **QES** (D-Trust sign-me, Hash-only) für § 650h.
|
|
- **Schon vorhanden** (Bausteine): Auth/Identität (P2-Kette), M001-Audit-Log, PDF-Erzeugung (P16), E-Mail (MailerSend), Datenmodell `ProjektSignatureDocument`/`Signer`.
|
|
- **Neu zu bauen:** Touch/Link-Signatur-UI (P16-Wizard), OTP-SMS, Org-Signing-Zertifikat + PAdES-Versiegelung, TSA-Anbindung, Completion-Certificate.
|
|
|
|
## Warum / was es blockt
|
|
- **Blocks:** P16 (Angebot/Signatur, AK-P16d) — dort wird die SES gebaut.
|
|
|
|
## Abhängigkeiten
|
|
- **blocked-by:** — (kein externer Account mehr nötig)
|
|
- **blocks:** P16 (AK-P16d)
|
|
|
|
## Definition of Done
|
|
Dies ist ein **Entscheidungs-/Setup-Ticket** — „done" heißt: Provider-Frage geklärt + Architektur festgelegt. Die *Bau*-Umsetzung gehört bewusst nicht hierher (siehe unten).
|
|
- [x] Signatur-Provider-Frage entschieden: **gehärtete SES-Eigenbau, kein externer Provider** ([[AD-25]])
|
|
- [x] Modell + Architektur festgelegt (7-Punkte-Härtung, `defineAdapter`, AES/QES-Pfad offen)
|
|
|
|
**Bewusst ausgelagert (nicht Teil dieses Tickets):**
|
|
- → **Umsetzung in P16 (`AK-P16d`)** — Touch + Fern-Link + OTP + PAdES-Versiegelung + Audit + Completion-Cert. EXT-09 *blockt* AK-P16d; dort wird gebaut + abgehakt.
|
|
- → **Go-Live-Gate (anwaltlich):** Bestätigung der Beweis-/Form-Einordnung (SES genügt, §650h→QES) läuft über [[EXT-03]] kurz vor Launch.
|
|
|
|
## Hinweis
|
|
QES-Add-on (Bauvertragskündigung §650h) ist nach [[EXT-17]] ausgelagert (v2, via D-Trust). AES nur bei Bedarf später (Adapter).
|
|
|
|
## Umsetzungs-Notiz (2026-06-28)
|
|
**Status: Done — 2/2 Entscheidungs-DoD grün = 100 % des Ticket-Scopes.** Die Provider-Frage ist mit [[AD-25]]
|
|
abschließend entschieden (gehärtete SES-Eigenbau als Default, PandaDoc nur als optionaler BYOK-Adapter [[EXT-17]]),
|
|
die Architektur steht (`defineAdapter` provider-agnostisch, `ses-selfhosted` + `pandadoc-byok`, AES/QES-Pfad offen
|
|
ohne Fachcode-Umbau). PandaDoc-BYOK wurde im POC end-to-end validiert (siehe [[EXT-17]]). Die eigentliche
|
|
SES-Bau-Arbeit (7-Punkte-Härtung) ist in **AK-P16d** verortet, das EXT-09 blockt — kein Doppel-Tracking hier.
|
|
Plane-Titel von „PandaDoc-Sandbox (Provider-Wahl)" auf den realen Scope angeglichen.
|