Skip to content

Commit b963a2d

Browse files
committed
DOCS-14151 usertodnmapping default to username transform
1 parent 93cce27 commit b963a2d

File tree

5 files changed

+43
-3
lines changed

5 files changed

+43
-3
lines changed

source/reference/configuration-options.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3219,6 +3219,13 @@ Key Management Configuration Options
32193219
authentication failures to the LDAP server. :binary:`~bin.mongod` or
32203220
:binary:`~bin.mongos` rejects the connection request and does not
32213221
check the remaining documents in the array.
3222+
3223+
Starting in MongoDB 5.0, :setting:`~security.ldap.userToDNMapping`
3224+
accepts an empty string ``""`` or empty array ``[ ]`` in place of a
3225+
mapping documnent. If providing an empty string or empty array to
3226+
:setting:`~security.ldap.userToDNMapping`, MongoDB will map the
3227+
authenticated username as the LDAP DN. Previously, providing an
3228+
empty mapping document would cause mapping to fail.
32223229

32233230
.. example::
32243231

source/reference/program/mongod.txt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1245,7 +1245,14 @@ LDAP Authentication or Authorization Options
12451245
or authentication failures to the LDAP server. :binary:`~bin.mongod`
12461246
rejects the connection request and does not check the remaining
12471247
documents in the array.
1248-
1248+
1249+
Starting in MongoDB 5.0, :option:`--ldapUserToDNMapping`
1250+
accepts an empty string ``""`` or empty array ``[ ]`` in place of a
1251+
mapping documnent. If providing an empty string or empty array to
1252+
:option:`--ldapUserToDNMapping`, MongoDB will map the
1253+
authenticated username as the LDAP DN. Previously, providing an
1254+
empty mapping document would cause mapping to fail.
1255+
12491256
.. example::
12501257

12511258
The following shows two transformation documents. The first

source/reference/program/mongoldap.txt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -534,7 +534,14 @@ Options
534534
or authentication failures to the LDAP server. :program:`mongoldap`
535535
rejects the connection request and does not check the remaining
536536
documents in the array.
537-
537+
538+
Starting in MongoDB 5.0, :option:`--ldapUserToDNMapping`
539+
accepts an empty string ``""`` or empty array ``[ ]`` in place of a
540+
mapping documnent. If providing an empty string or empty array to
541+
:option:`--ldapUserToDNMapping`, MongoDB will map the
542+
authenticated username as the LDAP DN. Previously, providing an
543+
empty mapping document would cause mapping to fail.
544+
538545
.. example::
539546

540547
The following shows two transformation documents. The first

source/reference/program/mongos.txt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2015,7 +2015,14 @@ LDAP Authentication and Authorization Options
20152015
or authentication failures to the LDAP server. :binary:`~bin.mongos`
20162016
rejects the connection request and does not check the remaining
20172017
documents in the array.
2018-
2018+
2019+
Starting in MongoDB 5.0, :option:`--ldapUserToDNMapping`
2020+
accepts an empty string ``""`` or empty array ``[ ]`` in place of a
2021+
mapping documnent. If providing an empty string or empty array to
2022+
:option:`--ldapUserToDNMapping`, MongoDB will map the
2023+
authenticated username as the LDAP DN. Previously, providing an
2024+
empty mapping document would cause mapping to fail.
2025+
20192026
.. example::
20202027

20212028
The following shows two transformation documents. The first

source/release-notes/5.0.txt

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -417,6 +417,18 @@ readability by separating the variables from the query text.
417417
The :dbcommand:`update` command also has a ``c`` field to define a list
418418
of variables.
419419

420+
Support for Username to LDAP DN Mapping by Default
421+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
422+
423+
Starting in MongoDB 5.0, the :setting:`~security.ldap.userToDNMapping`
424+
configuration file option and the :option:`--ldapUserToDNMapping
425+
<mongod --ldapUserToDNMapping>` command line option for
426+
:binary:`~bin.mongod` / :binary:`~bin.mongos` and :program:`mongoldap`
427+
now map the authenticated username as the LDAP DN by default if an
428+
empty mapping document (i.e. an empty string or empty array) is
429+
specified to the option. Previously, providing an empty mapping document
430+
would cause mapping to fail.
431+
420432
Additional ``dbStats`` Free Space Statistics
421433
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
422434

0 commit comments

Comments
 (0)