FileMaker Apache Commons JAR-Ersetzer

Übersicht

Der FileMaker Apache Commons JAR-Ersetzer ist eine Automatisierungslösung, die CVE-2025-46295 adressiert, indem sie verwundbare Apache Commons JAR-Dateien in FileMaker Server-Installationen ersetzt. Anstatt den gesamten FileMaker Server zu aktualisieren, folgt diese Lösung der offiziellen Claris-Anleitung, um nur die verwundbaren commons-text- und commons-lang3-JAR-Dateien durch aktualisierte Versionen zu ersetzen.

Schnell-Download

Für die meisten Benutzer: Laden Sie die neueste Version herunter, anstatt aus dem Quellcode zu bauen:

Neueste Version herunterladen

1. Gehen Sie zur Releases-Seite

2. Laden Sie die passende Datei für Ihre Plattform herunter:

   • Windows: filemaker-jar-replacer-windows.zip
   • macOS: filemaker-jar-replacer-macos.tar.gz
   • Ubuntu/Linux: filemaker-jar-replacer-ubuntu.tar.gz

3. Extrahieren und ausführen – Siehe die Versionshinweise für detaillierte Extraktions- und Nutzungsanweisungen

Warum Releases verwenden?

• ✅ Vorab getestet – Alle Releases werden plattformübergreifend gründlich getestet
• ✅ Einsatzbereit – Keine Kompilierung oder Einrichtung erforderlich
• ✅ Sicher – Signierte Releases mit Prüfsummen zur Verifizierung
• ✅ Vollständig – Enthält alle Abhängigkeiten und Dokumentationen

Informationen zur Verwundbarkeit

Wann ist ein Server verwundbar?

Die betroffenen JAR-Dateien werden nur installiert, wenn das Web Publishing Engine zum ersten Mal aktiviert wird.

CVE-2025-46295 Details

• Schweregrad: Kritisch
• CVSS-Score: 9,8 (Kritisch)
• Betroffene Komponente: Apache Commons Text (Versionen vor 1.10.0) und Apache Commons Lang (Versionen vor 3.18.0)
• Auswirkung: Remote-Code-Ausführung
• Betroffene FileMaker-Versionen: Alle Versionen mit verwundbaren JAR-Dateien
• Lösung: Ersetzen Sie verwundbare JAR-Dateien durch aktualisierte Versionen (commons-text 1.11.0+, commons-lang3 3.18.0+)

Offizielle Ressourcen

• Manuelle JAR-Ersetzungsanleitung (ohne FileMaker Server-Upgrade): https://support.claris.com/s/answerview?anum=000049055&language=en_US
• CVE-2025-46295 Sicherheitshinweis (NIST): https://nvd.nist.gov/vuln/detail/CVE-2025-46295
• Bestätigung der Verwundbarkeit und der sicheren Versionen: https://support.claris.com/s/answerview?anum=000049059&language=en_US

Unterstützte Plattformen

Dieser JAR-Ersetzer bietet plattformspezifische Skripte für:

• Windows: PowerShell-Skript (replace-filemaker-jars-windows.ps1)
• macOS: Bash-Skript (replace-filemaker-jars-macos.sh)
• Ubuntu: Bash-Skript (replace-filemaker-jars-ubuntu.sh)

Schnellstart

Voraussetzungen

Windows

• Windows Server 2016+
• PowerShell 5.1 oder höher
• Administratorrechte
• FileMaker Server installiert

macOS

• macOS 10.15 (Catalina) oder höher
• Bash-Shell
• sudo-Rechte
• FileMaker Server installiert

Ubuntu

• Ubuntu 20.04 LTS oder höher
• Bash-Shell
• sudo-Rechte
• FileMaker Server installiert

Verwendung

WICHTIG: Bevor Sie Änderungen an Ihrem FileMaker Server vornehmen, führen Sie das Skript mit der Option --dry-run aus, um zu überprüfen, ob Ihr Server verwundbar ist und welche Änderungen vorgenommen würden.

Windows

# PowerShell als Administrator ausführen

# Hilfe und verfügbare Optionen anzeigen
.\replace-filemaker-jars-windows.ps1 -Help

# Überprüfen, ob Ihr Server verwundbar ist (EMPFOHLENER ERSTER SCHRITT)
.\replace-filemaker-jars-windows.ps1 -DryRun

# Sicherheitsfix anwenden (nur nach Überprüfung der Trockenlauf-Ergebnisse)
.\replace-filemaker-jars-windows.ps1

macOS

