--- schema_version: "1" id: 1c089c6c7a3baba7914884e156c18c43c558488104dca01cc326820e4c72273e title: Azure Service Bus Connector Release Notes collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/release-notes/connector/azure-service-bus-connector-release-notes-mule-4.md canonical_url: https://docs.mulesoft.com/jp/release-notes/connector/azure-service-bus-connector-release-notes-mule-4 source_site: docs.mulesoft.com content_type: documentation content_hash: 9ecb0ffd2b192318f130dd7349d04113e18a821410eea2f8491b67b59e222825 description: MuleSoft Documentation Site latest: true --- # Azure Service Bus Connector Release Notes Support Category: [Select](https://www.salesforce.com/en-us/wp-content/uploads/sites/4/documents/legal/Agreements/versioning-back-support-policy.pdf) Anypoint Connector for Azure Service Bus (Azure Service Bus Connector) makes it easy to build integrations that send messages to and receive messages from Azure Service Bus, which is an asynchronous messaging cloud platform. This connector supports communication with queues and topics and can perform actions such as: - Send to queue - Send to topic - Receive from queue - Receive from subscription Guide: [Azure Service Bus Connector User Guide](https://docs.mulesoft.com/microsoft-azure-sb-connector/latest/) ## [](#3-8-1)3.8.1 **October 7, 2026** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

7.17.20

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The Send and Send batch of messages operations now throw AZURE-SERVICE-BUS-MESSAGING:PAYLOAD_SIZE_EXCEEDED when a message exceeds the destination maximum size. Previously, some oversized messages were dropped and the flow completed as if the send succeeded.

W-23859601

The Message Listener source now recovers after Azure force-detaches an idle AMQP receive link. Previously, the listener stopped consuming after about 10 minutes with no messages until the application was restarted.

W-24207700

The Message Listener source now stops when the subscribed queue or subscription is ReceiveDisabled, instead of reconnecting in a tight loop against a healthy namespace. Re-enable Receive and restart the flow to resume consumption.

W-24070614

These libraries are upgraded to address reported security vulnerabilities:

  • The azure-messaging-servicebus library is upgraded to version 7.17.20.

  • The azure-identity library is upgraded to version 1.18.6.

  • The jackson-databind and jackson-core libraries are upgraded to version 2.22.3.

  • The reactor-core library is upgraded to version 3.8.7.

  • The proton-j library is upgraded to version 0.35.0.

  • The azure-core-http-netty library is replaced with azure-core-http-okhttp version 1.13.6.

W-24262985, W-23441771, W-24137088, W-3300013
## [](#3-8-0)3.8.0 **August 19, 2026** ### What’s New - The **Message Listener** source now supports the new **Enable Dynamic Sessions** field. Enable this field to process session-enabled entities whose session IDs are generated dynamically and not known in advance. Instead of locking a fixed **Message Session Id**, each consumer continuously accepts the next available Service Bus session, drains it, and rolls to the next one. The **Number Of Consumers** field controls how many sessions are processed concurrently. This field can’t be combined with a fixed **Message Session Id** or with **Consume From Dead Letter Queue**. For more information, refer to [Message Listener](https://docs.mulesoft.com/microsoft-azure-sb-connector/latest/azure-service-bus-connector-reference#message-listener) and see the [Receive Messages from Dynamically Generated Sessions](https://docs.mulesoft.com/microsoft-azure-sb-connector/latest/azure-service-bus-connector-examples#dynamic-sessions) example. - The **Message Listener** source now supports the new **Session Idle Timeout** field, which applies only when **Enable Dynamic Sessions** is enabled. Use this field to specify the maximum time a consumer waits for the next message within the currently locked session before treating the session as idle, releasing it, and rolling to the next available session. Configure this duration using an ISO-8601 string. The default value (`PT30S`) preserves existing behavior. For more information, refer to [Message Listener](https://docs.mulesoft.com/microsoft-azure-sb-connector/latest/azure-service-bus-connector-reference#message-listener). ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

