| At line 1 added one line |
| \\ |
| At line 3 changed 3 lines |
| __!!! 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\\ |
| ---- |
| __⚠️ 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__\\ |
| ---- |
| At line 7 changed one line |
| !Microsoft Graph Application Registration |
| !1. Microsoft Graph Application Registration\\ |
| At line 12 removed one line |
| __Application registration__: Go to the App registrations and click on New registration:\\ |
| At line 14 changed one line |
| [attachments|new_registration.png]\\ |
| Open the __Microsoft Azure Portal__: [Link|https://azure.microsoft.com/en-us/features/azure-portal]\\ |
| At line 16 changed one line |
| Name it. Select the Multitenant and personal Microsoft accounts type. The redirect URL must end 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 18 changed one line |
| [attachments|register_app.png]\\ |
| [SharePoint Integration|new_registration.png]\\ |
| At line 20 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 22 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 24 changed one line |
| [attachments|SMTP Microsoft Graph XOAUTH 2 Integration/ms_client_secet.png]\\ |
| __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!\\ |
| At line 34 added 5 lines |
| [SharePoint Integration/new_secret.png]\\ |
| \\ |
| [SharePoint Integration/secret_value.png]\\ |
| \\ |
| \\ |
| At line 28 changed one line |
| MicrosoftMails task support OAuth 2.0 client credential grant. It requests permissions from a directory admin. Go to the API permission. Click on Add permission, and 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 35 changed one line |
| To grant permission for CrushFTP click on the "Get Admin consent" button. Make sure your Webinterface host and port match with the host and port specified in the 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 41 changed one line |
| You need to log in 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 43 changed one line |
| !Settings\\ |
| ---- |
| !2. Task Settings\\ |
| At line 47 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 52 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 54 changed one line |
| Message-related variables:\\ |
| __Variable patterns:__\\ |
| \\ |
| a.) Message-related variables:\\ |
| \\ |
| At line 57 changed one line |
| }}} \\ |
| }}}\\ |
| At line 59 changed one line |
| Attachment-related variables:\\ |
| b.) Attachment-related variables:\\ |
| \\ |
| At line 62 changed one line |
| }}} |
| }}}\\ |
| \\ |
| 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]\\ |