# Mit sudo-Rechten ausführen

# Hilfe und verfügbare Optionen anzeigen
sudo ./replace-filemaker-jars-macos.sh --help

# Überprüfen, ob Ihr Server verwundbar ist (EMPFOHLENER ERSTER SCHRITT)
sudo ./replace-filemaker-jars-macos.sh --dry-run

# Sicherheitsfix anwenden (nur nach Überprüfung der Trockenlauf-Ergebnisse)
sudo ./replace-filemaker-jars-macos.sh

Ubuntu

# Mit sudo-Rechten ausführen

# Hilfe und verfügbare Optionen anzeigen
sudo ./replace-filemaker-jars-ubuntu.sh --help

# Überprüfen, ob Ihr Server verwundbar ist (EMPFOHLENER ERSTER SCHRITT)
sudo ./replace-filemaker-jars-ubuntu.sh --dry-run

# Sicherheitsfix anwenden (nur nach Überprüfung der Trockenlauf-Ergebnisse)
sudo ./replace-filemaker-jars-ubuntu.sh

Warum zuerst den Trockenlauf verwenden?

Die Option --dry-run ist der sicherste Weg, um:

• Verwundbarkeitsstatus zu prüfen, ohne Änderungen vorzunehmen
• Zu identifizieren, welche JAR-Dateien ersetzt werden müssen
• Skript-Kompatibilität mit Ihrer FileMaker Server-Installation zu überprüfen
• Alle Aktionen vorab anzuzeigen, die durchgeführt würden
• Potenzielle Probleme zu erkennen, bevor Änderungen vorgenommen werden

Führen Sie immer zuerst --dry-run aus, um zu verstehen, was das Skript auf Ihrem System tun wird.

Funktionen

Automatisierte JAR-Erkennung und -Ersetzung

• Erkennt automatisch FileMaker Server-Installationen und Web Publishing Engine-Verzeichnisse
• Identifiziert verwundbare commons-text- und commons-lang3-JAR-Dateien
• Lädt aktualisierte JAR-Dateien herunter (commons-text 1.11.0+, commons-lang3 3.18.0+)
• Führt atomaren JAR-Dateiaustausch mit Integritätsprüfung durch

Umfassende Sicherung und Wiederherstellung

• Erstellt vollständige Sicherung vorhandener JAR-Dateien vor dem Austausch
• Automatischer Rollback bei fehlgeschlagenem Austausch
• Überprüfung der Sicherungsintegrität

Web Publishing Engine-Verwaltung

• Verwendet das offizielle fmsadmin-Befehlszeilentool zur Dienstverwaltung
• Sichere Handhabung von Anmeldedaten für die fmsadmin-Authentifizierung
• Automatischer Neustart der Web Publishing Engine nach JAR-Austausch
• Überprüfung der Funktionalität nach dem Austausch

Sicherheitsorientierter Ansatz

• Sichere Handhabung von Anmeldedaten (niemals protokolliert oder angezeigt)
• Unterstützt Umgebungsvariablen und .env-Dateien
• Überprüft Dateiberechtigungen für Anmeldedatendateien

Detaillierte Protokollierung

• Umfassende Betriebsprotokollierung mit Zeitstempeln
• Plattformspezifische Protokollspeicherorte
• Fehlerverfolgung und Wiederherstellungsanleitung

Benutzerfreundliche Oberfläche

• Farbcodierte Statusanzeigen
• Fortschrittsverfolgung für lange Vorgänge
• Klare Fehlermeldungen und Wiederherstellungsanweisungen

Verzeichnisstruktur

filemaker-jar-replacer/
├── README.md                          # Diese Datei
├── replace-filemaker-jars-windows.ps1 # Windows PowerShell-Skript
├── replace-filemaker-jars-macos.sh    # macOS Bash-Skript
├── replace-filemaker-jars-ubuntu.sh   # Ubuntu Bash-Skript
├── scripts/
│   ├── windows/
│   │   └── modules/                   # PowerShell-Module für JAR-Operationen
│   ├── macos/
│   │   └── modules/                   # Bash-Funktionsmodule für JAR-Operationen
│   ├── ubuntu/
│   │   └── modules/                   # Bash-Funktionsmodule für JAR-Operationen
│   └── shared/                        # Gemeinsame Hilfsprogramme und Vorlagen
├── config/
│   ├── logging-config.json           # Protokollierungskonfiguration
│   └── jar-replacement-config.json   # JAR-Ersetzungskonfiguration
├── tests/                            # Testsuite (BATS und Pester)
├── logs/                             # Protokolldateien (während der Ausführung erstellt)
└── backups/                          # JAR-Sicherungsdateien (während der Ausführung erstellt)

