From 5ddddd1a811db8741ff181453fdd1aadde176f17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Corentin=20N=C3=A9au?= Date: Fri, 25 Oct 2024 16:42:52 +0200 Subject: [PATCH] Clarify how user search works This adds a few points which should shed light on how to search users using a drop-down list in Rancher, whether to add users to clusters or to projects. --- .../how-to-guides/new-user-guides/add-users-to-projects.md | 7 +++++-- .../access-clusters/add-users-to-clusters.md | 5 ++++- .../manage-clusters/projects-and-namespaces.md | 6 +++++- 3 files changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/how-to-guides/new-user-guides/add-users-to-projects.md b/docs/how-to-guides/new-user-guides/add-users-to-projects.md index d3beb2fb0b5..6a476e892de 100644 --- a/docs/how-to-guides/new-user-guides/add-users-to-projects.md +++ b/docs/how-to-guides/new-user-guides/add-users-to-projects.md @@ -29,7 +29,10 @@ Following project creation, you can add users as project members so that they ca 1. Click **Cluster > Projects/Namespaces**. 1. Go to the project where you want to add members. Next to the **Create Namespace** button above the project name, click **☰**. Select **Edit Config**. 1. In the **Members** tab, click **Add**. -1. Search for the user or group that you want to add to the project. +1. Search for the user or group that you want to add to the project. Note that: + * At least 2 characters must be typed in the search box for results to appear + * Users can be searched based on their username or display name + * Search is case-sensitive If external authentication is configured: @@ -63,4 +66,4 @@ Following project creation, you can add users as project members so that they ca **Result:** The chosen users are added to the project. - To revoke project membership, select the user and click **Delete**. This action deletes membership, not the user. -- To modify a user's roles in the project, delete them from the project, and then re-add them with modified roles. \ No newline at end of file +- To modify a user's roles in the project, delete them from the project, and then re-add them with modified roles. diff --git a/docs/how-to-guides/new-user-guides/manage-clusters/access-clusters/add-users-to-clusters.md b/docs/how-to-guides/new-user-guides/manage-clusters/access-clusters/add-users-to-clusters.md index dae224a37b2..0b98399df21 100644 --- a/docs/how-to-guides/new-user-guides/manage-clusters/access-clusters/add-users-to-clusters.md +++ b/docs/how-to-guides/new-user-guides/manage-clusters/access-clusters/add-users-to-clusters.md @@ -31,7 +31,10 @@ Cluster administrators can edit the membership for a cluster, controlling which 1. Click **☰ > Cluster Management**. 1. Go to the cluster you want to add members to and click **⋮ > Edit Config**. 1. In the **Member Roles** tab, click **Add Member**. -1. Search for the user or group that you want to add to the cluster. +1. Search for the user or group that you want to add to the cluster. Note that: + * At least 2 characters must be typed in the search box for results to appear + * Users can be searched based on their username or display name + * Search is case-sensitive If external authentication is configured: diff --git a/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md b/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md index a333b7b4dc4..41c648cee8f 100644 --- a/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md +++ b/docs/how-to-guides/new-user-guides/manage-clusters/projects-and-namespaces.md @@ -168,7 +168,11 @@ By default, your user is added as the project `Owner`. To add members: 1. In the **Members** tab, click **Add**. -1. From the **Select Member** field, search for a user or group that you want to assign project access. Note: You can only search for groups if external authentication is enabled. +1. From the **Select Member** field, search for a user or group that you want to assign project access. Keep in mind that: + * You can only search for groups if external authentication is enabled + * At least 2 characters must be typed in the search box for results to appear + * Users can be searched based on their username or display name + * Search is case-sensitive 1. In the **Project Permissions** section, choose a role. For more information, refer to the [documentation on project roles.](../authentication-permissions-and-global-configuration/manage-role-based-access-control-rbac/cluster-and-project-roles.md) ### 4. Optional: Add Resource Quotas