Skip to content

Commit fba99d8

Browse files
xeno6696xeno6696
authored
Merge pull request #884 from kwwall/2.6.2.0
Prep work for ESAPI release 2.6.2.0
2 parents af4c901 + 950a56b commit fba99d8

File tree

3 files changed

+196
-2
lines changed

3 files changed

+196
-2
lines changed

‎documentation/esapi4java-core-2.6.2.0-release-notes.txt

Lines changed: 180 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,180 @@
1+
Release notes for ESAPI 2.6.2.0
2+
Release date: 2025-06-01
3+
Project leaders:
4+
-Kevin W. Wall <[email protected]>
5+
-Matt Seil <[email protected]>
6+
7+
Previous release: ESAPI 2.6.1.0, 2025-05-19
8+
9+
10+
Executive Summary: Important Things to Note for this Release
11+
------------------------------------------------------------
12+
This is a minor patch release with the intent of updating the Apache Commons BeanUtils dependency from v1.9.4 to v1.11.0 to CVE-2025-48734. This CVE wouuld only potentially affect application code that uses the ESAPI's AccessController component. It is extremently unlikely that anyone is using that because the default implmentation for that (the class "org.owasp.esapi.reference.DefaultAccessController") is really a toy implementation that doesn't scale to enterprise levels with out some customization. (The class "org.owasp.esapi.filters.ESAPIFilter" also uses "DefaultAccessController", but it is unlikely that anyone is using that either, unless they are using a customized AccessController implementation.) We plan to deprecate this ESAPI "DefaultAccessControler" shortly in a future release.
13+
14+
Notes if you are not updating from the immediate previous release. release 2.6.1.0:
15+
* You need to read through the series of release notes FIRST, going in order.
16+
* For example, if you were updating from an older ESAPI release (say, 2.3.0.0), you should go back and FIRST read all the subsequent release notes in turn. For instance, if you are currently on release 2.3.0.0 and upgrading to (say) release 2.x.y.z, you should MINIMALLY read the sections "Changes Requiring Special Attention" in each of the subsequent release notes. So, going from release 2.3.0.0 to 2.x.y.z, you should in turn, read:
17+
18+
esapi4java-core-2.4.0.0-release-notes.txt
19+
esapi4java-core-2.5.0.0-release-notes.txt
20+
esapi4java-core-2.5.1.0-release-notes.txt
21+
esapi4java-core-2.5.2.0-release-notes.txt
22+
...etc., up through the current set of release notes...
23+
esapi4java-core-2.x.y.z-release-notes.txt
24+
25+
in that order. YOU HAVE BEEN WARNED!!! (These release notes are too large to put all this in a given document; very few read them thoroughly as it is.)
26+
27+
If your SCA tool is reporting any CVE from a direct or transitive dependency in ESAPI, before reporting it as an GitHub issue, please make sure that you review the vulnerability analysis written up in https://github.com/ESAPI/esapi-java-legacy/blob/develop/Vulnerability-Summary.md. Please email us or contact us in our GitHub Discussions page if you have questions about this. See also the SECURITY.md file to report any security issues with ESAPI.
28+
29+
You are encouraged to review the vulnerability analysis written up in https://github.com/ESAPI/esapi-java-legacy/blob/develop/Vulnerability-Summary.md and email us or contact us in our GitHub Discussions page if you have questions.
30+
31+
32+
=================================================================================================================
33+
34+
Basic ESAPI facts
35+
-----------------
36+
37+
ESAPI 2.6.1.0 release:
38+
207 Java source files
39+
4312 JUnit tests in 133 Java source files
40+
41+
ESAPI 2.6.2.0 release:
42+
207 Java source files
43+
4312 JUnit tests in 133 Java source files
44+
45+
1 GitHub Issue closed in this release, including those we've decided not to fix (marked 'wontfix' and 'falsepositive').
46+
(Reference: https://github.com/ESAPI/esapi-java-legacy/issues?q=is%3Aissue+state%3Aclosed+updated%3A%3E%3D2025-05-19)
47+
48+
Issue # GitHub Issue Title
49+
----------------------------------------------------------------------------------------------
50+
883 Update Apache Commons BeanUtils from 1.9.4 to 1.11.0 to address CVE-2025-48734
51+
52+
-----------------------------------------------------------------------------
53+
54+
Changes Requiring Special Attention
55+
56+
-----------------------------------------------------------------------------
57+
Important JDK Support Announcement
58+
* ESAPI 2.3.0.0 was the last Java release to support Java 7. ESAPI 2.4.0 requires using Java 8 or later. See the ESAPI 2.4.0.0 release notes (https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/esapi4java-core-2.4.0.0-release-notes.txt) for details as to the reason.
59+
- This means if your project requires Java 7, you must use ESAPI 2.3.0.0 or earlier.
60+
61+
Important ESAPI Logging Changes
62+
63+
* Since ESAPI 2.5.0.0, support for logging directly via Log4J 1 has been removed. (This was two years after it haveing first been deprecated.) Thus, you only choice of ESAPI logging are
64+
- java.util.logging (JUL), which as been the default since ESAPI 2.2.1.0.
65+
* Set ESAPI.Logger=org.owasp.esapi.logging.java.JavaLogFactory in your ESAPI.properties file.
66+
- SLF4J (which your choice of supported SLF4J logging implemmentation)
67+
* Set ESAPI.Logger=org.owasp.esapi.logging.slf4j.Slf4JLogFactory in your ESAPI.properties file.
68+
* Logger configuration notes - If you are migrating from prior to ESAPI 2.2.1.1, you will need to update your ESAPI.properties file as logging-related configuration as per the ESAPI 2.2.1.1 release notes, which may be found at:
69+
https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/esapi4java-core-2.2.1.1-release-notes.txt#L39-L78
70+
71+
If you use ESAPI 2.5.0.0 or later, you will get an ClassNotFoundException as the root cause if you still have your ESAPI.Logger property set to use Log4J because the org.owasp.esapi.logger.log4j.Log4JFactory class has been completely removed from the ESAPI jar. If you are dead set on continuing to use Log4J 1, you ought to be able to do so via SLF4J. The set up for Log4J 1 (which has not be tested), should be similar to configure ESAPI to use SLF4J with Log4J 2 as described here:
72+
https://github.com/ESAPI/esapi-java-legacy/wiki/Using-ESAPI-with-SLF4J#slf4j-using-log4j-2x
73+
74+
-----------------------------------------------------------------------------
75+
76+
Remaining Known Issues / Problems
77+
78+
-----------------------------------------------------------------------------
79+
None known, other than the remaining open issues on GitHub.
80+
81+
-----------------------------------------------------------------------------
82+
83+
Other changes in this release, some of which not tracked via GitHub issues
84+
85+
-----------------------------------------------------------------------------
86+
87+
* Changes since last release 2.6.1.0 and 2.6.2.0, i.e., changes between 2025-05-19 and 2025-06-01).
88+
89+
Note: I am no longer going to provide the 'Developer Activity Report' that I used to this manually create in tabluar form. This is in part because I use to use 'mvn site' to assist with its creation, but neither the 'Developer Activiity' nor 'File Activity' sections of the 'mvn site' output is currently working.
90+
91+
That said, I don't care as this was always a major PITA and I think it had dubious value to start with.
92+
93+
Therefore, I am replacing it to a stock GitHub tag comparison of the current and previous release, which I can automate.
94+
95+
Please see,
96+
97+
https://github.com/ESAPI/esapi-java-legacy/compare/esapi-...esapi-2.6.2.0
98+
99+
for details. It contains all the information that the previous 'Developer Activity Reports' did and then some.
100+
101+
-----------------------------------------------------------------------------
102+
103+
CHANGELOG: Create your own. May I suggest:
104+
105+
git log --stat --since=2025-05-19 --reverse --pretty=medium
106+
107+
which will show all the commits since just after the previous (2.6.1.0) release.
108+
109+
Alternately, you can download the most recent ESAPI source and run
110+
111+
mvn site
112+
113+
which will create a CHANGELOG file named 'target/site/changelog.html'
114+
115+
116+
-----------------------------------------------------------------------------
117+
118+
Direct and Transitive Runtime and Test Dependencies:
119+
120+
$ mvn -B dependency:tree
121+
...
122+
[INFO] --- maven-dependency-plugin:3.8.1:tree (default-cli) @ esapi ---
123+
[INFO] org.owasp.esapi:esapi:jar:2.6.1.0
124+
[INFO] +- javax.servlet:javax.servlet-api:jar:3.1.0:provided
125+
[INFO] +- javax.servlet.jsp:javax.servlet.jsp-api:jar:2.3.3:provided
126+
[INFO] +- xom:xom:jar:1.3.9:compile
127+
[INFO] +- commons-beanutils:commons-beanutils:jar:1.11.0:compile
128+
[INFO] | +- commons-logging:commons-logging:jar:1.2:compile
129+
[INFO] | \- commons-collections:commons-collections:jar:3.2.2:compile
130+
[INFO] +- commons-configuration:commons-configuration:jar:1.10:compile
131+
[INFO] +- commons-lang:commons-lang:jar:2.6:compile
132+
[INFO] +- commons-fileupload:commons-fileupload:jar:1.5:compile
133+
[INFO] +- org.apache.commons:commons-collections4:jar:4.5.0-M2:compile
134+
[INFO] +- org.apache-extras.beanshell:bsh:jar:2.0b6:compile
135+
[INFO] +- org.owasp.antisamy:antisamy:jar:1.7.8:compile
136+
[INFO] | +- commons-io:commons-io:jar:2.19.0:compile
137+
[INFO] | +- org.apache.httpcomponents.client5:httpclient5:jar:5.4.4:compile
138+
[INFO] | | \- org.apache.httpcomponents.core5:httpcore5-h2:jar:5.3.4:compile
139+
[INFO] | +- org.apache.httpcomponents.core5:httpcore5:jar:5.3.4:compile
140+
[INFO] | +- org.apache.xmlgraphics:batik-css:jar:1.19:compile
141+
[INFO] | | +- org.apache.xmlgraphics:batik-shared-resources:jar:1.19:compile
142+
[INFO] | | +- org.apache.xmlgraphics:batik-util:jar:1.19:compile
143+
[INFO] | | | +- org.apache.xmlgraphics:batik-constants:jar:1.19:compile
144+
[INFO] | | | \- org.apache.xmlgraphics:batik-i18n:jar:1.19:compile
145+
[INFO] | | \- org.apache.xmlgraphics:xmlgraphics-commons:jar:2.11:compile
146+
[INFO] | +- org.htmlunit:neko-htmlunit:jar:4.11.0:compile
147+
[INFO] | +- xerces:xercesImpl:jar:2.12.2:compile
148+
[INFO] | \- xml-apis:xml-apis-ext:jar:1.3.04:compile
149+
[INFO] +- org.slf4j:slf4j-api:jar:2.0.16:compile
150+
[INFO] +- xml-apis:xml-apis:jar:1.4.01:compile
151+
[INFO] +- com.github.spotbugs:spotbugs-annotations:jar:4.9.3:compile (optional)
152+
[INFO] | \- com.google.code.findbugs:jsr305:jar:3.0.2:compile (optional)
153+
[INFO] +- commons-codec:commons-codec:jar:1.17.1:test
154+
[INFO] +- junit:junit:jar:4.13.2:test
155+
[INFO] +- org.bouncycastle:bcprov-jdk18on:jar:1.78.1:test
156+
[INFO] +- org.hamcrest:hamcrest-core:jar:2.2:test
157+
[INFO] | \- org.hamcrest:hamcrest:jar:2.2:test
158+
[INFO] +- org.powermock:powermock-api-mockito2:jar:2.0.9:test
159+
[INFO] | \- org.powermock:powermock-api-support:jar:2.0.9:test
160+
[INFO] +- org.mockito:mockito-core:jar:3.12.4:test
161+
[INFO] | +- net.bytebuddy:byte-buddy:jar:1.11.13:test
162+
[INFO] | +- net.bytebuddy:byte-buddy-agent:jar:1.11.13:test
163+
[INFO] | \- org.objenesis:objenesis:jar:3.2:test
164+
[INFO] +- org.powermock:powermock-core:jar:2.0.9:test
165+
[INFO] | \- org.javassist:javassist:jar:3.27.0-GA:test
166+
[INFO] +- org.powermock:powermock-module-junit4:jar:2.0.9:test
167+
[INFO] | \- org.powermock:powermock-module-junit4-common:jar:2.0.9:test
168+
[INFO] +- org.powermock:powermock-reflect:jar:2.0.9:test
169+
[INFO] \- org.openjdk.jmh:jmh-core:jar:1.37:test
170+
[INFO] +- net.sf.jopt-simple:jopt-simple:jar:5.0.4:test
171+
[INFO] \- org.apache.commons:commons-math3:jar:3.6.1:test
172+
[INFO] ------------------------------------------------------------------------
173+
-----------------------------------------------------------------------------
174+
175+
Acknowledgments:
176+
Thanks to GitHub Advanced Security's Dependabot SCA tool for flagging and fixing this one. And thanks to Matt Seil, Jeremiah Stacey, and all the ESAPI users who make this worthwhile. This is for you.
177+
178+
A special thanks to the ESAPI community from the ESAPI project co-leaders:
179+
Kevin W. Wall (kwwall) <== The irresponsible party for these release notes!
180+
Matt Seil (xeno6696)

