SmarterMail Help

General Domain Settings

This settings page is only available to Domain Administrators and System Admininstrators with the proper permissions.

Below are the options available for managing and configuring a domain. To access the domain settings, log into SmarterMail as a Domain Administrator and click the Domain Settings icon. Then click on General in the navigation pane. The following options will be available:

Jump To:

  • Domain Aliases - Add an alternate domain name for users on the domain
  • User Options - Adjust settings that apply to users on the domain
  • Folder Auto-Clean - Add settings that affect the auto-clean rules set for the domain on default folders.
  • Team Workspace Video / WebRTC - Set up alternate STUN/TURN server(s) for Team Workspaces
  • Custom Help - Add a custom Help link to the Logout menu
  • Webmail Login - Customize the login page for your domain
  • Logout URL - Set a special page to load on logout
  • Footer - Add a message footer that appends all outgoing messages
  • Email Signing - Protect users from phishing schemes and spam attacks
  • Mailing Lists - Set the Bounces Before Removal threshold for mailing lists

Domain Aliases

A domain alias is bascially an alternate domain name for one that already exists in SmarterMail. Domain aliases are useful, as they allow companies with multiple domain name extensions to receive any email sent to one of their domains directly within SmarterMail. For example, imagine you have a domain, 'example.com' with a user configured under 'user@example.com'. By adding a domain alias for 'example.net', any email sent to 'user@example.net' will be delivered to 'user@example.com'.

Note: You must own the domain name in order to create a domain alias. In addition, messages cannot be retrieved with a domain alias email address unless the domain is properly registered at a domain registrar.

Creating a Domain Alias

To create a new domain alias, click New Domain Alias. Then enter the name of the alternate domain. The name will be used to create the domain alias email address. For example, if the name of the alias is "example2.com", the domain alias email address will be user@example2.com.

Note: By default, before a Domain Administrator can save a domain alias, SmarterMail will check that the mail exchange record for the domain is pointing to the server. This prevents Domain Admins from "hijacking" mail from valid domains. For example, if this check were not in place, a Domain Admin could add a domain alias of example.com. Then, any mail sent from the server to "anything@example.com" would go to the domain with the example.com domain alias, rather than to the actual domain. Alternatively, System Administrators who impersonate a domain will see an option when adding a domain alias on whether to verify the MX record before saving.

User Options

This feature is only available when using SmarterMail Enterprise.
  • Two-Step Authentication - Two-Step Authentication is a method of providing a second way to verify account ownership before a user can log into their account or connect to third-party clients and/or devices. For example, when a user has set up Two-Step Authentication for their account, the SmarterMail login page will require their primary account password and a secondary verification of account ownership before the user can log into webmail. The second method of verification will be provided to the user through popular authentication apps, like Google or Microsoft Authenticator, or through a recovery email address.When this feature is enabled for a domain, the Domain Administrator can choose whether to Enable or Force Two-Step Authentication for their users - With Enable, users can choose whether to implement Two-Step for their accounts whereas with Force, users MUST use Two-Step for their accounts.
  • Show calendar availability for all users in domain - This setting is enabled by default and allows SmarterMail to alert users of any scheduling conflicts when adding a member of the Global Address List as an attendee on a calendar appointment. In addition, this allows users to view an Availability window to review the times that their attendee is free/busy. When disabled, domain users’ scheduling information will not be displayed in the appointment window.
  • Allow users to opt out of Global Address List - The Global Address List (GAL) is basically a listing of all users who have accounts for your particular email domain. However, not all accounts would necessarily need to be listed in the GAL. For example, generic addresses like info@ or support@ may not need to be listed as they're used for specific purposes (e.g., support@ being imported into a ticketing system.)

Folder Auto-Clean

Setting up auto-clean rules for email folders is a simple, yet effective, way to limit how much of the domain's disk space is taken up by users' Junk Email, Sent Items, and Deleted Items folders. By placing limits on the size of these folders, or by automatically deleting mail older than X number of days, you can help ensure that your domain disk space does not fill up unnecessarily. In addition, if you want to set a size limit on a folder for users, their messages are deleted in the order that they were received so that older messages get deleted first.

  • Allow users to override auto-clean settings - Enable this setting to allow users to override the domain policy and create their own auto-clean rules.
  • Override auto-clean settings - Enable this setting to override the settings established by the System Administrator, allowing you to create your own rules. Any changes you make will not be affected if the System Administrator changes their policy, unless they disable domain overrides.

