Add user group filter endpoint

[kjac]

Prerequisites

• I have added steps to test this contribution in the description below

Description

This PR adds a filter endpoint for user groups.

Note that the filter only ever returns groups that the current user is a member of, unless the current user is an admin.

Testing this PR

Use Swagger to test the new endpoint:

1. It should be possible to filter out groups by name using the filter parameter.
2. If the executing user is an admin, the endpoint returns all user groups that match the filter parameter (all groups if the parameter is empty)
3. If the executing user is not an admin, the endpoint returns only user groups that the current user is assigned to.

[warrenbuckley]

Nice hopefully saves me doing some juggling to get the current users groups that I am doing currently @kjac 😄

As I do the following in the UI/Javascript to get the current groups

• Use UMB_CURRENT_USER_CONTEXT and get the Current User Id/Key
• New up UmbUserDetailRepository and call requestByUnique with the current user Id/key
• Which returns a collection of GUIDs that are the groups the user is in
• New up UmbUserGroupItemRepository and call RequestItems with the array from the previous step
• Returns an array of the groups which include name property

Suggestions

Could this be part of the response of getting the current user at /umbraco/management/api/v1/user as there is an isAdmin and UserGroupIds array of GUIDs

Any plans to add group aliases?
This only returns the names and no longer the group aliases such as admin as opposed to now getting Administrators which can be problematic for some packages that have config that allowed users to control which usergroups had access and was using the same aliases based on the previous convention of specifying permissions in package.manifest or the C# approach of registering dashboards etc...

https://docs.umbraco.com/umbraco-cms/extending/dashboards#specifying-permissions

[kjac]

Hi @warrenbuckley - thanks for chiming in here 👍

We're amending the user group endpoints to handle aliases (it was omitted in the initial implementation by mistake) - see #16154

Once that PR is in, this PR will likewise feature user group aliases in the output 😄

[Zeegaan]

Looks good tests good