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

Beschreibbare Verzeichnisse und Berechtigungen

Welche Verzeichnisse einer Exponential-Installation beschreibbar sein müssen und für wen, die Einrichtung mit einem Benutzer und mit einer Gruppe, die gehärteten Dateimodi, Einstellungsdateien mit Geheimnissen, die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/basics/writable-directories-and-permissions.md

On this page

This page is a translation. Read the English original

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

  1. Was beschreibbar sein muss
  2. Wer schreibt
  3. Einrichtung 1: ein Benutzer
  4. Einrichtung 2: eine Gruppe
  5. Gehärtete Dateimodi
  6. Einstellungsdateien mit Geheimnissen
  7. Die eigenen Dateien von Velocity
  8. Eine Website reparieren
  9. Checkliste
  10. 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.

VerzeichnisWarumMuss beschreibbar bleiben
var/ und alles darunterCaches, kompilierte Templates, Logs, hochgeladene Dateien, Bildvarianten, Autoload-Arrays, die SQLite-Datenbankimmer
settings/, settings/override, settings/siteaccessdie Installer und die Administration schreiben Einstellungensolange Administratoren Einstellungen im Browser ändern
design/, extension/der Setup-Assistent und die Paketinstallation schreiben dorthinnur 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=enabled sperren; 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 nicht AllowRootWorkers=enabled gesetzt ist (mitgeliefert disabled).
  • Cron: die Crontab des Benutzers der Website (crontab -u <customer> -e) oder sudo -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=0660

und 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+w

Es darf nichts ausgeben. Stellen Sie sicher, dass der Webserver diese Dateien nie ausliefert (Kapitel 13.2).

Die eigenen Dateien von Velocity

PfadGeschrieben vonModus
/etc/vc/sites-available/<site>.confexp:velocity (root)0600
private Schlüssel im Verzeichnis ssl/ der Konfigurationdem Server0600
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 var

und 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/ und settings/ für diesen Benutzer beschreibbar; design/ und extension/ 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] und image.ini [FileSettings].
  • To do: Dateien in settings/override mit 0640; find settings -perm -o+w gibt nichts aus.
  • To do: Velocity-Worker nie als root.

Verwandte Seiten

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.

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