7.17.16

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
## [](#3-7-0)3.7.0 **July 8, 2026** ### What’s New - The **Message Listener** source now includes the new **Max Auto Lock Renew Duration** field to specify how long the SDK automatically renews message locks during processing. You can configure this duration using an ISO-8601 string, replacing the previous fixed 5-minute limit. The default value (`PT5M`) preserves existing behavior. Additionally, the connector logs a structured warning if a message lock expires before settlement and warns at startup if the configured duration is shorter than the broker entity’s broker-side lock duration. - The **Message Listener** source now supports the new **Consume From Dead Letter Queue** field. Enable this field to consume messages directly from a queue’s or subscription’s native dead-letter sub-queue (`$deadletterqueue`), without manually constructing the sub-queue path. - The connector now includes a new **Dead Letter** operation. Use this operation to send a locked message to its entity’s native dead-letter sub-queue, with an optional reason, description, and custom properties. - The output attributes for received messages now include the new **Dead Letter Reason** and **Dead Letter Error Description** fields, which are populated when consuming messages from a dead-letter sub-queue. ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

7.17.16

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
## [](#3-6-1)3.6.1 **March 18, 2026** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

7.17.16

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The connector now correctly honors the configured connection retry strategy for the Message Listener source. Previously, certain connection failures caused the receiver to stop without attempting to re-establish a connection.

W-21289737

The connector with the Azure Active Directory connection type now correctly validates connections for service principals that have only Send or Listen permissions and don’t have management-plane access. Previously, connection validation failed with the MULE:CONNECTIVITY error even though the credentials were valid and the principal could successfully send and receive messages.

W-21379356
## [](#3-6-0)3.6.0 **January 9, 2026** ### What’s New - The connector now uses the `azure-identity` library for authentication, replacing manual token handling. This provides built-in token caching and automatic refresh. - The **Message Listener** source now supports the new **Enable Auto Lock Renewal** field. Use this field to specify whether the source should automatically renew message locks, preventing lock expiration during long-running message processing. - The connector now uses the built-in Azure Service Bus exponential backoff mode for its retry behavior. This replaces custom retry logic with a standardized approach that automatically increases wait times between attempts, providing better connection stability during service interruptions or high-load periods. - The **Minimum Retry Backoff** field for the **Shared Access Signature** and **Azure Active Directory** connection types is now set to a default of 1 second. This must be a positive integer and setting it to zero results in ineffective retry behavior. - The **Increased Wait On Server Busy** and **Increased Wait On Server Busy Time Unit** fields are deprecated and no longer supported for **Shared Access Signature** and **Azure Active Directory** connection types. These behaviors are now fully managed by the Azure Service Bus Java SDK. - The new Azure Service Bus Java SDK v7.17.16 produces more detailed background logs. To keep your application logs clean, add `` to your `log4j2.xml` configuration to suppress excessive AMQP debug information. ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

7.17.16

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
## [](#3-5-2)3.5.2 **November 21, 2025** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The io.netty:netty-codec, io.netty:netty-codec-http, com.fasterxml.jackson.core:jackson-core, com.squareup.okio:okio, com.squareup.okio:okio-jvm, and com.google.guava:guava libraries are updated explicitly to address the outdated version in the app pom.xml file.

W-20146653
## [](#3-5-1)3.5.1 **September 24, 2025** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The com.squareup.okhttp3 and net.minidev:json-smart libraries are added explicitly to address the outdated version in the app pom.xml file.

W-19602619

The org.apache.commons library is upgraded to version 3.18.0 to address reported security vulnerabilities.

W-19602619
## [](#3-5-0)3.5.0 **September 7, 2025** ### What’s New - Azure Service Bus Connector now supports session-aware queues. This feature adds the **Message Session Id** field to the **Message Listener** source, and renames the **Session Id** field to **Message Session Id** in the **Send** operation. For an example about how to use this feature, see [Send and Receive Messages Using Session IDs for Session-Aware Queues Example](https://docs.mulesoft.com/microsoft-azure-sb-connector/latest/azure-service-bus-connector-examples#send-receive-session-ids). ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
## [](#3-4-3)3.4.3 **June 26, 2025** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

