Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Demo-Modus: EXP_DEMO_MODE=1 für öffentliche Demonstrationsseiten (6.0.15)

Eine öffentliche Demo von Exponential veröffentlicht ihre Administrator-Anmeldung, damit Besucher die Administration ausprobieren können. Ohne Hilfe geht dann zweierlei schief:

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/bc/6.0/demo-mode.md

On this page

This page is a translation. Read the English original

Demo-Modus: EXP_DEMO_MODE=1 für öffentliche Demonstrationsseiten (6.0.15)

Eine öffentliche Demo von Exponential veröffentlicht ihre Administrator-Anmeldung, damit Besucher die Administration ausprobieren können. Ohne Hilfe geht dann zweierlei schief:

Warnung .htaccess bremst jede Anfrage. Sind .htaccess-Dateien erlaubt (AllowOverride alles außer None), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten: AllowOverride None im virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auch staticcache_offload.conf), setzen Sie AllowOverride None, führen Sie apachectl configtest aus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.

  1. Ein Besucher ändert das Administratorpasswort oder setzt es zurück, und der nächste Besucher kann sich nicht anmelden. Bei einer Demo, die alle paar Stunden neu gebaut wird, ist die Demo damit bis zum nächsten Neubau kaputt; bei einer, die nicht neu gebaut wird, für immer.
  2. Seit 6.0.15 lehnen die Installationsprogramme ein bekanntes Administratorpasswort ab (schwache Passwörter), sodass ein Demo-Installationsprogramm das Passwort, das es veröffentlicht, nicht installieren konnte und es nach der Installation zurücksetzen musste.

Der Demo-Modus löst beides. Er wird durch eine Umgebungsvariable eingeschaltet, nie durch eine Einstellung:

EXP_DEMO_MODE=1

Er ist auf jeder Installation aus, die sie nicht setzt, also auf jeder Installation, die nicht absichtlich als Demo eingerichtet wurde. Dort ändert sich nichts.

Inhalt

  1. Was der Demo-Modus tut
  2. Wer als Administrator gilt
  3. Jeder geschlossene Weg
  4. Die Installationsprogramme akzeptieren das Demo-Passwort
  5. Warum er sich nicht versehentlich einschalten lässt
  6. Einschalten
  7. Banner und Protokoll
  8. Risiken
  9. Das Demo-Installationsprogramm auf dem Demo-Host
  10. Für Entwickler
  11. Kompatibilität
  12. Tests
  13. Wo der Demo-Modus sonst dokumentiert ist

Was der Demo-Modus tut

Solange EXP_DEMO_MODE=1 gilt:

  • Das Passwort eines Administrators kann nicht geändert oder zurückgesetzt werden, auf keinem Weg: die Seite Passwort ändern, das Formular Passwort vergessen? und seine Links, das Benutzerkonto im Bearbeitungsformular, exp:resetuserpassword (auch mit --allow-root-user), die Webdienste und jeder andere Code, der einen Benutzer speichert (siehe Jeder geschlossene Weg). Jede Ablehnung sagt, übersetzt: „Diese Installation ist eine öffentliche Demo: Die Passwörter von Administratoren können nicht geändert oder zurückgesetzt werden.“
  • Jedes andere Konto behält jede Regel: Ein Redakteur oder ein registrierter Besucher ändert sein eigenes Passwort wie gewohnt und setzt es zurück, und neue Passwörter werden weiterhin gegen die Liste bekannter Passwörter geprüft.
  • Die Installationsprogramme akzeptieren das Demo-Passwort: ein bekanntes Administratorpasswort beliebiger Länge, etwa publish oder publishing. Betroffen ist nur das Administratorpasswort einer neuen Installation; ein leeres wird weiterhin abgelehnt (Die Installationsprogramme akzeptieren das Demo-Passwort).
  • Die Administration zeigt auf jeder Seite ein Banner (admin4, admin4l und die klassische Administration): „Demo-Modus. Diese Installation ist eine öffentliche Demo: Jeder kann ihr Administratorpasswort kennen, und Administratorpasswörter können nicht geändert oder zurückgesetzt werden. Geben Sie hier nichts Privates ein.“
  • Jeder Prozess verzeichnet einmal, dass der Demo-Modus eingeschaltet ist: eine Zeile in var/log/security.log und das Audit-Ereignis system.demo.mode (Banner und Protokoll).

