Website Background
eventnet.ch Logo für Ihre wertvollen Daten

eventnet.ch | Hofenstrasse 20A | 9300 Wittenbach | Telefon 41 71 560 5445 | Email info@eventnet.ch

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:

  1. Stellen Sie sicher, dass der Pfad gesetzt ist, das Verzeichnis existiert und ausserhalb des Webroots liegt.
  2. Klicken Sie auf Master-Key erstellen und bestätigen Sie die Rückfrage.
  3. 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):

  1. Die bestehende Key-Datei am konfigurierten Pfad durch die Server-Administration manuell löschen lassen — das CMS überschreibt sie nicht automatisch.
  2. 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.
  3. Die Passwörter aller SMTP-Profile neu eingeben. Bis dahin können Formulare keine Mails mehr verschicken.
  4. 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

adresse
eventnet.ch
Hofenstrasse 20A
9300 Wittenbach
Telefon +41 71 560 5445
Email info@eventnet.ch

adresse