cat security.md

Sicherheit im Überblick

Diese Seite fasst zusammen, wie wir Oshu hosten, die Mandanten voneinander trennen, Daten verschlüsseln und Backups anlegen. Die vollständigen technischen und organisatorischen Maßnahmen (TOMs) nach Art. 32 DSGVO und den Auftragsverarbeitungsvertrag (AVV) finden angemeldete Kunden unter /settings/legal/toms und /settings/legal/dpa. Die Liste der Unterauftragsverarbeiter bleibt öffentlich, damit sich Änderungen leicht nachprüfen lassen.

Hosting und Standort

  • Anwendung, Datenbank und Backups liegen auf Servern der Hetzner Online GmbH in Deutschland (Nürnberg / Falkenstein). Eine Übermittlung in Drittländer findet nicht statt.
  • Inferenz und OCR laufen über die EU-API der Mistral AI SAS (Paris). Mistral trainiert keine Modelle mit den über die API übermittelten Daten. Seine eigenen Unterauftragsverarbeiter veröffentlicht Mistral unter trust.mistral.ai und stützt Übermittlungen in Länder außerhalb des EWR auf einen Angemessenheitsbeschluss oder die EU-Standardvertragsklauseln. Die Websuche ist standardmäßig aus. Schaltet der Kunde sie für einen Agenten ein, läuft sie über Brave Search in den USA. Im Tarif BYOK gehen die Anfragen über den eigenen Mistral-Schlüssel des Kunden.

Mandantentrennung

  • Die Workspaces sind in Postgres per Row-Level Security (RLS) auf Zeilenebene voneinander getrennt. Die Anwendungsrolle ist NOINHERIT, damit sich RLS nicht umgehen lässt.
  • Jede mandantenbezogene Abfrage läuft in einer Transaktion mit gesetztem app.tenant_id. Es gibt keinen gemeinsamen Cache und keine impliziten Lesezugriffe über Mandantengrenzen hinweg.
  • Administrative, mandantenübergreifende Aktionen werden in einem eigenen Audit-Log protokolliert.

Verschlüsselung

  • TLS 1.2+ für den gesamten externen Datenverkehr (Browser ↔ Anwendung, Anwendung ↔ Mistral, Anwendung ↔ Datenbank).
  • Die eigenen Mistral-Schlüssel der Kunden im Tarif BYOK speichern wir mit AES-256-GCM verschlüsselt. Den Hauptschlüssel erhält die Anwendung über eine Umgebungsvariable; in der Datenbank liegt er nie.
  • Off-Site-Backups werden mit age (X25519) verschlüsselt, bevor sie den Host verlassen. Der private Schlüssel liegt außerhalb der Produktionsumgebung.

Anmeldung und Zugang

  • An den Produktionsservern ist nur die Anmeldung per SSH-Schlüssel möglich. Die Anmeldung per Passwort ist abgeschaltet.
  • Alle administrativen Konten sind per MFA gesichert: beim Hosting-Anbieter, beim Git-Hoster und im Deployment-Panel.
  • Die Anmeldung an der Anwendung läuft über Better Auth, optional mit MFA. Passwörter speichern wir nur als kryptografische Hashwerte. Sitzungs-Cookies werden mit den Attributen HttpOnly, Secure und SameSite gesetzt.
  • Die Widget-Sitzungstokens für den Abruf des Chat-Verlaufs sind HMAC-signiert und laufen nach 7 Tagen ab (auf der Workspace-Seite nach 90 Tagen).

Backups und Wiederherstellung

  • Wir erstellen täglich Backups mit pg_dump, verschlüsseln sie und übertragen sie mit rclone an einen separaten Speicherort.
  • Maximaler Datenverlust (RPO): 24 Stunden. Wiederanlaufzeit (RTO): unter 8 Stunden nach dem vollständigen Verlust des Hosts.
  • Einmal im Quartal spielen wir ein Backup in einer isolierten Umgebung zurück und prüfen so, ob sich die Daten wiederherstellen lassen.

