DSGVO Art. 9 — Compliance-Gap im Mail-Connect-Flow geschlossen (Hans-Müller-DSB
hat den Gap für Gmail/iCloud/GMX identifiziert, schon vor Outlook-OAuth-Pflicht):
- Schema: mail_connections.consent_at + consent_version + consent_ip_address;
neue consent_logs-Tabelle für Audit (grant + revoke append-only)
- Endpoints:
- POST /api/mail-connections/consent (Bulk-Array für Re-Consent, partial-fail
wirft sofort = DSGVO-sicher gegen silent-skip fremder IDs)
- POST /api/mail-connections/:id mit consent-gate (412 wenn consentVersion fehlt)
- DELETE /api/mail-connections/:id mit Widerruf-Log (OAuth-Token-Revoke als
TODO für mo Phase 2)
- GET /api/mail-connections/pending-consent — listet Bestands-Connections
mit consent_at=NULL für Re-Consent-Modal
- Account-Lösch-Bug fix: deleteAllMailConnections() war in user/delete nicht
eingebunden — Verbindungen blieben als Waisen
- Frontend:
- ConnectMailSheet: neuer Consent-Step VOR Provider-Grid (view-Machine
consent → grid → form), exakter Hans-Müller-Wortlaut für Art. 9 Abs. 2
lit. a Einwilligung
- MailConsentReminderSheet: Re-Consent-Modal beim App-Open für Bestands-User
- Stores mailConsent + mailConnectDraft (letzterer fixt Bug: Email/Provider
ging verloren wenn User Browser für App-Pw-Generierung öffnete)
- 12 neue i18n-Keys mail.consent.* in DE + EN
- Versionierter Consent-Text: art9-mail-v1-2026-05-13 (Bump bei Text-Änderung
triggert Re-Consent für alle)
Outlook-OAuth Schema (Phase 0 — additiv, Endpoints kommen später):
- mail_connections: auth_method (default 'app_password' → keine Bestands-
Connection bricht), oauth_access_token, oauth_refresh_token,
oauth_token_expiry, oauth_scope
- Encryption via bestehendes server/utils/crypto.ts (AES-256-GCM, Key aus
Infisical)
- Plan-Doc backend/docs/mail-outlook-oauth-plan.md (mo)
- DSB-Review backend/docs/mail-outlook-oauth-dsgvo-review.md (Hans-Müller):
MS als Sub-AV via DPA Sep 2025, EU Data Boundary seit Feb 2025; 5 Pflicht-
Aufgaben + Anwalts-Klärung zu DPA-Anspruch ohne MS-Lizenz
Profile — Cooldown-Pattern-Analysis als Collapsible:
- CooldownPatternAnalysis: 24h-Uhrzeit-Heatmap, Mo–So-Wochentag-Histogramm,
Top-5-Reason-Wortcloud mit Stop-Words-Filter, Cancel-Rate-Anzeige
- DiGA-relevant: NLP läuft client-side, reason-Texte verlassen das Device
nicht (gut für DSB-Akte)
- useProfileData: useCooldownHistoryFull (limit=100) für Pattern-Analyse
- Neutral formuliert, kein Stigma, alle Headings als Frage
Plan-Docs (kein Code):
- backend/docs/mail-custom-keywords-plan.md — Pro/Legend Custom-Keyword-Filter
(3.25 PT MVP, user-scoped, Body-Match in Phase 2)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
104 lines
3.0 KiB
TypeScript
104 lines
3.0 KiB
TypeScript
import { CURRENT_ART9_MAIL_VERSION } from "../../utils/consent-texts";
|
|
import {
|
|
writeConsentGrant,
|
|
setMailConnectionConsent,
|
|
getMailConnectionWithConsent,
|
|
} from "../../db/consent";
|
|
|
|
/**
|
|
* POST /api/mail-connections/consent
|
|
*
|
|
* Erteilt Art. 9-Einwilligung für eine oder mehrere bestehende MailConnections.
|
|
* Schreibt pro Connection:
|
|
* 1. Eintrag in consent_logs (append-only Beweislog, Art. 7 Abs. 1 DSGVO)
|
|
* 2. consent_at + consent_version + consent_ip_address auf mail_connections
|
|
*
|
|
* Body: { mailConnectionId: string | string[], consentVersion: string }
|
|
*
|
|
* Response:
|
|
* 200: { success: true, consentAt: ISO-string, updated: number }
|
|
* 400: { error: 'invalid_body' }
|
|
* 404: { error: 'connection_not_found' } — wenn eine ID nicht zum User gehört
|
|
* 409: { error: 'consent_version_mismatch', expected: string }
|
|
*/
|
|
export default defineEventHandler(async (event) => {
|
|
const user = await requireUser(event);
|
|
|
|
const body = await readBody(event).catch(() => null);
|
|
const rawId = body?.mailConnectionId as string | string[] | undefined;
|
|
const consentVersion = body?.consentVersion as string | undefined;
|
|
|
|
if (!rawId || !consentVersion) {
|
|
throw createError({
|
|
statusCode: 400,
|
|
data: { error: "invalid_body" },
|
|
});
|
|
}
|
|
|
|
// Nur die aktuelle Version ist akzeptabel.
|
|
if (consentVersion !== CURRENT_ART9_MAIL_VERSION) {
|
|
throw createError({
|
|
statusCode: 409,
|
|
data: {
|
|
error: "consent_version_mismatch",
|
|
expected: CURRENT_ART9_MAIL_VERSION,
|
|
received: consentVersion,
|
|
},
|
|
});
|
|
}
|
|
|
|
// Normalisieren auf Array — erlaubt single-string und bulk-array
|
|
const ids = Array.isArray(rawId) ? rawId : [rawId];
|
|
|
|
if (ids.length === 0) {
|
|
throw createError({
|
|
statusCode: 400,
|
|
data: { error: "invalid_body" },
|
|
});
|
|
}
|
|
|
|
const now = new Date();
|
|
const ipAddress =
|
|
getHeader(event, "x-forwarded-for")?.split(",")[0]?.trim() ??
|
|
getHeader(event, "x-real-ip") ??
|
|
null;
|
|
const userAgent = getHeader(event, "user-agent") ?? null;
|
|
|
|
// Alle Connections validieren (müssen dem User gehören) — dann in Serie verarbeiten.
|
|
// Serie statt Promise.all: vermeidet Race-Conditions auf consent_logs primary key.
|
|
for (const mailConnectionId of ids) {
|
|
const connection = await getMailConnectionWithConsent(
|
|
mailConnectionId,
|
|
user.id,
|
|
);
|
|
if (!connection) {
|
|
throw createError({
|
|
statusCode: 404,
|
|
data: { error: "connection_not_found", mailConnectionId },
|
|
});
|
|
}
|
|
|
|
// 1. Append-only Audit-Log
|
|
await writeConsentGrant({
|
|
userId: user.id,
|
|
consentType: "art9-mail",
|
|
consentVersion,
|
|
consentAt: now,
|
|
ipAddress,
|
|
userAgent,
|
|
mailConnectionId,
|
|
});
|
|
|
|
// 2. MailConnection-Row updaten
|
|
await setMailConnectionConsent({
|
|
connectionId: mailConnectionId,
|
|
userId: user.id,
|
|
consentAt: now,
|
|
consentVersion,
|
|
consentIpAddress: ipAddress,
|
|
});
|
|
}
|
|
|
|
return { success: true, consentAt: now.toISOString(), updated: ids.length };
|
|
});
|