Reference

Workspace roles and ownership

Petros Amoiridis

Every User in a Workspace has a role, which sets what they can do in the Workbrew Console. Each Workspace also has one Owner. Ownership is separate from roles.

Roles

There are three roles. Each role includes everything the role above it can do.

RoleWhat it adds
ReadView Devices, Packages, vulnerabilities, Policies, Commands and their output. Export data, on plans that include data export.
WriteCreate, change and delete Device Groups, Policies, Commands, Brewfiles, Brew Configurations, and the automatic upgrade, automatic uninstall and vulnerability patching settings. Run Commands. Approve or decline Package Requests. Create Device invitation links. Remove Devices.
AdministratorEverything under Settings, including Users and their roles, Workspace settings, notifications, integrations such as Slack, GitHub, GitLab and webhooks, Taps, and Device Group sync from your MDM. View and export the activity log.

Roles can be assigned on plans that include roles and permissions. There, a User added to the Workspace starts as Read, and an Administrator changes roles from Settings > Users.

On other plans, every User is an Administrator and Settings > Users has no Role column. A Workspace that moves to one of these plans keeps the roles its Users already have.

Workspace Owner

The User who creates a Workspace is its Owner. Settings > Users shows an Owner badge next to them.

The Owner also has a role, and it can be any of the three. The actions only the Owner can take are under Settings, which only Administrators can open, so the Owner needs the Administrator role to use them.

Only the Owner can:

  • Change the plan, start a trial and manage billing from Settings > Subscription. An Administrator who is not the Owner sees who the Owner is there instead.
  • Delete the Workspace.
  • Transfer ownership to another User. The new Owner must be an Administrator.

Rules

  • The Owner cannot be removed from the Workspace and cannot leave it.
  • The only Administrator in a Workspace cannot be changed to another role.
  • The only Administrator cannot be removed while other Users remain in the Workspace.

Workspaces managed by a Workbrew MSP partner follow different rules. Partner members get their access through the partner, and roles can be assigned on any plan. See Working with role-based access control (RBAC).