> For the complete documentation index, see [llms.txt](https://ztrust.gitbook.io/ztrust-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ztrust.gitbook.io/ztrust-documentation/user-manual-ztrust-v2.0/guide-to-navigation/groups.md). # Groups

Under the Groups tab, users have the ability to create various groups to accommodate specific sets of users. You can use the search box to find a specific user. You also have the option to go for Exact Search. Click the Refresh button to see the latest settings.

You can also choose how many groups you want to display on one screen. Select your preferred option from the dropdown menu as shown above.

#### **Create group** Click on the Create group option to generate a new group.

Choose any Name you like and form the group. For example - demo Click on Create to establish the group, or click Cancel to abort the operation. Upon selecting Create, you will be directed to the screen below.

After clicking on the three dots, the following options are visible: * Rename - After selecting Rename, you will see the following prompt

Enter the desired name for the group. Click Rename to confirm the new name or Cancel to discard the change. * Move to - After selecting Move to, the following prompt will appear:

Choose the specific group where you want to move your group.

Then click Move here to confirm the action. * Create child group - After selecting this option, the following prompt will appear:

Enter any name according to your requirements. Click Create to create the child group, or click Cancel to discard.

The new group will be created inside the previous group. For example, childgroup\_demo2 will be created inside the rename\_demo group. * Delete - After selecting Delete, the following confirmation prompt will appear:

Click Delete to remove the group, or click Cancel to abort the action.

You can use the filter groups box to find a specific group. Click the Refresh button to see the latest settings.

You can also choose how many groups you want to display on one screen. Select your preferred option from the dropdown menu as shown above.

To delete multiple groups at once, select each group by clicking the checkbox next to it. Then, click Delete. A confirmation prompt will appear.

Click Delete to confirm the deletion, or click Cancel to abort.

#### **Child groups** #### **Create group** To create a new child group, click on Create Group.

Enter the desired name. Click Create to make the group, or Cancel to discard.

You can use the filter groups box to find a specific group. Click the Refresh button to see the latest settings.

You can also choose how many groups you want to display on one screen. Select your preferred option from the dropdown menu as shown above. #### **Members**

After selecting Add member, you will be taken to the following screen.

Select the desired users by clicking the checkbox next to their names, then click Add.

You'll find the specific user within this group.

#### **Name** This is the name used by the user during creation. It can also be used for logging into ZTrust. #### **Email** The user's provided Email address during registration or in case the user has been created by the Admin. It can also be used for logging into ZTrust. #### **First Name** The user's First Name or the First Name provided during registration. **Last Name** The Last Name provided by the user during registration, or the user's last name. #### **Membership**

To remove the specific user from the group, simply click the Leave button. #### **Attributes**

Within the Attributes section, you have the ability to define any variable you require for the entire Group. Click on Add attributes.

Just provide the Key, which is the variable you want to define, and then input its corresponding Value. Click Add attribute to save the Key-Value pair. To delete the Key-Value pair, click on the '-' symbol. Click on Save to keep these alterations, and click on Revert to discard any changes made. #### **Role mapping**

Upon selecting the Assign role, you will be directed to the following screen.

You can use the search box to find a specific group. Click the Refresh button to see the latest settings.

You can also choose how many groups you want to display on one screen. Select your preferred option from the dropdown menu as shown above.

You can then select the checkbox for the specific role you want to assign to this group. Click on the checkbox to select the role, then click on Assign. If you decide not to associate the selected roles, click on Cancel to discard the changes.

You also have the option to filter roles based on the clients.

You can use the search box to find a specific role. Click the Refresh button to see the latest settings.

You can also choose how many roles you want to display on one screen. Select your preferred option from the dropdown menu as shown above. #### **Hide inherited roles** Selecting this checkbox hides inherited roles, preventing you from seeing roles inherited from composites. To view inherited roles, simply uncheck this option. #### **Name** It includes the list of all the different roles that are already defined in ZTrust. #### **Inherited** This pertains to roles explicitly assigned to users and those inherited from composite roles. It can have two values: True (indicating the role is inherited from composites) or False (indicating it is not inherited from any composite role). #### **Description** It refers to the description for the role which will aid you in identifying its purpose. This field can be localized by specifying a substitution variable with ${var-name} strings.

Upon clicking on the three dots, you will find the Unassign option. When you click on Unassign, a confirmation prompt will appear.

If you wish to unassign a specific role from this group, click on Remove. Otherwise, click Cancel.

To unassign multiple roles simultaneously, first, select the specific roles by clicking on the checkboxes next to them. Then, click on Unassign.

You'll receive a confirmation prompt similar to the one shown above. To unassign the roles, click on Remove. Otherwise, click on Cancel.