Speicherdauer und Löschung

  • Chat-Protokolle werden nach 12 Monaten automatisch gelöscht. Kunden können ihre Chat-Protokolle außerdem jederzeit selbst löschen.
  • Wird ein Konto gelöscht, entfernen wir den Workspace mit allen zugehörigen Daten. In Backups bleiben gelöschte Datensätze nur bis zum Ende der dokumentierten Aufbewahrungsfrist erhalten.
  • API-Schlüssel, HTTP-Authorization-Header und ähnliche Geheimnisse entfernen wir aus den Logs, bevor diese gespeichert werden.

Widget-Einbindung

Das Chat-Widget wird von https://oshu.eu/widget.js geladen, einem eigenen Endpunkt, der beim selben Betreiber und auf derselben Infrastruktur läuft wie der Rest von Oshu. Es gibt kein CDN eines Drittanbieters, kein Cloudflare, keine Google Fonts und keine Aufrufe an Analysedienste. Zur Laufzeit verbindet sich das Widget nur über TLS mit der Oshu-API und lädt keinen weiteren Code nach.

  • Das Skript wird nur über HTTPS ausgeliefert. Auf oshu.eu ist HSTS aktiv, sodass der Browser Downgrade-Angriffe abweist, bevor er das Skript abruft.
  • Zur Laufzeit lädt das Widget kein externes JavaScript, keine Schriften und keine Stylesheets. Markdown-Darstellung, HTML-Bereinigung und KaTeX sind fest im Widget enthalten. Was ein Kunde einbindet, ist also genau der Code, den wir ausliefern.
  • API-Aufrufe gehen ausschließlich an oshu.eu, denselben Ursprung, von dem auch das Skript stammt (Same Origin). Das Widget lässt sich zur Laufzeit nicht auf ein fremdes Backend umleiten.

Subresource Integrity (SRI)

Der Standard-Einbettungscode verzichtet bewusst auf das Attribut integrity= (SRI). SRI legt die Einbindung auf den Hashwert eines bestimmten Bundles fest; jede andere Datei führt der Browser nicht aus. /widget.js liefert dagegen immer die aktuelle Version aus und erhält laufend Sicherheitskorrekturen und Verbesserungen. Mit einem festen Hashwert müsste jeder Kunde seinen Einbettungscode bei jeder neuen Version anpassen. Ein nicht angepasster Code würde dann für die Besuchenden ausfallen, ohne dass es jemand bemerkt. Beim Standard-Einbettungscode haben schnelle Sicherheitskorrekturen deshalb Vorrang vor dem Festschreiben einzelner Bundles.

An die Stelle von SRI treten andere Schutzmaßnahmen: eigenes Hosting beim selben Betreiber wie die übrige Plattform, TLS mit HSTS, kein Code von Drittanbietern im Widget sowie die oben beschriebene Härtung der Server (Anmeldung nur per SSH-Schlüssel, MFA im Deployment-Panel, verschlüsselte Off-Site-Backups).

Verlangt die Sicherheitsrichtlinie eines Kunden eine Einbindung mit SRI, veröffentlichen wir ein versioniertes Bundle (/widget/v<semver>.js) mit seinem SHA-384-Hashwert. Damit lässt sich die Einbindung festschreiben und im Rhythmus des Kunden auf neue Versionen umstellen. Schreiben Sie dazu an hello@oshu.eu.

Reaktion auf Datenschutzvorfälle

Betroffene Kunden informieren wir ohne schuldhaftes Zögern in Textform, spätestens binnen 48 Stunden nach Kenntnis. Die Meldung enthält mindestens die Angaben nach Art. 33 Abs. 3 DSGVO. Muss der Kunde als Verantwortlicher den Vorfall der Aufsichtsbehörde melden, unterstützen wir ihn dabei, die 72-Stunden-Frist nach Art. 33 DSGVO einzuhalten.


Brauchen Sie ein gesondert gegengezeichnetes Exemplar des AVV oder haben Sie einen Sicherheitsfragebogen für uns? Die vollständigen TOMs finden Sie unter /settings/legal/toms. Für alles andere schreiben Sie an hello@oshu.eu.