(DOCSP-43747): Note that LDAP is deprecated for MongoDB 8.0 (OM) (#389) (#421)

davidhou17 · web-flow · commit f09b82b1e67a · 2024-10-01T15:01:28.000-05:00
Remerges 10gen/docs-ops-manager#389
diff --git a/source/core/installation-checklist.txt b/source/core/installation-checklist.txt
@@ -168,6 +168,8 @@ information for accessing the databases. For details, see
 Will you use |ldap| for user authenticate to |onprem|?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. include:: /includes/ldap-deprecated.rst
+
 If you want to use |ldap| for user management, you can configure |ldap|
 authentication before or after creating your first project. There are
 different prerequisites for implementing a new |ldap| authentication
diff --git a/source/includes/fact-mdbagent-kerberos-principal-as-user.rst b/source/includes/fact-mdbagent-kerberos-principal-as-user.rst
@@ -10,6 +10,8 @@ using :manual:`LDAP authorization </core/security-ldap-external>`.
    .. tab:: LDAP Authorization
       :tabid: ldap-auth-kerberos-principal
 
+      .. include:: /includes/ldap-deprecated.rst
+
       If you are using |ldap| authorization in your MongoDB deployment,
       you must create an |ldap| user and |ldap| group for the
       {+mdbagent+} on the |ldap| server. After creating the |ldap| user
diff --git a/source/includes/fact-mdbagent-x509-subject-as-user.rst b/source/includes/fact-mdbagent-x509-subject-as-user.rst
@@ -8,6 +8,8 @@ using :manual:`LDAP authorization </core/security-ldap-external>`.
    .. tab:: LDAP Authorization
       :tabid: ldap-auth-x509
 
+      .. include:: /includes/ldap-deprecated.rst
+
       If you are using |ldap| authorization in your MongoDB deployment,
       you must create an |ldap| user and |ldap| group for the
       {+mdbagent+} on the |ldap| server. After creating the |ldap| user
diff --git a/source/includes/ldap-deprecated.rst b/source/includes/ldap-deprecated.rst
@@ -0,0 +1,8 @@
+.. note::
+
+   Starting with MongoDB 8.0, |ldap| authentication and authorization is
+   deprecated. The feature is available and will continue to operate
+   without changes throughout the lifetime of MongoDB 8. |ldap| will be
+   removed in a future major release.
+
+   For details, see :manual:`LDAP Deprecation </core/LDAP-deprecation>`.
diff --git a/source/includes/steps-add-group.yaml b/source/includes/steps-add-group.yaml
@@ -38,6 +38,8 @@ optional: true
 level: 4
 content: |
 
+   .. include:: /includes/ldap-deprecated.rst
+
    If managing |mms| users through |ldap|, enter values for the
    following **Optional LDAP Configuration** fields .
 
diff --git a/source/tutorial/configure-for-ldap-authentication.txt b/source/tutorial/configure-for-ldap-authentication.txt
@@ -4,7 +4,6 @@
 Configure |mms| Users for LDAP Authentication and Authorization
 ===============================================================
 
-
 .. default-domain:: mongodb
 
 .. contents:: On this page
diff --git a/source/tutorial/configure-mongodb-agent-for-ldap.txt b/source/tutorial/configure-mongodb-agent-for-ldap.txt
@@ -10,6 +10,8 @@ Configure MongoDB Agent for LDAP
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/ldap-deprecated.rst
+
 .. include:: /includes/extracts/intro-configure-mongodb-agent-ldap.rst
 
 .. include:: /includes/extracts/note-manage-mongodb-agent-auth-with-automation-ldap.rst
diff --git a/source/tutorial/enable-ldap-authentication-for-group.txt b/source/tutorial/enable-ldap-authentication-for-group.txt
@@ -12,6 +12,8 @@ Enable LDAP Authentication for your |mms| Project
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/ldap-deprecated.rst
+
 .. _enable-ldap-authentication:
 
 .. include:: /includes/enable-auth-intro.rst
