Module Permissions
Overview
In Unqork, Module Permissions lets you create and customize RBAC (role-based access control) in your module. RBAC lets you customize Express roles to determine how end-users End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. interact with your module. You can also adjust permissions and grant access to unauthenticated users.
With RBAC enabled, you can also customize permissions for specific components. For example, let's say you have an accounting firm and your module includes two dashboards. The first stores client submissions, and the second is used for administrator tasks. You want your accountants to have Write access to both dashboards. Your administrator needs Write access to the task dashboard and No Access to the client dashboard. With RBAC, this customization is simple. The Module Permissions provides you with two options for RBAC:
-
Customize RBAC for this module.
-
Allow Access to Anonymous Users.
First, let's explore how to access the Module Permissions.
Accessing Module Permissions
To access Module Permissions:
1. | Open your module in the Module Builder. |
2. | Click the ยทยทยท (ellipsis) button. |
3. | Select Module Permissions. |
Module Permissions Modal
Using the Module Permissions modal A modal is a window that appears on top of the content you are currently viewing., you can specify how your roles interact with your components and modules.
In the Module Permissions modal, there are two settings you can use to customize module RBAC:
Setting | Description |
---|---|
Customize RBAC for This Module |
When set to (ON), you can customize module and component access for each of your roles. By default, the Customize RBAC for This Module toggle is set to (ON). |
Allow Access to Anonymous Users |
When set to (ON), unauthenticated end-users End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product. can access this module without logging in. Unauthenticated or anonymous means the end-user does not have to be registered in Unqork. When an anonymous end-user navigates to your module, they receive a temporary token. Using this token, anonymous end-users can view the module in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.. By default, the Allow Access to Anonymous Users toggle is set to (OFF). |
Customizing Role Permissions
When the Customize RBAC for This Module toggle is set to (ON), you can adjust permissions for specific roles in your module. The modal displays roles and permissions in the following grid:
Attribute | Description |
---|---|
Role (Express) |
The Express role. |
Permission |
The permission for the corresponding Express role. Permissions include:
|
Effective Permission |
Confirmation of the selected permission from the Permission drop-down. |
Inherited From |
If the permission is Inherit, this column displays where the permission was inherited from. |
To make changes to role permissions:
1. | Find the role you'd like to customize. |
2. | From the Permissions drop-down, select a permission. |
3. | Click Save to return to the Module Builder. |