Each connected Entity has at least one owner, usually the or who onboarded it. Owners can share access to their Entities by assigning permissions to others.

Assigning permissions to Principals

Permissions can be assigned to Principals, which represent individual actors or groups of actors on our platform, each uniquely identified by a principalId.

Principals include Users, Clients, Collectives, and Tenants. You can grant permissions to individual Users and Clients or to groups like Collectives and Tenants.

Types of permissions

Each Entity supports four types of permissions that can be assigned to a Principal:

  • Viewer – Can access Readings, settings, and previously triggered Commands.
  • Contributor – Can trigger Commands.
  • Administer – Can manage certain settings.
  • Owner – Can manage permissions and all settings.

Inheritance

Individual Users and Clients may automatically inherit Viewer and Contributor permissions on an Entity, when they are an administrator of it’s Tenant or part of a shared Collective.