Der Demo-Modus macht eine Installation nicht schreibgeschützt, setzt keine Inhalte zurück und schränkt nicht ein, was ein Administrator außer dem Passwort tun darf. Eine Demo, die rückgängig machen muss, was Besucher tun, wird nach Zeitplan neu gebaut (siehe Das Demo-Installationsprogramm auf dem Demo-Host).

Wer als Administrator gilt

Ein Konto gilt als Administrator, wenn seine Rollen ihm uneingeschränkten Zugriff auf jede Funktion jedes Moduls geben: eine Richtlinie für alle Module und alle Funktionen ohne Einschränkung, wie sie die ausgelieferte Rolle Administrator hat. Das umfasst das Konto admin, jedes Konto in Administrator users und jedes Konto, dem eine solche Rolle direkt gegeben wurde.

Ein Konto, dessen Rollen sich nicht lesen lassen (ein Datenbankfehler), gilt bei eingeschaltetem Demo-Modus als Administrator: Ein Fehler öffnet nie das Passwort eines Administrators. Die Prüfung ist expDemoMode::isAdministrator().

Ein Konto mit weitem, aber eingeschränktem Zugriff (ein Redakteur, ein Administrator einer Sektion) ist nicht geschützt. Veröffentlicht eine Demo auch die Anmeldung eines solchen Kontos, geben Sie ihm eine Rolle, deren Übernahme sich nicht lohnt, oder bauen Sie die Demo oft neu.

Jeder geschlossene Weg

WegWas im Demo-Modus geschiehtCode
Passwort ändern (user/password), jedes Designdas Formular sagt, warum, und ändert nichts; in admin und admin4 zeigt die Seite den Grund, bevor etwas eingegeben wirdkernel/private/classes/views/user/password.php
Passwort vergessen? (user/forgotpassword), die Anforderungkein Schlüssel und keine E-Mail für einen Administrator; die Antwort ist dieselbe, die jede Adresse erhält, und die Seite sagt jedem Besucher, dass Administratorpasswörter nicht zurückgesetzt werden können, sodass das Formular nicht verrät, welche Adressen einem Administrator gehörenkernel/private/classes/views/user/forgotpassword.php
Passwort vergessen?, der Linkein Link eines Administrators (verschickt, bevor der Modus eingeschaltet wurde) wird abgelehnt und entferntebenda
Das Benutzerkonto in content/edit (auch das eigene Profil)ein neues Passwort für einen Administrator ist ein Validierungsfehler mit dem Grund; die anderen Felder lassen sich weiterhin ändernkernel/classes/datatypes/ezuser/ezusertype.php
exp:resetuserpassword / bin/php/resetuserpassword.phpmit dem Grund und Exit-Code 1 abgelehnt, auch mit --allow-root-userkernel/private/classes/commands/resetuserpassword.php
Webdienste: expaccount.reset, expaccount.changePassword, expuser.setPasswordHTTP 403 mit dem Grundextension/expservices/classes/users/expusersbase.php
Webdienste: expaccount.forgotRequestkein Schlüssel und keine E-Mail für einen Administrator; dieselbe Antwort wie für jede Adresseextension/expservices/classes/users/expaccountservices.php
Die Operationen user/password und user/forgotpassword (Workflows, Erweiterungen)Status false mit dem Grund demo_modekernel/user/ezuseroperationcollection.php
Alles andere, was einen Benutzer speichert: ein Import aus CSV oder einem Paket, eine Erweiterung, ein SkripteZUser::store() behält das gespeicherte Passwort eines Administrators und speichert alles andere; die Ablehnung wird verzeichnetkernel/classes/datatypes/ezuser/ezuser.php, expDemoMode::guardStore()

Jede Ablehnung wird im Audit-Protokoll als access.user.password.change.failed oder access.user.password.reset.failed mit dem Grund demo_mode und dem Weg verzeichnet (audit.md), und als Warnung in der Debug-Ausgabe.

Nicht betroffen: die Anmeldung (ein vorhandenes Passwort wird nie abgelehnt) und das Hash-Upgrade bei der Anmeldung ([UserSettings] UpdateHash), das dasselbe Passwort mit einem neueren Verfahren speichert.

Die Installationsprogramme akzeptieren das Demo-Passwort

