Skip to main content

User Roles

The Roles View (Main Menu / Admin / Roles) shows a list of all User Roles and provides management operations for those roles. A User Role is a named container for User Accounts. User Roles have no impact upon Access Control (by default), unless you assign Permissions to the User Role. All Permissions on a User Role will then be applied to all User Accounts which have this User Role assigned.

This report is divided into two panels. The left panel shows a list of all User Roles. You can use the filter bar at the top to search for role names. Selecting a User Role on the left panel will display its details on the right panel.

Warning:

The predefined admin User Role is a special super-user role. Any user within this role will be treated as a Txture Administrator, and will have access to the Admin area on the User Interface. This User Role cannot be removed, and the predefined admin User Account cannot be removed from this role. And permissions granted by this role cannot be denied/revoked.

Creating a new User Role​

Using the Add button above the roles list, you can add further User Roles. Clicking this button will bring up a form on the right panel:

In this form you can provide all data about your new User Role. You can also add User Accounts to this User Role by clicking on the Add user to role button. This will add a new user slot. You can then select the User Account using the dropdown menu:

Any excess User Accounts (or slots) can be removed with the button next to them. All empty slots will automatically be discarded when the User Role is Saved.

Editing a User Role​

Editing the name and description of a User Role is very similar to creating a new role. First, select the User Role you wish to edit in the left panel. Then use the form in the right panel to edit the details of the User Role and click on Save to confirm your modifications. The same form also allows you to add or remove users that have this role.

Note, that in order to edit the permissions of a User Role you have to define (or edit) the corresponding permission in the Permissions section.

Deleting a User Role​

To delete a User Role, select the User Role in the left panel. Then, click on the delete button in the top-right corner. The role will be removed from all User Accounts which previously had this role assigned.

Special User Roles​

There are a few User Roles which are special in Txture. They are predefined, cannot be deleted, and carry special semantics.

  • admin: This User Role marks any contained User Account as a Txture Administrator. Txture Administrators have access to the Admin area in the User Interface, are able to change the Txture Server configuration and have further privileges regarding the visibility of private elements owned by other users.

  • All applications: This User Role is by default assigned to all External Applications. It is useful for defining baseline Permissions globally for all External Applications.

  • All users: This User Role is by default assigned to all User Accounts. It is useful for defining baseline Permissions globally for all users.

FAQ​

Can I change the name and password of the admin user?​

Changing them on the UI is not recommended as those changes will be reset upon the next server restart. Instead, you can set the username and password for the admin user in the txture.properties file in your Txture Home Directory.