DOCSP-26560 Document showKerberosPasswordField Option (#480)

* DOCSP-26560 Document showKerberosPasswordField Option

* rename task page + add to task list

* rename page to txt

* JP edits

* clarify reason for disabling option

Author: ajhuh-mdb

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

@@ -151,7 +151,9 @@ Procedure
              this `RFC document <https://tools.ietf.org/html/rfc6806.html>`__.
 
          * - (Optional) Provide password directly
-           - Used to verify your identity. 
+           - Used to verify your identity. To show the Kerberos password field, 
+             you must enable the :ref:`showKerberosPasswordField 
+             <compass-kerberos-password>` option.
 
       Authenticate as a Different Kerberos User on Windows
       ````````````````````````````````````````````````````

source/settings.txt

@@ -41,6 +41,8 @@ Tasks
 
 - :ref:`compass-configure-network-traffic`
 
+- :ref:`compass-kerberos-password`
+
 - :ref:`compass-protect-connection-strings`
 
 - :ref:`compass-read-only`
@@ -65,6 +67,7 @@ Learn more
    /settings/command-line-options
    /settings/config-file
    /settings/restrict-outgoing-connections
+   /settings/show-kerberos-password
    /settings/protect-connection-strings
    /settings/read-only
    /settings/specify-read-preference-tags

source/settings/settings-reference.txt

@@ -74,7 +74,9 @@ You can configure the following settings on the |compass| interface:
    * - Show Kerberos Password Field 
      - General
      - Show or hide the Kerberos password field on the |compass-short| 
-       connection form.
+       connection form. 
+
+       To learn more, see :ref:`compass-kerberos-password`.
 
    * - Upper Limit for maxTimeMS for |compass-short| Database Operations 
      - General

source/settings/show-kerberos-password.txt

@@ -0,0 +1,111 @@
+.. _compass-kerberos-password:
+
+===================================
+Display the Kerberos Password Field
+===================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+If you use :manual:`Kerberos authentication </core/kerberos/>` to connect to 
+your MongoDB deployment, you can enable the ``showKerberosPasswordField`` 
+option on |compass|. 
+
+About This Task 
+---------------
+
+The password field is not necessary for Kerberos authentication, so 
+|compass-short| disables the ``showKerberosPasswordField`` option by default.
+
+If you enable the ``showKerberosPasswordField``, |compass| displays the 
+:guilabel:`Provide password directly` option, which contains the 
+:guilabel:`Password` field. You can find the Kerberos :guilabel:`Password` 
+under the :guilabel:`Advanced Connection Options > Authentication` tab on the 
+|compass-short| connection form. 
+
+Procedure
+---------
+
+You can enable the ``showKerberosPasswordField`` option in either: 
+
+- The |compass-short| :ref:`Settings panel <compass-settings-reference>`.
+
+- The :ref:`command line <cli-options>`.
+
+- A :ref:`configuration file <config-file>`.
+
+|compass-short| Settings Panel
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. procedure:: 
+   :style: normal
+   
+   .. step:: In the |compass-short| top menu bar, click :guilabel:`MongoDB Compass`. 
+
+      .. figure:: /images/compass/settings-panel-location.png
+         :scale: 60% 
+         :alt: Settings panel location under the MongoDB Compass system menu
+      
+      Alternatively, you can use keyboard shortcuts to open the 
+      :guilabel:`Settings` panel: 
+      
+      - Windows or Linux: ``Ctrl`` + ``,``
+      
+      - MacOS: ``⌘`` + ``,``
+
+   .. step:: In the :guilabel:`MongoDB Compass` menu, click :guilabel:`Settings`.
+
+      |compass-short| opens a dialog box where you can configure your |compass| 
+      settings.
+
+   .. step:: Toggle :guilabel:`Show Kerberos Password Field`.
+
+   .. step:: Click :guilabel:`Save`.
+
+Command Line
+~~~~~~~~~~~~
+
+The following command starts |compass-short| from the command line and sets
+the ``--showKerberosPasswordField`` option:
+
+.. code-block:: sh
+
+   <path-to-Compass-executable> --readOnly
+
+.. note::
+
+   The name and filepath of the |compass-short| executable depend on your
+   operating system.
+
+Configuration File
+~~~~~~~~~~~~~~~~~~
+
+You can specify the |compass-short| configuration file in either EJSON
+or YAML format. The following configurations set the 
+``showKerberosPasswordField`` option to ``true``:
+
+EJSON
+`````
+
+.. code-block:: json
+
+   { "showKerberosPasswordField": true }
+
+YAML
+````
+
+.. code-block:: yaml
+
+   showKerberosPasswordField: true
+
+Learn More
+----------
+
+To learn more about the |compass| configuration file, see
+:ref:`config-file`.
+