Jedes Installationsprogramm fragt dieselben Funktionen, ob ein Administratorpasswort installiert werden darf: eZStepSiteAdmin::isWeakDefaultPassword() (die Liste bekannter Passwörter) und eZStepSiteAdmin::isTooShortAdminPassword() ([UserSettings] MinPasswordLength, im Auslieferungszustand 10). Das sind der Setup-Assistent, der Kickstarter (kickstart.ini), exp:install (bin/php/install.php) und jedes darauf aufgebaute Demo-Installationsprogramm. Im Demo-Modus akzeptieren beide das Demo-Passwort. Genau:

  • Gelockert: die Prüfung gegen die Liste bekannter Passwörter (expWeakPasswordList, mit ihren Varianten) und die Mindestlänge, nur für das Administratorpasswort einer neuen Installation. Die Installation speichert es innerhalb von expDemoMode::installing() und expDemoMode::settingInstallationAdministratorPassword(); nur dort lässt eZUser::validatePassword() ein Passwort durch, das kürzer als MinPasswordLength ist.
  • Nicht gelockert: Ein leeres Passwort wird weiterhin abgelehnt (der Kickstarter und exp:install erzeugen eines, der Assistent fragt erneut); jedes andere Konto, das die Installation anlegt, jedes nach der Installation gesetzte Passwort und jedes Formular (user/password, Registrierung, das Formular zur Benutzerbearbeitung, die Konsole, die Webdienste) behalten MinPasswordLength, die Regeln aus [PasswordSettings] und die Liste bekannter Passwörter.

Eine Demo kann also publish (sieben Zeichen, der Klassiker) oder publishing unverändert installieren, mit den ausgelieferten Einstellungen.

Der Setup-Assistent sagt auf seiner Seite für den Administrator, dass der Demo-Modus eingeschaltet ist und was das bedeutet. Das Speichern des Administratorpassworts durch die Installation geht durch den Speicherschutz, weil es innerhalb von expDemoMode::installing() läuft.

Warum er sich nicht versehentlich einschalten lässt

  • Nur über die Umgebung. Es gibt dafür keine INI-Einstellung, keinen Anfrageparameter, kein Cookie und keine Seite in der Administration. Eine von einer Demo kopierte Einstellungsdatei, eine daraus wiederhergestellte Datenbank, ein Paket oder eine präparierte Anfrage können ihn nicht einschalten. Ein HTTP-Header kommt als HTTP_EXP_DEMO_MODE an und wird nie gelesen.
  • Nur der exakte Wert 1. 0, true, yes, on, ein leerer Wert und alles andere lassen ihn aus.
  • Bei jedem Aufruf gelesen. Nichts wird gecacht, sodass ein persistenter Worker (Exponential Velocity, FrankenPHP) für die Umgebung antwortet, die er gerade hat, und ein kompiliertes Template bei jeder Ausführung erneut fragt.
  • Sichtbar. Das Banner auf jeder Seite der Administration, der Hinweis im Setup-Assistenten, die Warnung auf der Konsole (Demo mode is on (EXP_DEMO_MODE=1) ... auf der Standardfehlerausgabe) und die Log-Zeile jedes Prozesses.

Der Wert wird zuerst mit getenv() gelesen (die Umgebung des Prozesses; unter PHP-FPM auch die FastCGI-Parameter), dann aus $_SERVER (Apache SetEnv mit mod_php und ähnlichen SAPIs). Ein Wert in der Umgebung des Prozesses gewinnt: EXP_DEMO_MODE=0 dort hält den Modus aus, egal was $_SERVER sagt.

Einschalten

Setzen Sie die Variable für jeden Prozess der Demo: das PHP des Webservers, Exponential Velocity, wenn er die Website ausliefert, die Cronjobs und jeden Konsolenbefehl. Ein Prozess ohne sie läuft mit ausgeschaltetem Demo-Modus.