‎pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@
141141
<!-- TODO: Be sure to update. Should be date of previous official release -->
142142
<!-- Exact date in the form 'yyyy-dd-yy 00:00:00' should be used. You can find the previous release date -->
143143
<!-- in the previous release notes file under the 'documentation/' directory. -->
144-
<date.prev_release>2024-11-25 00:00:00</date.prev_release>
144+
<date.prev_release>2025-05-19 00:00:00</date.prev_release>
145145
</properties>
146146

147147
<dependencies>
@@ -478,7 +478,7 @@
478478
<plugin>
479479
<groupId>org.apache.maven.plugins</groupId>
480480
<artifactId>maven-clean-plugin</artifactId>
481-
<version>3.4.1</version>
481+
<version>3.5.0</version>
482482
</plugin>
483483

484484
<plugin>

‎scripts/vars.2.6.2.0

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Do NOT edit this file directly. It will be created by the new createVarsFile.sh script,
2+
# which should be run prior to the newReleaseNotes.sh script.
3+
4+
# ESAPI (new / current) version
5+
VERSION=2.6.2.0
6+
7+
# Previous ESAPI version
8+
PREV_VERSION=2.6.1.0
9+
10+
# Release date of current version in yyyy-mm-dd format
11+
YYYY_MM_DD_RELEASE_DATE=2025-06-01
12+
13+
# Previous ESAPI release date in same format
14+
PREV_RELEASE_DATE=2025-05-19

0 commit comments

Comments
 (0)