Module Security

Last modified: April 18, 2024

1 Introduction

Within a module you can define module roles and specify security settings for pages, microflows, entities, and datasets.

2 Module Role

A module role is a specific role you create within the module to define a set of access permissions. The permissions are contained within the module. You can assign multiple module roles to a user role under the App Security > User roles tab. For more information on module roles, user roles, and their relation, see Security.

A module role has the following properties:

  • Name – the name of a module role; end-users do not see the names of module roles, if they create or view user accounts, they only see the names of user roles

  • Documentation – the documentation of a module role is there only for the convenience of Studio Pro users, it is not displayed to the end-users

2 Page Access

Page Access defines which pages are visible to each role. The Page access tab is displayed as a matrix showing pages and modules roles. You can choose to show the unused pages in the matrix or hide them by enabling/disabling the Show unused pages setting.

page access tab

For each combination you can indicate whether or not the page is visible for the module role. You can also edit this information in a page using the Visible for property.

A page that is not visible for a specific role will not show up in navigation structures, and Open Page buttons leading to that page will not be rendered by default.

Page access settings do not restrict users from navigating to a page through other means, for example through a deeplink or through a button that is forced to be visible (for more information, see Common Widget Properties). If you want to ensure that specific roles cannot access parts of your data or logic, than this must be expressed through entity access and microflow access constraints.

3 Microflow Access

Microflow Access defines which microflows can be executed by users with a certain module role. The menu bar is optimized so that it only shows microflows that the user has access to.

The Microflow access tab is displayed as a matrix showing microflows and modules roles. You can choose to show the unused microflows in the matrix or hide them by enabling/disabling the Show unused pages setting.

For each combination you can indicate whether or not the module role has access to the microflow. You can also edit this information in a microflow using the Allowed roles property.

4 Nanoflow Access

Nanoflow Access defines which nanoflows can be executed by users with a certain module role. The menu bar is optimized so that it only shows nanoflows that the user has access to.

The Nanoflow access tab is displayed as a matrix showing nanoflows and modules roles. You can choose to show the unused nanoflows in the matrix or hide them by enabling/disabling the Show unused nanoflows setting.

For each combination you can indicate whether or not the module role has access to the nanoflow. You can also edit this information in the nanoflow using the Allowed roles property.

5 Entity Access

Entity Access defines for each module role whether users with this role are authorized to Create, Read, Write and/or Delete objects of the entity. You can also write an XPath constraint to restrict the set of objects to which the access rule applies.

The Entity Access tab is displayed as a matrix showing access rules that apply to entities:

Each access rule in turn applies to a set of module roles. For more information, see Access Rules.

6 OData Access

OData Access defines for each module role whether users with this role are authorized to access OData resources for each OData service exposed within the module.

The OData Access tab is displayed as a matrix showing published OData services and modules roles:

For each combination, you can indicate whether the module role has access to the published OData service. You can also edit this information in published OData services using the Allowed roles property in the Settings tab.

7 REST Access

REST Access defines for each module role whether users with this role are authorized to access REST resources for each REST service exposed within the module.

The REST Access tab is displayed as a matrix showing published REST services and modules roles:

For each REST service, you can indicate whether or not the module role has access to the published REST service.

The REST Access tab is visible only when the service has the security set to require authentication. For more information, see published REST services.

8 Data Set Access

Data Set Access shows the access which the module role has to each dataset.

Value Description
Full access No constraint applies to the parameters for the data set and all possible range parameters are allowed.
Limited access At least one constraint applies to the parameters for the data set or at least one range parameter is not allowed.
No access Users with this module role have no access to the data set.

9 Read More