Skip to content
Mint Service Desk Documentation centre

Users

Mint Service Desk 3.4.2 user manual.

User Management

Create and manage user accounts.

Creating a user

If you want to create a new user, you need to click on the button, located on the right side of the search box.

Once you do that you will be moved to the ‘Create user’ form, where you need to put in some information regarding the new user. Depending on the role you choose for that user, he will be later shown on a different tab (Agents, Company users, or Administrators).

Account activity and roles

Use the following controls to manage existing users.

Use the list above the search bar to show active users, inactive users or all users.

Activate or deactivate an account. Deactivation locks the account and prevents sign-in.

You can also change the user Role. You can assign multiple role types to one user - Admin, Agent and Customer. Just click the and in the next window change the role for the desired one.

After clicking Role, a window with three role tabs will open:

  • Administrative – Admin roles
  • Agent – Agent roles
  • Customer – Customer roles

To assign or remove a role, select the appropriate tab and check or uncheck the required role.

Once all required roles have been selected, click Save to apply the changes.

If a user has roles from at least two different tabs, meaning they have more than one user type, the User type option will appear in their user profile.

For example, if a user is assigned roles from the Agent and Customer tabs, they will be able to switch between the Agent and Customer user types using the User type option.

If a user has roles from only one tab, the User type option will not be available.

For more information about the Switch Context, please visit Web interface -> Basics -> Switch Context section in this documentation.

Editing account details

If you like to add or change some information about the specific user, you can click on the button. It will direct you to the ‘Edit user’ screen containing information about the user you just choose.

Now, make any changes you like and click the button.

User anonymization

If anonymization is enabled in Settings > Users, you can anonymize the account. This replaces Login, Email, Name and Last Name with random values and removes Second name and Phone number. Clicking the button opens a confirmation step.

After confirmation, the data is anonymized and the user can no longer use the account.

Roles

Create and manage agent roles.

Creating a role

In order to add a new Agent Role, click on the button, located on the right side of the search field. It will open an ‘Add role’ window.

Enter a name and select the actions this role permits.

Role permissions

Available role permissions:

  • Change user assigned to ticket – means that an agent will be able to change the company user assigned to the ticket.
  • Hide the ability to create a client and company – means that the buttons for creating a new customer and company in the ticket creation view will be hidden for agent
  • Edit company user details – means that an agent will be able to change the basic company user data in the ticket view.
  • Edit company – means that an agent will be able to change the Company assigned to the ticket.
  • Edit asset user – means that an agent will be able to change the user assigned to the asset.
  • Edit asset company – Allows changning of company assigned to asset.
  • Edit asset categories – Allows changning of categories assigned to asset.
  • Edit asset agents – Allows changning of agents assigned to asset.
  • View access groups - Allows Agent to view access groups assigned to him
  • Manage access groups - Allows Agent to manage access groups in the same way as an administrator.
  • Report creator – allows to define reports.
  • Remove ticket – after selecting this option, the agent having this role will be able to delete tickets.
  • Assign company user to company – Allows agent to assign company user to company.
  • Manage companies – Allows agent to manage companies.
  • Manage users – Allows agent to manage users.
  • Work time coordinator – Allows to manage work time reports.
  • Manage contracts – Allows agent to add, modify and manage contracts.
  • Reports Scheduler - Allows the agent to create scheduled reports and send them to specified email recipients.
  • Allows the acceptance of potentially dangerous articles - Allows the agent to approve the display of articles identified by the Mint system as potentially dangerous in the ticket.
  • Generating SQL reports - Allows the agent to create database queries in the Reports module.
  • Expanding dictionary values - Allows the agent to add new values to dictionary attributes while creating and editing a ticket. The dictionary attribute must have the “Adding dictionary values” option enabled in Tickets -> Custom fields by the administrator.
  • Can only edit their own tickets – Allows Agent to edit only their own tickets. The agent can still view tickets assigned to other agents.
  • Can only view their own tickets – Allows Agent to view only their own tickets. Tickets assigned to other agents are not visible. Agent cannot edit their ticket unless Can only edit their own tickets role is selected
  • Cannot edit closed tickets – The Agent cannot edit ticket data or its custom fields if the ticket is closed.
  • Article search – Allows the agent to search for phrases in articles on the ticket list using the SOLR engine (see the SOLR section in Agent Portal → Full text search).
  • Attachment search – Allows the agent to search for phrases in attachments and attachment names on the ticket list using the SOLR engine (see the SOLR section in Agent Portal → Full text search).

