Menu

Manage Knox service admins

To streamline the admin management process, the Knox Admin Portal offers a consolidated Administrators & Roles page that allows you to invite and manage admins for multiple services.

In the left sidebar of the Knox Admin Portal, click Administrators & Roles to view a list of admins for all supported Knox services.

IMPORTANT — Only admins with the Invite and manage administrators or Manage roles permission can access the consolidated Administrators & Roles page.

Administrators

The Administrators tab displays a list of all admins registered for Knox services. The list contains the following info:

  • NAME — The name of the admin. The super admin, who created the enterprise's tenant, is marked with a crown next to their name. Click an admin's name to view or edit their details, including services they have access to and roles they have been assigned.
  • EMAIL — The work email address of the admin.

Additionally, all currently supported Knox services are included as columns in the list. If an admin has permission to manage a service, their role and admin status is shown in the service column. In order to view the admin list for a service, a user must have a role with the Invite and manage administrators or Manage roles permission.

Knox Admin Portal administrators and roles permissions

IMPORTANT — An admin with either the Invite and manage administrators or Manage roles permission can grant another admin any available permission, regardless of whether the granting admin has that permission or not.

Invite an admin

Click INVITE ADMINISTRATOR to add a new admin. An Invite administrator page opens, where you're prompted to enter the first name, last name, email address, and service permissions for the new admin. Similar to other Knox services, you can also bulk invite admins by uploading a CSV file containing their first names, last names, and email addresses.

Invite administrator screen

If an admin has not yet been invited to all available services, click INVITE TO MORE SERVICES to select services and roles for that admin.

Edit an admin

IMPORTANT — This feature is only available if your admin user has the Invite and manage administrators or Manage roles permission.

Once you've invited an admin, click their name in the administrators list to edit their details. On the Edit administrator page, you can modify the admin's first and last names, as well as their roles for each service they're invited to.

Edit administrator screen

Use the Knox Manage console to add super admins and edit other admin types.

Roles

In the ROLES tab, you can define custom permissions for admins for each solution, or for all solutions. Above the list, the search bar lets you search for roles by name.

The roles list contains the following information:

  • SERVICE — The Knox service, or services, the role applies to.
  • ROLE NAME — Either Super admin or the name of a custom role, both of which you can click on. Depending on whether you click a super admin role or a custom role, the resulting pop-up shows:
    • Super admin — The role details, along with a dropdown that lets you switch between services to view the permissions for each. The first admin who created the account is marked with a crown next to their name, and is also known as the account super admin.
    • Custom role — The role details, its permissions, and the number of administrators assigned to it.
      IMPORTANT — Custom roles for Knox Manage must be defined through the Knox Manage console instead. In the Knox Admin Portal roles list, custom Knox Manage roles are listed as Sub Admin.
  • DESCRIPTION — A short phrase describing the organizational purpose of the role.
  • ADMINISTRATORS — The number of administrators assigned to the role. Click a number to see a full list of the administrators and their info.

Create a role

To create a custom role, click CREATE ROLE to the right of the search bar. On the Create role page, you can select a Knox service for the role and enter a name and description for it. Based on the service you're creating a role for, various permissions are available.

Create role screen

When you're finished, click SAVE to complete the role creation.

Edit a role

To edit an existing role, click its ROLE NAME. Similar to the Create role page, you can enter a new role name, description, and permissions for the service. However, you can't reassign the role to another service.

Edit role screen

Once you're finished editing, click SAVE to record your changes.

Alternatively, you can choose to delete the role. Click DELETE at the bottom of the page to remove the role from the list and remove the associated permissions for all admins who are assigned to the role. Note that this action can't be undone.