Wo PHP läuftWie
PHP-FPMim Pool der Demo: env[EXP_DEMO_MODE] = 1 (ein Pool mit clear_env = no übergibt auch die Umgebung des Masters)
Apache mit mod_php oder mit Weiterleitung an PHP-FPMSetEnv EXP_DEMO_MODE 1 im virtuellen Host der Demo (mit PHP-FPM über mod_proxy_fcgi erreicht es PHP als FastCGI-Parameter)
Exponential Velocityexport EXP_DEMO_MODE=1 in den eigenen Site-envvars der Demo, /etc/vc/sites-available/<site>.envvars (<site> ist der Name, den ./console exp:velocity layout ausgibt). exp:velocity start liest die Datei nur für den Server dieser Installation, sodass Neustarts und Deploys aus jeder Shell sie behalten. Die Umgebung des Prozesses, der den Server dieser Installation startet, funktioniert ebenfalls (Environment=EXP_DEMO_MODE=1 in seiner eigenen systemd-Unit oder einem Drop-in). Nie /etc/vc/envvars: Der Server jeder Installation auf dem Host liest diese Datei, und ein Velocity-Worker lehnt einen Wert für den Demo-Modus ab, der von dort kommt (Velocity: nur eine Installation)
FrankenPHP, RoadRunnerin der Umgebung des Serverprozesses
Cronjobs und Konsolenbefehlein der Crontab (EXP_DEMO_MODE=1 auf einer eigenen Zeile oben) und in der Shell dessen, der Befehle ausführt
Ein ContainerENV EXP_DEMO_MODE=1 im Demo-Image oder -e EXP_DEMO_MODE=1 / environment: nur für den Demo-Dienst

Prüfen Sie es: Das Banner erscheint in der Administration, und grep 'demo/mode' var/log/security.log führt die Prozesse auf, die damit gestartet sind.

Velocity und Neustarts. Setzen Sie die Variable in die Site-envvars der Demo, neben ihre Site-Datei:

# /etc/vc/sites-available/<site>.envvars   (<site>: siehe ./console exp:velocity layout)
export EXP_DEMO_MODE=1

exp:velocity start liest diese Datei bei jedem Start des Servers dieser Installation und übergibt, was sie setzt, nur diesem Server, sodass exp:velocity restart und exp:velocity deploy den Demo-Modus eingeschaltet lassen, gleich welche Shell sie ausführt. ./console exp:velocity layout führt die gesetzten Namen in der Zeile site envvars auf. Eine Variable, die bereits in der Umgebung gesetzt ist, die den Server startet, wird von der Site-Datei überschrieben. Um den Demo-Modus zu beenden, entfernen Sie die Zeile und starten Velocity neu. Die Datei wird gelesen, nie ausgeführt, nach denselben Regeln wie envvars: ein NAME=value pro Zeile, und sie kann PATH, LD_*, DYLD_*, MALLOC_*, HTTP_*, PHPRC, PHP_INI_SCAN_DIR, GLIBC_TUNABLES, HOME, USER und die anderen Variablen von Loader und Shell nicht setzen (expVelocityConfigLayout::ENV_DENIED, dieselbe Liste wie die der Engine). Ein Neustart mit dem eigenen qbixctl der Engine statt mit exp:velocity liest die Site-Datei nicht: Der Demo-Modus ist dann bis zum nächsten exp:velocity restart ausgeschaltet (aus ist die sichere Richtung: Die Website funktioniert, nur könnten Besucher das Passwort ändern).

Velocity: nur eine Installation

Die gemeinsame Datei /etc/vc/envvars (oder /etc/qbix/envvars) liest der Velocity-Server jeder Installation auf dem Host, so wie jeder virtuelle Host /etc/apache2/envvars liest. Ein dort gesetzter Demo-Modus würde ihn auch für Produktivsites einschalten, deren Administratoren dann kein Passwort mehr ändern könnten. Deshalb gilt seit diesem Release:

  • exp:velocity start übergibt EXP_DEMO_MODE nie aus den gemeinsamen envvars (expVelocityConfigLayout::SITE_ONLY_ENV);
  • ein Velocity-Worker lehnt einen Wert ab, den die Engine selbst aus einer envvars-Datei eines Konfigurationsverzeichnisses außerhalb der Installation exportiert hat (expDemoMode::isSharedEnvvarsValue(), das den eigenen Eintrag Q_WebServer_Layout::$exported der Engine und die von ihr gelesenen Verzeichnisse auswertet). Der Demo-Modus bleibt ausgeschaltet, und der Worker verzeichnet einmal pro Prozess in var/log/security.log und als Debug-Warnung: demo/refused pid=... EXP_DEMO_MODE=1 came from an envvars file other installations share ...;
  • ein Konfigurationsbaum innerhalb der Installation (var/vc/qbix/etc, von einem Konto ohne root verwendet) gehört allein dieser Installation, und seine envvars werden wie bisher übernommen.

