Users#

The Users page displays a list of all system users, and allows creating and editing users. It is located at /admin/user.

Note

When using Active Directory, Azure Active Directory, or OpenID Connect, accounts are created automatically when users first log in, and role assignments are usually managed by the identity provider. See Authentication.

The list shows each user’s name, email address, and roles. A check mark in the Guest, User, or Administrator column indicates the roles assigned to the user. An icon next to the email address indicates that the address has been confirmed.

Filter by Role#

Use the Role buttons to show only Guest users, User and Administrator users, Administrator users, or All users.

Download the User List#

Click the Download CSV button to download a CSV file containing the email address, name, organization, department, position, and creation time of every user.

Create a New User#

  1. Click the Create New User button.

  2. Enter the new user’s email address and a password.

  3. Click the Create User button.

  4. The new user will be created, and a welcome email with a link to set a password is sent to the user, if email is configured.

If the DefaultNewUserRole setting in appsettings.json is set, that role is assigned to the new user.

View User Details#

  1. On the Users page, click a user’s name.

  2. A page showing the user’s profile information, roles, and security status is displayed. The security status shows the number of failed login attempts, whether the account is locked out, and whether two-factor authentication is enabled.

Edit User Details#

  1. When viewing a user’s detail page, click the Edit Details button.

  2. Edit the fields as appropriate. If the email address is changed, a verification email is sent to the new address.

  3. Click Save.

Edit User Roles#

  1. When viewing a user’s detail page, click the Edit Roles button.

  2. Use the checkboxes next to ColecticaAdministrator, ColecticaUser, and ColecticaGuest to assign roles.

    Note

    For details on each of the roles, see Roles.

  3. Click Save.

For deployments hosted by Colectica, the number of users with editing access (the ColecticaUser and ColecticaAdministrator roles) is limited by the hosting plan. The current count and limit are shown at the top of the Users page.

Delete a User#

  1. When viewing a user’s detail page, click the Delete button.

  2. Confirm the deletion. The user’s account and baskets are removed. This action cannot be undone.