Konfiguration

Umgebungsvariablen

Sie können den Updater mit Umgebungsvariablen konfigurieren:

# FileMaker Server-Anmeldedaten
export FILEMAKER_USERNAME="admin"
export FILEMAKER_PASSWORD="your_secure_password"

# Benutzerdefinierte Pfade (optional)
export FILEMAKER_INSTALL_PATH="/custom/path/to/filemaker"
export BACKUP_DIRECTORY="/custom/backup/path"

.env-Datei-Unterstützung

Erstellen Sie eine .env-Datei im Skriptverzeichnis:

# .env-Datei (muss Berechtigung 600 haben)
FILEMAKER_USERNAME=admin
FILEMAKER_PASSWORD=your_secure_password
BACKUP_DIRECTORY=/custom/backup/path

Wichtig: Stellen Sie sicher, dass die .env-Datei restriktive Berechtigungen (600) aus Sicherheitsgründen hat.

Manueller JAR-Ersetzungsprozess (Fallback)

Wenn das automatisierte Skript fehlschlägt, führen Sie die folgenden manuellen Schritte aus, um die verwundbaren JAR-Dateien zu ersetzen:

1. Web Publishing Engine stoppen

Windows

# Verwendung von fmsadmin (empfohlen)
& "C:\Program Files\FileMaker\FileMaker Server\Database Server\fmsadmin.exe" stop wpe -u admin -p password

# Oder mittels Dienste
Stop-Service "FileMaker Server Web Publishing Engine"

macOS

# Verwendung von fmsadmin (empfohlen)
sudo "/Library/FileMaker Server/Database Server/bin/fmsadmin" stop wpe -u admin -p password

# Oder mittels launchctl
sudo launchctl stop com.filemaker.wpe

Ubuntu

# Verwendung von fmsadmin (empfohlen)
sudo "/opt/FileMaker/FileMaker Server/Database Server/bin/fmsadmin" stop wpe -u admin -p password

# Oder mittels systemctl
sudo systemctl stop filemaker-wpe

2. Vorhandene JAR-Dateien sichern

Windows

$jarPath = "C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\jwpc-tomcat\webapps\ROOT\WEB-INF\lib"
$backupPath = "C:\Temp\jar-backup-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
New-Item -ItemType Directory -Path $backupPath
Copy-Item "$jarPath\commons-text-*.jar" $backupPath
Copy-Item "$jarPath\commons-lang3-*.jar" $backupPath

macOS/Ubuntu

JAR_PATH="/Library/FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/webapps/ROOT/WEB-INF/lib"  # macOS
# JAR_PATH="/opt/FileMaker/FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/webapps/ROOT/WEB-INF/lib"  # Ubuntu

BACKUP_PATH="/tmp/jar-backup-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_PATH"
cp "$JAR_PATH"/commons-text-*.jar "$BACKUP_PATH/"
cp "$JAR_PATH"/commons-lang3-*.jar "$BACKUP_PATH/"

3. Aktualisierte JAR-Dateien herunterladen

Laden Sie die folgenden JAR-Dateien von Apache Commons herunter:

• commons-text-1.11.0.jar oder höher von: https://commons.apache.org/proper/commons-text/download_text.cgi
• commons-lang3-3.18.0.jar oder höher von: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Überprüfen Sie die Prüfsummen mit den offiziellen Apache Commons-Prüfsummen.

4. JAR-Dateien ersetzen

Windows

$jarPath = "C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\jwpc-tomcat\webapps\ROOT\WEB-INF\lib"
# Alte JAR-Dateien entfernen
Remove-Item "$jarPath\commons-text-*.jar"
Remove-Item "$jarPath\commons-lang3-*.jar"
# Neue JAR-Dateien kopieren
Copy-Item "commons-text-1.11.0.jar" $jarPath
Copy-Item "commons-lang3-3.18.0.jar" $jarPath

macOS/Ubuntu

JAR_PATH="/Library/FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/webapps/ROOT/WEB-INF/lib"  # macOS
# JAR_PATH="/opt/FileMaker/FileMaker Server/Web Publishing/publishing-engine/jwpc-tomcat/webapps/ROOT/WEB-INF/lib"  # Ubuntu

