Open cfserialfilter.txt in <CF_HOME>/lib.
Last updated on
Aug 25, 2023
ColdFusion (2021 release) Update 10
Note:
The updates below are cumulative and contain all updates from previous ones. If you are skipping updates, you can apply the latest update, not those you are skipping. Further, you must take note of any changes that are implemented in each of the updates you are skipping.
To install previous updates, see ColdFusion (2021 release) updates.
Alert:
The Oracle Java CPU update released in July 2023 introduced an additional validation of ZIP64 extra fields that is known to cause an issue while downloading and/or applying the ColdFusion updates that were released on July 19, 2023 and Aug 17, 2023.
As a workaround, if you using the above JDK, you will need to install the update manually by using the command:
java -Djdk.util.zip.disableZip64ExtraFieldValidation=true -jar hotfix.jar
Note that this issue is only specific to the July CPU JDK patch release. If you're using Java bundled with ColdFusion, the update will install without any issues.
Adobe would like to thank Charlie Arehart for proposing this workaround.
What's new and changed
ColdFusion (2021 release) Update 10 (release date, 17 August, 2023) introduces the ColdFusion serial filter that can be used to allow or disallow Java classes or packages for the deserialization of Wddx packets.
ColdFusion SerialFilter
To ensure protection against insecure wddx deserialization attacks, a few vetted classes from the java.util package have been enumerated as allowed classes for deserialization, and are listed in the file cfserialfilter.txt. View the ColdFusion serialfilter document for more information.
Note:
If a few components in your applications aren't working because of this change, check the log files (check wddx.log present in <CF_HOME>/logs for the class/package that is blocked).
Follow these steps to allow or disallow a package:
-
-
If you want to allow a class or package, add it in the format:
- Class: java.<.package_name>.<class_name>;
- Package: java.<package_name>.**;
-
If you want to disallow a particular class or package, add it in the format:
- Class: !java.<.package_name>.<class_name>;
- Package: !java.<package_name>.**;
Note:The order in which the packages or classes are listed is important.
Let’s take an example. If you've allowed the package "java.util.**;" and want to block a class "java.util.Date;" in the package, use "!java.util.Date;java.util.**;".
In the example, if you reverse the order (i.e., java.util.**;!java.util.Date), by default, all classes in the package "java.util.**" will be allowed.
-
Restart ColdFusion.
Java serialfilter
Use the serialfilter.txt file to disallow the classes or packages to block Java deserialization. By default, all packages are allowed for Java deserialization. For more information, see Serialfilter file.
Standalone installation
-
Open the file serialfilter.txt in <CF_HOME>/lib.
-
Add the class or package:
- Class: !java.<.package_name>.<class_name>;
- Package: !java.<package_name>.**;
-
Restart ColdFusion.
JEE installation
On JEE installations, set the following JVM flag, "-Djdk.serialFilter= !org.mozilla.**;!com.sun.syndication.**;!org.apache.commons.beanutils.**", in the respective startup file depending on the type of Application Server being used.
For example:
- On Apache Tomcat Application Server, edit JAVA_OPTS in the Catalina.bat/sh file.
- On WebLogic Application Server, edit JAVA_OPTIONS in the startWeblogic.cmd file.
- On a WildFly/EAP Application Server, edit JAVA_OPTS in the standalone.conf file.
Security recommendations
Adobe strongly recommends securing your ColdFusion installations by applying server auto-lockdown and imposing IP restrictions on your server.
For more information, see:
Note:
If you are on Update 6, you need not download the bundle's folder, and can install Update 9 directly.
ColdFusion JDK flag requirements
COLDFUSION 2021 (version 2021.0.0.323925) and above
For Application Servers
On JEE installations, set the following JVM flag, "-Djdk.serialFilter= !org.mozilla.**;!com.sun.syndication.**;!org.apache.commons.beanutils.**;!org.jgroups.**;!com.sun.rowset.**", in the respective startup file depending on the type of Application Server being used.
For example:
- Apache Tomcat Application Server: edit JAVA_OPTS in the ‘Catalina.bat/sh’ file
- WebLogic Application Server: edit JAVA_OPTIONS in the ‘startWeblogic.cmd’ file
- WildFly/EAP Application Server: edit JAVA_OPTS in the ‘standalone.conf’ file
Set the JVM flags on a JEE installation of ColdFusion, not on a standalone installation.
Prerequisites
- On 64-bit computers, use 64-bit JRE for 64-bit ColdFusion.
- If the ColdFusion server is behind a proxy, specify the proxy settings for the server to get the update notification and download the updates. Specify proxy settings using the system properties below in the jvm.config for a stand-alone installation, or corresponding script file for JEE installation.
- http.proxyHost
- http.proxyPort
- http.proxyUser
- http.proxyPassword
- For ColdFusion running on JEE application servers, stop all application server instances before installing the update.
Installation
ColdFusion Administrator
In Package Manager > Packages, click Check for Updates in Core Server.
After it detects an update, click Update. The core package gets updated with the latest update.
All installed packages that needs an update get updated.
Restart ColdFusion for the changes to take effect.
Install the update in offline mode manually
- Download the hotfix installer from the link.
- Unzip the repository to a place where all ColdFusion server instances can access it.
- Update "packagesurl" in cfusion/lib/neo_updates.xml of cfusion and all its child instances to point to <InstallerReposityUnzippedPath>/bundles/bundlesdependency.json present inside the downloaded folder.
If the core server hotfix installation is successful and if there are errors or issues with packages, packages can be installed/updated from the package manager client(cfusion\bin\cfpm.bat|cfpm.sh).
You must have privileges to start or stop ColdFusion service and full access to the ColdFusion root directory.
- Windows: <cf_root>\jre\bin\java.exe -jar <InstallerReposityUnzippedPath>\bundles\updateinstallers\hotfix-010-330161.jar
- Linux-based platforms: <cf_root>/jre/bin/java -jar <InstallerReposityUnzippedPath>/bundles/updateinstallers/hotfix-010-330161.jar
Ensure that the JRE bundled with ColdFusion is used for executing the downloaded JAR. For standalone ColdFusion, this must be at, <cf_root>/jre/bin.
Install the update from a user account with permission to restart ColdFusion services and other configured webservers .
For further details on manually updating the application, see the help article.
Note:
Updating the core package updates all the packages that were downloaded. Also, updating any package updates the core and the rest of the packages. If ColdFusion (2021 release) is on Update 1, installing Update 10 via the admin of any instance updates the core for all other instances present.
Similarly, uninstalling the update from the same instance uninstalls the updates from instances that were updated together.
Post installation
Note:
After applying this update, the ColdFusion build number should be 2021.0.10.330161.
After applying this update, you must reinstall any custom hotfixes that might have been applied earlier. The hotfixes are located in the folder /ColdFusion2021/cfusion/hf-updates/hf-2021-00010-330161
/backup/lib/updates.
Uninstallation
To uninstall the update, perform one of the following:
- In ColdFusion Administrator, click Uninstall in Server Update > Updates > Installed Updates.
- Run the uninstaller for the update from the command prompt. For example, java -jar {cf_install_home}/{instance_home}/hf_updates/hf-2021-00010-330161/uninstall /uninstaller.jar
If you can't uninstall the update using the above-mentioned uninstall options, the uninstaller could be corrupted. However, you can manually uninstall the update by doing the following:
- Delete the update jar from {cf_install_home}/{instance_name}/lib/updates.
- Copy all folders from {cf_install_home}/{instance_name}/hf-updates/{hf-2021-00010-330161}/backup directory to {cf_install_home}/{instance_name}/