Beschreibbare Verzeichnisse und Berechtigungen
Diese Seite ist für Systemadministratoren und Support-Mitarbeitende bei einem Hosting-Anbieter. Sie beantwortet: was eine Exponential-Installation schreiben können muss, welchem Benutzer sie gehören sollte, wie Sie sie einrichten, wenn mehrere Benutzer beteiligt sind, welche Dateimodi Sie statt der mitgelieferten, für alle beschreibbaren verwenden und wie Sie eine Website reparieren, die ein root-Befehl beschädigt hat. Probleme mit Berechtigungen gehören bei jeder PHP-Anwendung zu den häufigsten Support-Fällen; bei Exponential entstehen sie fast immer dadurch, dass zwei Benutzer dieselben Dateien schreiben. Quellen: Kapitel 8.7 und Kapitel 13.11.
Inhalt
- Was beschreibbar sein muss
- Wer schreibt
- Einrichtung 1: ein Benutzer
- Einrichtung 2: eine Gruppe
- Gehärtete Dateimodi
- Einstellungsdateien mit Geheimnissen
- Die eigenen Dateien von Velocity
- Eine Website reparieren
- Checkliste
- Verwandte Seiten
Was beschreibbar sein muss
Der kritische Test directory_permissions des Setup-Assistenten prüft die Liste in settings/setup.ini,
[directory_permissions] CheckList: design, extension, settings, settings/override, settings/siteaccess,
settings/siteaccess/admin, var und seine Unterverzeichnisse für Cache, Log, Speicher und Autoload.
| Verzeichnis | Warum | Muss beschreibbar bleiben |
|---|---|---|
var/ und alles darunter | Caches, kompilierte Templates, Logs, hochgeladene Dateien, Bildvarianten, Autoload-Arrays, die SQLite-Datenbank | immer |
settings/, settings/override, settings/siteaccess | die Installer und die Administration schreiben Einstellungen | solange Administratoren Einstellungen im Browser ändern |
design/, extension/ | der Setup-Assistent und die Paketinstallation schreiben dorthin | nur solange Pakete aus der Administration installiert werden |
Alles andere (kernel/, lib/, vendor/, index.php) muss nur lesbar sein. Ein Code-Baum, den das PHP der Website
nicht ändern kann, ist ein starker Schutz: Eine Schwachstelle in einer Erweiterung kann dann keinen Code einschleusen
(Kapitel 13.11).
Tipp Websites, die aus der Versionsverwaltung ausgerollt werden, können ihre Einstellungen mit
[ConfigurationSettings] ManagedByDeployment=enabledsperren; dann schreibt die Administration auf dem Server keine Einstellungen und Templates mehr (ManagedByDeployment). Änderungen an Einstellungen kommen dann nur noch über das Ausrollen, nie über den Browser.
Wer schreibt
Vier Arten von Prozessen schreiben var/ und müssen sich über das Eigentum einig sein:
- das PHP des Webservers (der Benutzer des PHP-FPM-Pools oder der Apache-Benutzer von mod_php);
- die Worker von Velocity, wenn Velocity die Website ausliefert;
- Cronjobs (
runcronjobs.php); - Konsolenbefehle und Composer, von einem Administrator ausgeführt.
Eine Cache-Datei, die root von der Kommandozeile geschrieben hat, kann der Benutzer der Website danach nicht ersetzen,
und die Website versagt an seltsamen Stellen.
Einrichtung 1: ein Benutzer
Die empfohlene Einrichtung (Kapitel 8.7.2): Führen Sie alles als Benutzer der Website aus.
- PHP-FPM-Pool:
user = <customer>. - Velocity:
settings/velocity.ini [ServerSettings] User=<customer>,Group=<customer>, oder lassen Sie sie leer und den Eigentümer des Document Root entscheiden. Velocity als root zu starten ist in Ordnung: Nur sein Elternprozess bleibt root, und root-Worker werden abgelehnt, sofern nichtAllowRootWorkers=enabledgesetzt ist (mitgeliefertdisabled). - Cron: die Crontab des Benutzers der Website (
crontab -u <customer> -e) odersudo -u <customer> php runcronjobs.php. - Konsole und Composer: als Benutzer der Website (
sudo -u <customer> php bin/php/console ...).
Für einen Hosting-Anbieter mit einem Systembenutzer pro Kunde ist das auch das natürliche Modell der Abschottung; siehe Benutzer und Pools pro Kunde.
Einrichtung 2: eine Gruppe
Wenn die Benutzer verschieden sein müssen (zum Beispiel der Benutzer des Webservers und ein Benutzer für das Ausrollen), geben Sie ihnen eine gemeinsame Gruppe und machen Sie die beschreibbaren Verzeichnisse für die Gruppe beschreibbar und setgid, sodass neue Dateien die Gruppe erben:
sudo chgrp -R <customer> design extension settings var
sudo find var settings -type d -exec chmod 2775 {} +und geben Sie jedem Prozess eine umask von 0002. Das SQLite-Verzeichnis braucht dieselbe Behandlung
(SQLite für Hoster).
Wenn Apache mit PHP-FPM und Velocity dieselbe Installation nebeneinander ausliefern, teilen sie sich var/, die Caches
und die Sitzungen: Geben Sie ihnen denselben Benutzer oder diese Einrichtung mit einer Gruppe.
Gehärtete Dateimodi
Exponential legt Dateien mit den Modi aus settings/site.ini, [FileSettings] an. Die mitgelieferten Werte sind 0777
und 0666, für alle beschreibbar; site.ini selbst empfiehlt 0770 und 0660 mit dem richtigen Benutzer und der
richtigen Gruppe:
# settings/override/site.ini.append.php
[FileSettings]
StorageDirPermissions=0770
StorageFilePermissions=0660
TemporaryPermissions=0770
LogFilePermissions=0660und korrigieren Sie vorhandene Dateien einmal, mit der Gruppe der Website auf allem:
find var -type d -exec chmod 2770 {} +
find var -type f -exec chmod 0660 {} +Neue Bilder und ihre Varianten erhalten settings/image.ini [FileSettings] ImagePermissions, mitgeliefert leer: dann
bekommen sie denselben Modus wie jede andere gespeicherte Datei (StorageFilePermissions), die Einstellungen oben
gelten also auch für sie. Setzen Sie ImagePermissions nur für einen eigenen Modus (bis 6.0.15 war es mit 0666
vorbelegt, und Varianten entstanden für alle beschreibbar, wo nur StorageFilePermissions eingeschränkt war).
Bildverzeichnisse entstehen mit StorageDirPermissions; image.ini DirPermissions wird nicht gelesen. config.php kann jeden Modus mit EZP_DIR_MODE_MAX und
EZP_FILE_MODE_MAX begrenzen (Dateimodi).
Warnung Auf einem Server mit mehr als einem Kunden erlauben für alle beschreibbare Dateien dem PHP eines Kunden, die Website eines anderen Kunden zu ändern. Setzen Sie die gehärteten Modi auf jeder Installation, die Sie hosten.
TemporaryDir (mitgeliefert /tmp/) wird mit jedem Benutzer der Maschine geteilt; erwägen Sie ein eigenes
Verzeichnis der Website, zum Beispiel unter var/.
Einstellungsdateien mit Geheimnissen
settings/override/ und settings/siteaccess/ enthalten die Zugangsdaten zur Datenbank. Halten Sie sie auf 0640 oder
strenger. Seit 6.0.15 behält ein Speichern aus der Administration oder mit exp:ini Modus, Eigentümer und Gruppe der
Datei bei und legt eine neue Einstellungsdatei mit 0640 an; prüfen Sie einmal, dass nichts für alle beschreibbar
geblieben ist (Dateiberechtigungen beim Speichern von INI-Dateien):
find settings extension/*/settings -perm -o+wEs darf nichts ausgeben. Stellen Sie sicher, dass der Webserver diese Dateien nie ausliefert (Kapitel 13.2).
Die eigenen Dateien von Velocity
| Pfad | Geschrieben von | Modus |
|---|---|---|
/etc/vc/sites-available/<site>.conf | exp:velocity (root) | 0600 |
private Schlüssel im Verzeichnis ssl/ der Konfiguration | dem Server | 0600 |
var/vc/qbix/log/ | dem Server | [LogSettings] FileMode 0640, DirMode 0750 |
var/cache/qbix-reverse/ | dem Server, für die Worker | [CacheSettings] FileMode 0640, DirMode 0750 |
Der Benutzer der Worker muss den Quellcode der Engine in vendor/ lesen können
(Kapitel 8.7.3).
Eine Website reparieren
Nachdem versehentlich ein Befehl als root ausgeführt wurde, geben Sie den beschreibbaren Baum an den Benutzer der Website zurück:
sudo chown -R <customer>:<customer> design extension settings var
sudo chmod -R ug+rwx design extension settings varund leeren Sie dann die Caches als Benutzer der Website. Die Systemprüfung des Setup-Assistenten gibt die genauen Befehle
chown und chmod für die Maschine aus. Verwenden Sie bin/modfix.sh nicht: Es macht Verzeichnisse für alle
beschreibbar.
Checkliste
- To do: Ein Benutzer pro Website für PHP-FPM, Velocity-Worker, Cron und Konsole, oder eine Gruppe mit setgid-Verzeichnissen.
- To do:
var/undsettings/für diesen Benutzer beschreibbar;design/undextension/nur, solange nötig. - To do: Code (
kernel/,lib/,vendor/) für das PHP der Website nicht beschreibbar, wo der Tarif es erlaubt. - To do: Gehärtete Modi in
[FileSettings]undimage.ini [FileSettings]. - To do: Dateien in
settings/overridemit0640;find settings -perm -o+wgibt nichts aus. - To do: Velocity-Worker nie als root.
Verwandte Seiten
- Kapitel 8.7: Dateiberechtigungen und Eigentum
- Kapitel 13.11
- Trennung von Mandanten
- Aufbau des Speichers
- Sicherheitshärtung
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.