Skip to main content

Lesson 2.5 Roles

This lesson will teach users how to navigate and manage Roles, roles directly gives or removes access to speicifc API end points and also hide UI elements without access. Users will learn to assign Roles to different users and see the effect in those users accounts. To complete this lesson, you will need to have the Organization Admin role and a few colleagues that will be able check how different roles affects their accounts.

Roles

Roles define what a user can do within Yggio. A user can have preset roles (admin, editor, viewer, installer) or a custom role. The UI and API will enforce the permissions defined by the roles.

Preset roles​

  • Admin: Full access to all resources and actions. Can create, update, delete, and manage everything in the system.
  • Editor: Can create and edit devices, rules, dashboards etc. but cannot manage roles.
  • Viewer: Read-only access. Can only get data across most resources. No access to roles.
  • Installer: Focused on devices. Can get, put, and patch devices. Read-only for other resources. No access to roles.

Custom roles​

Custom roles can be created to fit specific needs. When creating a custom role, you can select from a list of resources and actions to define what the user can do.

Roles administrator page​

In the roles admin page you can select users to administer roles to. You can set predefined roles or create custom roles on specific or all selected users. Only admins can administer roles.