Master-Key
Der Master-Key ist ein zentrales Sicherheits-Element des CMS. Es ist ein langer Zufallswert, mit dem das CMS:
- Vorschau-Links signiert — das verhindert, dass jemand einen Vorschau-Link manipuliert.
- Die Passwörter der SMTP-Profile und den Zugang des KI-Assistenten verschlüsselt.
Ohne Master-Key funktioniert der Schutz CMS-Vorschau-Link nicht; die übrigen Vorschau-Schutz-Mechanismen sind davon nicht betroffen.
Wo liegt der Key?
In einer Datei ausserhalb der CMS-Webroot. Der genaue Speicherort steht in den Einstellungen unter Webtool → Allgemein im Feld für den Master-Key-Pfad (Schlüssel masterKeyPfad).
Wichtig: Der Key liegt nicht in der CMS-Datenbank. Das hat zwei Gründe:
- Ein Database-Dump enthält den Key nicht versehentlich.
- Der Filesystem-Pfad kann pro Server (z.B. Produktion, Staging) anders sein.
Den Master-Key erstellen
Unter Busapp Einstellungen → Webtool → Allgemein finden Sie beim Master-Key-Pfad die Knöpfe Master-Key erstellen und Master-Key testen. Vor dem Erstellen:
- Stellen Sie sicher, dass der Pfad gesetzt ist, das Verzeichnis existiert und ausserhalb des Webroots liegt.
- Klicken Sie auf Master-Key erstellen und bestätigen Sie die Rückfrage.
- Das CMS erzeugt einen kryptographisch sicheren Zufallswert und legt die Datei am konfigurierten Pfad an.
Beim Klick gibt es drei mögliche Ergebnisse:
- Erstellt — Datei wurde neu angelegt, alles in Ordnung.
- Bereits vorhanden — Datei existierte bereits, sie wird nicht überschrieben (Schutz gegen versehentliches Verlieren des bestehenden Keys).
- Fehler — Pfad nicht konfiguriert oder Datei nicht erstellbar.
Fehlt die Datei, legt das CMS sie beim nächsten Zugriff auf den Key auch von selbst an.
Den Master-Key testen
Über Master-Key testen prüft das CMS, ob der Key vorhanden ist und ob Verschlüsseln und Signieren damit funktionieren.
Master-Key erneuern
Achtung: Ein neuer Key macht alles unbrauchbar, was mit dem alten verschlüsselt wurde. Klären Sie das vorher mit Ihrem Ansprechpartner.
Wenn Sie einen neuen Master-Key brauchen (z.B. Sicherheits-Audit, Verdacht auf Kompromittierung):
- Die bestehende Key-Datei am konfigurierten Pfad durch die Server-Administration manuell löschen lassen — das CMS überschreibt sie nicht automatisch.
- Im Feld für den Master-Key-Pfad auf Master-Key erstellen klicken. Meldet das CMS «Bereits vorhanden», wurde der neue Key inzwischen automatisch angelegt.
- Die Passwörter aller SMTP-Profile neu eingeben. Bis dahin können Formulare keine Mails mehr verschicken.
- Konsequenz für die Vorschau: alle bestehenden Vorschau-Links und Vorschau-Sitzungen sind sofort ungültig.
Backup
Der Master-Key gehört ins Backup-System Ihres Servers. Geht er verloren, sind die aktuellen Vorschau-Links ungültig und vor allem die verschlüsselten SMTP-Passwörter und der KI-Zugang nicht mehr lesbar.
Sicherheit
- Behandeln Sie die Key-Datei vertraulich.
- Den Key niemals in Logfiles oder Code-Kommentare aufnehmen.
- Bei Server-Wechsel: Key mit umziehen; ein neuer Key bedeutet, die SMTP-Passwörter neu einzugeben.
Zurück zu: Busapp Einstellungen
