DOCSP-24594-Compass-auth-examples

source/connect/advanced-connection-options/advanced-connection.txt

@@ -113,3 +113,15 @@ Procedure
 .. seealso::
 
    To disconnect from your deployment, see :ref:`<disconnect-tab>`. 
+
+Example
+-------
+
+The following screenshot shows the :guilabel:`Advanced` tab configured
+with the read preference of :guilabel:`Secondary Preferred`. The
+:guilabel:`Secondary Preferred` read preference prevents queries from
+overloading the primary node. 
+
+.. figure:: /images/authentication/secondary-preferred.png
+   :figwidth: 662px
+   :alt: Screenshot of Compass configured to connect with read preference of secondary preferred

source/connect/advanced-connection-options/authentication-connection.txt

@@ -273,3 +273,22 @@ Procedure
 .. seealso::
 
    To disconnect from your deployment, see :ref:`<disconnect-tab>`.
+
+Example
+-------
+
+The following screenshot shows the :guilabel:`Authentication` tab
+configured for username and password authentication with
+:manual:`SCRAM-SHA-256 </core/security-scram/>`.
+
+.. figure:: /images/authentication/authentication-configuration.png
+   :figwidth: 662px
+   :alt: Screenshot of Compass configured to authenticate with username and password
+
+Alternatively, the following screenshot shows the
+:guilabel:`Authentication` tab configured for :manual:`LDAP
+</core/security-ldap-external/>` authentication.  
+
+.. figure:: /images/authentication/ldap-configuration.png
+   :figwidth: 662px
+   :alt: Screenshot of Compass configured to authenticate with LDAP

source/connect/advanced-connection-options/general-connection.txt

@@ -52,7 +52,20 @@ Procedure
             * - mongodb
               - :manual:`Standard Connection String Format </reference/connection-string/>`. 
                 The standard format of the MongoDB connection URI is used to 
-                connect to a MongoDB deployment by specifying its hosts directly.
+                connect to a MongoDB deployment by specifying its hosts
+                directly.
+
+                Use this option to connect to standalone, replica set,
+                or a sharded cluster
+
+                .. note::
+
+                   If you use the standard connection string format to
+                   connect to an `Atlas
+                   <https://www.mongodb.com/cloud/atlas>`__ deployment,
+                   you must turn on TLS/SSL in the
+                   :guilabel:`TLS/SSL` tab of the :guilabel:`New
+                   Connection` modal. 
 
             * - mongodb+srv 
               - :manual:`DNS Seed List Connection Format 
@@ -93,3 +106,14 @@ Procedure
 .. seealso::
 
    To disconnect from your deployment, see :ref:`<disconnect-tab>`. 
+
+Example
+-------
+
+The following screenshot shows the :guilabel:`General` tab configured
+for an Atlas cluster with :manual:`SCRAM-SHA-256
+</core/security-scram/>`. Since the connection uses the ``mongodb+srv``
+connection string scheme, the connection automatically enables TLS/SSL. 
+
+.. figure:: /images/authentication/new-atlas-connection.png
+   :alt: Screenshot of Compass configured to connect to an example Atlas cluster

source/connect/advanced-connection-options/tls-ssl-connection.txt

@@ -105,7 +105,8 @@ Procedure
       .. warning:: 
 
          Enabling ``tlsInsecure``, ``tlsAllowInvalidHostnames``, and 
-         ``tlsAllowInvalidCertificates`` may cause a security vulnerabilty. 
+         ``tlsAllowInvalidCertificates`` may cause a security
+         vulnerabilty. 
 
    .. step:: (Optional) For advanced connection configuration options, click the :ref:`Advanced <advanced-connection-tab>` tab.
 
@@ -114,3 +115,13 @@ Procedure
 .. seealso::
 
    To disconnect from your deployment, see :ref:`<disconnect-tab>`.
+
+Example
+-------
+
+The following screenshot shows the :guilabel:`TLS / SSL` tab configured
+for a cluster with TLS/SSL enabled. 
+
+.. figure:: /images/authentication/tls-ssl-configuration.png
+   :figwidth: 662px
+   :alt: Screenshot of Compass configured to connect to an example cluster with TLS/SSL