Für wen und wozu diese Empfehlungen
Die Empfehlungen richten sich an den Systemadministrator auf Seiten des Anbieters oder des Werks, der die Demo-Instanz vor der Vorführung für die Geschäftsleitung vorbereitet. Ein Fehler in dieser Phase ist imagemäßig teuer: Eine E-Mail mit einem SOS-Alarm, die bei einem echten Mitarbeitenden oder Vorgesetzten ankommt, zerstört das Vertrauen schneller als eine Störung.
Das System sendet Push- und E-Mail-Benachrichtigungen, und Ereignisse können einen externen Webhook auslösen. Da die Vorführung Alarme simuliert, muss jedes Konto, das am Szenario teilnimmt, von der Außenwelt abgeschottet sein.
Empfehlung 1: Adressen in einer für Tests reservierten Domäne
Demokonten sollten Adressen in einer für Tests reservierten Domäne haben, etwa example.invalid. Eine solche Domäne ist nie einem realen Postfach zugeordnet, daher erreicht eine E-Mail aus der Vorführung niemanden, selbst wenn sie versendet wird.
Verwenden Sie keine Firmenadressen von Mitarbeitenden und keine privaten Adressen. Es kommt vor, dass der Vorbereitende aus Bequemlichkeit seine eigene Adresse einträgt und sie dann vor der Vorführung beim Kundentermin vergisst.
Beispielhafter Satz von Konten in der Vorführung
Empfehlung 2: Rollen passend zum Szenario
Bereiten Sie nur so viele Konten vor, wie Rollen im Szenario vorkommen. Ein typischer Satz ist das Konto eines Mitarbeitenden, dessen Uhr SOS oder Stillstand auslöst, das Konto der Person, die die Freigabe erteilt, und das Konto der Disposition, die die Karte beobachtet.
Benennen Sie jedes Konto so, dass der Vortragende nicht überlegen muss, mit welchem er sich anmeldet. Gattungsbezeichnungen genügen: Hallenmitarbeiter, Freigebender, Disposition.
- Mitarbeiter mit Uhr oder App: Quelle von SOS und Stillstand,
- Freigebender: erstellt die Arbeit im Assistenten,
- Disposition: beobachtet die isometrische Karte und die Alarme,
- Besucher: nur, wenn das Szenario die Anmeldung am Kiosk umfasst.
Empfehlung 3: Passwort als Variable, nicht als Datei
Bewahren Sie das Passwort der Demokonten als CI/CD-Variable auf, nicht im Repository und nicht in einer Konfigurationsdatei. So gelangt das Passwort nicht in die Historie des Codes, und es lässt sich ohne Änderung des Repositorys wechseln.
Diese Regel gilt auch für Konten, die nur einige Stunden bestehen. Ein provisorisches Passwort in einer Textdatei wird später oft in weitere Umgebungen kopiert.
Empfehlung 4: Sicherung der Datenbank vor der Änderung und Kennzeichnung der Daten
Vor einer Änderung der Daten auf der Demo-Instanz erstellen Sie eine Sicherung der Datenbank: einen mit gzip gepackten Export und die Prüfung seiner Größe. Eine leere oder auffällig kleine Datei bedeutet, dass die Sicherung fehlgeschlagen ist und nicht als Schutz gelten darf.
Kennzeichnen Sie Standorte und Sender der Vorführung mit einer externen Kennung. Dann löschen Sie nach der Vorführung nur die eigenen Daten, und die Marker der beendeten Vorführung entfernen Sie nur für die Demokonten.
So prüfen Sie die Bereitschaft der Konten
Melden Sie sich vor dem Termin mit jedem Konto an, lösen Sie ein Ereignis aus und prüfen Sie, dass es auf der Karte erscheint. Stellen Sie außerdem sicher, dass keine Nachricht die Umgebung verlassen hat: Die Testpostfächer existieren nicht, daher besteht die Kontrolle im Durchsehen der Versandprotokolle und nicht im Posteingang.
Notieren Sie, welche Konten verwendet wurden. Nach der Vorführung wechseln Sie das Passwort und löschen die mit einer externen Kennung markierten Demodaten gemäß dem Verfahren zum Beenden der Vorführung.
Videomaterial
Häufig gestellte Fragen
Warum die Domäne example.invalid?
Sie ist für Tests reserviert und verweist nie auf ein reales Postfach, daher erreichen Benachrichtigungen aus der Vorführung niemanden.
Wo bewahrt man das Passwort der Demokonten auf?
In der CI/CD-Variable, nicht im Repository und nicht in einer Konfigurationsdatei. Nach der Vorführung sollte das Passwort gewechselt werden.
Ist eine Sicherung der Datenbank für die Demo-Instanz nötig?
Ja. Vor einer Änderung der Daten wird ein mit gzip gepackter Export erstellt und seine Größe geprüft, damit man zum Ausgangszustand zurückkehren kann.
Sichere Vorführung ohne Risiko für Menschen
Wir bereiten die Demo-Instanz und die Testkonten vor, damit Sie das System der Geschäftsleitung zeigen können, ohne Benachrichtigungen an reale Personen zu senden.
Sprechen wir