1.27 release (#501)

Co-authored-by: sarahsimpers <[email protected]>

Author: zach-carr

source/dashboard-permissions.txt

@@ -1,8 +1,8 @@
 .. _dashboard-permissions:
 
-=====================
-Dashboard Permissions
-=====================
+=================================
+Dashboard Permissions and Sharing
+=================================
 
 .. default-domain:: mongodb
 
@@ -86,7 +86,7 @@ View Dashboard Permissions
 --------------------------
 
 To view permissions for a specific dashboard, hover over the icon
-next to the dashboard's :guilabel:`Access` button. A tooltip appears
+next to the dashboard's :guilabel:`Share` button. A tooltip appears
 describing what permission you have on the dashboard, who the owner
 of the dashboard is, and who else has access to the dashboard.
 
@@ -107,16 +107,23 @@ permissions:
 
    * - :icon-fa5:`users` Group Icon
      - You have either ``Author`` or ``Owner`` permission and
-       :ref:`additional users <dashboard-specific-access>` or :ref:`Everyone <dashboard-access-everyone>` have
-       some level of access to the dashboard.
+       :ref:`additional users <dashboard-specific-access>` or :ref:`Everyone <dashboard-access-everyone>` in your |service| 
+       project some level of access to the dashboard.
+
+   * - :icon-fa5:`globe` Globe Icon
+     - You have the setting  
+       :ref:`Anyone with this link can view <dashboard-access-link>`
+       enabled.
 
    * - :icon-fa5:`lock` Lock Icon
      - You have ``Owner`` permission and no other user has
        access.
 
-If you have ``Author`` or ``Owner`` permission and
-:ref:`Anyone with this link <dashboard-access-link>` sharing is
-enabled, the icon doesn't change.
+.. note::
+
+   If :ref:`Anyone with this link can view <dashboard-access-link>` 
+   sharing is enabled and you have ``Author`` or ``Owner`` permission, 
+   the icon doesn't change.
 
 .. _modify-dashboard-permissions:
 
@@ -136,14 +143,14 @@ the dashboard from the :guilabel:`Dashboards` page:
    :figwidth: 750px
    :alt: Dashboard permission icon
 
-Or click the :guilabel:`Access` button at the top-right of the
+Or click the :guilabel:`Share` button at the top-right of the
 dashboard within the specific dashboard view:
 
-.. figure:: /images/charts/dashboard-access-button.png
+.. figure:: /images/charts/dashboard-share-button.png
    :figwidth: 750px
    :alt: Dashboard access button
 
-With the :guilabel:`Dashboard Permissions` dialog open, read the
+With the :guilabel:`Share Dashboard` dialog open, read the
 following sections to learn how to grant permissions to a dashboard to:
 
 - :ref:`A specific user <dashboard-specific-access>`
@@ -157,9 +164,10 @@ Specific User Permissions
 
 To give specific users permissions on the dashboard:
 
-1. Search for the desired user using the search bar directly above
-   where the dashboard users are listed. You can search for users
-   by their username or email address.
+1. Select the :guilabel:`User Access` tab.
+
+#. Search for the desired user using the search bar. You can search for 
+   users by their username or email address.
 
 #. Click the desired user to add them to the permissions list.
 
@@ -183,7 +191,7 @@ To give specific users permissions on the dashboard:
 #. Repeat steps 1-3 for each user you would like to provide dashboard
    permissions for.
 
-#. Click :guilabel:`Apply Changes`.
+#. Click :guilabel:`Close`. |charts| saves your changes automatically.
 
 To remove permissions for a user, click the trash can icon to the right
 of the user's name.
@@ -196,7 +204,9 @@ Access for All Users
 To allow access to the dashboard for all users in your |service|
 project:
 
-1. Toggle the switch on the right-side of the :guilabel:`Everyone` user
+1. Select the :guilabel:`User Access` tab.
+
+#. Toggle the switch on the right-side of the :guilabel:`Everyone` user
    to ``On``.
 
 #. Select the :ref:`permission <dashboard-roles>` to apply to all
@@ -226,7 +236,7 @@ project:
       - If you don't own a Data Source used in the dashboard, ask an
         Owner to grant permission to Everyone to view the data.
 
-#. Click :guilabel:`Apply Changes`.
+#. Click :guilabel:`Close`. |charts| saves your changes automatically.
 
 .. _dashboard-access-link:
 
@@ -240,8 +250,10 @@ on each data source in the charts in the dashboard.
 To allow access to the dashboard for users on your |charts|
 deployment who have a direct link:
 
-1. Toggle the switch on the right-side of the
-   :guilabel:`Anyone with this link` user to ``On``.
+1. Select the :guilabel:`Public Link` tab.
+
+#. Toggle the switch on the right-side of the
+   :guilabel:`Anyone with this link can view` user to ``On``.
 
    A user's permissions don't affect their ability to view a chart
    using a link. |charts| generates two links: a public and a private
@@ -261,7 +273,7 @@ deployment who have a direct link:
       - If you don't own a Data Source used in the dashboard, ask an
         Owner to enable external sharing to view the data.
 
-#. Click :guilabel:`Apply Changes`.
+#. Click :guilabel:`Close`. |charts| saves your changes automatically.
 
 .. warning:: Link Sharing with Sensitive Data
 

source/dashboards.txt

@@ -141,9 +141,8 @@ Export a Dashboard to a File
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can export a dashboard to a single file named 
-``<Dashboard-Title>.charts`` on the :ref:`Dashboards page 
-<dashboards-tab>`. The file contains the metadata for the dashboard, 
-including:
+``<Dashboard-Title>.charts``. The file contains the metadata for the 
+dashboard, including:
 
 - Dashboard name and description
 - Dashboard layout including location of the charts in the dashboard 
@@ -171,10 +170,14 @@ The file **doesn't** include:
 You must have ``Viewer`` or higher :ref:`permissions 
 <dashboard-permissions>` to export a dashboard.
 
-From the :guilabel:`Dashboards` page: 
+You can export a dashboard from the :guilabel:`Dashboards` page or from 
+the dashboard itself. To export a dashboard:
 
-1. Click the ellipsis (``...``) for the dashboard you want to export 
-   and select :guilabel:`Export Dashboard` from the dropdown.
+1. If you are on the :guilabel:`Dashboards` page, click the ellipsis 
+   (``...``) for the dashboard you want to export.
+
+   If you are on a dashboard, click the ellipsis 
+   (``...``) in the top right corner.
 
 #. Follow the browser prompts to download the file.
 

source/embed-chart-jwt-auth.txt

@@ -54,6 +54,20 @@ Enable Authenticated Embedding for a Chart
 Configure |charts-short| to use your Custom JWT Provider
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. note::
+
+   When you configure authentication using a custom JWT provider, you can choose
+   the signing algorithm. This tutorial uses the HS256 signing algorithm. If you select
+   the RS256 signing algorithm, you can also choose one of the following signing keys:
+
+   - JSON web key (`JWK <https://datatracker.ietf.org/doc/html/rfc7517>`__) or
+     JSON web key set (JWKS) URL: |charts-short| retrieves the key from the JWK
+     or JWKS file at the specified URL. |charts-short| then uses
+     the key to validate the JSON web token. If there are multiple keys in the
+     file, |charts-short| tries each key until it finds a match.
+   - PEM public key: |charts-short| uses the specified public key to verify the
+     JSON web token.
+
 .. include:: /includes/steps/add-auth-jwt-tutorial.rst
 
 Create a Web App to Display your Chart

source/images/charts/dashboard-access-button.png

@@ -25,14 +25,26 @@
 
       - ``HS256``: enter the secret key used to sign the |jwt|.
 
-      - ``RS256``: enter the public key of the key pair used to sign 
-        the |jwt| The public key must be in `PEM format 
-        <https://tools.ietf.org/html/rfc7468#section-5>`__, as shown in
-        the following example:
+      - ``RS256``: Select either :guilabel:`JWK or JWKS URL` or
+        :guilabel:`PEM Public Key`.
+         
+        If you select :guilabel:`JWK or JWKS URL`, |charts-short|
+        retrieves the key from the `JWK <https://datatracker.ietf.org/doc/html/rfc7517>`__
+        or JWKS file at the specified URL. |charts-short|
+        then uses the key to validate the JSON web token. If there are
+        multiple keys in the file, |charts-short| tries each key until
+        it finds a match. Enter the URL that contains the JWK or JWKS file.
+         
+        If you choose :guilabel:`PEM Public Key`,
+        |charts-short| uses the specified public key to verify the JSON web
+        token. Enter the public key of the key pair used to sign the |jwt|. The
+        public key must be in `PEM format
+        <https://tools.ietf.org/html/rfc7468#section-5>`__, as shown in the
+        following example:
 
         .. code-block:: none
            :copyable: false
-
+             
             -----BEGIN CERTIFICATE-----
             MIIDfjCCAmagAwIBAgIBBzANBgkqhkiG9w0BAQUFADB0MRcwFQYDVQQDEw5LZXJu
             ZWwgVGVzdCBDQTEPMA0GA1UECxMGS2VybmVsMRAwDgYDVQQKEwdNb25nb0RCMRYw

source/images/charts/dashboard-share-button.png

@@ -10,7 +10,7 @@
     - Enter ``charts-jwt-tutorial``.
 
   * - Provider
-    - Select :guilabel:``Custom JSON Web Token``.
+    - Select :guilabel:`Custom JSON Web Token`.
 
   * - Signing Algorithm
     - Select :guilabel:`HS256`.

source/includes/list-table-jwt-auth-provider-options.rst

@@ -38,16 +38,21 @@ Duplicate a Dashboard
 You can duplicate any dashboard in your Dashboards page,
 even if you do not have editing permissions.
 
-To duplicate a dashboard from the Dashboards page:
+You can duplicate a dashboard from the :guilabel:`Dashboards` page or 
+from the dashboard itself. To duplicate a dashboard:
 
-1. Click the ellipsis (:guilabel:`...`) button on the desired dashboard.
+1. If you are on the :guilabel:`Dashboards` page, click the ellipsis 
+   (``...``) for the dashboard you want to duplicate.
+
+   If you are on a dashboard, click the ellipsis 
+   (``...``) in the top right corner.
 
 #. Select :guilabel:`Duplicate Dashboard` from the pop-up menu.
 
 #. In the :guilabel:`Dashboard Details` dialog, update the
    :guilabel:`Title` and :guilabel:`Description` fields.
 
-#. Click :guilabel:`Create` to save the duplicated dashboard.
+#. Click :guilabel:`Save` to save the duplicated dashboard.
 
 .. note::
 
@@ -267,12 +272,14 @@ Delete a Dashboard
    underlying data in the collections used in the dashboard will
    continue to exist.
 
-To delete a dashboard:
+You can delete a dashboard from the :guilabel:`Dashboards` page or 
+from the dashboard itself. To delete a dashboard:
 
-1. In the :guilabel:`Dashboards` page, locate the dashboard you wish to
-   delete.
+1. If you are on the :guilabel:`Dashboards` page, click the ellipsis 
+   (``...``) for the dashboard you want to delete.
 
-#. Click the :guilabel:`...` button on the top-right of the dashboard.
+   If you are on a dashboard, click the ellipsis 
+   (``...``) in the top right corner.
 
 #. Click :guilabel:`Delete Dashboard`.
 

source/includes/list-table-jwt-auth-tutorial-options.rst

@@ -10,6 +10,49 @@ MongoDB Charts Cloud Release Notes
    :depth: 1
    :class: twocols
 
+|charts| v1.27.0
+----------------
+
+*Released September 13, 2021*
+
+Improvements in this release:
+
+- |charts| now supports JWK\s or JWKS URL\s as an authentication 
+  provider when embedding charts.
+
+- Adds a new filter icon that indicates when dashboards are impacted by 
+  dashboard filters.
+
+- Adds new dashboard share icons to indicate public and internal 
+  sharing statuses.
+
+- Updates the dashboard and data source sharing screens.
+
+Bug fixes in this release:
+
+- Fixes an issue with highlighting in bar and column charts when 
+  converting the time zone of a date field.
+
+- Axis labels are now correctly highlighted for binned dates.
+
+- Improves performance when adding a missed field in the chart builder.
+
+- The :guilabel:`Convert type` option is now correctly enabled in the 
+  chart builder for single-level arrays in documents.
+
+- Fixes an issue where part of the chart builder tour for new users
+  was incorrectly positioned.
+
+- Donut charts with :guilabel:`By Series` colors now display properly 
+  with ``null`` values.
+
+- Programmatic highlighting now works correctly with single quotes in 
+  values.
+
+- The chart aggregation pipeline view is now accessible when a chart is 
+  loading.
+
+
 |charts| v1.26.1
 ----------------