Deploy the optional email approval feature
- Alex Xie
Prerequisites
A dedicated mailbox for receiving task approval email and the credentials to log on the mailbox.
For Office 365 mailbox: Azure configuration for receiving email using Azure MS Graph service .
For on-premises Exchange server: IMAP server host name and port.
Add the service to the docker-compose.yml file
Download the emailapproval.yml file:
Open the docker-compose.yml file;
Copy the emailapproval service from the emailapproal.yml and insert it at the end of the services section of the docker-compose.yml file. Make sure its indentation is aligned with other services;
Save the updated docker-compose.yml file.
Update the .env file
Add the following variables and their value to the .env file:
For on-premises Exchange server
imap_host=<The IMAP server name> imap_port=<The IMAP service port> imap_username=<The mailbox log on user name> imap_password=<The mailbox log on password>For Office 365 mailbox
imap_class=IQX.OneList.EmailApproval.Services.MsGraphHandlerService imap_username=<The mailbox log on user name> imap_authority=https://login.microsoftonline.com/<Azure tenant id>/v2.0 imap_clientid=<Azure client id> imap_clientsecret=<Azure client secret>
Restart OneList application
Run the following command to restart OneList:
docker-compose up -d
Create the OneList Email Approval channel
Follow the instructions at Configure Notification Channels to create the OneList notification channel for email approval:
Channel type: Email Approval
Email template: Task Approval