Once you finish click button.

Editing and exporting roles

If you like to add/change anything later for the role, you can use the button.

If you want to get rid of any Agent role on the list just click and confirm your choice by clicking YES on the confirmation screen. You will also be informed that role will only be deleted if it is not used in the system.

If you want to export your roles settings, you can click on button and simply export it to .csv or .xlsx file

Custom Fields

Add custom fields to store information about users.

User profiles already contain standard fields such as ‘First name’ and ‘Phone number’.

If you click on the round icon (or round picture if you have uploaded one in your profile) it will open a dropdown menu. Click on ‘Profile’.

Groups and attributes

Use ‘Custom field’ to add groups of attributes. These appear at the bottom of the user’s ‘Profile’.

First, enter a group name in ‘Add group’.

Press ‘Enter’ on your keyboard to confirm the name. Once you do that a new field ‘Add attribute‘ will appear on the right side.

Now, add some attributes. First, in the ‘Add attribute field’ type a name and confirm it with ‘Enter’. On the right side, you will see a new field ‘Attribute type…”. Select one type from the dropdown list. You can also select a ‘MultiChoice’ check-box to allow selecting/adding more than just one Value later in the User profile view.

Editing and displaying fields

If you want to rename any of already existing elements just click on its name, make some changes, and click Enter.

If you want to remove anything just click on a trashcan icon located on the right side. In the new window, you will be asked to confirm the action.

You can add several attributes to a group. The example below shows a completed group.

Now, if you move to the ‘User profile’ section, at the bottom of the view you will see those additional attributes.

Users Integrations

Creating an integration

To create an Azure AD or LDAP user integration, click .

In the Name field, enter the name you want displayed on the list of all integrations. In the Definition field, select LDAP or Azure AD from the dropdown menu.

To complete the first configuration process, press the button.

Connection and synchronization

Then return to the list with all available users integrations and edit the configuration of interest.

  • Azure AD Client/LDAP Client - Here, select the option you configured in Authentication Backends from the dropdown menu.
  • User name - user name of the person to integrate.
  • Password - password of the person to integrate.
  • Search filter - In the case of LDAP, you still need to add a search filter.

After entering the correct data, press the button. When the page reloads, press the button. If the configuration is correct, an appropriate message will be displayed. The next step is to press the button. After refreshing the page, a new entry will appear in Synchronizations.

Synchronization results

Reload the page to update its information. Open a synchronization entry to inspect its results.

At the very top, progress, the date the sync was performed, the result of the sync, and the sum of all operations along with successes and errors appear.

User Role Resolver

User Role Resolver assigns company roles to users who create tickets by email or, optionally, register through the website. Rules match the user’s email address. For example, a rule matching “customer” assigns its selected role to customer@mintsd.com when that user sends a ticket.

Upon opening the User Role Resolver tab, a table with the list of existing configurations is displayed, including the columns Name, Order, Stop after match, Active, and Action.

Administrators can manage column visibility and search the table by Name and Order; the Action column provides Edit and Delete buttons, while the remaining columns are described in detail in the configuration creation section below.

To create a configuration, click on the + button located in the upper right corner of the page below the user icon. After clicking, a configuration creation form will open.

Filter section

In the Filter section, you define the logical conditions that determine whether a company role should be assigned to a user. The logical operator field allows you to toggle between AND and OR, defining how all conditions in the configuration are evaluated together. Next to this field, there is a plus (+) icon that lets you add a new condition row.

Each added row contains an operator selection list (Contains, StartsWith, EndsWith, IsEqual, or MatchPattern), a text field where you enter the full email address or its fragment (e.g., part of the username or domain), a Match case checkbox to enable case-sensitive comparison, and a delete (trash) icon to remove the condition if needed.

Configuration settings section

In the configuration settings section, you define how the rule behaves once the filter conditions are met.

The Name field is used to identify the configuration, while Order determines the sequence in which the system evaluates this rule in relation to others.

The Role field specifies which company role will be assigned to the user when the filter matches. You can set one or more company roles to assign. The Stop after match option ensures that no further configurations are evaluated after this rule is successfully applied. The Active checkbox controls whether the configuration is currently enabled in the system, and Include registration form determines whether the rule should also apply to users registering through the system’s registration form.

Example

A new user with the address customer@mintsd.com sends a ticket. A rule matches addresses containing “customer” and assigns the Customer role for the Mint Service Desk company.

After the message is processed, the role is assigned automatically.