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

.ini.append.php-Dateien und sichere Einstellungen

Warum Override-Dateien PHP sind, welche Einstellungsdateien Geheimnisse enthalten, Dateirechte, was nie in die Versionskontrolle oder in eine Erweiterung gehört und wie Sie prüfen, dass Einstellungen nicht über das Web…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-2-builder/append-php-files-and-safety.md

On this page

This page is a translation. Read the English original

.ini.append.php-Dateien und sichere Einstellungen

Teil 2, Kapitel 7. Einstellungsdateien sind Konfiguration, und manche von ihnen sind Geheimnisse. Dieses Kapitel erklärt, wie das System sie schützt und was Sie tun müssen, damit Ihre Erweiterungen und Ihre Repositories sie nie preisgeben. Die Fakten stammen aus Sicherheitshärtung und INI-Dateien behalten ihre Berechtigungen.

Warum der PHP-Rahmen

Eine Override-Datei heißt <file>.ini.append.php und schließt ihren INI-Text in einen PHP-Kommentar ein:

<?php /* #?ini charset="utf-8"?

[DatabaseSettings]
Database=mysite

*/ ?>

Ist ein Webserver einmal falsch konfiguriert und liefert die Datei direkt aus, führt PHP sie aus, der Kommentar erzeugt keine Ausgabe, und der Besucher sieht eine leere Seite statt Ihrer Einstellungen. Verwenden Sie diese Form immer für Override-Dateien und lassen Sie das schließende */ ?> in der letzten Zeile.

Die Dateien mit Geheimnissen

DateiGeheimnis
settings/override/site.ini.append.phpDatenbankbenutzer und -passwort ([DatabaseSettings])
settings/override/audit.ini.append.phpder Signaturschlüssel und der Pseudonymschlüssel des Audits
settings/override/mailpreferences.ini.append.phpdas Website-Geheimnis [SecretSettings] TokenSecret
settings/override/velocity.ini.append.php[DashboardSettings] Token, wenn gesetzt
config.env.phpMaschineneinstellungen
var/log/initial-admin-passworddas erste Administratorpasswort einer Installation über die Konsole oder Kickstart

Einige davon werden bei der ersten Verwendung erzeugt, sodass auch eine Entwicklungsinstallation sie bekommt. Genau deshalb liegen sie alle unter settings/override/ oder außerhalb von settings/.

Regeln für Builder und Autoren von Erweiterungen

  1. Committen Sie settings/override/ nie. In einem Git-Klon des Kernels führt git status das Verzeichnis als nicht verfolgt auf; lassen Sie es so, tragen Sie es in Ihre eigene .gitignore oder in .git/info/exclude ein und stagen Sie Dateien namentlich statt mit git add -A.
  2. Legen Sie nie ein Geheimnis in eine Erweiterung. Erweiterungen werden geteilt, gepackt und veröffentlicht. Eine Erweiterung, die einen Schlüssel braucht, sollte ihn aus einer Einstellung lesen, die die Installation in ihrem eigenen settings/override/ ausfüllt, und die Einstellung leer mit einem erklärenden Kommentar ausliefern.
  3. Kopieren Sie Einstellungen nie pauschal zwischen Servern. Kopieren Sie die Blöcke, die Sie brauchen; Datenbank- und Geheimnis-Blöcke bleiben Sache jedes einzelnen Servers.
  4. Maskieren Sie Geheimnisse in Ausgaben. exp:ini und die Einstellungsseite maskieren Variablen, deren Name Password, Secret, Token oder Salt enthält oder auf Key endet. Benennen Sie Ihre eigenen geheimen Einstellungen genauso, dann werden auch sie maskiert.
  5. Protokollieren Sie keine Einstellungen. Eine Debug-Zeile, die einen ganzen Block ausgibt, kann ein Passwort ausgeben.

Der Paket-Download unter Setup > Extensions weigert sich, eine Erweiterung zu packen, die einen geheimen Wert oder Schlüsselmaterial enthält, und nennt die gefundenen Dateien und Einstellungen; siehe die Geheimnisprüfung.

Dateirechte

eZINI::save() gibt einer neuen Einstellungsdatei die Rechte 0640 sowie Eigentümer und Gruppe ihres Verzeichnisses; eine vorhandene Datei behält ihre Rechte. Prüfen Sie, dass nichts für alle schreibbar ist:

find settings extension/*/settings -name '*.ini*' -perm -o+w

Der Befehl darf nichts ausgeben. Korrigieren Sie, was er auflistet, mit chmod 0640 (oder 0644, wo ein anderer Benutzer die Datei lesen muss).

Kann das Web Ihre Einstellungen lesen?

Das Document Root von Exponential ist das Wurzelverzeichnis der Installation, und die Rewrite-Regeln schicken Anfragen an settings/, var/ und die Quelltexte an index.php, das mit einer Seite oder einem 404 antwortet, nie mit der Datei. Prüfen Sie Ihren Server:

curl -s -o /dev/null -w '%{http_code}\n' https://www.example.com/settings/site.ini
curl -s -o /dev/null -w '%{http_code}\n' https://www.example.com/settings/override/site.ini.append.php

Keine der beiden Adressen darf den Inhalt der Datei liefern. Die vollständige Liste der zu prüfenden Adressen steht in Sicherheitshärtung.

Eine sichere Einstellungserweiterung, zusammengefasst

In der Erweiterung (committet)In settings/override/ (nie committet)
Design, Sprachen, Bild-Aliase, Overrides, Regeln für den View-CacheDatenbank, Zugangsdaten des Mailservers
die eigenen Optionen Ihrer Erweiterung, mit sicheren StandardwertenAPI-Schlüssel, Tokens, Geheimnisse
Kommentare, die jede Einstellung erklärenHostnamen, Pfade, Debug-Schalter je Server

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