Eine Installation, die mit einem früheren Release über /etc/vc/envvars mit eingeschaltetem Demo-Modus gestartet wurde, hat ihn nach dem Neustart des Updates ausgeschaltet, bis die Zeile in die Site-envvars verschoben ist. Verschieben Sie sie vor dem Neustart: grep EXP_DEMO_MODE /etc/vc/envvars, dann tragen Sie sie nur in /etc/vc/sites-available/<site>.envvars der Demo ein und entfernen sie aus der gemeinsamen Datei.

PHP-FPM, Apache, LiteSpeed, FrankenPHP und die Konsole sind nicht betroffen: Jeder Pool, jeder virtuelle Host und jeder Prozess hat bereits seine eigene Umgebung.

Nie auf einer Website, die keine Demo ist. Eine Site-envvars-Datei gehört zu einer Installation; kopieren Sie die einer Demo nie auf eine andere Website.

Setzen Sie sie nie in einem gemeinsam genutzten PHP-FPM-Pool, einem serverweiten SetEnv, einem globalen /etc/environment, einem Basis-Image für Container oder einer Deploy-Vorlage, die für andere Websites verwendet wird.

  • Banner: design/admin4/templates/parts/exp_demo_mode_banner.tpl (admin4, und admin4l über seinen Rückfall) und dieselbe Datei in design/admin (die klassische Administration, und admin3 über seinen Rückfall). admin4 zeichnet es oben im Hauptbereich (page_mainarea.tpl, unter dem festen Kopf), admin4l außerdem vor der Hauptzone eines Admin-Layouts, admin3 als eigenes Design oben in seinem eigenen Hauptbereich (design/admin3/templates/page_mainarea.tpl), die klassische Administration unter ihrem Kopf; immer außerhalb der Cache-Blöcke, sodass es der Umgebung jeder Anfrage folgt. Es verwendet die gemeinsame Komponente .a4-notice.is-warn aus components.css (Tokens mit hellen und dunklen Werten; kein eigenes CSS). Der Template-Operator exp_demo_mode() gibt zurück, ob der Modus eingeschaltet ist; ein eigenes Design kann das Banner mit {include uri='design:parts/exp_demo_mode_banner.tpl'} anzeigen.

  • Protokoll: Zu Beginn der ersten Webanfrage (ezpKernelWeb::requestInit()) und jedes Skripts (eZScript::initialize()) schreibt jeder Prozess eine Zeile in var/log/security.log, im Format der Zeilen des Anfrage-Klassifizierers, sodass Setup > Logdateien sie als demo/mode gruppiert:

    [ Oct 19 2026 18:00:00 ] [203.0.x.x] demo/mode on pid=4711 sapi=fpm-fcgi EXP_DEMO_MODE=1: administrator passwords cannot be changed or reset, the installers accept a well-known administrator password; never use it in production

    und verzeichnet das Audit-Ereignis system.demo.mode (Schweregrad warning, Kanal system, immer eingeschaltet). Ein geforkter Worker hat seine eigene PID und verzeichnet es erneut; ein persistenter Worker verzeichnet es einmal. Ein Webprozess, der jede Anfrage neu beginnt (PHP-FPM, mod_php, LiteSpeed, der eingebaute Server von PHP), legt je Prozess eine leere Markierungsdatei im Cache-Verzeichnis an (<cache>/demo-mode/<pid>-<start time>) und verzeichnet es so ebenfalls einmal statt bei jeder Anfrage; nach dem Leeren der Caches verzeichnen die laufenden Prozesse es erneut. Ein Konsolenbefehl meldet außerdem Demo mode is on (EXP_DEMO_MODE=1) ... auf der Standardfehlerausgabe.

Auf einer Produktivsite bedeutet ein Ereignis system.demo.mode oder eine Zeile demo/mode, dass die Variable einen Prozess erreicht hat, den sie nicht hätte erreichen dürfen: Entfernen Sie sie sofort und prüfen Sie, wer die Umgebung des Servers geändert hat.

