Skip to content

Commit f6e76b9

Browse files
committed
DOCS-4231: mongod/mongos requires access to saslauthd dir
1 parent 3ad34ac commit f6e76b9

File tree

4 files changed

+27
-4
lines changed

4 files changed

+27
-4
lines changed

source/core/security-ldap.txt

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,9 @@ MongoDB 3.4 supports simple and SASL binding to LDAP servers via:
3232
Linux MongoDB servers supports binding to an LDAP server via the
3333
``saslauthd`` daemon.
3434

35+
.. include:: /includes/fact-saslauthd-permission.rst
36+
37+
3538
Previous versions of MongoDB support LDAP authentication using ``saslauthd``.
3639
This restricted LDAP authentication support to Linux MongoDB deployments only.
3740

@@ -294,7 +297,11 @@ Or, if using the :doc:`YAML configuration file
294297

295298
You need to create or update the ``saslauthd.conf`` file with the parameters
296299
appropriate for your LDAP server. Documenting ``saslauthd.conf`` is out
297-
of scope for this documentation. The following tutorials provide basic
300+
of scope for this documentation.
301+
302+
.. include:: /includes/fact-saslauthd-permission.rst
303+
304+
The following tutorials provide basic
298305
information on configuring ``saslauthd.conf`` to work with two popular
299306
LDAP services:
300307

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
.. important::
2+
3+
The parent directory of the ``saslauthd`` Unix domain socket file
4+
specified to :setting:`security.sasl.saslauthdSocketPath` or
5+
:parameter:`--setParameter saslauthdPath <saslauthdPath>` must grant
6+
read and execute (``r-x``) permissions for either:
7+
8+
- The user starting the :binary:`mongod <bin.mongod>` or
9+
:binary:`mongos <bin.mongos>`, *or*
10+
- a group to which that user belongs.
11+
12+
The ``mongod`` or ``mongos`` cannot successfully authenticate via
13+
``saslauthd`` without the specified permission on the ``saslauthd``
14+
directory and its contents.

source/includes/steps-configure-ldap-mongodb.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,8 @@ pre: |
3838
3939
- :parameter:`saslauthdPath` parameter set to the path to the Unix-domain Socket of the ``saslauthd`` instance.
4040
41+
.. include:: /includes/fact-saslauthd-permission.rst
42+
4143
If you use the :setting:`~security.authorization` option to enforce
4244
authentication, you will need privileges to create a user.
4345
action:

source/includes/steps-configure-ldap-saslauthd-activedir.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,8 +75,8 @@ post: |
7575
- ``0: NO "authentication failed"`` indicates a username, password, or
7676
configuration error.
7777
78-
.. note::
78+
Modify the file path with respect to the location of the
79+
``saslauthd`` directory on the host operating system.
7980
80-
``/var/run/saslauthd`` directory must have permissions set to
81-
``755`` for MongoDB to successfully authenticate.
81+
.. include:: /includes/fact-saslauthd-permission.rst
8282
...

0 commit comments

Comments
 (0)