| 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 22 added 17 lines |
| In the Redirect URI section, for Platform configuration, select __Web__. The Redirect URL must end with __"register_microsoft_graph_api/"__.\\ |
| \\ |
| {{{ |
|
| http://localhost:9090/register_microsoft_graph_api/ |
| or |
| https://your.crushftp.domain.com/register_microsoft_graph_api/ |
|
| }}}\\ |
| \\ |
| __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 18 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 25 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 31 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 33 changed one line |
| !Settings\\ |
| ---- |
| !2. Task Settings\\ |
| At line 37 changed one line |
| Client ID, Client Secret, Tenant => Authentication related settings |
| __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\\ |
| \\ |
|
| __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.\\ |
| \\ |
| __Variable patterns:__\\ |
| \\ |
| a.) 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} |
| }}}\\ |
| \\ |
| b.) Attachment-related variables:\\ |
| \\ |
| {{{ |
| {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]\\ |
