Hub Permissions

A permission is an authorization granted to a user to perform particular operations. Permissions are granted to a user within a role, but not directly.

A role is a set of permissions which defines the level of access for a user to particular functionality and operations.

Permissions in Hub are divided in two categories:

• Global permissions are granted at the global scope and do not depend on a specific project. For example, you cannot grant permission to create user accounts in a single project, you can do it only in the system-wide scope. Global permissions are marked with the globe icon () in the list of permissions.
• Per-project permissions allow actions related to a specific project. Read Project or Read User Group are examples of such permissions.

The following permissions are built into Hub and regulate access to Hub administration.

Project-related Permissions

The following permissions grant access to project-related actions.

Permission	Description
Create Project	Create a new project.
Read Project	View project properties and content. List project resources. This permission is required (with Read Role) to read the project roles of a user, group, or service.
Update Project	Edit the properties and content of a project. Add and remove resources.
Delete Project	Delete projects.

Role-related Permissions

The following permissions grant access to role-related actions. These permissions are all available at the global level.

Permission	Description
Create Role	Create a new role.
Read Role	View the list of roles. View the set of permissions assigned to a role. This permission is required (with Read Project) to read the project roles of user, group, or service.
Update Role	Modify the properties of and set of permissions assigned to a role.
Delete Role	Delete roles.

Project Role-related Permissions

The following permissions grant access to actions that link projects and roles. These permissions are all available at the per-project level.

User-related Permissions

The following permissions grant access to user-related actions. These permissions all available at the global level.

Permission	Description
Create User	Register new users. Invite new users.
Read User	View the list of registered user accounts. Read user authorization details. This permission is required (with Update Group) to modify group membership for another user account.
Update User	Edit the user name. Edit, create, or delete user profile data. Ban and merge user accounts.
Delete User	Delete user accounts.
Read Self	Same as Read User, but only for the current user account.
Update Self	Same as Update User, but only for the current user account.

Group-related Permissions

The following permissions grant access to group-related actions. User groups are used as resources in a project. These permissions are all available at the per-project level.

Service-related Permissions

The following permissions grant access to service-related actions. These permissions are all available at the global level.

Permission	Description
Create Service	Register a new service.
Read Service	View the list of services. View the properties of a service. View service resources, permissions, and default roles.
Update Service	Modify the properties of a service. Create, update, or delete the resources, permissions, and default roles for a service.
Delete Service	Delete services.

Auth Module-related Permissions

The following permissions grant access to authentication module-related actions. These permissions are all available at the global level.

Permission	Description
Create Auth Module	Add and enable a new authentication module.
Read Auth Module	View the list of authentication modules. View the properties of an authentication module.
Update Auth Module	Modify the properties of an authentication module.
Delete Auth Module	Delete authentication modules.

Generic Permissions

The following permissions are not related to specific entities in the system. These permissions are available at the global level.

Permission	Description
Low-level Administration	Manage low-level administrative actions. Includes permission to integrate with third-party services and back up the database.
Low-level Read Administration	Read-only access to low-level administrative settings. Includes permission to view integrations with third-party services and metrics.