Skip to content

Commit d00905c

Browse files
committed
DOCSP-50019 - Remove EOL Server versions (#132)
(cherry picked from commit 0fa9d38) (cherry picked from commit 6112917) (cherry picked from commit e5d7536)
1 parent 4bd16dd commit d00905c

File tree

3 files changed

+20
-89
lines changed

3 files changed

+20
-89
lines changed

source/connect-to-mongo/network-compression.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ of data passed over the network between MongoDB and your application.
2323

2424
The driver supports the following algorithms:
2525

26-
- `Snappy <https://google.github.io/snappy/>`__: available in MongoDB 3.4 and later.
27-
- `Zlib <https://zlib.net/>`__: available in MongoDB 3.6 and later.
28-
- `Zstandard <https://github.com/facebook/zstd/>`__: available in MongoDB 4.2 and later.
26+
- `Snappy <https://google.github.io/snappy/>`__
27+
- `Zlib <https://zlib.net/>`__
28+
- `Zstandard <https://github.com/facebook/zstd/>`__
2929

3030
The driver tests against the following versions of these libraries:
3131

@@ -95,4 +95,4 @@ guide, see the following API documentation:
9595
- `MongoClient <{+api+}/mongodb-driver-reactivestreams/com/mongodb/reactivestreams/client/MongoClient.html>`__
9696
- `createSnappyCompressor() <{+api+}/mongodb-driver-core/com/mongodb/MongoCompressor.html#createSnappyCompressor()>`__
9797
- `createZlibCompressor() <{+api+}//mongodb-driver-core/com/mongodb/MongoCompressor.html#createZlibCompressor()>`__
98-
- `createZstdCompressor() <{+api+}/mongodb-driver-core/com/mongodb/MongoCompressor.html#createZstdCompressor()>`__
98+
- `createZstdCompressor() <{+api+}/mongodb-driver-core/com/mongodb/MongoCompressor.html#createZstdCompressor()>`__

source/includes/mongodb-compatibility-table-java-rs.rst

Lines changed: 6 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -6,87 +6,35 @@
66
* - {+java-rs} Driver Version
77
- MongoDB 8.0
88
- MongoDB 7.0
9-
- MongoDB 6.1
109
- MongoDB 6.0
11-
- MongoDB 5.0
12-
- MongoDB 4.4
13-
- MongoDB 4.2
14-
- MongoDB 4.0
15-
- MongoDB 3.6
1610

17-
* - 5.2
11+
* - 5.2 to 5.5
1812
- ✓
1913
- ✓
2014
- ✓
2115
- ✓
22-
- ✓
23-
- ✓
24-
- ✓
25-
- ✓
26-
-
2716

2817
* - 4.10 to 5.1
2918
- ⊛
3019
- ✓
3120
- ✓
32-
- ✓
33-
- ✓
34-
- ✓
35-
- ✓
36-
- ✓
37-
- ✓
3821

39-
* - 4.8 to 4.9
22+
* - 4.7 to 4.9
4023
- ⊛
4124
- ⊛
42-
- ✓
43-
- ✓
44-
- ✓
45-
- ✓
46-
- ✓
47-
- ✓
48-
- ✓
49-
50-
* - 4.7
5125
- ⊛
52-
- ⊛
53-
- ⊛
54-
- ✓
55-
- ✓
56-
- ✓
57-
- ✓
58-
- ✓
5926
- ✓
6027

61-
* - 4.3 to 4.6
28+
* - 4.0 to 4.6
6229
- ⊛
6330
- ⊛
6431
- ⊛
6532
- ⊛
66-
- ✓
67-
- ✓
68-
- ✓
69-
- ✓
70-
- ✓
7133

72-
* - 4.1 to 4.2
73-
- ⊛
74-
- ⊛
34+
* - 3.11 to 3.12
35+
- ✗ [#v3-note]_
7536
- ⊛
7637
- ⊛
7738
- ⊛
78-
- ✓
79-
- ✓
80-
- ✓
81-
- ✓
8239

83-
* - 4.0
84-
- ⊛
85-
- ⊛
86-
- ⊛
87-
- ⊛
88-
- ⊛
89-
- ⊛
90-
- ✓
91-
- ✓
92-
- ✓
40+
.. [#v3-note] These driver versions are not compatible with MongoDB 8.1 or later because of an authentication issue. To learn more, see :ref:`java-rs-server-8.1-incompatibility`.

source/security/auth.txt

Lines changed: 10 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -42,13 +42,8 @@ mechanisms.
4242
Default Authentication Mechanism
4343
--------------------------------
4444

45-
In MongoDB 3.0, MongoDB changed the default authentication mechanism
46-
from ``MONGODB-CR`` to ``SCRAM-SHA-1``. In MongoDB 4.0, support for
47-
the deprecated ``MONGODB-CR`` mechanism was removed and ``SCRAM-
48-
SHA-256`` support was added.
49-
5045
To create a credential that authenticates by using the default
51-
authentication mechanism, regardless of server version, create a
46+
authentication mechanism, ``SCRAM-SHA-256``, create a
5247
credential by using the ``createCredential()`` static factory method:
5348

5449
.. code-block:: java
@@ -73,33 +68,24 @@ authentication mechanism:
7368

7469
MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authSource=db1");
7570

76-
For challenge and response mechanisms, using the default
77-
authentication mechanism is the recommended approach, as it makes
78-
upgrading from MongoDB 2.6 to MongoDB 3.0 more simple, even after
79-
upgrading the authentication schema. For MongoDB 4.0 users, using the
80-
default authentication mechanism is also recommended as the mechanisms are
81-
checked and the correct hashing algorithm is used.
71+
For challenge and response mechanisms, we recommend using the default
72+
authentication mechanism. This simplifies upgrades and ensures that the correct hashing
73+
algorithm is used.
8274

8375
SCRAM-Based Mechanisms
8476
----------------------
8577

86-
Salted Challenge-Response Authentication Mechanism (``SCRAM``) has been
87-
the default authentication mechanism for MongoDB since 3.0. ``SCRAM`` is
78+
Salted Challenge-Response Authentication Mechanism (``SCRAM``) is
8879
based on the `IETF RFC 5802
8980
<https://datatracker.ietf.org/doc/html/rfc5802>`__ standard that defines
9081
best practices for implementation of challenge-response mechanisms for authenticating
91-
users with passwords.
92-
93-
MongoDB 3.0 introduced support for ``SCRAM-SHA-1``, which uses the
94-
``SHA-1`` hashing function. MongoDB 4.0 introduced support for ``SCRAM-
95-
SHA-256`` which uses the ``SHA-256`` hashing function.
82+
users with passwords. MongoDB supports both ``SCRAM-SHA-1``, which uses the
83+
``SHA-1`` hashing function, and ``SCRAM-
84+
SHA-256``, which uses the ``SHA-256`` hashing function.
9685

9786
SCRAM-SHA-256
9887
~~~~~~~~~~~~~
9988

100-
Using this mechanism requires MongoDB 4.0 and
101-
``featureCompatibilityVersion`` to be set to 4.0.
102-
10389
To explicitly create a credential of type ``SCRAM-SHA-256``, use
10490
the ``createScramSha256Credential()`` method:
10591

@@ -149,7 +135,6 @@ To explicitly create a credential of type ``SCRAM-SHA-1``, use the
149135
Or, you can use a connection string that explicitly specifies
150136
``authMechanism=SCRAM-SHA-1``:
151137

152-
153138
.. code-block:: java
154139

155140
MongoClient mongoClient = MongoClients.create("mongodb://user1:pwd1@host1/?authSource=db1&authMechanism=SCRAM-SHA-1");
@@ -159,12 +144,10 @@ MONGODB-CR
159144

160145
.. important::
161146

162-
Starting in version 4.0, MongoDB removes support for the deprecated
147+
MongoDB no longer supports the deprecated
163148
MongoDB Challenge-Response (``MONGODB-CR``) authentication mechanism.
164-
165149
If your deployment has user credentials stored in a ``MONGODB-CR`` schema,
166-
you must upgrade to use a ``SCRAM``-based mechanism before you
167-
upgrade to version 4.0.
150+
you must upgrade to a ``SCRAM``-based mechanism.
168151

169152
To explicitly create a credential of type ``MONGODB-CR`` use the
170153
``createMongCRCredential()`` static factory method:

0 commit comments

Comments
 (0)