Manage admins and roles for Knox services

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.

Administrators

You can invite admins to manage one or more Knox cloud services. To allow an admin to manage features across services, such as managing common tags and deleting devices deletion, you must assign to them a role with Common permissions.

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

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. The COMMON column shows the role and status of admins with permissions to manage feature across services.

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 for that service.

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.

Edit an admin

Once you’ve invited an admin, click their name in the admin 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.

If you want to invite an admin to other available services, click MORE ACTIONS > Invite to more services and select services and roles for that admin.

In case of Knox Manage, use the Knox Manage console to add super admins and edit other admin types.

Deactivate an admin

If you want to prevent an admin from managing certain Knox services your company uses, you can choose to deactivate their account. Only active admins can be deactivated.

To deactivate a Knox admin:

1. In Administrators & Roles, click the name of the admin you want to deactivate.
2. Click MORE ACTIONS, then Deactivate account.
3. Select the Knox services you don’t want the admin to manage anymore, then click DEACTIVATE.

The admin then won’t be able to access the Knox services you selected, but can still manage any services you unselected.

Delete an admin

If an admin no longer needs to manage any Knox services for your company, you can delete them from your admin list. Make sure you have the Invite and manage administrators or Manage roles permission for the same Knox services as the admin you’re deleting, or the Delete account option is disabled.

To delete a Knox admin:

1. In Administrators & Roles, click the name of the admin you want to delete.
2. Click MORE ACTIONS, then Delete account.
3. (Optional) Enter a reason for the admin deletion.
4. Click DELETE.

The admin is then deleted from your company’s account and can no longer access your Knox services and data. Note that this action also deletes their Samsung Knox account.

Roles

On the ROLES tab, you can define roles with custom permissions for admins who manage one or more services. You can also define roles with common permissions to access cross-service features from the common device list.

The Roles tab lists all the roles in your tenant. You can use the search bar lets to search for roles by name.

The roles list contains the following information:

Create a role

To create a role with custom permissions:

1. Click CREATE ROLE to the right of the search bar. The Create role page displays.

   

2. Select a Service for which to create the role.

   • Select Common to create a role with common permissions for select features across services. This role applies to the common device list only.

3. Enter a Role name and Description (optional).

4. Select the required Permissions. Note that permissions are shown based on the service you select.

5. (Optional) Set the following permissions to create a Common role:

   • Common tags: Allows admins to manage common tags for the common device list on the Devices page.
   • Delete devices: With this permission, admins can delete devices from the common device list, which also removes devices across all services.
   • Invite and manage administrators: Allows admins to invite other admins and assign them the common role.
   • Manage roles: Allows admins to manage all permissions for a common role, including the permissions not assigned to them.

   For information about creating roles for other services, see each service’s documentation.

6. Click SAVE.

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.

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.