DOCSP-27860 Add LDAP Auth Connection Details (#283)

* DOCSP-27860 Add LDAP Auth Connection Details

* XR1

* *

* *

* Remove extra auth methods

* *

* *

* *

* IR

* *

* *

* *

Author: ianf-mongodb

source/connect.txt

@@ -122,6 +122,48 @@ option for programmatic usage of ``mongosh``, like a :driver:`driver
    - To provision access to a MongoDB deployment, see :manual:`Database
      Users </core/security-users/>`.
 
+
+Connect with LDAP
+~~~~~~~~~~~~~~~~~
+
+To connect to a deployment using :ref:`LDAP <security-ldap>`:
+
+- Set :option:`--username <mongosh --username>` to a username that 
+  respects the :setting:`security.ldap.authz.queryTemplate`, or any 
+  configured :setting:`security.ldap.userToDNMapping` template.
+
+- Set :option:`--password <mongosh --password>` to the appropriate 
+  password. If you do not specify the password to the 
+  ``--password`` command-line option, ``mongosh`` prompts you for 
+  the password.
+
+- Set :option:`--authenticationDatabase <mongosh --authenticationDatabase>` 
+  to ``$external``.
+  The ``$external`` argument must be placed in single quotes, not
+  double quotes, to prevent the shell from interpreting ``$external``
+  as a variable.
+
+- Set :option:`--authenticationMechanism <mongosh --authenticationMechanism>` 
+  to ``PLAIN``.
+
+.. warning::
+
+   When you use one-time passwords with LDAP authentication, adding 
+   the :ref:`connection string options <connections-connection-options>` 
+   ``maxPoolSize=1&srvMaxHosts=1`` to your connection string is 
+   recommended to reduce the potential for connection failures.
+
+Include the :option:`--host <mongosh --host>` and 
+:option:`--port <mongosh --port>` of the MongoDB deployment, along with 
+any other options relevant to your deployment.
+
+For example, the following operation authenticates to a MongoDB 
+deployment running with LDAP authentication and authorization:
+
+.. code-block:: bash
+
+   mongosh --username alice@dba.example.com --password  --authenticationDatabase '$external' --authenticationMechanism "PLAIN"  --host "mongodb.example.com" --port 27017
+
 Connect to a Replica Set
 ~~~~~~~~~~~~~~~~~~~~~~~~