Skip to main content
Version: Any 26

Content-based visibility

This module restricts access to the contents of the application, during browsing and search, by designating for each set of contents the users and groups allowed to see them.

By default, permissions are managed per room. Room administrators define the following rights:

  • Room administrator: users (or groups) allowed to change the configuration of the room
  • Room members: users (or groups) allowed to enter the room
  • User allowed to request access: these users (or groups) are not allowed to enter the room but can request access to the room from the room administrator

Once in a room, every user is allowed to manage the content according to the license defined for that application (read only, Standard or Advanced). This module refines that principle: within the same room, it makes some contents invisible to part of the members.

Configuration​

The configuration is done by creating rules. Each row of the table is a rule to apply:

  • GQL Predicate: defines a set of contents. For instance: standard.status = 'Approved'.
  • Authorized users and groups: users, groups and metadata allowed to browse and search the set of contents defined above.
    • Users: list of users.
    • Groups: list of groups.
    • Metadata: metadata holding a list of users or groups.

The rules are evaluated from top to bottom and stop at the first valid rule.

If a content matches a GQL predicate, it is only visible to the users and groups as defined in that rule, for this application.

Applying the configuration​

The configuration is applied:

  • Automatically as soon as a document is updated or changed
  • Periodically by the JobAclConfigApply job, when the configuration has changed since the last run
  • Manually, with the Apply button of the module configuration, to force immediate execution (requires the "Super administrator" role)

This module adds up with User-based visibility, which restricts contents based on the metadata of the signed-in user rather than by named users and groups.