Risiken

  • Der Demo-Modus sagt allen, dass das Administratorpasswort bekannt ist. Betreiben Sie ihn nur auf einer Installation, deren Inhalte, Benutzer und Einstellungen alle wegwerfbar sind: keine echten Kundendaten, keine echten E-Mail-Adressen, keine Geheimnisse in Einstellungen, keine Verbindung zu anderen Systemen.
  • Administratoren behalten jede andere Befugnis. Ein als Administrator angemeldeter Besucher kann Konten anlegen, Rollen ändern, Einstellungen in der Administration bearbeiten, Pakete installieren und Dateien hochladen. Der Demo-Modus schränkt das nicht ein. Bauen Sie die Demo nach Zeitplan neu, halten Sie sie auf einem eigenen Host oder Konto und geben Sie ihr keine Zugangsdaten, die anderswo funktionieren.
  • Ein bekanntes Passwort wird installiert. Das ist der Zweck und der Grund, warum der Modus nie eine echte Website erreichen darf.
  • E-Mail. Besucher können E-Mails auslösen (Registrierung, Benachrichtigungen). Senden Sie die E-Mails der Demo in eine Datei oder eine Senke, nie an echte Adressen.
  • Eine verlorene Variable schaltet ihn stillschweigend aus. Ein Neustart ohne die Variable betreibt die Demo mit ausgeschaltetem Demo-Modus: Besucher können das Administratorpasswort dann wieder ändern. Setzen Sie sie dort, wo sie Neustarts überdauert, und achten Sie auf das Banner.
  • Nur Administratoren sind geschützt. Andere veröffentlichte Anmeldungen (Redakteur, Mitglied) kann weiterhin ändern, wer sie verwendet.
  • Eine gemeinsame Umgebung erreicht jede Website darin. Ein serverweites SetEnv, ein gemeinsam genutzter PHP-FPM-Pool, /etc/environment, ein Basis-Image für Container oder die Shell eines Betreibers, der die Variable exportiert hat, schaltet den Demo-Modus für jede Installation ein, die diese Umgebung erreicht; deren Administratoren können dann ein kompromittiertes Passwort nicht mehr ändern. Für Velocity lehnt der Kernel die gemeinsame /etc/vc/envvars selbst ab (Velocity: nur eine Installation); für die anderen setzen Sie sie nur pro Installation. Führen Sie exp:velocity start, exp:install oder den Kickstarter für eine andere Website nie aus einer Shell aus, die die Variable hat.

Das Demo-Installationsprogramm auf dem Demo-Host

Die öffentliche Demo wird alle zwei Stunden aus dem aktuellen Code neu gebaut, von einem Skript, das exp:install mit SQLite ausführt und die neue Website einwechselt. Mit dem Demo-Modus sollte es die Variable zweimal setzen:

  1. Für die Installation, sodass exp:install das veröffentlichte Demo-Passwort unverändert installiert, statt es durch ein zufälliges zu ersetzen und danach zurückzusetzen:

    EXP_DEMO_MODE=1 php bin/php/install.php --apply --db=sqlite --password='<the published demo password>' ...

    Der Schritt zum Zurücksetzen nach der Installation (exp:resetuserpassword) wird dann nicht mehr gebraucht und im Demo-Modus ohnehin abgelehnt. Jedes nicht leere Passwort funktioniert, auch das siebenstellige publish.

  2. Für die laufende Website, in der Umgebung des PHP der Demo (ihr PHP-FPM-Pool, die Umgebung von lsphp unter LiteSpeed oder das SetEnv des virtuellen Hosts) und in der Crontab des Benutzers der Demo, sodass das Banner erscheint und das Administratorpasswort zwischen zwei Neubauten nicht geändert werden kann. Der Preloader, der nach dem Einwechseln läuft (bin/php/preload.php), braucht keine Variable.

Die Variable gehört nur zum eigenen Benutzer und virtuellen Host der Demo. Das Skript darf sie nicht in config.php, settings/ oder irgendetwas anderes schreiben, das auf andere Websites kopiert wird.

So läuft die immer aktuelle Demo des Projekts seit dem 19. Oktober 2026, unter LiteSpeed mit lsphp: Ihr Build-Skript exportiert EXP_DEMO_MODE=1 für jeden Schritt, exp:install übernimmt das veröffentlichte Passwort wie angegeben, ein generiertes Passwort lässt den Build fehlschlagen (der alte Schritt zum Zurücksetzen ist entfernt), und die .htaccess jedes Builds erhält SetEnv EXP_DEMO_MODE 1; security.log zeigt demo/mode on ... sapi=litespeed, und die Seiten zur Anmeldung und für vergessene Passwörter zeigen den Hinweis. Die allgemeine Form: Rezept: eine öffentliche Demo unter LiteSpeed und Plesk betreiben und install-demo-sqlite.sh.

