Skip to main content

Authorization and Access control

GeneTegra is normally configured to use an institutions Authentication Server, such as Active Directory, to authenticate user accounts and link the user with a set of Roles (or user groups) that are permitted to use the system.

Roles

User group assignment is managed by the institution's authentication server (Active Directory). The Role's name is matched against a group in the auth server. GeneTegra users are automatically assigned the Roles that match their assigned Groups.

If a Group exists in the auth server but it doesn't have a corresponding Role, the Group will not be assigned any permissions.

Adding a Role

To add a role, click + Add Role. You must provide a Name.

FieldDescription
NameName of the Role. Must match name in LDAP/Active Directory
Description[Future Use]
PermissionsAudit Logs
Roles must match a Authorization Server's Group

If the Name doesn't match a Group in the Auth server, the Role will not be used.

security-user-acl Security configuration for the Administrator account by default enables all permissions.

Configuring Permissions

Permissions are specified as a combination of Type, Action, and Targets. They are all combined together to define an Access Control List.

Permission Types/Domains

Type refers to the general domain of the permission. Some Types define a set of Actions that can be performed. For example, Mediator and Query.

Permissions without a Target

TypeDescription
AdminAdministrative features
Table-Data[Future Use]
AuditAudit Logs
Settings[Future Use]
Data-Source[Future Use]
Query-Audit[Future Use]
RoleACL Roles (User Groups)
OntologyOntologies and Mediator models
UserUsers
Data-Dictionary[Future Use]

Permissions with a Target
Target refers to a specific item within the Type. For example, LIMS Mediator.

TypeDescription
MediatorMediators
QueryQueries
Query ResultQuery Results
Data SetData files and datasets
DatabaseDatabase connections

Permission Actions

Action refers the actions that are allowed within the domain. For example, Read and Execute.

ActionDescription
CreateCreate a new instance of the Type. [No Target]
ReadRead/Access instances of the Type.
UpdateUpdate/Modify instances of the Type.
DeleteDelete/Archive instances of the Type.
UndeleteUndelete/restore archived instances of the Type.
PurgePurges/completely removes an archived instance. Cannot be undone.
Modify-LockLock/Unlock an instance so that it cannot be modified.