At line 1 removed 3 lines |
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 |
At line 5 changed one line |
It requires Microsoft Graph Application registration. Start at the Microsoft azure portal:\\ |
Based on __Microsoft Graph REST API__ ( More info: [Message Resource Type Link| https://docs.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0]).\\ |
\\ |
---- |
__⚠️ Proxy Configuration:__ If your server accesses the internet through a proxy, make sure to whitelist the following domains to allow authentication and Microsoft Graph API access:\\ |
•__login.microsoftonline.com__\\ |
•__graph.microsoft.com__\\ |
---- |
\\ |
!1. Microsoft Graph Application Registration\\ |
\\ |
It requires Microsoft Graph Application registration. Start at the Microsoft Azure portal:\\ |
At line 8 removed one line |
__Application registration__: Go to the App registrations and click on New registration:\\ |
At line 10 changed one line |
[attachments|new_registration.png]\\ |
Open the __Microsoft Azure Portal__: [Link|https://azure.microsoft.com/en-us/features/azure-portal]\\ |
At line 12 changed one line |
Name it. Select the Multitenant and personal Microsoft accounts type. The redirect url must ends with :register_microsoft_graph_api/. Then click on register.\\ |
__Application registration:__ Navigate to App registrations in the Azure Portal. Click on __New registration__ to create a new application.\\ |
At line 14 changed one line |
[attachments|register_app.png] |
[SharePoint Integration|new_registration.png]\\ |
At line 16 changed one line |
Under the redirect url configuration enable the __Access Token__ to be issued by the authorization endpoint: |
In the Redirect URI section, for Platform configuration, select __Web__. The Redirect URL must end with __"register_microsoft_graph_api/"__.\\ |
At line 18 changed one line |
[attachments|SMTP Microsoft Graph XOAUTH 2 Integration/enable_access_token.png]\\ |
{{{ |
|
http://localhost:9090/register_microsoft_graph_api/ |
or |
https://your.crushftp.domain.com/register_microsoft_graph_api/ |
|
}}}\\ |
At line 32 added 7 lines |
__Secret key__: A new client secret must be created. Go to Certificates & secrets, and generate a new client secret by clicking on New client secret. ⚠️ Ensure you copy over the __value__ immediately!\\ |
\\ |
[SharePoint Integration/new_secret.png]\\ |
\\ |
[SharePoint Integration/secret_value.png]\\ |
\\ |
\\ |
At line 22 changed one line |
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".\\ |
Go to __API permissions__, click __Add a permission__, and select __Microsoft Graph__. Then choose __Application permissions__ and add the following permissions:\\ |
At line 29 changed one line |
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.\\ |
Grant __Admin consent__ for the newly added permission.\\ |
At line 50 added 4 lines |
[SharePoint Integration/app_permission_admin_consent.png]\\ |
\\ |
Alternatively, you can perform this action via __CrushFTP__: Click the __Get Admin Consent__ button. __⚠️ Note:__ Make sure the WebInterface host and port match the host and port specified in the App Registration’s __Redirect URL__.\\ |
\\ |
At line 35 changed one line |
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. |
You need to log in with an __admin account__ to grant permissions for CrushFTP.\\ |
⚠️ Any changes made to __API permissions__ in the __Azure App Registration__ require new admin consent.\\ |
At line 37 changed one line |
!Settings\\ |
---- |
!2. Task Settings\\ |
At line 41 changed 4 lines |
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].\\ |
After processing copy message to this mailbox: Supports subfolders too.\\ |
__Client ID__ : See at App Registration -> Overview -> Application (client) ID\\ |
__Client Secret__: See at App Registration -> Manage -> Certificates & secrets) make sure to copy the value field, not the ID\\ |
__Tenant__: See at App Registration -> Overview -> Directory (tenant) ID\\ |
At line 46 changed one line |
Variable patterns:\\ |
|
__Folder__: Specifies the mail folder to process. Supports subfolders using the format Folder/Subbolder/SubSubFolder\\ |
__Search query__: Defines the search criteria for messages. Refer to the Microsoft Graph Search Parameters for syntax and options. More info: [Microsoft Graph Search Parameter Link|https://docs.microsoft.com/en-us/graph/query-parameters#search-parameter].\\ |
__After processing copy message to this mailbox__: Specifies the destination mailbox for processed messages. Subfolders are also supported.\\ |
At line 48 changed one line |
Message related variables:\\ |
__Variable patterns:__\\ |
\\ |
a.) Message-related variables:\\ |
\\ |
At line 51 changed one line |
}}} \\ |
}}}\\ |
At line 53 changed one line |
Attachment related variables:\\ |
b.) Attachment-related variables:\\ |
\\ |
At line 55 changed 2 lines |
{id}, {contentType}, {size, name}, {lastModifiedDateTime} |
}}} |
{id}, {contentType}, {size}, {name}, {lastModifiedDateTime} |
}}}\\ |
\\ |
For alternatives, see the general POP/IMAP Task description: [POP/IMAP Task – CrushFTP Documentation Link| https://www.crushftp.com/crush11wiki/Wiki.jsp?page=CrushTask#section-CrushTask-POP3IMAP]\\ |