From 49387201fdc65dc8a125df58195c969521b09bf8 Mon Sep 17 00:00:00 2001 From: Paul Cornell Date: Wed, 25 Jun 2025 16:26:10 -0700 Subject: [PATCH] MongoDB connectors: clusters with only SCRAM-SHA-1 are not supported --- snippets/general-shared-text/mongodb.mdx | 28 ++++++++++++------------ 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/snippets/general-shared-text/mongodb.mdx b/snippets/general-shared-text/mongodb.mdx index a7cfea76..0a212de1 100644 --- a/snippets/general-shared-text/mongodb.mdx +++ b/snippets/general-shared-text/mongodb.mdx @@ -1,23 +1,23 @@ The MongoDB requirements for a MongoDB Atlas deployment include: - - import AllowIPAddressRanges from '/snippets/general-shared-text/ip-address-ranges.mdx'; import MongoDBRecordID from '/snippets/general-shared-text/mongodb-record-id.mdx'; + + For MongoDB Atlas, SCRAM-SHA-1 is not supported for authentication. This means that cluster types that only + include SCRAM-SHA-1, such as **Free**, **M0**, **Flex**, and **Serverless**, are **not** supported. + Unstructured only supports SCRAM-SHA-256 for MongoDB Atlas, which is cryptographically stronger than SCRAM-SHA-1. + + If you try to test or use a connector that refers to a cluster type that only includes SCRAM-SHA-1, the + operation will fail, and you will get an error message similar to the following: + `[digital envelope routines] unsupported`. + - A MongoDB Atlas account. [Create an account](https://www.mongodb.com/cloud/atlas/register). -- A MongoDB Atlas cluster. [Create a cluster](https://www.mongodb.com/docs/atlas/tutorial/deploy-free-tier-cluster). -- The cluster must be reachable from your application environment. [Learn how](https://www.mongodb.com/docs/atlas/setup-cluster-security/#network-and-firewall-requirements). -- The cluster must be configured to allow IP address. [Learn how](https://www.mongodb.com/docs/atlas/setup-cluster-security/#ip-access-list). +- A MongoDB Atlas cluster. [Create a cluster](https://www.mongodb.com/docs/atlas/tutorial/create-new-cluster/). Be sure to **not** + select a cluster type that only includes SCRAM-SHA-1, such as **Free**, **M0**, **Flex**, or **Serverless**. +- The cluster must be reachable from your application environment, for example by adding IP addresses to your IP access list. [Learn more](https://www.mongodb.com/docs/atlas/setup-cluster-security/#network-and-firewall-requirements). +- The cluster must be configured to allow IP address. [Learn how](https://www.mongodb.com/docs/atlas/security/ip-access-list/#add-ip-access-list-entries). @@ -38,7 +38,7 @@ import MongoDBRecordID from '/snippets/general-shared-text/mongodb-record-id.mdx 1. Log in to your MongoDB Atlas console. 2. In the sidebar, under **Databases**, click **Clusters**. 3. Click on the cluster you want to connect to. - 4. Click **Connect**, or click the **Cmd Line Tools** tab and then click **Connect Instructions**. + 4. Click **Connect**. 5. Click **Drivers**. 6. Under **Add your connection string into your application code**, copy the connection string. You can then close the **Connect** dialog in MongoDB Atlas.