مستبدل ملفات JAR الخاصة بـ Apache Commons في FileMaker

نظرة عامة

يُعد مستبدل ملفات JAR الخاصة بـ Apache Commons في FileMaker حلاً آلياً يعالج CVE-2025-46295 عن طريق استبدال ملفات JAR المعرّضة للخطر الخاصة بـ Apache Commons في تثبيتات FileMaker Server. فبدلاً من ترقية FileMaker Server بالكامل، يتبع هذا الحل الإرشادات الرسمية من Claris لاستبدال ملفات commons-text و commons-lang3 المعرّضة للخطر فقط بنسخ محدّثة.

تنزيل سريع

بالنسبة لمعظم المستخدمين، قم بتنزيل أحدث إصدار (release) بدلاً من البناء من المصدر:

تنزيل أحدث إصدار

1. انتقل إلى صفحة الإصدارات

2. قم بتنزيل الملف المناسب لمنصتك:

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

3. قم بفك الضغط والتشغيل - راجع ملاحظات الإصدار للحصول على تعليمات تفصيلية لفك الضغط والاستخدام

لماذا استخدام الإصدارات؟

• ✅ مختبر مسبقاً - جميع الإصدارات مختبرة بدقة عبر المنصات
• ✅ جاهز للاستخدام - لا يتطلب أي تجميع أو إعداد
• ✅ آمن - إصدارات موقّعة مع مجاميع تحقق للتحقق من صحتها
• ✅ مكتمل - يتضمن جميع التبعيات والتوثيق

معلومات الثغرة الأمنية

متى يكون الخادم معرّضاً للخطر؟

يتم تثبيت ملفات JAR المتأثرة فقط عند تمكين Web Publishing Engine لأول مرة.

تفاصيل CVE-2025-46295

• الخطورة: حرجة
• درجة CVSS: 9.8 (حرجة)
• المكوّن المتأثر: Apache Commons Text (الإصدارات الأقدم من 1.10.0) و Apache Commons Lang (الإصدارات الأقدم من 3.18.0)
• التأثير: تنفيذ تعليمات برمجية عن بُعد
• إصدارات FileMaker المتأثرة: جميع الإصدارات التي تحتوي على ملفات JAR معرّضة للخطر
• الحل: استبدال ملفات JAR المعرّضة للخطر بنسخ محدّثة (commons-text 1.11.0+، commons-lang3 3.18.0+)

الموارد الرسمية

• إرشادات الاستبدال اليدوي لملفات JAR (بدون ترقية FileMaker Server): https://support.claris.com/s/answerview?anum=000049055&language=en_US
• النشرة الأمنية لـ CVE-2025-46295 (NIST): https://nvd.nist.gov/vuln/detail/CVE-2025-46295
• الإقرار بالثغرة وتأكيد الإصدار الآمن: https://support.claris.com/s/answerview?anum=000049059&language=en_US

المنصات المدعومة

يوفر هذا المستبدل لملفات JAR نصوصاً برمجية خاصة بكل منصة:

• Windows: نص برمجي بـ PowerShell (replace-filemaker-jars-windows.ps1)
• macOS: نص برمجي بـ Bash (replace-filemaker-jars-macos.sh)
• Ubuntu: نص برمجي بـ Bash (replace-filemaker-jars-ubuntu.sh)

بدء سريع

المتطلبات الأساسية

Windows

• Windows Server 2016+
• PowerShell 5.1 أو أحدث
• صلاحيات المسؤول (Administrator)
• تثبيت FileMaker Server

macOS

• macOS 10.15 (Catalina) أو أحدث
• قشرة Bash
• صلاحيات sudo
• تثبيت FileMaker Server

Ubuntu

• Ubuntu 20.04 LTS أو أحدث
• قشرة Bash
• صلاحيات sudo
• تثبيت FileMaker Server

الاستخدام

مهم: قبل إجراء أي تغييرات على FileMaker Server لديك، شغّل النص البرمجي مع خيار --dry-run للتحقق مما إذا كان خادمك معرّضاً للخطر ومعرفة التغييرات التي سيتم إجراؤها.

Windows

# Run PowerShell as Administrator

# Show help and available options
.\replace-filemaker-jars-windows.ps1 -Help

# Check if your server is vulnerable (RECOMMENDED FIRST STEP)
.\replace-filemaker-jars-windows.ps1 -DryRun

# Apply the security fix (only after reviewing dry-run results)
.\replace-filemaker-jars-windows.ps1

macOS

# Run with sudo privileges

# Show help and available options
sudo ./replace-filemaker-jars-macos.sh --help

# Check if your server is vulnerable (RECOMMENDED FIRST STEP)
sudo ./replace-filemaker-jars-macos.sh --dry-run

# Apply the security fix (only after reviewing dry-run results)
sudo ./replace-filemaker-jars-macos.sh

Ubuntu

# Run with sudo privileges

# Show help and available options
sudo ./replace-filemaker-jars-ubuntu.sh --help

