View Source

Take care to to configure Incoming Mail handler to allow approval via email.

Outgoing mail settings

Ensure that the SMTP mail server has been correctly configured and the "Outgoing Mail" is enabled.

Herzum Approval Documentation 3.X > Mail System Configuration > image2014-12-11 10:5:18.png

Incoming mail settings

1

Go to the Mail administration panel.

JIRA Administration -> System -> Mail -> Incoming Mail

Mail administration panel

2

Setup the "POP/IMAP Mail Servers" that has to manage incoming mail queue if not already configured,

The Accounts set on the Incoming Mail Server as Username and on the Outgoing Mail Server as From address must be the same.

Herzum Approval Documentation 3.X > Mail System Configuration > image2014-12-10 19:49:17.png

POP/IMAP Mail Servers administration panel

3

Setup a new "Mail handler" by clicking on the "Add incoming mail handler" button.

Herzum Approval Documentation 3.X > Mail System Configuration > image2014-12-10 19:52:17.png

Incoming Mail Handler administration panel

4

Digit the mail handler name, select the configured POP / IMAP server, choose "Approval Mail Handler" as Handler Type and click Next.

Herzum Approval Documentation 2.X > Herzum Approval - Installation and Upgrade > image2013-10-24 18:50:58.png

Incoming Mail Handler configuration screen

5

Digit the forward email and save.

Herzum Approval Documentation 3.X > Mail System Configuration > image2014-12-11 9:49:51.png

Incoming Mail Handler configuration screen

Recommendations and notices

Following, some recommendations respect to the email addresses used on your mail server setup and information regarding the Approval Request/Reply email handling.

Outgoing mail server set up

The Username setup on the mail server must differ by any Approver email address.

Herzum Approval Documentation 3.X > Mail System Configuration > image2016-2-25 17:38:19.png

Incoming mail - POP / IMAP Mail Server set up

Ensure that:

the Username setup on the IMAP Mail Server must be the same Username set on the mail server SMTP Host.
only one POP Mail Server exists associated to the specified username.
only the Approval Mail Handler is associated to the specified POP Mail Server.

Herzum Approval Documentation 3.X > Mail System Configuration > image2016-2-25 17:41:27.png

Mail Handler setup

The Forward email address is not managed by the add-on yet also if it is required when configuring the Approval Mail Handler.

Herzum Approval Documentation 3.X > Mail System Configuration > image2016-2-25 17:43:56.png

Approval request/reply email handling

In order to allow the mail handler working properly, the emails incoming to the SMTP Host email address must not be open because the mail handler is able to handle the new (still not read) incoming email exclusively.

Further notice:

the "From" address on the Approval Request email arriving to every approvers is the Username setup on your outgoing mail server SMTP Host.
when the approver replies to the email by following the expected convention (e.g. @Approved my optional comments @), the email turn back to the "From" address; the Mail handler intercepts incoming emails and, if the email address of the approver belongs to a JIRA user enabled to approve/reject the specific approval item, changes the status of the Approval item in APPROVED or REJECTED.