Email Configuration

The section elementMailSetting (prior to v3.1.x.y this section used to be called elementSmtpSetting) is required to be filled out to add email-capabilities to the Aligned Elements web application. This is required for the user management to work properly since new users are invited per mail only. Furthermore, the password reset and email address confirmation functionality require this e-mail sending capability.

Fill out the microsoftGraphSetting or smtpSetting as required by your emailing system. It could make sense to request a specific address for use on the server.

Note: It is recommended to not write any passwords in clear text in the web.config file. Therefore, please use our tool https://demo.aligned.ch:444/encrypt to encrypt your password.

Using Microsoft Graph To Send Mail

Register an application in Azure AD/Entra to allow sending mails.

After registering the new app registration using default options, take note of the client_id and the tenant_id.

Click on “Certificates & secrets” and create a new client secret. Also take note of the secret right away as it will only show once:

Finally this app registration needs to have the right API permission. Under “API permissions” select “Add permission” and then select “Microsoft Graph”. Since we’re building a background service with no user present, choose “Application permissions”, search for “Mail.Send” and select it:

Important: After adding a permission an admin needs to grant this permission for the entire organization:

After granting there should be a green check-mark on the permissions:

Enter the obtained data in the web.config. Ensure to encrypt the client_secret using the encryption tool above and mark the entry isSecretEncrypted="true". Sender is the email address that will used.

Using a SMTP server to Send Mail

Copy the encrypted password into the SMTP section in the Web Config. Then mark the smtp entry with the attribute isPswEncrypted="true". User and sender are often the same as the email address.