In Chocolatey Central Management, Users are people who are given access to login in, and perform operations.

Users can be accessed by going to Administration on the left-hand navigation and selecting Users.

Users menu entry on the Chocolatey Central Management Dashboard

Creating a User

NOTE

If you do not see the + Create new user button, please see your Administrator to determine if your account has the Creating new user permission.

On the main Users page, select the + Create New User button.

Create New User button on the Users page

You will then be presented with the Create New User window where you can enter all the information for the User, including First Name, Email address, etc.

Creating New User Setting User Properties

Next you’ll want to click over to Roles. This window will allow you to select what specific Roles you wish to give your new User.

Creating New User Setting Roles

Click 💾 Save to close the window and create the new User. A green toast notification will be shown once the operation completes successfully.

Editing a User

NOTE

If you do not see the Edit menu entry or the âš™ Actions buttons, please see your Administrator to determine if your account has the Editing user permission.

On the main Users page, find the User you want to edit. Select the âš™ Actions button on the left-hand side of the User, and then select Edit to open the Edit User window.

Edit menu entry in User actions flyout menu

From the Edit Role window, you can modify all the properties for a User, for example, First Name, Phone number, etc. In addition, you can alter the Roles associated with the User.

Once modifications are complete, click the 💾 Save button. A green toast notification will be shown once the operation completes successfully.

Fine grained permissions

In addition to configuring a set of Roles for an individual User, so can set speicial permissions for an individual User.

On the main Users page, find the User you want to edit. Select the âš™ Actions button on the left-hand side of the User, and then select Permission to open the Permissions window.

Permissions menu entry in User actions flyout menu

From the tree of permissions, check/uncheck the permissions that are needed.

Once modifications are complete, click the 💾 Save button. A green toast notification will be shown once the operation completes successfully.

Deleting a User

NOTE

If you do not see the Delete menu entry or the âš™ Actions buttons, please see your Administrator to determine if your account has the Deleting user permission.

On the main Users page, find the User that needs to be deleted. Select the âš™ Actions button on the left-hand side of the User, and then select Delete. A prompt will be shown asking Are you sure?. Click Cancel to not continue with the operation. Click Yes to proceed with the operation. A green toast notification will be shown once the operation completes successfully.

Unlocking a User

NOTE

If you do not see the Unlock menu entry or the âš™ Actions buttons, please see your Administrator to determine if your account has the Editing user permission.

If a User enters the wrong login information 5 times, their account will become locked. To allow them to attempt to login again, the account will need to be unlocked. On the main Users page, find the User that is locked out. Select the âš™ Actions button on the left-hand side of the User, and then select Unlock. A green toast notification will be shown once the operation completes successfully.

Searching for a User

By default, there is a single search box, which can be used to search for a given User by their User name, First Name, Surname, and Email.

Clicking the Show advanced filters link, provide additional filtering options:

  • Permissions
  • Role
  • Only locked users

Exporting User Information

From the main Users page, it is possible to export all User information into either PDF or Excel format. This can be done by using either the Export | Export to PDF, or the Export | Export to Excel button.

This will generate a file name similar to Chocolatey_Users_20231122_130612.xlsx, or Chocolatey_Users_20231122_130612.pdf.

Pre-Configured Users

In a fresh installation of Chocolatey Central Management, there is a single pre-configured User called ccmadmin, which has been allocated the CCM Admin Role.