# Alte JAR-Dateien entfernen
sudo rm "$JAR_PATH"/commons-text-*.jar
sudo rm "$JAR_PATH"/commons-lang3-*.jar
# Neue JAR-Dateien kopieren
sudo cp commons-text-1.11.0.jar "$JAR_PATH/"
sudo cp commons-lang3-3.18.0.jar "$JAR_PATH/"
# Korrekte Berechtigungen setzen
sudo chown fmserver:fmsadmin "$JAR_PATH"/commons-*.jar  # Besitzer ggf. anpassen
sudo chmod 644 "$JAR_PATH"/commons-*.jar

5. Web Publishing Engine neu starten

Windows

# Verwendung von fmsadmin (empfohlen)
& "C:\Program Files\FileMaker\FileMaker Server\Database Server\fmsadmin.exe" start wpe -u admin -p password

# Oder mittels Dienste
Start-Service "FileMaker Server Web Publishing Engine"

macOS

# Verwendung von fmsadmin (empfohlen)
sudo "/Library/FileMaker Server/Database Server/bin/fmsadmin" start wpe -u admin -p password

# Oder mittels launchctl
sudo launchctl start com.filemaker.wpe

Ubuntu

# Verwendung von fmsadmin (empfohlen)
sudo "/opt/FileMaker/FileMaker Server/Database Server/bin/fmsadmin" start wpe -u admin -p password

# Oder mittels systemctl
sudo systemctl start filemaker-wpe

6. JAR-Austausch überprüfen

1. Prüfen, ob die Web Publishing Engine läuft
2. Überprüfen, ob die neuen JAR-Dateien mit korrekten Versionen vorhanden sind
3. Web-Publishing-Funktionalität testen
4. FileMaker Server-Protokolle auf Fehler prüfen

Manueller Update-Prozess (Fallback)

Wenn das automatisierte Skript fehlschlägt, führen Sie die folgenden manuellen Schritte aus:

1. FileMaker Server-Dienste stoppen

Windows

net stop "FileMaker Server"

macOS

sudo launchctl stop com.filemaker.fms

Ubuntu

sudo service fmshelper stop

2. Sicherung erstellen

• Sichern Sie Ihre Datenbanken aus dem Data-Ordner
• Sichern Sie Konfigurationsdateien
• Notieren Sie die aktuelle Version für einen Rollback

3. Update herunterladen

• Laden Sie FileMaker Server 22.0.4 von Claris herunter
• Überprüfen Sie die Prüfsummenintegrität
• Führen Sie das Installationsprogramm mit geeigneten Parametern aus

4. Installation überprüfen

• Bestätigen, dass die Version 22.0.4 oder höher ist
• Datenbankkonnektivität testen
• Überprüfen, ob Dienste ausgeführt werden

5. Dienste wiederherstellen

Windows

net start "FileMaker Server"

macOS

sudo launchctl start com.filemaker.fms

Ubuntu

sudo service fmshelper start

Fehlerbehebung

Häufige Probleme

"FileMaker Server nicht gefunden"

• Überprüfen, ob FileMaker Server installiert ist
• Prüfen, ob der Installationspfad den erwarteten Speicherorten entspricht
• Skript mit entsprechenden Berechtigungen ausführen

"Unzureichende Berechtigungen"

• PowerShell als Administrator ausführen (Windows)
• sudo mit dem Skript verwenden (macOS/Ubuntu)
• Überprüfen, ob das Benutzerkonto über die erforderlichen Berechtigungen verfügt

"JAR-Sicherung fehlgeschlagen"

• Verfügbaren Speicherplatz prüfen
• Schreibberechtigungen für das Sicherungsverzeichnis überprüfen
• Sicherstellen, dass JAR-Dateien nicht von laufenden Prozessen gesperrt sind

"JAR-Download fehlgeschlagen"

• Internetverbindung prüfen
• Firewall-Einstellungen überprüfen, ob HTTPS-Downloads zu den Apache Commons-Repositorien erlaubt sind
• Manuellen Download versuchen und die Datei im Skriptverzeichnis ablegen

"Neustart der Web Publishing Engine fehlgeschlagen"

• Überprüfen, ob die fmsadmin-Anmeldedaten korrekt sind
• Prüfen, ob FileMaker Server läuft
• Manuellen Neustart mit dem fmsadmin-Befehl versuchen
• FileMaker Server-Protokolle auf Dienstprobleme prüfen

Protokollspeicherorte

• Windows: logs\filemaker-jar-replacer-windows.log
• macOS: logs/filemaker-jar-replacer-macos.log
• Ubuntu: logs/filemaker-jar-replacer-ubuntu.log

