Configuring roles
In order to allow users to perform certain actions, permissions have to be set up. Before permissions, however, roles should be created that are also contained in a user JWT token. For example, if a user has ROLE_USER
in Keycloak. In order to create permissions that apply to that specific role, the role has to first be known by Valtimo. Keep in mind ROLE_ADMIN
will always have access to items in the admin menu.
For information on how to configure permissions, see this page.
Creating a role
Creating a role can be done by going to the Admin
menu. There, under A&E
you will find Access Control
. This will show the list of roles that have been configured. In order to create a new role, make sure no other roles are selected, and press Add new role
. A dialog will show that allows you to specify the name of the role before creating it.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-b5f79663296fe68a4e8b4e65e5f7141b6e03d63b%252Fcreating-a-role.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=6122aff5&sv=1)
Editing a role
Roles can be edited by clicking on that role. Then, by clicking on the three dots next to the Save
button, the role can then be updated.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-ec140cd215faf8a19462a306596a12b97956f193%252Fupdating-a-role.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=6b1ea707&sv=1)
Deleting a role
Roles can be deleted by clicking on that role. Then, by clicking on the three dots next to the Save
button, the role can then be deleted. Take caution, as deleting roles will also result in the deletion of related permission. Deleting roles will not delete the role in Keycloak.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-e6879bc86bcebd323c5c0afd4238aed23fa3b283%252Fdeleting-a-role.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=5cef8e0f&sv=1)
Bulk actions for roles
In addition to creating a role, roles can also be deleted, or exported. These options will only show when one or more roles have been selected.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-68ab85cf936b151c0740523d99c8a6269620eecb%252Fbulk-actions.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=44d431a1&sv=1)
Export
Exporting a role not only exports the role itself, but also the configured permissions. This can be used to create or update auto-deployment files. For information on how auto-deployment works for Access Control, see here.
When exporting roles, there are two options. Either to export all selected roles as one single file, or alternatively downloading separate files per role.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-e138b9d631afb9af7d96658a2f882c7c7753c2cc%252Fexporting-roles.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=51a6460c&sv=1)
Delete
Roles can also be deleted. Take caution, as deleting roles will also result in the deletion of related permission. Deleting roles will not delete the role in Keycloak.
![](https://docs.valtimo.nl/~gitbook/image?url=https%3A%2F%2F181910120-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FG21VIGcgPc1cyGRZY5CR%252Fuploads%252Fgit-blob-97640b998a116e2c86fce7435d23a5dfbe1712fc%252Fdeleting-roles.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ffabc629&sv=1)
Last updated