These libraries are upgraded to address reported security vulnerabilities:

  • The com.squareup.okhttp3:okhttp library is upgraded to version 4.11.0.

  • The com.squareup.okio:okio library is upgraded to version 3.4.0.

  • The net.minidev:json-smart library is upgraded to version 2.5.2.

  • The com.google.guava:guava library is upgraded to version 32.1.3-jre.

W-18647584
## [](#3-4-2)3.4.2 **May 17, 2025** ### Compatibility
Application/Service Version

Mule

4.3.0 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The outdated dependency versions are upgraded to address reported security vulnerabilities.

W-18291109
## [](#3-4-1)3.4.1 **August 12, 2024** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.7

Microsoft Authentication Library for Java

1.16.2

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The Receive Batch operation no longer prefetches messages to prevent retrieving messages that might never be read.

W-16325071

The AZURE-SERVICE-BUS-MESSAGING:ANY error is now thrown instead of the MULE:ANY error.

W-14052254

The following libraries are upgraded to address reported security vulnerabilities:

  • The io.netty:netty-codec, io.netty:netty-codec-http, io.netty:netty-common, io.netty:netty-codec-socks, io.netty:netty-handler-proxy, and io.netty:netty-handler libraries are upgraded to version 4.1.112.Final.

  • The com.microsoft.azure:azure-servicebus library is upgraded to version 3.6.7.

  • The com.microsoft.azure:msal4j library is upgraded to version 1.16.2.

  • The commons-io:commons-io library is upgraded to version 2.16.1.

  • The commons-codec:commons-codec library is upgraded to version 1.17.1.

  • The com.fasterxml.jackson.core:jackson-databind library is upgraded to version 2.17.2.

W-14462875
## [](#3-4-0)3.4.0 **June 25, 2024** ### What’s New - Use the new **Azure endpoint** field to construct the complete URL that the connector uses to establish a connection. ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The following libraries are upgraded:

  • com.google.guava:guava from 32.0.1-jre to 32.1.3-jre.

  • com.microsoft.azure:msal4j from 1.11.0 to 1.15.1.

W-15747087
## [](#3-3-0)3.3.0 **May 31, 2024** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8, 11, and 17
### Fixed Issues
Issue Resolution ID

The debug logging is now improved.

W-15613142

The connector now sends the correct ANY error type propagation for the Send operation.

W-15829526

The connector now allows disabling the producers (senders) cache.

W-15861141

The connector now allows to set additional backoff time whenever there is a ServerBusyException.

W-15846020
## [](#3-2-8)3.2.8 **February 6, 2024** ### What’s New - This connector is now compatible with Java 17. ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8, 11, and 17
## [](#3-2-7)3.2.7 **September 19, 2023** ### What’s New - The okio version 3.4.0 dependency was added. The following dependencies are upgraded: - json-smart 2.4.7 to 2.4.9 - netty-handler 4.1.48.Final to 4.1.94.Final - okhttp3 4.9.2 to 4.11.0 ### Fixed Issues
Issue Resolution ID

The following dependencies are upgraded:

  • json-smart 2.4.7 to 2.4.9

  • netty-handler 4.1.48.Final to 4.1.94.Final

  • okhttp3 4.9.2 to 4.11.0

W-14067647

The okio version 3.4.0 dependency was added.

W-14067647
### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
## [](#3-2-6)3.2.6 **July 19, 2023** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue Resolution ID

The correlation ID of the received message now matches the correlation ID of the flow.

W-13569728
## [](#3-2-5)3.2.5 **June 8, 2023** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue Resolution ID

Upgraded the Netty Codec library from io.netty:netty-codec:4.1.68.Final to io.netty:netty-codec:4.1.92.Final.

W-12665448
## [](#3-2-4)3.2.4 **April 28, 2023** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue Resolution ID

