@@ -30,7 +30,6 @@ The Go driver supports the following authentication mechanisms:
30
30
31
31
* :ref:`SCRAM-SHA-256 <golang_sha_256>`
32
32
* :ref:`SCRAM-SHA-1 <golang-sha-1>`
33
- * :ref:`MONGODB-CR <golang-mongodb-cr>`
34
33
* :ref:`MongoDB-AWS <golang-mongodb-aws>`
35
34
* :ref:`X.509 <golang-x509>`
36
35
@@ -60,33 +59,17 @@ Each authentication mechanism contains the following placeholders:
60
59
authentication data. If you omit this option, the driver uses the
61
60
default value ``admin``.
62
61
62
+ .. _golang_sha_256:
63
63
.. _golang-default-auth-mechanism:
64
64
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
+ ~~~~~~~~~~~~~~~~~
84
67
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.
87
71
88
- To specify the default authentication mechanism, omit the
89
- ``AuthMechanism`` option:
72
+ To specify this default authentication mechanism, omit the ``AuthMechanism`` option:
90
73
91
74
.. code-block:: go
92
75
@@ -100,26 +83,8 @@ To specify the default authentication mechanism, omit the
100
83
101
84
client, err := mongo.Connect(clientOpts)
102
85
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"``:
123
88
124
89
.. code-block:: go
125
90
:emphasize-lines: 2
@@ -135,17 +100,15 @@ To specify the ``SCRAM-SHA-256`` authentication mechanism, assign the
135
100
136
101
client, err := mongo.Connect(clientOpts)
137
102
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
+
138
106
.. _golang-scram-sha-1-auth-mechanism:
139
107
.. _golang-sha-1:
140
108
141
109
``SCRAM-SHA-1``
142
110
~~~~~~~~~~~~~~~
143
111
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
-
149
112
``SCRAM-SHA-1`` is a salted challenge-response mechanism (SCRAM) that uses your
150
113
username and password, encrypted using the ``SHA-1`` algorithm, to authenticate
151
114
your user.
@@ -167,29 +130,11 @@ To specify the ``SCRAM-SHA-1`` authentication mechanism, assign the
167
130
168
131
client, err := mongo.Connect(clientOpts)
169
132
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
-
183
133
.. _golang-mongodb-aws:
184
134
185
135
``MONGODB-AWS``
186
136
~~~~~~~~~~~~~~~
187
137
188
- .. important::
189
-
190
- The MONGODB-AWS authentication mechanism is available only in MongoDB
191
- versions 4.4 and later.
192
-
193
138
The ``MONGODB-AWS`` authentication mechanism uses your Amazon Web Services
194
139
Identity and Access Management (AWS IAM) credentials to authenticate your
195
140
user.
0 commit comments