If "Override auto-clean settings" is off, the auto-clean rules created by the System Administrator will be displayed at the bottom of this card. (If no rules were created by the System Administrator, a note saying such will be displayed.

However, if "Override auto-clean settings is turned on, you're presented with a New rule button that will allow you to create your own rule(s) for domain users. Auto-clean rules can be created for any default mail folder, and can be created based on a message's age or the folder's size.

Team Workspace Video / WebRTC

This feature is only available when using SmarterMail Enterprise.

SmarterMail's Team Workspaces uses Web RealTime Communication (WebRTC) for peer-to-peer audio and video chat. WebRTC is an open standard that uses plugin-free APIs to connect web browsers (WebRTC compatible web browsers, that is) for the transfer of voice, video and general data.

For most people, using Team Workspaces as it's implemented in SmarterMail is perfectly fine. It uses a default STUN service to assist with the transfer of the data from user-to-user. However, larger or more complex networks may have restictions that limit, if not fully deny, a Workspace's WebRTC requests. For example, the use of firewalls or the use of Network Address Translation (NAT) on their routers. In these cases, using a standalone STUN or TURN server may be necessary.

To add a separate STUN/TURN server for a domain, simply click the New STUN/TURN Server button. Once you do so, you'll be presented with the following:

  • Type - Whether you're adding a STUN or TURN server.
  • URI Paths - These are the paths to the STUN or TURN server you're setting up.
  • Username - When setting up a TURN server, this is the username used to connect to that server.
  • CREDENTIAL - When setting up a TURN server, this is the "password" for connecting to that server.

While STUN servers are very inexpensive for a company to operate (they’re basically a glorified “What’s My IP” service), TURN servers can consume a significant amount of bandwidth. Therefore, a TURN server may require you to use a paid service to host it for you. Companies like Twilio or Xirsys offer such services. If you want to host your own TURN server, one of the most popular options is Coturn, a Linux-based TURN server. Note: These are simply examples, and are NOT endorsements of any product or service mentioned.

Custom Help

Note: This section will only be visible if the System Administrator has enabled Login Display Customization for the domain.

  • Custom Help URL - Entering a full URL in this field will add a custom button to the Help menu that users can access in the SmarterMail interface. Administrators can link to a variety of things, including server-specific instructions for syncing, help resources, contact information, etc.
  • Custom Help Text - The hyperlink text for the custom URL in the Help menu. Note: If no text is entered in this field, the hyperlink text in the Help menu will default to "External Help".

Webmail Login

Domain Administrators can customize the SmarterMail login page for their domain to add a company logo, provide additional branding text, or simply adjust the default “Login to SmarterMail” text to be more in line with an overall brand message.

Note: This section will only be visible if the System Administrator has enabled Login Display Customization for the domain. Furthermore, if the System Administrator allows a domain to override the custom login display and the Domain Administrator does not enable customization for their domain, users will see the default SmarterMail login screen, regardless of whether the System Administrator has enabled a custom login display for the server.

  • Logo Image - Upload an image, like a company logo, by dragging and dropping a file in the highlighted area or clicking to browse for a file (max file size of 3mb). Uploading an image using this upload control will host the image publicly on the server and enter the <img src="URL" /> tag in the HTML section. Note: Uploading an image here alone will NOT display the image on the login screen. The HTML must remain in the Login Page HTML section. This upload control can be used by those who don't have their logo publicly hosted or who wish the image source to point back to their mail server. Furthermore, regardless of the image uploaded, the image's source URL will remain the same; only one image may be hosted at a time.
  • Custom Login Text - Use this setting to customize the login page header to something more in line with an overall brand message. If Custom Login Text is left blank, SmarterMail's login page will show the default text "Welcome to SmarterMail".
  • Custom Title Text - Use this setting to customize the title of the login page to something more in line with an overall brand message. If Custom Title Text is left blank, SmarterMail's login page will show the default text of "SmarterMail" in the browser tab title. Note: Users will see this text on the login page only, with their email address displayed as the browser title for all other pages.
  • Login Page Language - Use this setting to set the default language of login page as well as the default language if "Login Display Customization" is enabled for a domain. NOTE: This setting will only go into effect for a new user who is visiting the SmarterMail login page for the first time, or if a user's local storage is cleared. This will NOT change the default language for users who return to the login page after already visiting it under a different language.
  • Enable custom login page HTML - Enable this setting to use HTML to further modify the login screen to add additional text or adjust the layout.
  • Login Page HTML - Enter the custom HTML that will be used to further modify the login screen (in-line custom CSS can be used as well). Note: To include white space around the Image for Login Screen, the div id "companyinfo" must be included. In addition, Domain Administrators cannot enter scripts as this is considered to be unsafe code; however, System Administrators do not have this limitation.
  • Preview Login - This button will open a small preview in a pop-up window of the login customizations you've made without you having to save your changes and test it yourself.

Logout URL

In most cases, when a user logs out of SmarterMail, they are taken back to the standard login screen. However, Administrators can enforce a logout redirect for all users on the system (like to an Intranet page or company site) or allow Domain Administrators to enforce their own policies. In this section, the system policy will be displayed.

If the Administrator has allowed it, you can enable the ability to Override System Settings, then enter a unique logout URL for the domain in the Logout URL text box.

Footer

If the System Administrator has enabled footer customization for the domain, Domain Administrators can configure server-wide message footers that SmarterMail will append on all outgoing messages, forwards that do not already have a footer, replies to messages and emails sent to a mailing list from SmarterMail, if enabled. Although similar to signatures, message footers are typically used to convey disclaimers or provide additional information. For example, a domain administrator may want every message to include a notice that the message was scanned for viruses or the text "Sent by SmarterMail." NOTE: If the system administrator has a footer configured and enabled for all messages, incoming messages will use that footer. If the domain footer is the only one being used, it is only appended to outgoing messages.

The following options will be available:

  • Override footer settings for this domain - Enable this setting to customize the footer for your domain.
  • Enable footer for all messages - When enabled, only outgoing messages will have the footer appended. When toggled to the right, new messages as well as replies and forwards will have the footer appended.
  • Apply to mailing lists - By default, footers are not applied to emails posted to mailing lists. To add the footer to mailing list emails, enable the setting. Note: Mailing lists have their own configurable footers. If a custom mailing list footer is already configured, enabling this option will append a second footer at the end of each message posted to the mailing list subscribers. Because this may be confusing for mailing list moderators and recipients, most administrators will choose to keep this option disabled.
  • Footer - Use this section to create the message footer text. Clicking the edit icon will open a modal that includes an HTML-based editor, allowing admins to create footers that seamlessly fit into any email message. Note: The message footer does not support the use of variables.

Email Signing

Email signing protocols can be used to protect users from phishing schemes or spam attacks. For example, DKIM signing uses cryptography to verify the authenticity of a message, ensuring the message came from your server and was not changed in transit. To enable DKIM Signing, click the Enable button. SmarterMail will display a unique Text Record Name and Text Record Value. You will need to contact your DNS provider and add the TXT record to your DNS server. After the TXT record has been added to DNS, click on the Enable button once again. SmarterMail will attempt to verify the DNS settings and DKIM Signing will be enabled.

To view the Text Record Name and Value, click on View Record. To adjust the mail signing settings, click the Settings button. Note: In most cases, these settings do not need to be altered. However, in the event that you would like to specify how closely you want the system to monitor messages in transit, please refer to the DKIM documentation linked below.

  • Key Size - The length of encryption key to use. 2048 is recommended.
  • Max message size to sign (MB) - This is the largest message size you want to sign using DKIM. DKIM generates a "hash" on the email up to the size limit. Generating the "hash" could be an expensive operation, especially if the domain sends large messages all the time. Limiting it means not having to process the whole message -- It would only grab the bytes up to the size limit and sign that.
  • Body Canonicalization - The method used to monitor in-transit changes to the body of a message. Two canonicalization algorithms are defined for the body: a "simple" algorithm that tolerates almost no modification and a "relaxed" algorithm that tolerates common modifications such as whitespace replacement and header field line rewrapping. For more information, please visit http://dkim.org/specs/rfc4871-dkimbase.html#canonicalization.
  • Header Canonicalization - The method used to monitor in-transit changes to the header of a message. Two canonicalization algorithms are defined for the header: a "simple" algorithm that tolerates almost no modification and a "relaxed" algorithm that tolerates common modifications such as whitespace replacement and header field line rewrapping. For more information, please visit http://dkim.org/specs/rfc4871-dkimbase.html#canonicalization.
  • Header Field to Use - The header fields included in the hash algorithm. This is further defined by header fields. For assistance in determining the header fields to sign, please visit http://dkim.org/specs/rfc4871-dkimbase.html#canonicalization.
  • Header Fields - The header fields included in the hash algorithm. Note: List only one header field per line break.

Setting Up Email Signing

Setting up email signing and creating the fields necessary to add DKIM to a domain's DNS record is simple within SmarterMail.

  1. Log in as a Domain Administrator
  2. Click on the Domain Settings icon
  3. Navigate to the domain’s General settings
  4. Find the Email Signing card
  5. Click on the Settings button
  6. A modal window opens, like the one below. Here, all of the DKIM settings are displayed. SmarterMail defaults all of these to a set of general recommendations, but they can be adjusted as needed.
  7. Email Signing Settings
  8. Make any changes you want and save them. If no changes are made, simply click the Cancel button.
  9. Next, click the Enable button on the Email Signing card. A modal window will open, and it will contain the text necessary for adding the DNS record. This window contains two important pieces of information: the “Text Record Name” and the ”Text Record Value”. The Text Record Name contains the “DKIM selector”, which is the value that precedes “._domainkey”. For example, “2B8U4DAB93D58YR”. The selector can be used to verify that your DKIM record is set up correctly. (When the Text Record Name is added to DNS, the ".domain" should automatically be appended by DNS.) The Text Record Value is also the public key that’s created by the SmarterMail server. Therefore, it’s the encrypted key that pairs to the private key that’s stored on the mail server. This is why it looks like a random series of characters.
  10. Email Signing Records
  11. Now that you have the Name and Value for the TXT record, you will want to log in to your DNS provider and create the actual DNS record. How you do this depends on who your provider is. In general, the DNS TXT record format will be as follows:
    • NAME = Text Record Name, which will be something like 2B8U4DAB93D58YR._DomainKey
    • TYPE = TXT
    • VALUE = Text Record Value, which contains the public key created by SmarterMail

NOTE: As this is a change to DNS, it may take a few hours for the record to propagate for the domain. Generally that propagation is pretty fast, but it could take 24 hours or more.

Validating Your DKIM Record

Once you've made the changes to your domain's DNS, it can take a few hours for those changes to take effect. To test whether you're set it up properly, you can do a search for "DKIM record validation" or use a site such as MXToolbox. MXToolbox makes DKIM validation simple; you just need your domain name and the selector. (The "selector" is what comes before the "." in your Text Record Name. So if your Text Record Name was 2B8U4DAB93D58YR._domainKey, the selector is 2B8U4DAB93D58YR). Enter those into their form, and they'll let you know a) if the record can be found, and b) if it's valid.

