From a244b0720372386eac1ef776ee2e2390f366d8a1 Mon Sep 17 00:00:00 2001 From: Kapian1234 Date: Thu, 2 Jan 2025 17:26:36 +0800 Subject: [PATCH 1/8] Add documentation for workspace privacy Signed-off-by: Kapian1234 --- _dashboards/workspace/workspace-acl.md | 35 ++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 16b2cc8628..0d4155ee4f 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -151,3 +151,38 @@ To remove several collaborators simultaneously, follow these steps: 2. Select the **Delete x collaborators** button. 3. Review the confirmation modal that appears. 4. Select **Confirm** to remove all selected collaborators from the table. + +## Workspace privacy + +**Workspace Privacy** allows quick configuration of access permissions for all users. Only **workspace administrators** can set workspace privacy. As with the collaborators feature, **Workspace Privacy** is only available when permission control is enabled. Workspace privacy can be configured with the following three access levels: + +* **Private to collaborators (default access level):** Only collaborators can access the workspace. +* **Anyone can view:** Anyone can view workspace assets. (Grants **Read only** permission to all users.) +* **Anyone can edit:** Anyone can view, create, and update workspace assets. (Grants **Read and write** permission to all users.) + +A collaborator will be granted the higher permissions when their individual access level differs from the workspace privacy. For example, if workspace privacy is set to "Anyone can edit", any collaborator with read-only access level will also be able to edit the workspace assets. + +### Configuring workspace privacy + +You can set up workspace privacy on the **Create Workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** and **Workspace details** pages as a **Workspace admin** or **Dashboard admin**. + +#### Setting up workspace privacy during workspace creation + +1. Complete entering the workspace name, selecting use case, and associating data sources. See [Create a workspace]({{site.url}}{{site.baseurl}}/dashboards/workspace/create-workspace) for instructions. +2. Choose the desired access level from the cards at the **Set up privacy** panel. (**Private to collaborators** is set as the default selection.) +3. Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox below. +4. Select **Create workspace** to finish the workspace creation. + +#### Modifying workspace privacy on the Collaborators page + +1. Select the **Edit** next to **Workspace privacy**. +2. Click the selector which displays the current workspace privacy access level. +3. Select the new access level from the dropdown list. +4. Select **Save changes** to apply the modifications. + +#### Modifying workspace privacy on the Workspace details page + +1. Select the **Edit** button at the top-right corner of the **Details** panel. +2. Click the selector which displays the current workspace privacy access level at the bottom of the panel. +3. Select the new access level from the dropdown list. +4. Select **Save** to apply the modifications. From c5f23c952254de5a21d2ccfb231bf59916937bb1 Mon Sep 17 00:00:00 2001 From: Kapian1234 Date: Fri, 3 Jan 2025 10:41:23 +0800 Subject: [PATCH 2/8] Address the automation check failures Signed-off-by: Kapian1234 --- _dashboards/workspace/workspace-acl.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 0d4155ee4f..97db8742f1 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -168,9 +168,9 @@ You can set up workspace privacy on the **Create Workspace** page as a **Dashboa #### Setting up workspace privacy during workspace creation -1. Complete entering the workspace name, selecting use case, and associating data sources. See [Create a workspace]({{site.url}}{{site.baseurl}}/dashboards/workspace/create-workspace) for instructions. +1. Complete entering the workspace name, selecting use case, and associating data sources. See [Create a workspace]({{site.url}}{{site.baseurl}}/dashboards/workspace/create-workspace/) for instructions. 2. Choose the desired access level from the cards at the **Set up privacy** panel. (**Private to collaborators** is set as the default selection.) -3. Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox below. +3. Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox at the bottom of the panel. 4. Select **Create workspace** to finish the workspace creation. #### Modifying workspace privacy on the Collaborators page @@ -182,7 +182,7 @@ You can set up workspace privacy on the **Create Workspace** page as a **Dashboa #### Modifying workspace privacy on the Workspace details page -1. Select the **Edit** button at the top-right corner of the **Details** panel. +1. Select the **Edit** button at the upper-right corner of the **Details** panel. 2. Click the selector which displays the current workspace privacy access level at the bottom of the panel. 3. Select the new access level from the dropdown list. 4. Select **Save** to apply the modifications. From de5ed8bbe4c5bdfac48686cb141e24ee1afb081c Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Mon, 13 Jan 2025 17:17:18 -0600 Subject: [PATCH 3/8] Writer review Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 53 +++++++++++++++----------- 1 file changed, 31 insertions(+), 22 deletions(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 97db8742f1..578153cbc1 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -152,37 +152,46 @@ To remove several collaborators simultaneously, follow these steps: 3. Review the confirmation modal that appears. 4. Select **Confirm** to remove all selected collaborators from the table. -## Workspace privacy +## Configuring workspace privacy -**Workspace Privacy** allows quick configuration of access permissions for all users. Only **workspace administrators** can set workspace privacy. As with the collaborators feature, **Workspace Privacy** is only available when permission control is enabled. Workspace privacy can be configured with the following three access levels: +When permission control is enabled, workspace administrators can set who has access to a workspace, with the following three access levels: -* **Private to collaborators (default access level):** Only collaborators can access the workspace. -* **Anyone can view:** Anyone can view workspace assets. (Grants **Read only** permission to all users.) -* **Anyone can edit:** Anyone can view, create, and update workspace assets. (Grants **Read and write** permission to all users.) +* **Private to collaborators (Default):** Gives only workspace collaborators can access the workspace. +* **Anyone can view:** Grants **Read only** permissions to all users in the workspace, allowing them to view workspace assets. +* **Anyone can edit:** Grants **Read and write** permissions to all users, allowing view, create, and update workspace assets. -A collaborator will be granted the higher permissions when their individual access level differs from the workspace privacy. For example, if workspace privacy is set to "Anyone can edit", any collaborator with read-only access level will also be able to edit the workspace assets. +Collaborators are granted higher permissions when their individual access level differs from that set in the workplace settings. For example, if workspace privacy is set to “Anyone can edit”, any collaborator with read-only access level will also be able to edit the workspace assets. -### Configuring workspace privacy +You can set up workspace privacy on the **Create Workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** and **Workspace details** pages, as a **Workspace admin** or **Dashboard admin**. -You can set up workspace privacy on the **Create Workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** and **Workspace details** pages as a **Workspace admin** or **Dashboard admin**. +### Setting up workspace privacy during workspace creation -#### Setting up workspace privacy during workspace creation +Use the following steps to change workplace privacy settings when creating a new workspace: -1. Complete entering the workspace name, selecting use case, and associating data sources. See [Create a workspace]({{site.url}}{{site.baseurl}}/dashboards/workspace/create-workspace/) for instructions. -2. Choose the desired access level from the cards at the **Set up privacy** panel. (**Private to collaborators** is set as the default selection.) -3. Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox at the bottom of the panel. -4. Select **Create workspace** to finish the workspace creation. +1. Choose the desired access level from the cards at the **Set up privacy** panel. +2. _Optional_ Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox. +3. Select **Create workspace** to finish the workspace creation. -#### Modifying workspace privacy on the Collaborators page +### Modifying workspace privacy on the **Collaborators** page -1. Select the **Edit** next to **Workspace privacy**. -2. Click the selector which displays the current workspace privacy access level. -3. Select the new access level from the dropdown list. -4. Select **Save changes** to apply the modifications. +Use the following steps to edit the workplace privacy settings on the **Collaborators** page: -#### Modifying workspace privacy on the Workspace details page +1. Next to **Workplace privacy**, select **Edit**. +2. Select the new access level from the dropdown. +3. Select **Save changes** to apply the modifications. + +### Modifying workspace privacy on the Workspace details page + +Use the following steps to edit the workplace privacy settings on the **Collaborators** page: + +1. Select the **Edit** button at the upper-right corner of the **Details** panel. +2. Select the new access level from the dropdown. +3. Select **Save** to apply the modifications. + +### Modifying workspace privacy on the Workspace details page + +Use the following steps to edit the workplace privacy settings on the **Collaborators** page: 1. Select the **Edit** button at the upper-right corner of the **Details** panel. -2. Click the selector which displays the current workspace privacy access level at the bottom of the panel. -3. Select the new access level from the dropdown list. -4. Select **Save** to apply the modifications. +2. Select the new access level from the dropdown. +3. Select **Save** to apply the modifications. From 1066f11b2aa3cd1017651db7237257dd1eb3e051 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 14 Jan 2025 10:53:48 -0600 Subject: [PATCH 4/8] Apply suggestions from code review Co-authored-by: Nathan Bower Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 33 +++++++++++++------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 578153cbc1..a96afde293 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -154,41 +154,40 @@ To remove several collaborators simultaneously, follow these steps: ## Configuring workspace privacy -When permission control is enabled, workspace administrators can set who has access to a workspace, with the following three access levels: +When permission control is enabled, workspace administrators can set one of the following three access levels: -* **Private to collaborators (Default):** Gives only workspace collaborators can access the workspace. -* **Anyone can view:** Grants **Read only** permissions to all users in the workspace, allowing them to view workspace assets. -* **Anyone can edit:** Grants **Read and write** permissions to all users, allowing view, create, and update workspace assets. +* **Private to collaborators (Default):** Only workspace collaborators can access the workspace. +* **Anyone can view:** Grants **Read only** permissions to all workspace users, allowing them to view workspace assets. +* **Anyone can edit:** Grants **Read and write** permissions to all users, allowing them to view, create, and update workspace assets. -Collaborators are granted higher permissions when their individual access level differs from that set in the workplace settings. For example, if workspace privacy is set to “Anyone can edit”, any collaborator with read-only access level will also be able to edit the workspace assets. +Collaborators are granted higher permissions when their individual access level differs from that set in the workspace settings. For example, if workspace privacy is set to "Anyone can edit", any collaborator with read-only access will also be able to edit workspace assets. -You can set up workspace privacy on the **Create Workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** and **Workspace details** pages, as a **Workspace admin** or **Dashboard admin**. +You can set up workspace privacy on the **Create workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** or **Workspace details** pages as a **Workspace admin** or **Dashboard admin**. ### Setting up workspace privacy during workspace creation -Use the following steps to change workplace privacy settings when creating a new workspace: +Use the following steps to change workspace privacy settings when creating a new workspace: -1. Choose the desired access level from the cards at the **Set up privacy** panel. +1. Choose the desired access level from the **Set up privacy** panel. 2. _Optional_ Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox. -3. Select **Create workspace** to finish the workspace creation. +3. Select **Create workspace** to create the workspace. ### Modifying workspace privacy on the **Collaborators** page -Use the following steps to edit the workplace privacy settings on the **Collaborators** page: +Use the following steps to edit the workspace privacy settings on the **Collaborators** page: -1. Next to **Workplace privacy**, select **Edit**. -2. Select the new access level from the dropdown. +1. Next to **Workspace privacy**, select **Edit**. +2. Select the new access level from the dropdown menu. 3. Select **Save changes** to apply the modifications. -### Modifying workspace privacy on the Workspace details page +### Modifying workspace privacy on the **Workspace details** page -Use the following steps to edit the workplace privacy settings on the **Collaborators** page: +Use the following steps to edit the workspace privacy settings on the **Workspace details** page: -1. Select the **Edit** button at the upper-right corner of the **Details** panel. -2. Select the new access level from the dropdown. +1. Select the **Edit** button in the upper-right corner of the **Details** panel. +2. Select the new access level from the dropdown menu. 3. Select **Save** to apply the modifications. -### Modifying workspace privacy on the Workspace details page Use the following steps to edit the workplace privacy settings on the **Collaborators** page: From 75790559d64218bc2ff9d358e3dce9f8c82c1467 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 14 Jan 2025 10:54:24 -0600 Subject: [PATCH 5/8] Remove redundant text. Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index a96afde293..4087c7b9c6 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -187,10 +187,3 @@ Use the following steps to edit the workspace privacy settings on the **Workspac 1. Select the **Edit** button in the upper-right corner of the **Details** panel. 2. Select the new access level from the dropdown menu. 3. Select **Save** to apply the modifications. - - -Use the following steps to edit the workplace privacy settings on the **Collaborators** page: - -1. Select the **Edit** button at the upper-right corner of the **Details** panel. -2. Select the new access level from the dropdown. -3. Select **Save** to apply the modifications. From 415fccb640be4fbf533af4628b04726cf1fadff4 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 14 Jan 2025 12:57:03 -0600 Subject: [PATCH 6/8] Update _dashboards/workspace/workspace-acl.md Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 4087c7b9c6..fb7cd24711 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -169,7 +169,7 @@ You can set up workspace privacy on the **Create workspace** page as a **Dashboa Use the following steps to change workspace privacy settings when creating a new workspace: 1. Choose the desired access level from the **Set up privacy** panel. -2. _Optional_ Decide whether to continue configuring collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox. +2. _Optional_ Decide whether to add collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox. 3. Select **Create workspace** to create the workspace. ### Modifying workspace privacy on the **Collaborators** page From d3d81754b6f01faac4a78d8fe6561f56a1fa5b23 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Tue, 14 Jan 2025 12:57:26 -0600 Subject: [PATCH 7/8] Apply suggestions from code review Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index fb7cd24711..1d9f3e83a1 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -161,7 +161,7 @@ When permission control is enabled, workspace administrators can set one of the * **Anyone can edit:** Grants **Read and write** permissions to all users, allowing them to view, create, and update workspace assets. Collaborators are granted higher permissions when their individual access level differs from that set in the workspace settings. For example, if workspace privacy is set to "Anyone can edit", any collaborator with read-only access will also be able to edit workspace assets. - +Users at the collaborator level are granted additional permissions even when their access level differs from that of the workspace. You can set up workspace privacy on the **Create workspace** page as a **Dashboard admin**. You can also modify it on the **Collaborators** or **Workspace details** pages as a **Workspace admin** or **Dashboard admin**. ### Setting up workspace privacy during workspace creation From 5437c59d2027550a319ecaf0c812dbd8559f27d7 Mon Sep 17 00:00:00 2001 From: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Date: Wed, 15 Jan 2025 15:57:01 -0600 Subject: [PATCH 8/8] Update workspace-acl.md Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> --- _dashboards/workspace/workspace-acl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_dashboards/workspace/workspace-acl.md b/_dashboards/workspace/workspace-acl.md index 1d9f3e83a1..a3779cfbe0 100644 --- a/_dashboards/workspace/workspace-acl.md +++ b/_dashboards/workspace/workspace-acl.md @@ -169,7 +169,7 @@ You can set up workspace privacy on the **Create workspace** page as a **Dashboa Use the following steps to change workspace privacy settings when creating a new workspace: 1. Choose the desired access level from the **Set up privacy** panel. -2. _Optional_ Decide whether to add collaborators after workspace creation by selecting the **Go to configure the collaborators right after creating the workspace.** checkbox. +2. _Optional_ Decide whether to add collaborators after workspace creation by selecting the **Add collaborators after workspace creation.** checkbox. 3. Select **Create workspace** to create the workspace. ### Modifying workspace privacy on the **Collaborators** page