Upgrading and Migrating WSS Module to Version 2.0

Upgrade WSS Module to version 2.x.

Supported Upgrade Paths

From Version	To Version
1.x	2.x

From Version

To Version

1.x

2.x

Changes in This Release

WSS Module 2.0 includes these changes.

WSS Module (and its dependencies) are now compilable and compatible only with Java 17.
To align with modern development practices and ensure continued compatibility with secure and supported libraries, WSS Module is upgraded from Spring 5.x to the latest stable Spring 6.x version (Spring Framework 6.4.6).
In the Encryption Config type, the EMBEDDED_KEY_NAME option has been removed from the Encryption Key Identifier field.

Upgrade Prerequisites

Before you perform the upgrade, you must create a backup of your files, data, and configurations in case you need to restore them.

Upgrade Steps

Follow these steps to perform the upgrade:

In Anypoint Studio, right-click the project and select Manage Dependencies > Manage Modules.
Select Web Service Security Module and click Update version.
Click Apply and Close.
Verify that the WSS Module dependency version is 2.0.0 in the pom.xml file in the Mule project.

Alternatively, you can manually update the WSS Module dependency version in the pom.xml file in the Mule project, or simply add the updated module to the project.

Verify the Upgrade

After you upgrade the connector, follow these steps to verify the upgrade:

In Studio, verify that there are no errors in the Problems or Console views.
Verify that there are no problems in the project pom.xml file.
Test the connection to verify that the operations work.

Troubleshoot

If there are problems with caching the parameters and caching the metadata, try restarting Anypoint Studio.

Revert the Upgrade

If it is necessary to revert to the previous version of WSS Module, change the WSS Module dependency version 2.0.0 in the project’s pom.xml to the previous version.

You must update the project’s pom.xml in Anypoint Studio.