Using Lansweeper it's possible to send emails in the context of both the helpdesk module and to send report and event alerts. Since Lansweeper 8.3, O365 with modern authentication is supported as a mail provider. To do this a Microsoft Cloud Services application is required. This article explains what is required to set this up, which permissions to add to your Microsoft Cloud Services application and how to configure your email account in the helpdesk email configuration or email alert configuration.
Prerequisites
To use an O365 email account to send or receive emails in Lansweeper, make sure that:
- You've already set up your Microsoft Cloud Services application.
- You're in possession of your Microsoft Cloud Services application's Application (client) ID, Directory (tenant) ID, and Client secret.
Adding permissions to the Microsoft Graph application to send and receive emails
Step 1: API permissions in the Azure Portal
Open your companies' Azure portal, navigate to app registration and click on the API permissions tab in the left-hand menu.
On the API permissions page, click on the Add permission button and select the Microsoft Graph from the API list.
As we are setting up the Graph API to enforce modern authentication, you will need to add Application permissions. Therefore, click the Application permissions button.
Add the API permissions listed in the table below. These are all required to send and receive emails.
Mail.ReadWrite | Read and write mail in all mailboxes |
Mail.Send | Send mail as any user |
User.Read.All | Read all users' full profiles |
Once the permissions are added, click the save button on the bottom of the page and double-check that the permissions that are listed.
Step 2: Grant admin consent
The permissions are added but admin consent must still be granted. To do this, click the button Grant admin consent for <organization> and click the Grant button in the resulting pop-up.
All added permissions should now show Granted for <organization>
How to configure your email account in the helpdesk email configuration
Navigate to Configuration\Email Settings and click the add E-mail account button. You can also change an existing configuration by hitting the edit button. Fill out DisplayName and E-mail address in the General Settings tab.
Microsoft Graph (REST API) as protocol. Fill in the Client ID, Tenant ID, and Client Secret. These values can be gathered when creating the Microsoft Cloud Services application.
Last, click on the outgoing tab and select the Microsoft Graph (REST API) as protocol. Fill out the Client ID, Tenant ID, and Client Secret, and click the OK button to save your helpdesk email account.
How to configure your email account to send Email Alerts
Navigate to Configuration\Email Alerts and select the Microsoft Graph (REST API) protocol in the E-mail Server section. Fill in the From address, Client ID, Tenant ID, and Client Secret. These values can be gathered when creating the Microsoft Cloud Services application.
