Role Creation Guide
The "Create New Role" form is used to define a new role by assigning specific permissions across different sections.
Input Fields
Role Name*:
Enter the name for the new role.
Input Rules:
- The Role Name must be 3 (minimum) to 50 (maximum) characters long.
- It can include letters (A–Z, a–z), numbers (0–9), spaces, hyphens (-), and underscores (_).
- The Role Name cannot start or end with a hyphen (-) or underscore (_).
- It cannot contain consecutive hyphens or underscores (e.g.,
Admin__RoleorRole--Manager).
Organization Name*:
Select the Organization from the dropdown menu.
Permission Configuration
Permissions are organized into five main sections.
Check the boxes to grant the corresponding abilities to the users who will be assigned this role.
Permissions Breakdown
| Section | Permission | Description |
|---|---|---|
| Devices | Register | Allows the user to register new devices. |
| View | Allows the user to view the list and detail page of a device. | |
| Update | Allows the user to change a device’s location or edit its description. | |
| Unregister | Allows the user to remove a device from its assigned organization. | |
| Users | Create | Allows the user to invite new users. |
| View | Allows the user to view the list of existing users. | |
| Update | Allows the user to edit a user's name or change their assigned role. | |
| Delete | Allows the user to delete a user account. | |
| Roles | Create | Allows the user to define and create new roles. |
| View | Allows the user to view the list and profiles of roles. | |
| Update | Allows the user to modify the name or permissions of an existing role. | |
| Delete | Allows the user to delete a role. | |
| Organizations | Create | Allows the user to create new child organizations. |
| View | Allows the user to view the list of organizations. | |
| Update | Allows the user to modify the name of an organization. | |
| Delete | Allows the user to delete an organization. | |
| VPN | Create | Allows the user to create new VPN tunnels and add devices/users to them. |
| View | Allows the user to view the list and overview page of VPN tunnels. | |
| Update | Allows the user to edit the name of a VPN tunnel. | |
| Delete | Allows the user to delete a VPN tunnel, which also removes users and devices from it. | |
| Start/Stop | Allows the user to start and stop an existing VPN tunnel. | |
| Enable/Disable | Allows the user to enable and disable an existing VPN tunnel. |
⚠️ Important Notes on Permissions
View Dependency: The View permission for any section is required if you intend to grant any other permission (Create, Update, Delete, etc.) in that same section.
VPN Dependency: To grant any VPN permissions, the Devices View permission must also be selected.
