Top

Wapi documentation

## Role Permissions Overview

#### Role Permissions

#### Overview

The Role Permissions module enables administrators to implement Role-Based Access Control (RBAC) within the Wapi platform. This ensures that team members only have access to the specific modules required for their roles, reducing security risks and streamlining the administrative workflow.

Prerequisites
Before managing roles, ensure you have Super Admin access. Default roles like "Admin" and "User" are seeded during installation but can be customized or expanded.

#### Managing Roles

Follow these steps to create and manage custom roles for your organization:

- Navigate to Admin Guide > Role Permissions in the main sidebar.
- Click the Add New button at the top right of the roles table.
- Enter a descriptive Role Name (e.g., Billing Manager or Support Specialist).
- Define the role's status as Active to enable it for user assignment.

#### Permission Assignment

Assigning permissions is a granular process that defines exactly what a role can do within each module:

- Locate the role you wish to configure and click the Edit Permissions (Shield) icon.
- Select Modules: Use the checkboxes to grant access to specific modules like Users, Plans, or Campaigns.
- Specify Actions: For each module, define if the role has View, Create, Edit, or Delete capabilities.

Pro Tip
Always follow the Principle of Least Privilege. Grant only the minimum permissions required for a user to perform their specific tasks.

#### Assigning Roles to Users

Once a role is created, it can be assigned to new or existing users:

- Go to Manage Users and click Add User.
- In the Role dropdown menu, select the custom role you just created.
- For existing users, click the Edit icon in the user list and update their Role field.

Important
A user can only be assigned one role at a time. Changing a role's permissions will immediately affect all users currently assigned to that role.