Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Start on Security Overview beta release docs #8770

Open
wants to merge 19 commits into
base: development
Choose a base branch
from

Conversation

WimJongeneel
Copy link
Contributor

Docs for the Security Overview, to be released in Beta in 10.18

@WimJongeneel WimJongeneel changed the title Draft: start on Security Overview beta release docs Start on Security Overview beta release docs Dec 10, 2024

## Entity access

The Entity access tab shows the combined access rules for all entities within the application for the currently selected user role. Individual access rules and module roles are here all combined into the concrete access the runtime will give an user with the selected user role. An access rule does apply to an user roles when any of the module roles of the access rule are part of the module roles of the user role.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe we should mention that we only show entities, attributes, and associations with defined access rules that can be edited. This means we exclude items with no access, as well as access rules for system or protected modules.

Additionally, could we provide an example of combined access rules to make it clearer?


The Entity access tab shows the combined access rules for all entities within the application for the currently selected user role. Individual access rules and module roles are here all combined into the concrete access the runtime will give an user with the selected user role. An access rule does apply to an user roles when any of the module roles of the access rule are part of the module roles of the user role.

When combining different access rules the Security Overview followes the same behaviour as the runtime does, meaning that if any access rule defines that a user has been granted access, that user has access. Multiple columns per entity can be shown when XPath constrains apply. Access rules with the same XPath contraint are also combined here so each XPath in this list is unique.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I’m not sure if the current explanation is entirely clear. Could we rephrase it to something like this: The Entity Access tab shows a summarized view of the permissions that will be applied during runtime for all entities in the selected module for each user role. This helps developers and reviewers easily understand what an end user can or cannot access within the application.What do you think?

@MarkvanMents
Copy link
Collaborator

@MariaShaposhnikova can you let @katarzyna-koltun-mx know when you have reviewed it so that she can look at it in relation to her work in this area.
Thanks.

@MariaShaposhnikova
Copy link
Collaborator

@katarzyna-koltun-mx , I have done my first review. I will probably get another look next week, but I think it is good enough to check the dependencies in your area.

@katarzyna-koltun-mx
Copy link
Collaborator

Review done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants