Table of Contents
Last updated: 4/16/2025

SMTP Mail

A ShareAspace installation has to send emails, especially for inviting users to a Collection or a Space.

Therefore, in order to be able to send emails it is required to connect the ShareAspace installation to a mail server.

Using the SMTPMail-x.y.z.build.msi it is possible to set up a server that connect to a mail server through the SMTP Protocol.

SMTP stands for Simple Mail Transfer Protocol and is a common protocol for sending mail.

The SMTP Mail component can be installed on the same server where the ShareAspace Host and other ShareAspace components are installed but the recommendation is to install any External Extension component on a separate machine.

At least one mail component (SendGrid Mail or SMTP Mail) should be configured for a ShareAspace Collection.

Prerequisites

The installation of the ShareAspace SMTP Mail extension requires to have a machine that is running a Web Server (IIS).

Installation steps

Run the installer

Run installer SMTPMail-x.y.z.build.msi to install the ShareAspace SMTP Mail extension on a Web Server (IIS).

Configuration

An SMTP server requires the following information:

  • Host: network address/name of the SMTP server the ShareAspace installation can connect to
  • Port: port value the SMTP server (usually 25)
  • TLSPort: port value the SMTPS server (usually 465)
  • EnableSsl: if the SMTP server requires a secured connection through SSL
  • UserName and Password: the credential of the account the ShareAspace installation can use for connecting to the SMTP server

The SMTP Mail component also needs to set up a SymmetricKey that should be used when the component is added as an External Extension.

The SymmetricKey key should be generated as described in the section Generate Symmetric Signing Keys.

The above values should be set in the appsettings.json file found in the installation folder for SMTP Mail (normally at C:\Program Files\Eurostep\ShareAspace\SMTPMail).

Below is an example of the settings:

"NovaConfig": {
  "SymmetricKey": "dqMrsV4Z...",
  "Smtp": {
    "Host": "smtp.mailserver.net",
    "Port": 25,
    "TLSPort": 465,
    "EnableSsl": false,
    "UserName": "UserName",
    "Password": "Password"
  }
}

The ShareAspace collection that will use the SMTP Mail component has to configure a Nova Extension before it can be used by that collection.

Note

The SMTP Mail component must be up and running during the registration process since a manifest exchange will take place between ShareAspace and the extension.

IIS settings

When installing the ShareAspace SMTP Mail, an Application Pool named "SMTPMail" is created in IIS. By default the account running the Application Pool is the built-in account "LocalSystem".

Note

If another account has to be used for running the "SMTPMail" Application Pool, this account running the "SMTPMail" Application Pool must have read access to the SMTP Mail installation folder.