Sicherheitsaspekte

• Skripte immer mit entsprechenden Berechtigungen ausführen
• Skriptintegrität vor der Ausführung überprüfen
• Sichere Methoden zur Speicherung von Anmeldedaten verwenden
• Protokolle auf sicherheitsrelevante Ereignisse überprüfen
• Zuerst in einer Nicht-Produktionsumgebung testen

Support und Ressourcen

Offizielle Claris-Ressourcen

• Claris Support: https://support.claris.com/
• FileMaker Community: https://community.claris.com/
• Sicherheitshinweise: https://support.claris.com/s/topic/0TO4u000000TNvGGAW/security-advisories

Notfallkontakte

• Claris Technischer Support: Verfügbar über Ihren Support-Plan
• Sicherheitsprobleme: Melden an [email protected]

Tests

Dieses Projekt enthält umfassende Testsuites für alle Plattformen, um Zuverlässigkeit und Sicherheit zu gewährleisten.

Test-Frameworks

Das Projekt verwendet verschiedene Test-Frameworks für jede Plattform:

• Linux/macOS: BATS (Bash Automated Testing System)
• Windows: Pester (PowerShell-Test-Framework)

Test-Werkzeuge installieren

BATS (Linux/macOS)

macOS (mit Homebrew):

brew install bats-core

Ubuntu/Debian:

# Installation über den Paketmanager
sudo apt update
sudo apt install bats

# Oder die neueste Version aus dem Quellcode installieren
git clone https://github.com/bats-core/bats-core.git
cd bats-core
sudo ./install.sh /usr/local

Manuelle Installation (jedes Unix-ähnliche System):

git clone https://github.com/bats-core/bats-core.git
cd bats-core
sudo ./install.sh /usr/local

Pester (Windows)

Pester ist in PowerShell 5.1+ und Windows PowerShell vorinstalliert, aber Sie möchten möglicherweise auf die neueste Version aktualisieren:

# Aktuelle Version überprüfen
Get-Module -Name Pester -ListAvailable

# Installieren/Aktualisieren auf die neueste Version (PowerShell 5.1+)
Install-Module -Name Pester -Force -SkipPublisherCheck

# Für PowerShell Core (7+)
Install-Module -Name Pester -Scope CurrentUser

Tests ausführen

Alle Plattformen - Einzelne Testdateien

# Bestimmte BATS-Testdatei ausführen (Linux/macOS)
bats tests/backup-creation.bats
bats tests/version-detection.bats

# Bestimmte Pester-Testdatei ausführen (Windows)
Invoke-Pester tests/windows/Integration.Tests.ps1
Invoke-Pester tests/windows/Utilities.Tests.ps1

Alle Plattformen - Vollständige Testsuite

# Alle BATS-Tests ausführen (Linux/macOS)
bats tests/*.bats

# Alle Pester-Tests ausführen (Windows)
Invoke-Pester tests/windows/

Testkategorien

Die Testsuite umfasst:

• Unit-Tests: Einzelfunktions- und Modultests
• Integrationstests: End-to-End-Workflow-Tests
• Sicherheitstests: Überprüfung der Anmeldedatenverarbeitung und Berechtigungen
• Plattformspezifische Tests: Überprüfung OS-spezifischer Funktionalität
• Randfalltests: Fehlerbehandlung und Tests der Grenzbedingungen

Testumgebung einrichten

Tests erstellen isolierte temporäre Umgebungen und haben keine Auswirkungen auf Ihr System oder Ihre FileMaker-Installation. Einige Tests erfordern jedoch möglicherweise:

• Administrator-/sudo-Rechte (für Berechtigungserweiterungstests)
• Netzwerkzugriff (für Simulations-Downloadtests)
• Ausreichend Speicherplatz (für Sicherungserstellungstests)

Lizenz

Dieser JAR-Ersetzer wird wie besehen zur Behebung von CVE-2025-46295 bereitgestellt. Verwenden Sie es gemäß Ihrem FileMaker Server-Lizenzvertrag und den Lizenzbedingungen von Apache Commons.

Änderungsprotokoll

Version 1.0.0

• Erstveröffentlichung
• Unterstützung für Windows, macOS und Ubuntu
• Automatisierte JAR-Ersetzung für CVE-2025-46295
• Austausch der commons-text- und commons-lang3-JAR-Dateien
• Umfassende Protokollierungs- und Sicherungsfunktionalität
• Web Publishing Engine-Verwaltung mit fmsadmin-Integration