(DOCSP-39284) Adds example config for federated auth connected orgs. (#379) (#380)

Author: erabil-mdb

source/reference/json.txt

@@ -26,6 +26,7 @@ you can pass a configuration file when using the {+atlas-cli+} to:
   :ref:`update an alert configuration <atlas-alerts-settings-update>`.
 - :ref:`Create a rolling index <atlas-clusters-indexes-create>` for a cluster.
 - :ref:`Update a project <atlas-projects-update>`
+- :ref:`Update connected organizations for federated authentication <atlas-federatedAuthentication-federationSettings-connectedOrgConfigs-update>`.
 
 Usage
 -----
@@ -81,6 +82,9 @@ command. The commands you can use include but are not limited to:
   * - :ref:`atlas-projects-update`
     - :oas-atlas-tag:`Update One Project </Projects/operation/updateProject>`
 
+  * - :ref:`atlas-federatedAuthentication-federationSettings-connectedOrgConfigs-update`
+    - :oas-atlas-tag:`Update One Org Config Connected to One Federation </Federated-Authentication/operation/updateConnectedOrgConfig>`
+
 When you run the command in your terminal, specify the ``--file`` option 
 and provide the path to the |json| configuration file that defines your 
 desired settings. 
@@ -175,6 +179,13 @@ To learn more about project configuration files, see
 :ref:`atlas-cli-project-config-file`. To learn the syntax for a file,
 see :ref:`example-project-config-file`.
 
+Federated Authentication Configuration File
+-------------------------------------------
+
+To learn more about federated authentication configuration files, see 
+:ref:`federated-auth-config-file`. To learn the syntax for a file,
+see :ref:`example-connected-org-config-file`.
+
 
 .. toctree::
    :titlesonly:
@@ -188,3 +199,4 @@ see :ref:`example-project-config-file`.
    Alert </reference/json/alert-config-file>
    Rolling Index </reference/json/rolling-index-config-file>
    Project </reference/json/project-config-file>
+   Federated Authentication </reference/json/connected-org-config-file>

source/reference/json/connected-org-config-file.txt

@@ -0,0 +1,44 @@
+.. _federated-auth-config-file:
+
+===========================================
+Federated Authentication Configuration File
+===========================================
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. facet::
+   :name: genre
+   :values: tutorial
+
+.. To create a configuration file doc, copy this template, change
+.. the replacements below, and update the H1 title and refs.
+
+.. |atlas-cli command| replace:: :ref:`atlas-federatedAuthentication-federationSettings-connectedOrgConfigs-update`
+.. |configuration-file-name| replace:: federated authentication configuration  
+.. |openapi-link| replace:: :oas-atlas-tag:`Update One Org Config Connected to One Federation </Federated-Authentication/operation/updateConnectedOrgConfig>`
+.. |action| replace:: update connected organizations for federated authentication
+
+You can use a |configuration-file-name| file to specify the
+settings required when you |action|
+using the {+atlas-cli+}. The {+atlas-cli+} accepts ``.json`` 
+|configuration-file-name| files.
+
+.. _connected-org-settings:
+
+Available Settings
+------------------
+
+When you |action| using a configuration file, you
+can specify any settings that are listed in 
+|openapi-link| under :guilabel:`Request Body Schema`.
+
+.. _example-connected-org-config-file:
+
+Create a Configuration File
+---------------------------
+
+.. include:: /includes/steps-config-file-template.rst