Based on Microsoft Graph REST API ( for more info see : https://docs.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0).
Microsoft Graph Application registration#
It requires Microsoft Graph Application registration. Start at the Microsoft azure portal:
https://azure.microsoft.com/en-us/features/azure-portal/
![](https://www.crushftp.com/crush10wiki/images/out.png)
Application registration: Go to the App registrations and click on New registration:
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/new_registration.png)
Name it. Select the Multitenant and personal Microsoft accounts type. The redirect url must ends with :register_microsoft_graph_api/. Then click on register.
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/register_app.png)
Under the redirect url configuration enable the Access Token to be issued by the authorization endpoint:
![attachments](https://www.crushftp.com/crush10wiki/attach/SMTP%20Microsoft%20Graph%20XOAUTH%202%20Integration/enable_access_token.png)
API permissions :
MicrosoftMails task support OAuth 2.0 client credential grant. It requests the permissions from a directory admin. Go to the API permission. Click on Add permission, select Microsoft Graph.Choose "Application permissions".
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/permission_microsoft_graph.png)
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/permission_app_permissions.png)
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/permission_user.png)
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/permissions_mail.png)
To grant permissison for CrushFTP click on "Get Admin consent" button. Make sure your Webinterface host and port match with the host and port specified in App registration's redirect url.
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/admin_consent.png)
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/client_id.png)
You need to login with an admin account and grant permissions for your CrushFTP. Any changes on Azure App Registration -> API permissions require new admin consent.
Settings
#
![attachments](https://www.crushftp.com/crush10wiki/attach/MicrosoftMails/mail_task.png)
Client ID, Client Secret, Tenant : Authentication related setting. Azure App registration -> Overview.
Folder : Supports subfolders too like Folder/Subbolder/SubSubFolder
Search query : Search settings for messages. See https://docs.microsoft.com/en-us/graph/query-parameters#search-parameter
![](https://www.crushftp.com/crush10wiki/images/out.png)
After processing copy message to this mailbox: Supports subfolders too.
Variable patterns:
Message related variables:
{mail_id}, {mail_createdDateTime}, {mail_lastModifiedDateTime}, {mail_hangeKey}, {mail_sentDateTime}, {mail_receivedDateTime}, {mail_hasAttachments}, {mail_internetMessageId}, {mail_subject}, {mail_body_content}, {mail_body_type}, {mail_importance}, {mail_parentFolderId}, {mail_conversationId}, {mail_isRead}, {mail_isDraft}, {mail_sender}, {mail_from} , {mail_to}, {mail_cc}, {mail_bcc}, {mail_reply_to}
Attachment related variables:
{id}, {contentType}, {size}, {name}, {lastModifiedDateTime}
Add new attachment
Only authorized users are allowed to upload new attachments.
List of attachments
Kind | Attachment Name | Size | Version | Date Modified | Author | Change note |
---|---|---|---|---|---|---|
png |
admin_consent.png | 84.1 kB | 1 | 02-Jun-2021 14:25 | krivacsz | |
png |
client_id.png | 93.3 kB | 1 | 02-Jun-2021 14:28 | krivacsz | |
png |
mail_task.png | 186.3 kB | 1 | 02-Jun-2021 14:38 | krivacsz | |
png |
new_registration.png | 86.9 kB | 1 | 02-Jun-2021 12:26 | krivacsz | |
png |
permission_app_permissions.png | 59.4 kB | 3 | 02-Jun-2021 13:07 | krivacsz | |
png |
permission_microsoft_graph.png | 182.9 kB | 1 | 02-Jun-2021 12:58 | krivacsz | |
png |
permission_user.png | 83.1 kB | 1 | 02-Jun-2021 13:12 | krivacsz | |
png |
permissions_mail.png | 83.2 kB | 1 | 02-Jun-2021 13:12 | krivacsz | |
png |
register_app.png | 230.6 kB | 1 | 02-Jun-2021 12:27 | krivacsz |
«
This particular version was published on 01-Mar-2023 11:09 by krivacsz.
G’day (anonymous guest)
Log in
JSPWiki