Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

TIS has two roles classes: built-in static System Roles and flexible Custom Roles. Most System Roles have two permission levels: Admin and Auditor, which are depicted in the role names. Admin may administrate and manage, Auditor may view. The System Roles still work, but should no longer be used as giving Custom Roles through groups is considered a better option.

User permission paths

Users may gain permissions through multiple paths. The paths are listed below in order of preference. Directly setting roles, and permissions to user is deprecated and should be avoided if at all possible.

  1. Custom roles through groups
  2. Custom roles through namespace default account policy (special case, gives roles to all accounts within a namespace)
  3. Direct Custom roles (deprecated)
  4. Direct system roles (deprecated)
  5. Direct permissions (deprecated)

...

Image below shows the different paths from Permissions to Accounts.


The new recommended role structure

From time to time it is necessary to refresh architecture, and now it is time for simpler and more understandable RBAC. Then new schema is shown below, and as you can see, it is more elegant.

Image Added

There are just Roles, and you can freely manage them in your namespace.

All Roles are assigned normally to a Group. There is one special use case, where groups are not used in name space, yet some roles and related permissions should be assigned to those all users. In this case it is possible to assign role(s) to the Default Account Policy, as it is applied to all users when they sign in.

The current complexity is being reduced after collecting and analysing customer feedback. You know, sometimes there can be too much flexibility, as it may reduce usability and learnability.

Role classes and

...

the special roles

Roles are divided into two main classes: Admin and Auditor. In addition there are two special roles: Multi-namespace and Developer.

...

Multi-namespace is a special role. It allows for the role holder to switch from a namespace (usually same as a tenant) to another for convenient management of multiple namespaces and the user accounts, groups, and roles in those namespaces. The Multi-namespace role itself does only allow for switching namespace. In fact the permission related to Multi- namespace role is Switch-namespace. Other roles are required for actual management. On the user interface, the switching is done by selecting the namespace name on Namespace Menu on the Top Bar. This is a very powerful role, and the holders of this role are always considered trusted persons.

Developer is another special role. It is reserved for application developers. Developers may manage Management API clients and OpenID Connect clients. Those are external applications utilising TIS platform. The onePortalâ„¢ API Guide, (Doc ID 1001-188P) explains it explains the use of external applications in more detail.

Roles and Permissions

...

A role is actually a collection of permissions. Some permissions, like listing user accounts, are required by many roles, so there is a lot of overlapping. Due to the rather technical nature of permissions, they are not widely or often discussed, but it is important to understand they exist and they make the basis for roles to function. If you need to make a Custom Role for some reason, you need to understand Permissions, as you are essentially assigning Permissions to a Custom Role, and then later via Group to a user Account.

New schema coming for version 3.0

From time to time it is necessary to refresh architecture, and now it is time for simpler and more understandable RBAC. Then new schema is shown below, and as you can see, it is more elegant.

Image Removed

There are just Roles, and you can freely manage them in your namespace.

...

Account

...

.



Expand
titleRole assignment (outdated)

Role assignment

There are multiple pre-defined roles and rules on how each role can be assigned to a user account or group. The following table contains this information in one place for System Roles. Custom Roles follow the same schema.

#

Role or permission to be assigned

Current required roles on the assigner

Assignment scope/validity

Required roles on the assignee

1

Group Admin + Auditor

Namespace Admin

Single namespace

None

2

Role Admin + Auditor

Namespace Admin

Single namespace

None

3

Account Admin + Auditor

Namespace Admin

Single namespace

None

4Authorisation Admin + AuditorNamespace AdminSingle namespaceNone

5

Contact Admin + Auditor

Namespace Admin

Single namespace

None

6

Location/Site Admin + Auditor

Namespace Admin

Single namespace

None

7

Target Admin + Auditor

Namespace Admin

Single namespace

None

8

Incident Admin + Auditor

Namespace Admin

Single namespace

None

9Single sign-on Admin + AuditorNamespace AdminSingle namespaceNone

10

Namespace Admin

Namespace Admin -or-

Portal Admin and Security Admin

Single namespace

None

11

Namespace Auditor

Namespace Admin

Single namespace

None

12

Portal Admin

Portal Admin

System ( platform level)

None

13

Portal Auditor

Portal Admin

System ( platform level)

None

14

Security Admin

Portal Admin, Security Admin

System ( platform level)

Portal Admin

15

Security Auditor

Portal Admin, Security Admin

System ( platform level)

Portal Admin or Auditor

16

Multi-namespace

Portal Admin, Security Admin

Multiple namespaces

None

17

Context Admin + Auditor

Portal Admin, Context Admin

System ( platform level)

None

18

License Admin

Portal Admin, License Admin

System (platform level)

Portal Admin

19

License Auditor

Namespace Admin -or-

Portal Admin, License Admin

Single namespace

None

Role assignment matrix.

There are few limitations on role assignment and especially removal. This is to avoid lock-out situations.

  1. There must be at least one user account in the system which has both roles Portal Admin and Security Admin. The last user account with these roles can not be removed and neither of the roles can be removed from that user account. Instead an informative error message is shown.

  2. There must be at least one user account in the system which has role Context Admin. The last user account with this role can not be removed and the role can not be removed from that user account. Instead an informative error message is shown. Last Context Admin must first be moved to another account by first assigning it role Portal Admin, and then Context Admin role.

  3. There must be at least one user account in the system which has role License Admin. The last user account with this role can not be removed and the role can not be removed from that user account. Instead an informative error message is shown. Last License Admin must first be moved to another account by first assigning it role Portal Admin, and then License Admin role.

Assigning namespace for account with role Multi-namespace

It is important to understand:

  • Namespace assignment is a separate task from Multi-namespace role assignment.

  • The other namespaces may be assigned to account with role Multi-namespace separately by:

    • another account having role Multi-namespace, where the assigner may only assign (and remove for that matter) those namespaces where (s)he is currently assigned to (primary use case), or

    • a highly privileged account which has roles Portal Admin and Security Admin for any currently existing namespace (this a very rare use case).

Results from above are:

  • Accounts with role Multi-namespaces control the managed namespaces in peer-to-peer fashion rather independently, and

  • the few user accounts with both Portal Admin and Security Admin roles are the supervisors and highest level controllers.

Tip: Familiarise yourself with information in section below.

...