Passwork-Serverkonfiguration

Wenn ein erforderlicher Parameter in der Liste fehlt, bedeutet dies, dass er über die Passwork-Weboberfläche konfiguriert wird oder nicht mehr unterstützt wird.

Die Konfigurationsdatei config.env befindet sich in den folgenden Verzeichnissen (abhängig von der gewählten Passwork-Installation):

• Linux — /var/www/init/config.env
• Windows Server — C:\inetpub\wwwroot\passwork\init\config.env
• Docker — /<passwork>/conf/keys/config.env

Parameter für den Passwork-Betrieb

Parameter	Standardwert	Beschreibung
ENCRYPTION_CIPHER	AES-256-CFB	Datenverschlüsselungsalgorithmus.
IS_EXPORT_ENABLED	1	Standardmäßig ist der Passwortexport in Passwork aktiviert. Der Wert 0 deaktiviert den Export.
IS_EMERGENCY_RESET_ENABLED	0	Berechtigung zum Zurücksetzen des Besitzer-Passworts über einen Konsolenbefehl.
IS_WRITING_LOGS_TO_STDERR_ENABLED	1	Fehler in den stderr-Stream schreiben.
IS_WRITING_LOGS_TO_ERROR_LOG_ENABLED	1	Fehler in die error_log-Datei schreiben.
IS_BASE64_RESPONSE_ENCODING_ENABLED	1	Antworten in Base64 kodieren.
APP_URL		Passwork-URL-Adresse. Wird während des Installationsassistenten festgelegt.
HEALTH_CHECK_TOKEN		Token für den Health-Check-Endpunkt.
HASH_ALGORITHM	Empfohlen, nicht zu ändern	Passwort-Hashing-Algorithmus. Standardmäßig wird SHA512 verwendet.
ENCRYPTION_CIPHER	Empfohlen, nicht zu ändern	Sie können einen Verschlüsselungsalgorithmus aus der OpenSSL-Bibliothek angeben.
IS_HTTP_HEADERS_CHECKER_ENABLED	0	Referer-Prüfung in HTTP-Headern aktivieren.

Pfad- und Konfigurationsdateiparameter

Parameter	Standardwert	Beschreibung
FILES_DIR	<Passwork root>/files	Verzeichnis mit Hintergrundaufgaben-Protokollen, API-Schemabeschreibung und anderen Dateien.
INIT_DIR	<Passwork root>/init	Standardverzeichnis für die Speicherung des Verschlüsselungsschlüssels und der Benutzerkonfigurationsdatei.
ENCRYPTION_KEY_PATH	INIT_DIR/encryption_key	Pfad zur Verschlüsselungsschlüssel-Datei.
ENV_LOCAL_PATH	INIT_DIR/config.env	Pfad zur Benutzerkonfigurationsdatei.
SSO_FILES_DIR	FILES_DIR/sso	Pfad zum SSO-Verzeichnis, erforderlich für die Speicherung von Zertifikaten bei Verwendung zur Signierung.

Verwendung

init/config.env — der standardmäßig angegebene Pfad, der jedoch über .env.local überschrieben werden kann. Er enthält den Hauptteil der Einstellungen, und in den meisten Fällen beschränkt sich die Konfiguration auf das Ändern oder Hinzufügen von Parametern in dieser Datei.

.env — befindet sich im Stammverzeichnis des Passwork-Codes (nicht zu verwechseln mit .env im Stammverzeichnis des Docker Builds). Bitte nehmen Sie keine Änderungen an dieser Datei vor, es sei denn, dies wird von unserem technischen Support verlangt.

.env.local — standardmäßig nicht vorhanden, kann nur im Stammverzeichnis des Passwork-Codes angelegt werden. Wir empfehlen, sie nur zum Ändern weniger Einstellungen zu verwenden: Pfade, Verschlüsselungsmodus, Antwortkodierungsmodus. Einstellungen aus dieser Datei überschreiben die in init/config.env und .env angegebenen.

Environment variables — können ebenfalls für die Konfiguration verwendet werden, was jedoch nur beim Betrieb in Containern oder über externe Prozessmanager sinnvoll ist. In anderen Fällen ist die Verwendung von Konfigurationsdateien vorzuziehen.

Datenbankverbindungsparameter

MongoDB

Parameter	Beschreibung
MONGODB_URL	Verbindungszeichenfolge zu MongoDB.
MONGODB_DB	Name der Passwork-Datenbank.
MONGODB_USERNAME	(optional) MongoDB-Benutzername.
MONGODB_PASSWORD	(optional) MongoDB-Benutzerpasswort.

E-Mail-Parameter

info

Wird mit dem DSN-Typ verwendet.

Parameter	Beschreibung
APP_SENDER_EMAIL	Absender-E-Mail für Systemnachrichten.
MAILER_DSN	DSN-Verbindungszeichenfolge zum E-Mail-Server.

Oberflächenanpassung

Logo-Anzeige

Passwork ermöglicht es Ihnen, Ihr Firmenlogo in der Weboberfläche anstelle des Textnamens anzuzeigen.

Einrichtungsreihenfolge:

1. Bereiten Sie eine PNG-Datei in der entsprechenden Größe vor und legen Sie sie in einem für den Webserver-Benutzer zugänglichen Verzeichnis ab.
2. Geben Sie den absoluten Pfad zur Datei im Parameter APP_LOGO_PATH in config.env an.
3. Starten Sie die Dienste neu, um das Logo zu laden.

Empfehlungen für das Logo-Format:

• Format: PNG
• Maximale Größe: 200×80 Pixel

Parameter	Beschreibung
APP_LOGO_PATH	Pfad zum Logo-Bild

Konfigurationsbeispiele

Linux

1. Verschieben Sie die .png-Datei auf den Server, auf dem Passwork installiert ist, und setzen Sie den Apache2-Webserver-Benutzer als Eigentümer.

DEB

chown www-data:www-data /opt/logo/example.png

RPM

chown apache:apache /opt/logo/example.png

2. Bearbeiten Sie config.env und fügen Sie den Parameter hinzu:

config.env

APP_LOGO_PATH=/opt/logo/example.png

3. Starten Sie die PHP- und Webserver-Dienste neu:

DEB

systemctl restart php8.3-fpm
systemctl restart apache2

RPM

systemctl restart php-fpm
systemctl restart httpd

Docker

1. Legen Sie die .png-Datei in /<passwork>/conf/keys/ im Konfigurationsverzeichnis ab:

tree

keys
├── config.env
├── encryption_key
└── example.png

2. Fügen Sie den Parameter in config.env mit der Variable %init_dir% hinzu:

config.env

APP_LOGO_PATH="%init_dir%/example.png"

3. Starten Sie die PHP- und Nginx-Container neu:

Docker

docker restart passwork_php passwork_nginx

Windows Server

1. Kopieren Sie die Datei in ein beliebiges für IIS zugängliches Verzeichnis, zum Beispiel:

PowerShell

C:\inetpub\logo\example.png

2. Fügen Sie den Parameter in config.env hinzu:

config.env

APP_LOGO_PATH="C:\inetpub\logo\example.png"

3. Starten Sie in IIS die Passwork-Website oder den entsprechenden Anwendungspool neu.