Note: You are currently viewing documentation for Moodle 3.11. Up-to-date documentation for the latest stable version of Moodle may be available here: Tenant administrator role.

Tenant administrator role: Difference between revisions

From MoodleDocs
(Assigning tenant administrators.)
m (Reworded old content)
 
Line 1: Line 1:
{{Workplace}}
{{Workplace}}
The tenant administrator role is created automatically when [[Moodle Workplace]] is installed. This role cannot be removed, however the main admin can modify its capabilities.


The tenant administrator role is created automatically when [[Moodle Workplace]] is installed. This role can not be removed, however the main admin can modify the capabilities.
This role is issued automatically to users assigned as tenant administrators in a [[Multi-tenancy]] setting. To assign an administrator to a given tenant, click on the "Edit tenant" icon and select the user under "Management > Administrators".


This role is issued automatically to the users who are set as tenant administrators in the [[Multi-tenancy]] feature. In order to assign an administrator to a given tenant, click on the "Edit tenant" icon and search for and select the appropriate users under "Management > Administrators".
Tenant administrators can [[Capabilities/tool/tenant:browseusers|browse]], [[Capabilities/tool/tenant:manageusers|add and edit users]], and [[Capabilities/tool/tenant:managetheme|manage theme settings]] within their own tenant. They can also create and manage programs, certifications, dynamic rules, custom reports, organisation structure and certificates for their tenants and assign respective roles to other users.
 
Such users will be able to [[Capabilities/tool/tenant:browseusers|browse users]], [[Capabilities/tool/tenant:manageusers|add and edit users]] and [[Capabilities/tool/tenant:managetheme|manage theme settings]] for their own tenant. They can also create and manage programs, certifications, dynamic rules, custom reports, organisation structure and certificates for their tenants as well as assign the respective roles to the other users.
 
Some core capabilities are also included in this role, for example 'moodle/role:assign', 'moodle/site:uploadusers', 'moodle/site:viewuseridentity', 'moodle/badges:awardbadge', 'moodle/badges:viewawarded'. Even though these capabilities are defined by core, the core code was modified in Moodle Workplace to limit the users the tenant administrator can view to the list of users in their own tenant. This means the tenant administrator will not be able to assign roles to users outside of their tenant, award or view awarded badges. Examples of places that have been modified:


Some core capabilities have been included in this role, for example 'moodle/role:assign', 'moodle/site:uploadusers', 'moodle/site:viewuseridentity', 'moodle/badges:awardbadge', 'moodle/badges:viewawarded'. Even though these capabilities are defined by core, their scope has been limited in Moodle Workplace to users of the current tenant. This means, by default, the tenant administrator will not be able to view, select or assign users outside of their tenant. Examples of interfaces that have been modified:
* User selector used when manually enrolling users in a course
* User selector used when manually enrolling users in a course
* User selector used when assigning roles
* User selector used when assigning roles
* User selector used when issuing badges
* User selector used when issuing badges
 
Note that most core capabilities, if granted, would allow the tenant administrator to view or assign all users in the system. If a capability is not included in the default "Tenant administrator" role, it is unlikely to be multi-tenant compatible. Bear that in mind when modifying the "Tenant administrator" role.
It is important to remember that there are still a lot of core capabilities that, if granted, would allow the user to see or work with all users in the system. If the capability is not included in the default "Tenant administrator" role, it may not be multi-tenant compatible. When modifying the "Tenant administrator" role it is better not to add any more capabilities to it.

Latest revision as of 09:20, 18 January 2022

workplacelogo.png This feature is part of Moodle Workplace™, which is available through Moodle Partners only.

The tenant administrator role is created automatically when Moodle Workplace is installed. This role cannot be removed, however the main admin can modify its capabilities.

This role is issued automatically to users assigned as tenant administrators in a Multi-tenancy setting. To assign an administrator to a given tenant, click on the "Edit tenant" icon and select the user under "Management > Administrators".

Tenant administrators can browse, add and edit users, and manage theme settings within their own tenant. They can also create and manage programs, certifications, dynamic rules, custom reports, organisation structure and certificates for their tenants and assign respective roles to other users.

Some core capabilities have been included in this role, for example 'moodle/role:assign', 'moodle/site:uploadusers', 'moodle/site:viewuseridentity', 'moodle/badges:awardbadge', 'moodle/badges:viewawarded'. Even though these capabilities are defined by core, their scope has been limited in Moodle Workplace to users of the current tenant. This means, by default, the tenant administrator will not be able to view, select or assign users outside of their tenant. Examples of interfaces that have been modified:

  • User selector used when manually enrolling users in a course
  • User selector used when assigning roles
  • User selector used when issuing badges

Note that most core capabilities, if granted, would allow the tenant administrator to view or assign all users in the system. If a capability is not included in the default "Tenant administrator" role, it is unlikely to be multi-tenant compatible. Bear that in mind when modifying the "Tenant administrator" role.