4.1 Roles
This feature allows you to set up and manage default and custom roles and permissions for different user groups on your deployment. Each deployment has a default “Admin” and "Member" role, which cannot be deleted. The default “Admin” role allows for full control over ALL functionality on your deployment, while the default "Member" role only grants access to edit their own posts. "Member" role can be edited to update the permissions. "Admin" role cannot be edited to update the permissions.
Also, permissions are fully determined by Role-Based Access Control (RBAC). This means that each user can be assigned a specific role by an admin, which in turn grants them a particular set of operations within the platform. Below is a list of permissions included in the Mzima Platform;
Permissions included in the platform
Manage Users: This permission entails the following operations;
Viewing the list of users on the platform
Adding, Editing or Deleting Users
The setup in this guide is demonstrated in the below video as well. You can watch and follow the guide at the same time!
Video setup guide
Actions that need Authorization or Login to be Accessed
Users can still interact with the Mzima Platform while logged out, but their capabilities will be limited compared to those of logged-in users. Here is a breakdown:
If a user is not authenticated;
The user can create posts on the platform although the usernames will be marked as Anonymous. Also, the user cannot edit their posts once submitted.
The user can view statuses that are published only.
The user can view saved filters if only the visibility of the filters is set to ‘Everyone’.
If a user is authenticated;
The user can access the platform settings if they have the 'Manage Settings' permission only.
The user can create saved filters and adjust the visibility.
The users can create posts. It is worth noting that they can only edit them if they have the 'Edit their own posts' permission.
To access the roles management page, on the sidebar, click on Settings
Then, click on Roles
You’ll be redirected to a page with a list of all existing roles - default & custom roles (created by admins if any exist).
To add a custom user role, click on the yellow Add icon
Add the following details
Name: Provide a name for this new custom role
Description: Provide a brief description of what/who this custom role has been created for
Set your permissions. The list below shows the list of permissions included in the platform. You can view the brief breakdown of each of the permissions that can be granted to users by selecting .
4.1.2 Edit Role
To edit a role, click on a role from the list provided to you.
Next:
On redirection to the edit page, make your desired changes to the role (i.e fill out details as directed in the section)
Click on Save to update the role.
4.1.3 Delete Role
To delete a role, click on a role from the Roles management list page
Then, click on the Delete button at the bottom of the page
A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the custom role. If:
You would like to proceed with deletion, click on Delete
You would not like to proceed with deletion, click on Cancel