# Check if your server is vulnerable (RECOMMENDED FIRST STEP)
sudo ./replace-filemaker-jars-ubuntu.sh --dry-run

# Apply the security fix (only after reviewing dry-run results)
sudo ./replace-filemaker-jars-ubuntu.sh

لماذا استخدام الوضع التجريبي (Dry Run) أولاً؟

يُعد خيار --dry-run الطريقة الأكثر أماناً من أجل:

• التحقق من حالة الثغرة دون إجراء أي تغييرات
• تحديد ملفات JAR التي يجب استبدالها
• التحقق من توافق النص البرمجي مع تثبيت FileMaker Server لديك
• معاينة جميع الإجراءات التي سيتم تنفيذها
• اكتشاف المشكلات المحتملة قبل إجراء التغييرات

قم دائماً بتشغيل --dry-run أولاً لفهم ما سيفعله النص البرمجي على نظامك.

الميزات

الاكتشاف التلقائي لملفات JAR واستبدالها

• يكتشف تلقائياً تثبيتات FileMaker Server وأدلة Web Publishing Engine
• يحدد ملفات JAR المعرّضة للخطر الخاصة بـ commons-text و commons-lang3
• يقوم بتنزيل ملفات JAR المحدّثة (commons-text 1.11.0+، commons-lang3 3.18.0+)
• ينفذ استبدالاً ذرياً (atomic) لملفات JAR مع التحقق من السلامة

نسخ احتياطي واسترداد شامل

• ينشئ نسخة احتياطية كاملة من ملفات JAR الحالية قبل الاستبدال
• تراجع تلقائي عند فشل الاستبدال
• التحقق من سلامة النسخة الاحتياطية

إدارة Web Publishing Engine

• يستخدم أداة سطر الأوامر الرسمية fmsadmin لإدارة الخدمات
• معالجة آمنة لبيانات الاعتماد لمصادقة fmsadmin
• إعادة تشغيل تلقائية لـ Web Publishing Engine بعد استبدال ملفات JAR
• التحقق من الوظائف بعد الاستبدال

نهج الأمان أولاً

• معالجة آمنة لبيانات الاعتماد (لا يتم تسجيلها أو عرضها أبداً)
• يدعم متغيرات البيئة وملفات .env
• يتحقق من صلاحيات الملفات الخاصة بملفات بيانات الاعتماد

تسجيل مفصّل

• تسجيل شامل للعمليات مع طوابع زمنية
• مواقع سجلات خاصة بكل منصة
• تتبع الأخطاء وإرشادات الاسترداد

واجهة سهلة الاستخدام

• مؤشرات حالة مرمّزة بالألوان
• تتبع التقدم للعمليات الطويلة
• رسائل خطأ واضحة وتعليمات استرداد

هيكل الدليل

filemaker-jar-replacer/
├── README.md                          # This file
├── replace-filemaker-jars-windows.ps1 # Windows PowerShell script
├── replace-filemaker-jars-macos.sh    # macOS Bash script
├── replace-filemaker-jars-ubuntu.sh   # Ubuntu Bash script
├── scripts/
│   ├── windows/
│   │   └── modules/                   # PowerShell modules for JAR operations
│   ├── macos/
│   │   └── modules/                   # Bash function modules for JAR operations
│   ├── ubuntu/
│   │   └── modules/                   # Bash function modules for JAR operations
│   └── shared/                        # Shared utilities and templates
├── config/
│   ├── logging-config.json           # Logging configuration
│   └── jar-replacement-config.json   # JAR replacement configuration
├── tests/                            # Test suite (BATS and Pester)
├── logs/                             # Log files (created during execution)
└── backups/                          # JAR backup files (created during execution)

الإعدادات

متغيرات البيئة

يمكنك إعداد المحدِّث باستخدام متغيرات البيئة:

# FileMaker Server credentials
export FILEMAKER_USERNAME="admin"
export FILEMAKER_PASSWORD="your_secure_password"

# Custom paths (optional)
export FILEMAKER_INSTALL_PATH="/custom/path/to/filemaker"
export BACKUP_DIRECTORY="/custom/backup/path"

دعم ملفات .env

أنشئ ملف .env في دليل النص البرمجي:

# .env file (must have 600 permissions)
FILEMAKER_USERNAME=admin
FILEMAKER_PASSWORD=your_secure_password
BACKUP_DIRECTORY=/custom/backup/path

مهم: تأكد من أن ملف .env لديه صلاحيات مقيدة (600) لأغراض الأمان.

عملية الاستبدال اليدوي لملفات JAR (خطة بديلة)

إذا فشل النص البرمجي الآلي، اتبع هذه الخطوات اليدوية لاستبدال ملفات JAR المعرّضة للخطر:

1. إيقاف Web Publishing Engine

Windows

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

# Or using services
Stop-Service "FileMaker Server Web Publishing Engine"

macOS

# Using fmsadmin (recommended)
sudo "/Library/FileMaker Server/Database Server/bin/fmsadmin" stop wpe -u admin -p password

# Or using launchctl
sudo launchctl stop com.filemaker.wpe