The new Role permissions system requires that you use version 6.6+ of your liana (version 5.4+ for Rails) on all your environments. Moreover, if your project was created before February 2021, please contact Forest Admin support to ask for it to be "ready to migrate".
The new role system allows you to control all the permissions of your roles from a single details page, which will look like this:
To start migrating, since this is still in beta, you will need to ask someone from the Forest Admin customer success team to switch your project to a "Ready to migrate" status.
Click on Learn more. Then, after you've read the instructions, Start migration process:
This is where it gets interesting:
All your users will be presented in groups(1) that have the exact same permissions (smart action permissions + collection permissions):
If you had created roles and assigned them to smart actions before the migration, they will appear there (2). Additionally, if you had assigned them to users, they will be automatically assigned to those users.
If you wish to create more roles, you can do so by clicking Create a new role(3).
Then assign the available roles to the users of this group (4).
At the end of the migration, the permissions presented on the left will be assigned to all the roles displayed on the right (under "Roles").
You cannot delete roles at this stage, but you can always rearrange roles after the migration.
Lastly, review all assigned roles on the last page and validate to finalize the migration process: