Managing Groups

Custom Groups

Groups in SeaLights allow you to organize users and manage their access to specific applications they interact with. Users possessing the "Manage Users & Permissions" permission can create, update, or delete these groups to align with your organizational structure, such as departments or teams.

Creating a Group

1. In the Groups section under Users & Permissions , click Create Group .

2. Provide a name and an optional description for the group.

3. Assign applications to the group.

4. Click Create .

5. Optionally, add existing users as members.

   1. When members are added to a group, they'll receive an email notification informing them of their new group assignment.

Updating a Group

1. In the Groups list, find the group using the search bar or by navigating the list.

2. Click on the group's entry.

3. You can update the group's name, description, assigned applications, and members.

Deleting a Group

To delete a group, you'll first need to deactivate it:

1. In the Groups list, locate the group you want to delete.

2. Hover over the group and click the deactivate switch button.

3. Confirm the action when prompted. (As long as the group is only deactivated and not deleted, you can reactivate it if needed).

4. Once deactivated, hover over the group again and click the Delete icon.

5. Confirm the deletion when prompted.

---

System Groups

SeaLights includes special, default system groups: Everyone and Unassigned Users. Users with "Manage Users & Permissions" can update these groups.

Group: Everyone

This group automatically includes all users in your organization, regardless of whether they have been assigned to other custom groups.

• Purpose: To easily grant a common set of applications to all users in your organization.

• Key Behavior: Applications assigned to this group are visible to every user.

• Use Cases:

  • If you have a core set of applications that everyone should always have access to, regardless of their team or role.

  • If you choose not to manage application access via custom groups, you can enable the "Assign all apps to this group" flag within the Everyone group. This will make all existing and future applications visible to all users by default, simplifying access management in broader scenarios.

• "Assign all apps to this group" flag: This flag is off by default.

  • To set the "Assign all apps to this group" flag:

    1. Go to Settings > Users & Permissions > Groups

    2. Locate and click on the Everyone Group.

    3. Toggle the "Assign all apps to this group" flag.

Group: Unassigned Users

This group automatically contains all users in your organization who have not been explicitly assigned to any other custom group.

• Purpose: Primarily to manage the initial application visibility for new users who haven't yet been placed into a specific team or departmental group.

• Key Behavior: Applications assigned to this group are visible only to users who are not part of any other group.

• Use Cases:

  • To ensure that newly onboarded users can immediately see and interact with all applications upon their first login, even before they are assigned to a specific team's group.

  • If you prefer to restrict or specify the applications new, unassigned users can see, you can toggle this flag off or assign only a limited set of specific applications to this group.

• "Assign all apps to this group" flag: This flag is on by default.

  • To set the "Assign all apps to this group" flag:

    1. Go to Settings > Users & Permissions > Groups

    2. Locate and click on the Unassigned Users Group.

    3. Toggle the "Assign all apps to this group" flag.

Key Differences at a Glance:

Feature	Everyone Group	Unassigned Users Group
Membership	All users in the organization	Users not assigned to any other custom group
Primary Use	Broad access for all users	Initial access for new/unassigned users
Default "Assign all apps" Flag	Off	On
Application Visibility	Apps assigned here are seen by everyone in the organization.	Apps assigned here are seen only by users not in any other group.

---

Unassigned Applications

Applications that are not assigned to any group in your organization are considered unassigned applications. By default, these applications are not visible to any user in SeaLights unless the "Assign all apps to this group" toggle is enabled in one of your system groups (like the "Everyone" group or "Unassigned Users Group").

Applications can become unassigned in two main scenarios:

• A brand new application is reported to SeaLights through your Continuous Integration (CI) process and hasn't yet been assigned to a group.

• An application was previously assigned to one or more groups but has since been removed from all of them.

Users with the "Assign Unassigned Apps" permission have the ability to assign these applications to existing groups, making them visible to relevant users.

How to Assign Unassigned Applications

1. Go to Settings > Users & Permissions > Unassigned Apps

2. Find the applications you want to assign by browsing the list or using the search bar.

3. Select the desired applications.

4. Click on Assign To Group(s).

5. Choose the groups you want to assign the applications to from the list.

6. Click Assign to Groups to complete the process.