Microsoft 365 Configuration Guide

Created by Alfie Jennings, Modified on Thu, 5 Jun at 2:37 PM by Lewis Eley

You can use your M365 tenant to send and receive emails within your My Council Services (MCS) Platform.   

 

Microsoft Graph APIs are used to facilitate the sending and receiving of emails with the desired domain and mailbox. 

The system will send and receive emails using an M365 mailbox (not Shared Mailbox). 

 

 All prerequisites and set-up are detailed in this document. 

 

  1.  M365 Configuration 

The following configuration will need to be undertaken by your MS Entra administrator: -  

  1. Enterprise Application . 

An Enterprise Application is required within the M365 tenant to ensure the appropriate authentication to receive and send emails. 

  1. Within Manage Microsoft Entra ID, go to Enterprise Applications, ‘Create your own application’.   Specify option ‘Integrate any other application you don’t find in the gallery (Non gallery) 

 

A screenshot of a computer application

Description automatically generated, Picture 

  1. Once the application is created, assign the appropriate users and groups as required. 

 

 

  1. Grant the following API Permissions 

 

Manage > API Permissions – configure the following Microsoft Graph permissions : 

 

A screenshot of a computer

Description automatically generated, Picture 

 

Mail.ReadBasic.All – Delegated 

Mail.Send –Delegated 

User.Read.All - Delegated 

 

Tenant-Specific Policies - please be aware that Conditional Access, Security Defaults, or other custom policies may: 

  • Override or restrict access to Graph API. 

  • Block authentication or token issuance. 

If issues occur we may need to review permissions.  As recommended, this is a general guideline for permissions and may not be applicable in all environments based on these factors. 

Please note Multi-Factor Authentication (MFA) 

  • Can be enabled.  This should be Fully compatible with delegated permissions when using OAuth 2.0 authentication flows. 

 

 

 

Please note at this point, from App Registrations, 

 

Overview  > Application (client) ID 

Overview > Directory (tenant) ID 

 

Picture 9, Picture 

 

Manage > Certificates & Secrets > Client secrets > Value 

 

A screenshot of a computer

Description automatically generated, Picture 

 

 

 

 

MCS - Account Configuration 

Go to Administration > Mail > Accounts > Email 

  1. The O365 account can must be set as ‘Default’ to allow the sending and receiving of emails for all default emails. 

Go to Administration > Mail > Accounts > Email 

A screenshot of a computer

Description automatically generated, Picture 

Enter the email address. 

Enter the incoming and outgoing port values will default to 143/587.  Incoming and Outgoing Host values will default to smtp.office.365.com. 

Set ‘Default’ as ‘Yes’ is you require this email to be the default email for your system.  Other mailboxes can be configured here but only one mailbox can be selected as the ‘Default’ for your system. 

  1. Service Messaging must be enabled 

Set ‘Service Messaging’ as ‘Yes’ 

  1. 0365 tenant details 

Add details from the Enterprise application configured to include: -  

Directory (tenant) ID  

Application (client) ID  

Client Secret Value  

A screenshot of a computer

Description automatically generated, Picture 

 


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article