Users

Team > Users lists the people of your account. Here you add users, give them a role and the groups their devices join, block or delete them, and create access tokens for regular users.

Users with an e-mail address in your company's domain are added automatically the first time they sign in. Add a user here to invite someone in advance, to give them a password without an e-mail, or to set their role and groups before they sign in.

Roles

RoleCanCannot
Owner (one per account)Everything, including Settings > Plans & Billing and Settings > Tenant, and transferring ownership
AdminAll administrationThe owner-only items above
UserThe Workplace: applications, their devices, the AI Workspace when an AI gateway is granted to them, and their own Profile Settings with self-service access tokens. Through the API they see only their own devices and what applies to them.Any administration page
AgentAPI access with the role it was givenSigning in. Agents are managed under Team > Agents, see Agents.

The Users list

The Users page under Team with six users, among them Alice Morgan marked You with the role Owner, two Admins and three Users, each with Status Active, a Block User switch, Last Login and Delete, and an Add User button

ColumnShows
NameName and e-mail. You marks your own entry.
RoleOwner, Admin or User
StatusActive, Pending for an invited user who has not signed in yet, or Blocked
GroupsThe user's auto-assigned groups
Block UserBlocks or unblocks the user at once. Not shown for yourself or the owner.
Last LoginWhen the user last signed in
DeleteDeletes the user. Not available for yourself or the owner.

Add a user

  1. Go to Team > Users and click Add User.
  2. Fill in the dialog:

The Add User dialog with the name Jamie Rivera, the e-mail jamie@example.com, the role User, an empty Auto-assigned groups selector, Email invitation selected and a Send Invitation button

FieldWhat to enter
NameFirst and last name, both required
E-mailThe user's e-mail address
RoleUser or Admin. To make someone owner, add them first and then transfer ownership.
Auto-assigned groupsGroups the user's devices join when the user adds them (Groups will be assigned to peers added by this user.)
Email invitation or Create passwordHow the user gets access, see below
  1. Click Send Invitation or Create User.

Email invitation sends the user an e-mail to confirm. When they sign in, they join the account. The user appears as Pending until then.

Create password creates the account at once with a password you set. The password needs at least 8 characters, with an uppercase letter, a lowercase letter, a number and one of @$!%*?&.

The Add User dialog with Create password selected, a password field filled in, and a Create User button

After Create User, the dialog User created successfully! shows the login name and the password once, with Copy to clipboard. Pass them to the user securely. At the first sign-in the user has to change the password.

You cannot invite someone who already has a Netzilo account.

Edit a user

Click a user in the list to open their page.

The user page of Riley Chen with Name, E-Mail, Status Active, Block User, Last login and MFA Not Enrolled, the Auto-assigned groups selector with Employees, User Role set to User, a Change Password button, and an empty Access Tokens section with a Create Access Token button

ItemWhat it does
NameClick the pencil to rename the user.
Block UserBlocks or unblocks the user.
MFAActive with Reset MFA when the user enrolled a second factor, or Not Enrolled
Auto-assigned groupsThe groups the user's devices join
User RoleThe user's role
PasswordChange Password sets a new password for the user.
Access TokensTokens of this user, for regular users only, see below

Click Save Changes. When you changed the groups, the dashboard asks Would you like to apply group change to user's peers? Answer yes to move the user's existing devices too; otherwise only devices added later get the new groups.

Change a user's role

Open the user, pick the role under User Role and click Save Changes.

To make another user the owner, pick Owner. The dialog Transfer Ownership? explains that you become an admin, and that only the new owner can transfer the role back. Only the owner can do this.

The role selector is disabled, without a message, in the cases listed under Changes that are refused.

Access tokens for a regular user

Administrators can create access tokens on a regular user's page, for example for a script that must act as that user. The Create Access Token dialog warns: This token acts as (user), with their role and everything they can reach, through the API and the gateway. Give it only to (user), keep its expiry short, and delete it when it is no longer needed. Its use is recorded as (user).

For automation that is not tied to a person, use an agent, see Agents. Users manage their own tokens under Profile Settings. You cannot create tokens for another admin or for the owner.

Remove a user

  1. Turn on Block User. The user loses access at once and their devices disconnect. Blocking can be undone.
  2. When you are sure, click Delete in the list. Deleting this user will remove their devices and remove dashboard access. This action cannot be undone. On a self-hosted server the user is also removed from the identity provider.
  3. If the user had access to an agent's tokens, create new tokens for that agent and delete the old ones.

Changes that are refused

These protections are deliberate:

AttemptResult
Delete your own accountRefused: self deletion is not allowed
Delete the ownerRefused: transfer ownership first
Block the owner, or block or unblock yourselfRefused
Change your own roleRefused: another admin must do it
Grant or remove the owner roleOnly the owner can
Add someone directly as ownerRefused: add, then transfer
Create a token for another admin or the ownerRefused: they create their own

Plan limits

The Free plan allows 5 users, and agents count towards them. Adding a sixth user fails with maximum number of users reached. Delete a user or change the plan, see Plans & Billing.

Events

User changes are recorded under Activity > Events: user invited, joined, role changed, blocked and unblocked, deleted, groups changed, and access tokens created and deleted.

Troubleshooting

The invited user never gets the e-mail. On a self-hosted server the identity provider has no SMTP configured. Configure it, or delete the pending user and add them again with Create password.

A user signs in but sees only the Workplace. Their role is User. Change it to Admin if they should administer the account.

A user sees only the install page. Disable portal access for regular users is on under Settings > Permissions.

A user's devices lack the new groups. You answered no to applying the group change to their peers, or group propagation is off under Settings > Groups. Save again and answer yes.

You cannot change a role, or the role selector is disabled. See Changes that are refused.

A user's token stopped working. It expired, was deleted, or the user is blocked. Create a new one.