Skip to content

Commit a665298

Browse files
authored
MongoDB connectors: clusters with only SCRAM-SHA-1 are not supported (#672)
1 parent 427c263 commit a665298

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

snippets/general-shared-text/mongodb.mdx

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
The MongoDB requirements for a MongoDB Atlas deployment include:
22

3-
<iframe
4-
width="560"
5-
height="315"
6-
src="https://www.youtube.com/embed/g6qDfbg808M"
7-
title="YouTube video player"
8-
frameborder="0"
9-
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
10-
allowfullscreen
11-
></iframe>
12-
133
import AllowIPAddressRanges from '/snippets/general-shared-text/ip-address-ranges.mdx';
144
import MongoDBRecordID from '/snippets/general-shared-text/mongodb-record-id.mdx';
155

6+
<Warning>
7+
For MongoDB Atlas, SCRAM-SHA-1 is not supported for authentication. This means that cluster types that only
8+
include SCRAM-SHA-1, such as **Free**, **M0**, **Flex**, and **Serverless**, are **not** supported.
9+
Unstructured only supports SCRAM-SHA-256 for MongoDB Atlas, which is cryptographically stronger than SCRAM-SHA-1.
10+
11+
If you try to test or use a connector that refers to a cluster type that only includes SCRAM-SHA-1, the
12+
operation will fail, and you will get an error message similar to the following:
13+
`[digital envelope routines] unsupported`.
14+
</Warning>
1615

1716
- A MongoDB Atlas account. [Create an account](https://www.mongodb.com/cloud/atlas/register).
18-
- A MongoDB Atlas cluster. [Create a cluster](https://www.mongodb.com/docs/atlas/tutorial/deploy-free-tier-cluster).
19-
- The cluster must be reachable from your application environment. [Learn how](https://www.mongodb.com/docs/atlas/setup-cluster-security/#network-and-firewall-requirements).
20-
- The cluster must be configured to allow IP address. [Learn how](https://www.mongodb.com/docs/atlas/setup-cluster-security/#ip-access-list).
17+
- A MongoDB Atlas cluster. [Create a cluster](https://www.mongodb.com/docs/atlas/tutorial/create-new-cluster/). Be sure to **not**
18+
select a cluster type that only includes SCRAM-SHA-1, such as **Free**, **M0**, **Flex**, or **Serverless**.
19+
- 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).
20+
- 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).
2121

2222
<AllowIPAddressRanges />
2323

@@ -38,7 +38,7 @@ import MongoDBRecordID from '/snippets/general-shared-text/mongodb-record-id.mdx
3838
1. Log in to your MongoDB Atlas console.
3939
2. In the sidebar, under **Databases**, click **Clusters**.
4040
3. Click on the cluster you want to connect to.
41-
4. Click **Connect**, or click the **Cmd Line Tools** tab and then click **Connect Instructions**.
41+
4. Click **Connect**.
4242
5. Click **Drivers**.
4343
6. Under **Add your connection string into your application code**, copy the connection string.
4444
You can then close the **Connect** dialog in MongoDB Atlas.

0 commit comments

Comments
 (0)