Community Knowledge Base

Users

This settings page is only available to domain administrators.

The Users section is where a domain administrator can manage the user accounts on their domain. This document explains the actions that can be taken on user accounts, including the ability to import users, improve the search functionality for a user by reindexing their account, enabling or disabling the MAPI/EWS and/or EAS synchronization add-ons, and more.

More information is available for adding new users as well as Managing Users.

When initially going to the accounts are of a domain, the Users tab will load by default. Here, you'll see a list of users already set up for the domain. You can also edit users, add new users, delete users, and much more on this tab.

When viewing the Users tab, the following information is listed:

  • Account - The username, or name that appears to the left of the "@" symbol in the email address.
  • Name - The Display Name set for the User.
  • Type - The "Role" of the User: User, Domain Admin or Primary Admin.
  • Enabled - Whether the User is allowed to send/receive email (Enabled) or not.
  • Last Login - The last date and time the User logged in to webmail.
  • Disk Usage - The total amount of disk space being used versus their limit.

The Actions (⋮) menu provides you with a number of different ways to interact with the domain users. This includes:

  • Impersonate User - If domain administrators have permission to impersonate users, when a user is selected and this action is taken, the domain administrator will log into the user's account and be able to see their entire account.
  • Enable - Enables the account, allowing the user to access their mailbox and send/receive email.
  • Disable - Disables the account. This, essentially, locks the user out of their account. However, when disabling a user, the domain administrator does have the ability to "allow incoming messages", so mail is still received even though the user is unable to log in.
  • Expire Password - Force a user to change their password on their next webmail login.
  • Reindex - Reindexes users/accounts to improve the search functionality for a user by reindexing their account.
  • Recalculate Disk Usage - Recalculate the disk usage for one or more user accounts.
  • Resync Devices - This forces a resync of all clients and all protocols for the selected user(s).
  • Import from CSV - Import new user accounts from a CSV file.
  • Import from LDAP - When enabled, this allows a domain administrator to import new user accounts from Microsoft's Active Directory.
  • Export All to CSV - Export a CSV file of all users on the domain.

Expire Password

This option can be used to expire the password of one or more users, forcing the user(s) to change their password the next time they log into the webmail interface. To expire the password of one or multiple users, checkmark the desired user accounts, click on the Actions (⋮) button, then click on Expire Password.

Note: If password changes were disabled for a user, expiring the user's password will automatically enable password changes and expire their password. They will be required to set a new password next time they log in. In addition, accounts set to Active Directory authentication cannot be expired.

Reindex

If a user reports errors or a lack of results when performing a search, it may be necessary to reindex their user account, which will regenerate the mailbox index file. To reindex one or multiple users, checkmark the desired user accounts, click on the Actions (⋮) button, then click on Reindex.

Recalculate Disk Usage

This option can be used to recalculate the disk usage for the selected user(s). If you find discrepancies in the user's disk usage display throughout the various areas of the interface (in the email section, reports, or Users grid), use this option to recalculate and correct that display. Please note that there may be no visual effect if the disk usage numbers shown were already correct. To refresh the disk usage for one or multiple users, checkmark the desired user accounts, click on the Actions (⋮) button, then click on Recalculate Disk Usage.

Resync Devices

This option can be used by either a domain administrator or a system administrator to help potentially resolve an issue that's seen by a user who is using a particular client. (I.e., Microsoft Outlook, eM Client, etc.) For example, a user can see an issue receiving new emails in Outlook for Windows, which uses the MAPI protocol. The issue they're seeing may be the result of something hung in a different client: iOS Mail that uses EAS, eM Client that uses EWS, Gmail that is using IMAP. To help resolve this issue, an administrator can force a resynchronization of all clients across all protocols, thereby clearing up any issue regardless of which protocol is affected.

An administrator (domain or system) can use this tool on up to 25 individual accounts, on a single domain, at a time. Once started, a toast notification appears for the administrator(s) running the resync that lets them know the resync has started. They also see a notification. Once the resync has completed another notification appears with the results. If one or more users are unable to be resynced, that information appears in the notification, but the resync will continue until all users have been synced. NOTE: The notification will appear for all domain or system administrators, not just the one running the resync.

All resyncs are captured in the Administrative logs.

IMPORTANT NOTE: Resyncing user protocols can cause an increase in server resources, so it is restricted to 25 users at a time to mitigate impact on a server. When resyncing ALL users (in batches of 25) administrators will want to closely monitor CPU and memory usage to ensure the server can handle the additional load.

Import from CSV

To add new SmarterMail users via a CSV spreadsheet, click on the Actions (⋮) button then click on Import from CSV. Upload the CSV file that contains the user information and click Next. The first page of the import modal will allow you to map the CSV column headers to the appropriate configuration option within SmarterMail. For example, if your CSV contained a column header for "user name", you can select the "Username" mapping.

At minimum, the CSV file must contain a "Username" column header. All remaining configuration options will mimic the domain's User Defaults template. If no "Password" column header is provided in the CSV, the import modal will prompt you to create a temporary password for the user(s) being imported. Those users will be prompted to change their password the next time they log into the webmail interface.

Import Users From LDAP

This feature is only available to domain administrators using SmarterMail Enterprise.

The Lightweight Directory Access Protocol (LDAP) is, as the name implies, a lightweight client-server protocol that email servers, software and network appliances can use to connect to, and look up information from, a directory service. For example, LDAP can be used to look up information from Microsoft Active Directory.

For its part, SmarterMail acts as an LDAP client. That means LDAP can be used to integrate SmarterMail with Microsoft Active Directory as a lookup service for users, finding the accounts within aliases, and finding mailing list subscribers, as well as an authentication method for users. The LDAP integration between SmarterMail and AD via LDAP is, therefore, one-way: SmarterMail can look up information within Active Directory, but it can't send information TO Active Directory. So, when Active Directory is used as an authentication method for users, if the user changes their password, display name or other information in SmarterMail, that change is NOT synced back to Active Directory. However, if that same information is changed in AD, it will sync back to SmarterMail.

Follow these steps to import new users using LDAP:

  1. In the Actions (⋮) dropdown menu, select Import from LDAP. A modal will appear.
  2. Input the location of your active directory users via the LDAP binding string. An example LDAP string might look like this:
    LDAP://testdomain.local/CN=Users,OU=Company,DC=testdomain,DC=local
  3. If you want to use the LDAP email address as the username for the imported accounts, enable it.
  4. Click List Users.
  5. Select the users you wish to import into the domain. NOTE: If any users, aliases or mailing lists already exist in SmarterMail they will not show up in the LDAP list.
  6. Click Import to begin the import process.

Note: LDAP integration will only function if SmarterMail is on the same domain as the LDAP server you are trying to connect to.

Export All to CSV

To export a list of all user accounts on the domain, click on the Actions (⋮) button then click on Export All CSV. The CSV file will continue a variety of details about the user accounts, including their username, display name, authentication method, home and work address, disk usage, and more.