2.12 Groups Module | Guardpot Documentation

The Groups module enables role-based access control (RBAC) through user group management, allowing administrators to organize users into logical groups and assign permissions to resources such as honeypots, alarms, and reports. The main Groups interface is shown in Figure 2.12-1.

Figure 2.12-1 – Group Management Interface

2.12.1 Groups Overview

The left panel displays all configured groups as individual cards, as shown in Figure 2.12.1-1. Each card provides at-a-glance information about the group and its members.

Figure 2.12.1-1 – Groups Card Layout

2.12.1.1 Search Groups

A Search field at the top of the Groups panel allows you to quickly locate specific groups by name. As you type, the group cards filter in real time to match your search query, as shown in Figure 2.12.1.1-1.

Figure 2.12.1.1-1 – Group Search Bar

2.12.2 Group Card Structure

Each group is displayed as a card in the main Groups panel, containing detailed information and action buttons, as shown in Figure 2.12.2-1.

Figure 2.12.2-1 – Group Card Detail

2.12.2.1 Card Properties

Property	Description
Group Avatar	Visual icon identifier for the group
Group Name	Identifier for the group (e.g., "grup1", "grup2", "grup3")
Group Members	Header with hint text: "Click to photo for list or delete users in group."
Member Count	Number of members with icon (e.g., "1 Member", "2 Members")
Description	Purpose or scope statement (e.g., "Ortak çalışma grubu.", "Ortak paylaşım grubu.", "Ortak proje grubu.")
Created By	Administrator who created the group (e.g., "Guardpot Admin")
Created Date	Date when the group was established (e.g., "03.04.2024")

2.12.2.2 Card Action Buttons

Each group card includes action icons in the top-right corner:

Action	Icon	Function
Edit	✏️	Modify group name, description, or group picture
Delete	🗑️	Permanently remove the group and its associations

2.12.3 Editing a Group

To modify an existing group, click the Edit (✏️) icon on the desired group card. The edit form opens, as shown in Figure 2.12.3-1.

Figure 2.12.3-1 – Edit Group Form

The edit form allows you to update the following properties:

Parameter	Description
Group Name	Rename the group
Description	Update the purpose or scope statement
Upload Image	Change the group's visual avatar/icon

Save the changes to apply the updates to the group card.

2.12.4 Deleting a Group

To remove a group entirely, click the Delete (🗑️) icon on the corresponding group card, as shown in Figure 2.12.4-1. Confirm the deletion when prompted.

Figure 2.12.4-1 – Group Delete Icon

Warning: Deleting a group permanently removes all group associations and member assignments. This action cannot be undone.

2.12.5 Adding Members to a Group

To assign users to a group, click the + Add Member button located at the bottom of the desired group card, as illustrated in Figure 2.12.5-1.

Figure 2.12.5-1 – Add Member Button on Group Card

Clicking this button opens the member assignment form with the following fields:

Parameter	Description
Select User	Choose a user from the available user list to add to the group
Description	Optional note about the member's role or purpose in the group

After confirming the selection, the new member appears in the group card. The Group Members section updates to reflect the new count. If the group has more members than can be displayed as avatars, a +N badge indicates the additional count.

The Group Members section header provides the hint: "Click to photo for list or delete users in group." — clicking on member avatars allows you to view the full member list or remove individual users from the group.

2.12.6 Creating a New Group

To create a new group, click the Create A New Group button located in the right panel, as highlighted in Figure 2.12.6-1.

Figure 2.12.6-1 – Create A New Group Button

2.12.6.1 Summary Panel

The summary panel above the button displays the current system totals:

Metric	Description
Total Groups	Current number of groups configured in the system (e.g., 3)
Total User	Total number of users assigned across all groups (e.g., 2)

2.12.6.2 New Group Form

Clicking the Create A New Group button opens the group creation form, as shown in Figure 2.12.6.2-1.

Figure 2.12.6.2-1 – Create New Group Form

Configure the following parameters:

Parameter	Description
Name	A unique identifier for the group (e.g., "SOC Team", "Auditors")
Upload Group Image	Optional visual avatar/icon for the group card
Description	A brief explanation of the group's purpose or scope (e.g., "Incident response coordination group")

After saving, the new group appears as a card in the left panel alongside existing groups, and the summary panel counters update accordingly.