Skip to content
Nokku LogoNokku
GuidesLearn the concepts

Bring people into your workspace, pick their role, and group them in teams.

Last updated on

This guide covers how people get into your workspace. Getting in does not open any server yet. Two separate things decide what someone can do:

  • A role decides what they can do in the web app.
  • A grant decides which servers they can log in to, and as which Linux account. See Grant access.

Bring people in

Every person is a user in your workspace. There are three ways to become one:

  • Invite. An admin invites someone by email, with a role. Nokku mails the invitation, or hands the admin a link to pass on when the core can’t send mail.
  • Your company’s SSO. With a provider set up, colleagues sign in through it and become a user on the spot. See Single sign-on.
  • SCIM. Your identity provider creates and removes users for you. See SCIM.

Roles

Every user has one role. Each role can do everything the one above it can.

RoleCan
memberUse the server access granted to them. The default.
viewerAlso see everything in the workspace, including the audit log. Good for auditors.
editorAlso manage servers, access, daemons, teams and service accounts.
adminAlso manage people, invites, enroll tokens, the certificate authority and daemon defaults.
ownerAlso change workspace settings, SSO and SCIM, transfer ownership and delete the workspace. Only one.

Most people only need member. Nobody can hand out a role higher than their own. The owner role only moves through the ownership transfer.

Teams

A team is a named group of users, like sre or backend. Grant a team access once and every member gets it. Adding someone to the team gives them the team’s access right away, and removing them takes it away.

With SCIM set up, your identity provider can manage team membership for you.