Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article explains how to configure

SMTP Protocol

e-mail sending for the Adonis Personnel Manager (APM) installations located

in

on the

Azure

Adonis Cloud.


Introduction

In order to be able

Adonis applications have inbuilt functionality to send various e-

mail

mails (notifications & payslips to crew members, reports,

notifications from APM installation located in the Azure Cloud

etc.). While Adonis applications don’t incorporate their own SMTP server, it uses standard protocols to communicate with any SMTP server for sending e-mails.

To send e-mails and notifications from the installations located in Adonis Cloud (hosted on the Microsoft Azure platform), it is necessary to

setup

set up one of the

send e-mail

methods available in Adonis:

SMTP

APM has 2

and Office 365

In this article we will cover the SMTP configuration.

Setup and Configuration

Adonis Personnel Manager (APM) has two places where the mail server is configured in

global options.

Global Options:

  • One is for sending

mails
  • mail in general (when choosing to send mail to crew members from the crew list view or other places).

  • Another one is used for sending standard (in-build) payslip reports.

Let’s check how to set it up.

Setup and Configuration

General tab

The setup for sending

mails

emails, in general, is configured under

the

Setup > Global options > General.

Here you need to

select the Security Protocol you use - SMTP in our case.
For the selected option you also need to define Server and Port.
Image Removed
Please also note that Microsoft has tightened the

:

  • Select the security method -Office 365 or SMTP.

  • Define the Server and Port.

    Image Added

Depending on whether you use Office 365 or SMTP, there will be a different set of fields that you need to fill in under Authentication.

Authentication > SMTP

Image Added

Authentication > Office 365

Image Added

Payroll tab

If you use a standard/ in-build payslip report, then you also need to make the same configuration under the Setup > Global options > Payroll > Email reports > Communication.

Image Added

Ports

Microsoft has strict anti-spam filtering policies for all its platforms

and limited

. Thus the the number of ports allowed for Office 365 or SMTP is limited:

  • Blocked Ports: 25;

  • Allowed Ports: 443, 465, 587;

Note

If the port is blocked or set incorrectly you

may

will get the "socket 10060" error:

Image Removed

You will also need to input the mail box account details, due to 2 factor authentications.
For the mail box we must use TLS encryption protocol for sending mails.
In Azure we support TLSv1.0 and TLSv1.2. But APM itself has many hard-coded references to TLSv1, which might create issues if you use TLSv1.2.
Thus we recommend to test send e-mail properly from different places if you decide on TLSv1.2.
Image Removed
If you use standard/ in-build payslip report, then you also need to make the same configuration under the Setup > Global options > Payroll > Email reports > Communication.
Image Removed
Image Added