---
schema_version: "1"
id: 11df29ef21b03570f00a99601d49753be90303a7e2776a23176972f70ef56bbf
title: Upgrading and Migrating WSS Module to Version 2.1
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/wss-module/2.1/wss-module-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/wss-module/2.1/wss-module-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 2ad3b70661570062ce90cce8086161a92fed4116ff0a19e581b219a29027eae4
description: MuleSoft Documentation Site
release: "2.1"
latest: false
---
---
product: WSS Module
version: 2.1
---

# Upgrading and Migrating WSS Module to Version 2.1

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade WSS Module to version 2.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>2.0.x</p></div></div></td><td><div><div><p>2.1.x</p></div></div></td></tr></tbody></table>

## Changes in This Release

WSS Module 2.1 includes these changes.

- WSS Module upgrades the default hashing algorithm from SHA-1 to SHA-256 to enhance cryptographic
  security and align with FIPS 140-3 approved standards.

## Upgrade Prerequisites

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

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, right-click the project and select **Manage Dependencies** > **Manage
    Modules**.

2.  Select `Web Service Security Module` and click **Update version**.

3.  Click **Apply and Close**.

4.  Verify that the WSS Module dependency version is `2.1.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:

1.  In Studio, verify that there are no errors in the **Problems** or **Console** views.

2.  Verify that there are no problems in the project `pom.xml` file.

3.  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’s necessary to revert to the previous version of WSS Module, change the WSS Module dependency
version `2.1.0` in the project’s `pom.xml` to the previous version.

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

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [WSS Module Reference](https://docs.mulesoft.com/wss-module/2.1/wss-reference)

- [Salesforce Help](https://help.salesforce.com)