@@ -30,7 +30,6 @@ The Go driver supports the following authentication mechanisms:
3030
3131* :ref:`SCRAM-SHA-256 <golang_sha_256>`
3232* :ref:`SCRAM-SHA-1 <golang-sha-1>`
33- * :ref:`MONGODB-CR <golang-mongodb-cr>`
3433* :ref:`MongoDB-AWS <golang-mongodb-aws>`
3534* :ref:`X.509 <golang-x509>`
3635
@@ -60,33 +59,17 @@ Each authentication mechanism contains the following placeholders:
6059 authentication data. If you omit this option, the driver uses the
6160 default value ``admin``.
6261
62+ .. _golang_sha_256:
6363.. _golang-default-auth-mechanism:
6464
65- Default
66- ~~~~~~~
67-
68- The default mechanism uses one of the following authentication
69- mechanisms depending on what MongoDB versions your server supports:
70-
71- .. list-table::
72- :header-rows: 1
73- :stub-columns: 1
74- :class: compatibility-large
75-
76- * - Mechanism
77- - Versions
78-
79- * - ``SCRAM-SHA-256``
80- - MongoDB 4.0 and later
81-
82- * - ``SCRAM-SHA-1``
83- - MongoDB 3.0, 3.2, 3.4, and 3.6
65+ ``SCRAM-SHA-256``
66+ ~~~~~~~~~~~~~~~~~
8467
85- * - ``MONGODB-CR``
86- - MongoDB 2.6 and earlier
68+ ``SCRAM-SHA-256`` is a salted challenge-response authentication mechanism
69+ (SCRAM) that uses your database username and password, encrypted with the ``SHA-256``
70+ algorithm, to authenticate your user. This is the default authentication mechanism.
8771
88- To specify the default authentication mechanism, omit the
89- ``AuthMechanism`` option:
72+ To specify this default authentication mechanism, omit the ``AuthMechanism`` option:
9073
9174.. code-block:: go
9275
@@ -100,26 +83,8 @@ To specify the default authentication mechanism, omit the
10083
10184 client, err := mongo.Connect(clientOpts)
10285
103- To learn more about the challenge-response (CR) and salted
104- challenge-response authentication mechanisms (SCRAM) that MongoDB supports,
105- see the :manual:`SCRAM </core/security-scram/>` section of the server manual.
106-
107- .. _golang_sha_256:
108-
109- ``SCRAM-SHA-256``
110- ~~~~~~~~~~~~~~~~~
111-
112- .. important::
113-
114- ``SCRAM-SHA-256`` is the default authentication method for MongoDB starting
115- in MongoDB 4.0.
116-
117- ``SCRAM-SHA-256`` is a salted challenge-response authentication mechanism
118- (SCRAM) that uses your database username and password, encrypted with the ``SHA-256``
119- algorithm, to authenticate your user.
120-
121- To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
122- ``AuthMechanism`` option the value ``"SCRAM-SHA-256"``:
86+ You can also explicitly specify the ``SCRAM-SHA-256`` authentication mechanism
87+ by assigning the ``AuthMechanism`` option the value ``"SCRAM-SHA-256"``:
12388
12489.. code-block:: go
12590 :emphasize-lines: 2
@@ -135,17 +100,15 @@ To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
135100
136101 client, err := mongo.Connect(clientOpts)
137102
103+ To learn more about the challenge-response authentication mechanisms (SCRAM) that MongoDB supports,
104+ see the :manual:`SCRAM </core/security-scram/>` section of the Server manual.
105+
138106.. _golang-scram-sha-1-auth-mechanism:
139107.. _golang-sha-1:
140108
141109``SCRAM-SHA-1``
142110~~~~~~~~~~~~~~~
143111
144- .. important::
145-
146- ``SCRAM-SHA-1`` is the default authentication method for MongoDB versions
147- 3.0, 3.2, 3.4, and 3.6.
148-
149112``SCRAM-SHA-1`` is a salted challenge-response mechanism (SCRAM) that uses your
150113username and password, encrypted using the ``SHA-1`` algorithm, to authenticate
151114your user.
@@ -167,29 +130,11 @@ To specify the ``SCRAM-SHA-1`` authentication mechanism, assign the
167130
168131 client, err := mongo.Connect(clientOpts)
169132
170- .. _golang-mongodb-cr:
171-
172- ``MONGODB-CR``
173- ~~~~~~~~~~~~~~
174-
175- ``MONGODB-CR`` is a challenge-response authentication mechanism that uses your
176- username and password to authenticate your user.
177-
178- .. important::
179-
180- This authentication mechanism was deprecated starting in MongoDB 3.6
181- and is no longer supported as of MongoDB 4.0.
182-
183133.. _golang-mongodb-aws:
184134
185135``MONGODB-AWS``
186136~~~~~~~~~~~~~~~
187137
188- .. important::
189-
190- The MONGODB-AWS authentication mechanism is available only in MongoDB
191- versions 4.4 and later.
192-
193138The ``MONGODB-AWS`` authentication mechanism uses your Amazon Web Services
194139Identity and Access Management (AWS IAM) credentials to authenticate your
195140user.
0 commit comments