(DOCSP-28684): Include LDAP SRV details in config docs (#6184) (#6200)

* (DOCSP-28684): Include LDAP SRV details in config docs

* use replacements

* change mongod replacement

* review feedback

* typo

* edits

Author: jeff-allen-mongo

source/core/security-ldap-external.txt

@@ -227,6 +227,12 @@ configuration file:
      - Quote-enclosed comma-separated list of LDAP servers in ``host[:port]``
        format.
 
+       You can prefix LDAP servers with ``srv:`` and ``srv_raw:``.
+
+       .. |ldap-binary| replace:: :binary:`mongod`
+
+       .. include:: /includes/ldap-srv-details.rst
+
      - **YES**
 
    * - :setting:`security.ldap.authz.queryTemplate`

source/core/security-ldap.txt

@@ -216,6 +216,12 @@ configuration file:
      - Quote-enclosed comma-separated list of LDAP servers in ``host[:port]``
        format.
 
+       You can prefix LDAP servers with ``srv:`` and ``srv_raw:``.
+
+       .. |ldap-binary| replace:: :binary:`mongod`
+
+       .. include:: /includes/ldap-srv-details.rst
+
      - **YES**
 
    * - :setting:`security.ldap.bind.method`

source/includes/ldap-srv-details.rst

@@ -0,0 +1,8 @@
+If your connection string specifies ``"srv:<DNS_NAME>"``, |ldap-binary|
+verifies that ``"_ldap._tcp.gc._msdcs.<DNS_NAME>"`` exists for SRV to
+support Active Directory. If not found, |ldap-binary| verifies that
+``"_ldap._tcp.<DNS_NAME>"`` exists for SRV. If an SRV record cannot be
+found, |ldap-binary| warns you to use ``"srv_raw:<DNS_NAME>"`` instead.
+
+If your connection string specifies ``"srv_raw:<DNS_NAME>"``,
+|ldap-binary| performs an SRV record lookup for ``"<DNS NAME>"``.

source/reference/configuration-options.txt

@@ -3134,6 +3134,12 @@ Key Management Configuration Options
    :setting:`security.ldap.servers`. MongoDB supports following LDAP referrals as defined in `RFC 4511
    4.1.10 <https://www.rfc-editor.org/rfc/rfc4511.txt>`_. Do not use :setting:`security.ldap.servers`
    for listing every LDAP server in your infrastructure.
+
+   You can prefix LDAP servers with ``srv:`` and ``srv_raw:``.
+
+   .. |ldap-binary| replace:: :binary:`mongod`
+
+   .. include:: /includes/ldap-srv-details.rst
 
    This setting can be configured on a running :binary:`~bin.mongod` or :binary:`~bin.mongos` using
    :dbcommand:`setParameter`.

source/reference/program/mongoldap.txt

@@ -157,16 +157,12 @@ configuration files are valid, the output might be as follows:
 Behavior
 --------
 
-Starting in MonogoDB 5.1, ``mongoldap`` supports prefixing LDAP
+Starting in MongoDB 5.1, ``mongoldap`` supports prefixing LDAP
 server with ``srv:`` and ``srv_raw:``.
 
-If your connection string specifies ``"srv:<DNS_NAME>"``, ``mongoldap`` 
-verifies that ``"_ldap._tcp.gc._msdcs.<DNS_NAME>"`` exists for SRV to 
-support Active Directory. If not found, it verifies 
-``"_ldap._tcp.<DNS_NAME>"`` exists for SRV. If an SRV record cannot be 
-found, ``mongoldap`` warns you to use ``"srv_raw:<DNS_NAME>"`` instead. 
-``mongoldap`` does the reverse check for ``"srv_raw:<DNS_NAME>"`` by 
-checking for ``"_ldap._tcp.<DNS NAME>"``. 
+.. |ldap-binary| replace:: ``mongoldap``
+
+.. include:: /includes/ldap-srv-details.rst
 
 Options
 -------