KFZ-Bozo Handbuch

Daten, Datenschutz & Sicherheit › Verschlüsselter Secret-Store

Verschlüsselter Secret-Store

SicherheitLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)

Zugangsschlüssel, die im Büro-Panel eingetragen werden — heute für den SMS-Versand und für die Kalkulations-Schnittstelle —, liegen verschlüsselt in einer eigenen Ablage und bewusst nicht in der normalen Einstellungstabelle, die jedes angemeldete Verwaltungskonto im Klartext lesen könnte. Zurück gibt die Oberfläche nur, ob ein Schlüssel hinterlegt ist. Wichtig: Wird das Grundgeheimnis des Systems gewechselt, sind alle hinterlegten Schlüssel unlesbar und müssen neu eingegeben werden.

ChefSystem

Bild folgt

Trägt jemand im Büro-Panel einen Zugangsschlüssel ein, wandert er nicht in die allgemeine Einstellungstabelle. Der Grund ist einfach: Diese Tabelle wird im Ganzen und im Klartext an jedes angemeldete Verwaltungskonto ausgeliefert, ein Zugangsschlüssel hat dort nichts verloren. Stattdessen verschlüsselt das System den Wert mit einem starken, geprüften Verfahren und legt nur das Ergebnis ab. Der dafür nötige Schlüssel wird bei Bedarf aus einem Grundgeheimnis des Betriebs abgeleitet und steht selbst nie in der Datenbank. Zurück an die Oberfläche geht nie der Klartext, sondern nur die Auskunft, ob etwas hinterlegt ist. Fehlt das Grundgeheimnis, meldet sich die Ablage als nicht einsatzbereit, und die betroffene Anbindung — heute der SMS-Gateway und die Zugangsdaten der Kalkulations-Schnittstelle — behandelt sich als nicht konfiguriert, statt still ins Leere zu senden. Der eingehende Rückkanal des SMS-Wegs prüft das ebenfalls und weist Anfragen ab, solange nichts hinterlegt ist. Wird das Grundgeheimnis später gewechselt, lassen sich die alten Werte nicht mehr entschlüsseln; das ist eine bewusste Entscheidung und keine Störung.

  • Ein Dienst meldet plötzlich „nicht konfiguriert", obwohl der Schlüssel eingetragen war → das Grundgeheimnis wurde gewechselt; die Schlüssel einmal neu eintragen.
  • Die Oberfläche zeigt den hinterlegten Schlüssel nicht an → das ist gewollt; ausgegeben wird nur, ob etwas gespeichert ist.
  • Ein Schlüssel lässt sich gar nicht speichern → im Betrieb fehlt das Grundgeheimnis; ohne dieses ist die Ablage abgeschaltet.

Schützt

Geregelt durch

SchütztGeregelt dur…Verschlüss…SMS-GatewayDSGVO / Datens…
  • Ob in Produktion ein eigenes Grundgeheimnis für die Ablage gesetzt ist oder der Rückfall auf das Sitzungsgeheimnis genutzt wird, sagen die gelesenen Quellen nicht. Beides funktioniert, aber nur im ersten Fall lässt sich das Sitzungsgeheimnis wechseln, ohne die Schlüssel zu verlieren.
  • Es gibt keinen Weg, hinterlegte Schlüssel zu exportieren oder umzuschlüsseln. Ein geplanter Wechsel des Grundgeheimnisses bedeutet deshalb heute - alle Schlüssel neu eintragen.
  • MEM:sms-gateway-feature.md
  • app/api/admin/sms/route.ts
verfahrenAES-256-GCM
schluesselableitungHKDF aus SECRET_STORE_KEY bzw. ADMIN_SESSION_SECRET
mechanismusWerte werden mit AES-256-GCM verschluesselt in einer eigenen Tabelle abgelegt; der 32-Byte-Schluessel wird per HKDF-SHA256 aus einem Grundgeheimnis abgeleitet und liegt nie in der Datenbank; die Oberflaeche bekommt nur ein configured-Kennzeichen oder einen maskierten Hinweis zurueck, nie den Klartext
ohne_grundgeheimnisDer Store meldet sich als nicht konfiguriert; die betroffene Anbindung schaltet sich ab, statt still ins Leere zu senden

Beleg: MEM:sms-gateway-feature.md: 'ADMIN_SESSION_SECRET ist gesetzt (Secret-Store einsatzbereit)'; AES-256-GCM mit HKDF-SHA256-Ableitung, Format base64(iv12||tag16||ciphertext), Rueckfall auf das Sitzungs-Grundgeheimnis, Mindestlaenge 16 Zeichen; Nutzer: app/api/admin/sms/route.ts und app/api/admin/silverdat/settings/route.ts, Pruefung in app/api/sms/webhook/route.ts (503 wenn nicht konfiguriert) [Quelle(n) wegen Hausregel entfernt: lib/crypto/secret-store.ts (Pfad enthält "secret")]

Daten, Datenschutz & SicherheitSeite bearbeiten: wiki/seiten/daten-recht-sicherheit/sec-secret-store.md