Users, roles

How to manage Users and Roles, access control.

This is for advanced level users only. Do not mess with this if you do not know what you are doing.

System Management Tool (SMT)

You can access the SMT for the OLab cloud service here: https://smt.olab4.net

User Management

Login to the SMT and then click on the USERS tab.

The table of users on the left is searchable. Click on the 3 vertical dots beside a column name and choose Filter then enter your search criteria.

There is an annoying interface glitch where the first matching row is hidden behind the Filter box. Sorry.

When you click on a row in the left side table, you can see and edit the person's details in the right side panel e.g. username, full Name, email or password.

Remember to [SAVE] your changes because they are not saved automatically.

You can also [GENERATE] a random strong password.

Bulk Upload of Users

You can add new users, using an Excel worksheet.

You can download a sample template of the worksheet from here.

Leave row 1 as is. 'operation' — usually you will leave this as '+' to add a new user. For columns FGHIJ etc, you can add more than one role per user but for most projects, a single role is enough.

In the SMT Users interface, click on 'Upload XLSX file' to import the Excel file you have created.

Duplicate usernames are ignored in the Excel file and are not imported.

Users can be assigned to Groups, which along with their Role, will determine which resources they have access to.

Role management

We have improved this, taking an approach which is much more standard, and similar to how most LMS applications handle roles, courses, groups etc.

The user credentials, their groups and their roles within the group are set. You have a number of Roles to choose from:

  • Superuser - Can edit and control access to all OLab4 objects at all scope levels, up to server-level.

  • Director -- Can edit and control access to all OLab4 objects at all scope levels, up to course-level

  • Author -- Can edit and control access to all OLab4 objects at all scope levels, up to map-level

  • Learner -- can play and list those maps and courses that are open to their group

  • Reviewer -- can play and annotate those maps and courses that are open to their group

Role-based access in OLab4

There are a number of things that are under the control of Roles in OLab4

  • Scoped Objects - depending on your role, you can edit different scopes of objects

    • insert xref to that section in Objects

  • Courses - these are tied to the LMS

  • Maps - you can control which maps can be played by certain roles.

  • Nodes - you can even prevent certain roles from visiting some nodes. We have more information on this here.

Anonymous or open play of OLab4 maps

You can now provide completely open or anonymous access to some OLab4 cases. For basic information on this, check out https://olab4.net/anonymous-access-to-olab4-cases/

You can try simply changing the access level in Map Details for a case to Open. This will often work but is not fully debugged.

You, or someone with access to a SQL that is connected to the OLab4 server's database, can also make a small change. You need to create an entry in the security_users table, which points at the correct map_id, is linked to user_id = 1441 (our anonymous user), and with the ACL set to RX. (If that does not make sense, you maybe should not be given access to a connected SQL tool.)

Anonymous access is not quite the same as guest access. Anon needs no login at all and the map will start immediately. With Guest access, the user must still login with the published user credentials of 'guest' for username and password.

Last updated