Für Entwickler

  • expDemoMode::enabled(): Der Modus ist eingeschaltet (EXP_DEMO_MODE ist genau 1); bei jedem Aufruf gelesen.
  • expDemoMode::protectsPassword( $user ): Der Modus ist eingeschaltet, und das Konto (ein eZUser oder eine ID eines Inhaltsobjekts) ist ein Administrator. Fragen Sie es, bevor Sie ein Passwort ändern, und zeigen Sie expDemoMode::refusalText().
  • expDemoMode::refused( $user, $path, $event ): verzeichnet eine Ablehnung (Audit-Protokoll und Debug-Ausgabe).
  • expDemoMode::installing( $callable ): führt die Arbeit eines Installationsprogramms aus, die das Administratorpasswort setzt; der Speicherschutz lässt sie durch. Der Geltungsbereich endet mit dem Aufruf, auch bei einer Ausnahme. Ein eigenes Installationsprogramm, das das Administratorpasswort nach den Schritten des Kernels setzt, muss es verwenden, sonst wird seine Änderung im Demo-Modus abgelehnt.
  • expDemoMode::guardStore( $user ): von eZUser::store() aufgerufen; behält das gespeicherte Passwort eines Administrators, solange der Modus eingeschaltet ist. Code, der ezuser.password_hash mit eigenem SQL schreibt, umgeht das: Tun Sie das nicht.
  • Der Template-Operator exp_demo_mode() (expDemoModeOperator).
  • Prüfen Sie den Modus mit class_exists( 'expDemoMode' ) && expDemoMode::enabled() in Code, der in einem persistenten Worker laufen kann, der gestartet wurde, bevor die Klasse existierte.

Kompatibilität

  • Ohne EXP_DEMO_MODE=1 ändert sich nichts: keine Einstellung, keine Datenbankänderung, kein neuer Standard.
  • Neue Klassen: expDemoMode (kernel/classes/expdemomode.php), expDemoModeOperator (kernel/common/expdemomodeoperator.php); erzeugen Sie die Autoloads des Kernels neu, wenn Sie durch Kopieren von Dateien aktualisieren. Exponential Velocity lädt Klassen beim Start: Führen Sie nach dem Update exp:velocity deploy --kernel aus (oder starten Sie es neu).
  • Neues Audit-Ereignis system.demo.mode; die vorhandenen Ereignisse access.user.password.change.failed und access.user.password.reset.failed können den Grund demo_mode haben.
  • Neue Template-Variablen (alle optional, sodass ein älteres Design weiterhin rendert): demo_mode_locked und demo_mode_text in user/password.tpl, demo_mode_text und demo_mode_refused in user/forgotpassword.tpl, demo_mode in setup/init/site_admin.tpl.
  • Die Operationen user/password und user/forgotpassword können status => false mit reason => demo_mode zurückgeben.
  • Die Webdienste können für eine Änderung oder ein Zurücksetzen des Passworts eines Administrators mit HTTP 403 antworten.
  • Exponential Velocity: EXP_DEMO_MODE in der gemeinsamen /etc/vc/envvars schaltet den Demo-Modus nicht mehr ein (früher galt das für jede Installation auf dem Host); verwenden Sie die Site-envvars /etc/vc/sites-available/<site>.envvars, die exp:velocity start liest, oder die Umgebung, die den Server dieser Installation startet. exp:velocity layout zeigt die Zeile site envvars.
  • Neues Template design/admin3/templates/page_mainarea.tpl (das Banner für admin3 als eigenes Design): Leeren Sie nach einem Update durch Kopieren von Dateien den Cache der Template-Overrides.

Tests

  • tests/tests/kernel/classes/user/expDemoModeTest.php (ohne Datenbank): die Regeln für den Wert, getenv vor $_SERVER und nie die Anfrage, kein Caching, wer Administrator ist, die Entscheidung des Speicherschutzes, der Geltungsbereich von installing(), die Lockerung der Installationsprogramme und ihre Grenzen, die Aufzeichnung einmal pro Prozess, der Template-Operator, das Banner (ein Teil-Template, gemeinsame Komponente, kein Inline-CSS, außerhalb jedes Cache-Blocks der drei Pagelayouts), jeder Weg zum Passwort, der Audit-Katalog und die Kataloge.
  • expAuditRecordTest zählt das neue Audit-Ereignis.

Wo der Demo-Modus sonst dokumentiert ist

Jede Seite unten sagt, was sie über den Demo-Modus sagen muss, und verlinkt hierher zurück.

Verwandte Seiten

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x