Skip to content

Role Management


Role management is used to set functional operation permissions for workspace members. You can assign default roles to members, or create custom roles to combine the required permissions.

Default Roles

If different teams in your organization need to view or operate different functional modules, you can invite members to join the current workspace and assign role permissions to them, thereby controlling the Guance functional modules that members can access and operate.

The system provides four default member roles:

  • Owner

  • Administrator

  • Standard

  • Read-only

Default roles cannot be deleted or have their permission scopes changed.

Permission Description

For the permission scopes of different default roles, refer to Permission List.

  • Owner: The owner of the current workspace, with all operation permissions within the workspace, and the ability to adjust the role permissions of other members.

    • The workspace creator is the Owner by default;

    • A workspace can have only one Owner;

    • The Owner cannot leave the workspace;

    • The Owner can transfer ownership to a workspace member. After the transfer succeeds, the original Owner is downgraded to Administrator.

  • Administrator: The administrator of the current workspace, with read/write permissions for the workspace, and the ability to adjust the role permissions of members other than the Owner;

  • Standard: A standard member of the current workspace, with read/write permissions for the workspace;

  • Read-only: A read-only member of the current workspace, who can only view workspace data without write permissions.

Custom Roles

Besides default roles, you can create custom roles, combine the required functional operation permissions according to job responsibilities, and then assign the roles to members.

Creating, editing, and cloning custom roles requires Member Management permission.

  1. On the Manage > Role Management page, click "Add Role";

  2. Define the role name and description;

  3. Select the required functional permissions; select at least one;

  4. Save.

You can select permissions item by item, or check all configurable permissions within a group. When only some permissions within a group are selected, the group appears half-selected; after saving, authorization is applied according to the actually checked items.

Custom roles support the configuration of the following administrator operation permissions:

Permission Group Permission Item Purpose
Workspace Management Token Management Grants workspace Token management permissions. Write operations on the Token management page also require the member to have Owner or Administrator identity.
Cloud Account Management Account Management Create, edit, and delete cloud accounts in the current workspace.
Cloud Billing Cloud Billing Budget Management Create, edit, enable, disable, delete, and export budgets.
RUM Application Hosting RUM Admin Enable/Configure View RUM hosting configuration and manage Sourcemap (source code mapping) files.

Permission items are displayed according to the workspace version and feature availability. After saving a role, you can go to Member Management to assign the role to target members. After role permissions are adjusted, members who obtained permissions through the role will take effect according to the new configuration.

A member's effective permissions are the combined result of roles directly assigned to the individual, member group roles, and team roles. To revoke a permission, you should adjust all role sources that still grant that permission.

For example, when changing the daily management permissions of an operations member to a custom role and having another administrator manage the member's personal API Key usage eligibility, you should remove the Manage member use of personal API Key permission from all role sources of that member, and adjust the original Administrator role.

Manage Roles

You can perform the following operations on custom roles:

  • Export the permissions of all roles as a list;

  • Edit and adjust role permissions;

  • Delete a role if it is not associated with any member account;

  • Clone an existing role, add or remove permissions based on the source role's authorized permissions, and create a new role;

  • Click any custom role to view its details, including the role name, creation/update time, creator/updater, description, and role permissions;

    • Click the edit button to the right of the role name at the top to modify role permissions;
    • In the role list, you can enable the "Show only enabled permissions" toggle.

Associating Data Access Rules

Roles define the operations that members can perform, while data access rules define the data scope that members can view. The two remain independent resources. In the role management list, to the right of the Members column, you can use the Data Access Rules column to view the number of rules currently associated with default and custom roles, and maintain the associations between roles and rules.

  • Click or hover over the rule count to choose Edit or Go to Data Access; the operations are also available when the count is 0;
  • Choosing Edit opens the "Associate Data Access Rules" drawer on the right side of the current page. You can search rule names, view rule information by page, and check or uncheck rules associated with the current role;
  • After saving, the system only updates the associations between roles and data access rules; it does not modify rule names, data types, filter conditions, or field masking configurations;
  • Choosing Go to Data Access takes you to the data access page with the current role filter automatically applied;
  • Deleted data access rules are not counted toward the rule count.

After rules are successfully associated, the system calculates the applicable data access rules based on the member's roles when the member queries data.

Notes on system default role behavior
  • Owner is not restricted by data access rules;
  • When an Administrator is associated with rules, the data scope is restricted and masking is applied according to the rules; when no rules are associated, even if “Data Access Scope Restriction” is enabled, data can still be queried within the original permission scope.
Permission Notes

Viewing the rule count and rule details requires both role viewing and data access viewing permissions; editing and saving associations requires data access management permission. Without data access viewing permission, rule details are not returned, and the page displays -- or hides the column according to permission specifications.

Assigning Roles to Members

With Member Management permission, adjust a member's personal role as follows:

  1. Go to Manage > Member Management;
  2. Select the target member and click the Edit button on the right;
  3. Select a role in the dialog and click OK.

After saving, the system applies permissions according to the roles the member ultimately obtains. If the member also obtains roles through a member group or team, you also need to adjust the authorization in the corresponding member group or team.

Permission List

You can set permissions for custom roles in the workspace.

For more details, refer to Permission List.

Feedback

Is this page helpful?