Incompatible changes
Incompatible changes refer to changes that impact existing functionality and may affect your migration from a previous release. Before you upgrade, review these lists and make the appropriate changes to your scripts and plugins.
Changes in Java Agent 2024.9
Monitoring
The common REST monitoring endpoint has been removed. Use the Prometheus endpoint for monitoring your deployment.
Changes in Java Agent 2024.6
Commons Audit Framework
To improve security, the audit handling code is deprecated and replaced by the Commons Audit Framework.
To prevent logging of sensitive data for an audit event, the Commons Audit Framework uses a safelist to specify which audit event fields appear in the logs.
By default, only safelisted audit event fields are included in the logs. To include and exclude elements from JSON audit events, use Audit Log Include Paths and Audit Log Exclude Paths.
Changes in Java Agent 2023.11
There are no incompatible changes in this release or any of its maintenance releases.
Changes in Java Agent 2023.9
Tomcat Java Agent software update
The agent.jar
isn’t required for drop-in software update to
Java Agent 2023.9. If the file is present in the container, delete it as
described in Tomcat Java Agent software update.
JBoss and WildFly Java Agent software update
You must now provide the full path to
jee-agents-sdk-version.jar
in the module.xml
file for drop-in software update to Java Agent 2023.9.
The following libraries are no longer required:
-
agent.jar
-
jee-agents-jboss-common-version.jar
-
tyrus-standalone-client-version.jar
For more information, refer to JBoss and WildFly Java Agent software update.
Changes in Java Agent 2023.3
JDK 11 with WebLogic 12c Java Agent and WebSphere Java Agent
WebLogic 12c Java Agent and WebSphere Java Agent do not support JDK 11, which is the minimum JDK version supported in this release. Consequently, these platforms are not supported in this release. Use Java Agent 5.10 or an earlier version for these platforms.
Changes in Java Agent 5.10
Logback
Log messages in Java Agent and third-party dependencies are now recorded using the Logback implementation of the Simple Logging Facade for Java (SLF4J) API.
From this release, TRACE
is the highest log level. In previous releases,
ON
was the highest log level.
From this release, when the log level is ON
, TRACE
level logs are written to
file. In previous releases, TRACE
level logs were written to the standard output.
Changes in Java Agent 5.9
Advice format for session upgrade
During session upgrade when both Enable SSO Token Acceptance
and Enable Custom Login Mode
are true
, the composite advice has the new format:
?authIndexType=composite_advice&authIndexValue=<Advices Value>
.
When either property is false
, the composite advice is not changed from the
previous format: ?composite_advice=<Advices Value>
AM 5.x.x EOL
AM 5.x.x has reached End of Life and is no longer supported. For more information, refer to Ping Identity Product Support Lifecycle Policy | PingGateway and Agents.