Upgraded the Jackson Core library from com.fasterxml.jackson.core:jackson-core:2.13.1 to com.fasterxml.jackson.core:jackson-core:2.15.0.

W-12665862
## [](#3-2-3)3.2.3 **October 25, 2022** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue ID

The TimeoutException message now contains more information about the related error.

W-11785747
## [](#3-2-2)3.2.2 **October 6, 2022** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue ID

The jackson-databind library is upgraded to version 2.14.0-rc1 to address reported security vulnerabilities.

W-11853417
## [](#3-2-1)3.2.1 **May 19, 2022** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
### Fixed Issues
Issue ID

Fixed reported security vulnerabilities by upgrading io.netty:netty-common from 4.1.68.Final to 4.1.77.Final.

W-11124604
## [](#3-2-0)3.2.0 **February 1, 2022** ### What’s New - Added the Azure Active Directory connection provider, which enables authentication via client credentials. ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

Microsoft Authentication Library for Java

1.11.0

OpenJDK

8 and 11
## [](#3-1-3)3.1.3 **December 7, 2021** ### Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.6.5

OpenJDK

8 and 11
### Fixed Issues
Issue ID

Fixed security vulnerabilities.

CONN-9253
## [](#3-1-2)3.1.2 **April 14, 2021** ### [](#compatibility-24)Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.4.0

OpenJDK

8 and 11
### [](#fixed-issues-18)Fixed Issues - The Message Listener will now try to reconnect if you disable and then re-enable a queue from the Azure Portal. (SE-20365) ## [](#3-1-1)3.1.1 **November 25, 2020** ### [](#compatibility-25)Compatibility
Application/Service Version

Mule

4.2.1 and later

Azure Service Bus Java SDK

3.4.0

OpenJDK

8 and 11
### [](#fixed-issues-19)Fixed Issues - Fixed the missing dependency error that occured when the connector was added to Studio 7. (SE-18475) ## [](#3-1-0)3.1.0 **October 7, 2020** ### [](#compatibility-26)Compatibility
Application/Service Version

Mule

4.1.1 and later

Azure Service Bus Java SDK

3.4.0

OpenJDK

8 and 11
### [](#fixed-issues-20)Fixed Issues - Fixed the `nimbus-jose-jwt` and `lang-tag` dependency versions to avoid the `Missing Jar` errors. (SE-17751) - Fixed the `Delivery not found on the receive link` error in the Abandon operation when using the manual ACK type. (SE-17703) - Added a parameter to configure `Buffered` or `Serial mode` in the Message Listener operation. (SE-17364) ## [](#3-0-2)3.0.2 **September 8, 2020** ### [](#compatibility-27)Compatibility
Application/Service Version

Mule

4.1.6 and later

Azure Service Bus Java SDK

3.4.0
### [](#fixed-issues-21)Fixed Issues Fixed security vulnerabilities. (CONN-6884) ## [](#3-0-1)3.0.1 **September 3, 2020** ### [](#compatibility-28)Compatibility
Application/Service Version

Mule

4.1.6 and later

Azure Service Bus Java SDK

3.4.0
### [](#fixed-issues-22)Fixed Issues Fixed the `Delivery not found on the receive link` error in the Complete operation when using ACK manual type. (SE-17352) ## [](#3-0-0)3.0.0 **July 31, 2020** New release ### [](#compatibility-29)Compatibility
Application/Service Version

Mule

4.1.6 and later

Azure Service Bus Java SDK

3.4.0
### [](#features)Features Azure Service Bus Connector offers the following features: - Send and Fetch Multiple Messages Use the connector to send messages and fetch messages in batches. - Perform ACK’s and NACK’s Leverage the connector’s capabilities to acknowledge a message or to abandon a message. For a list of supported configurations and operations, see the Azure Service Bus Connector Reference Guide. ## [](#see-also)See Also - [Salesforce Help](https://help.salesforce.com) - [MuleSoft Services](https://www.mulesoft.com/support-and-services) - [Known Issues](https://help.salesforce.com/s/issues)