DOCSP-13158 connection section (includes links to configuring MONGODB-AWS) (#79)

* DOCSP-13158: add connection section

Author: Chris Cho

source/index.txt

@@ -13,6 +13,7 @@ MongoDB Kafka Connector
    :maxdepth: 1
 
    Install MongoDB Kafka Connector </kafka-installation>
+   Connect to MongoDB </kafka-connection-mongodb>
    Configure SSL/TLS </kafka-configure-ssl>
    Sink Connector Guide </kafka-sink>
    Source Connector Guide </kafka-source>
@@ -44,6 +45,7 @@ implementation.
 This guide is divided into the following topics:
 
 - :doc:`Install MongoDB Kafka Connector </kafka-installation>`
+- :doc:`Connect to MongoDB </kafka-connection-mongodb>`
 - :doc:`Configure SSL/TLS </kafka-configure-ssl>`
 - :doc:`Sink Connector Guide </kafka-sink>`
 - :doc:`Source Connector Guide </kafka-source>`

source/kafka-connection-mongodb.txt

@@ -0,0 +1,91 @@
+.. _kafka-connect-mongodb:
+
+=======================================
+Connect your Kafka Connector to MongoDB
+=======================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Overview
+--------
+
+This guide shows you how to configure your MongoDB Kafka Source or Sink
+Connector to connect to and authenticate with a MongoDB cluster.
+
+The MongoDB Kafka Connector uses the MongoDB Java Driver to connect to
+your MongoDB cluster. The MongoDB Java Driver enables you to use any of
+the **authentication mechanisms** available in that version of the driver
+using a **Connection URI**.
+
+To read more about the terms above, see the following MongoDB Server Manual
+entries:
+
+- :manual:`Authentication Mechanisms </core/authentication-mechanisms/>`
+- :manual:`Connection String URI Format </reference/connection-string/>`
+
+Identify Your MongoDB Java Driver Version
+-----------------------------------------
+
+Each MongoDB Kafka Connector version uses a specific version of the
+MongoDB Java Driver. Check the version of the Java Driver in the connector's
+dependency list to ensure that it supports the authentication mechanism.
+
+If you are using the Uber JAR, you can find the dependency file from the
+same place that you downloaded that distribution. For links to the
+distributions, see the :ref:`Installation Reference Table <kafka-connector-installation-reference>`.
+
+To check whether a specific MongoDB Java Driver version supports your
+authentication mechanism, see the table below or visit the
+`reference documentation for the driver release version <http://mongodb.github.io/mongo-java-driver/>`__.
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 10 10
+
+   * - MongoDB Java Driver Version
+     - 4.x
+     - 3.x
+
+   * - SCRAM / MONGODB-CR
+     - ✓
+     - ✓
+
+   * - X.509
+     - ✓
+     - ✓
+
+   * - MONGODB-AWS
+     - ✓
+     -
+
+   * - Kerberos (GSSAPI)
+     - ✓
+     - ✓
+
+   * - LDAP (PLAIN)
+     - ✓
+     - ✓
+
+Configure Your Connection URI
+-----------------------------
+
+To configure your MongoDB Kafka Source or Sink Connector, specify your
+connection URI in the ``connection.uri`` setting. Refer to the configuration
+guides for more detail:
+
+- :doc:`Sink Configuration Properties </kafka-sink-properties>`
+- :doc:`Source Connector Guide </source/connector-guide>`
+
+For more information on how to build your connection URI, navigate
+to the :guilabel:`Authentication` section in the
+`MongoDB Java Driver reference documentation <https://mongodb.github.io/mongo-java-driver/>`__
+that corresponds to your connector version.
+
+If you need to configure SSL/TLS, see our :doc:`Configure SSL/TLS Guide </kafka-configure-ssl>`.

source/kafka-sink-properties.txt

@@ -63,6 +63,9 @@ data to sink to MongoDB. For an example configuration file, see
 
           mongodb://username:password@localhost/
 
+       | For additional information, see the
+       | :doc:`Connect your Kafka Connector to MongoDB section </kafka-connection-mongodb>`.
+
        .. include:: /includes/externalize-secrets.rst
 
        | **Default**: ``mongodb://localhost:27017``

source/kafka-source.txt

@@ -117,6 +117,13 @@ an example source connector configuration file, see
    * - connection.uri
      - string
      - | A :manual:`MongoDB connection URI string </reference/connection-string/#standard-connection-string-format>`.
+       
+       .. code-block:: none
+
+          mongodb://username:password@localhost/
+
+       | For additional information, see the
+       | :doc:`Connect your Kafka Connector to MongoDB section </kafka-connection-mongodb>`.
 
        .. include:: /includes/externalize-secrets.rst