Attachments

  • Inbound Extension Blacklist - This list allows you to limit the file types that can be attached to emails sent to users on your domain. For example, many email administrators won't allow executable files (EXE) as they can cause issues on the mail server, and possibly across an entire network. To add a blacklisted file type, simply type in the file extension, one per line. (E.g., .exe or EXE)
  • Outbound Extension Blacklist - This list allows you to limit the file types that are users on your domain are allowed to send out of the mail server. For example, many email administrators won't allow batch files (BAT) as they can cause issues on the recipients' mail server, and possibly across their entire network. To add a blacklisted file type, simply type in the file extension, one per line. (E.g., .bat or BAT)

Mailing Lists

Mailing Lists are a great way to allow users to communicate with a number of different individuals via a single email address. Unlike an Alias, a mailing list allows people to subscribe to, or unsubscribe from, email communications. In addition, mailing lists can be public or private, be replied to by all users or managed by a single list administrator and more. Use this card to specify the following mailing list setting:

  • Mailing List Command Address - This is, essentially, the "To" address for your listserv. If someone wants to subscribe to a list, for example, they'd email listserv@your-domain.com with the listname and the word "subscribe" in the body of their message. They'd then be subscribed to that mailing list.
  • Bounces Before Removal - The number of times a message to a specific subscriber may bounce before the subscriber is automatically removed from the mailing list. By default, this number is 2.