This article follows announcement on a previous article that mentioned the end of support for Transport Security Layer (TLS) 1.0/1.1.

TLS 1.3 is the latest version of the internet’s most deployed security protocol, which encrypts data to provide a secure communication channel between two endpoints. Microsoft has implemented updates to enable TLS 1.3 for Azure Cosmos DB.

When will TLS 1.3 support begin? Copy link

Effective March 31, 2025, support for TLS 1.3 will be enabled for Azure Cosmos DB.

What issues might TLS 1.3 cause? Copy link

If your application relies on an Azure Cosmos DB SDK version between 4.20.0 and 4.40.0 with direct mode connections, and you are using a JRE/JDK version lower than 1.8.0_262, you might experience disruptions. Learn more about TLS 1.3 enablement in Azure Cosmos DB

Required action Copy link

To prevent any disruptions due to the rollout of TLS 1.3 support, we recommend Azure Cosmos DB customers using Java update to the latest Cosmos SDK or JRE version.

How to mitigate Copy link

• Upgrade Azure Cosmos DB Java SDK to the minimum recommended version.
• We recognize that upgrading to the latest SDK version might not always be feasible. While transitioning your application to the newest SDK, you can address this issue by switching the connection to Gateway Mode. Make sure to thoroughly test the application before deploying it in the production environment.

Leave a review Copy link

Tell us about your Azure Cosmos DB experience! Leave a review on PeerSpot and we’ll gift you $50. Get started here.

About Azure Cosmos DB Copy link

Azure Cosmos DB is a fully managed and serverless NoSQL and vector database for modern app development, including AI applications. With its SLA-backed speed and availability as well as instant dynamic scalability, it is ideal for real-time NoSQL and MongoDB applications that require high performance and distributed computing over massive volumes of NoSQL and vector data.

Try Azure Cosmos DB for free here. To stay in the loop on Azure Cosmos DB updates, follow us on X, YouTube, and LinkedIn