Skip to content

Commit f3669a4

Browse files
author
Johanna Hemminger
authored
Merge pull request mendix#6154 from mahendra-mahajan-mendix/patch-17
Update email-connector.md
2 parents 337eb98 + 4375a6c commit f3669a4

1 file changed

Lines changed: 26 additions & 5 deletions

File tree

content/en/docs/appstore/connectors/email-connector.md

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ The Email Connector includes the following features:
1717

1818
* Configuration of multiple email accounts
1919
* Supports basic authentication and [creating an account with OAuth 2.0](#create-oauth) to configure Microsoft Azure AD accounts.
20+
* Supports Authorization Code Flow and Client Credentials Flow.
2021
* Supports shared mailboxes using basic and OAuth 2.0 authentication.
2122
* Digital signatures and encryption
2223
* Email templates
@@ -80,7 +81,9 @@ When you run your app to use this module for the first time, and earlier data is
8081
2. Choose if you want to either configure the **Primary** account or **Shared Mailbox**.
8182
3. Choose the protocols for sending and receiving emails.
8283

83-
You can add and configure an email account in the Email Connector using basic authentication and OAuth 2.0 for Microsoft Azure AD accounts. You can also add and configure "Shared Mailbox" using Basic & OAuth 2.0 authentitcation. To configure OAuth 2.0 accounts, see [Creating an Account Using Microsoft Azure OAuth 2.0](#create-oauth). The account configuration wizard supports automatic and manual configurations for Sending and Receiving emails.
84+
You can add and configure an email account in the Email Connector using basic authentication and OAuth 2.0 for Microsoft Azure AD accounts. You can also add and configure "Shared Mailbox" using Basic and OAuth 2.0 authentication, or using the Authorization Code Flow or the Client Credentials Flow.
85+
86+
To configure OAuth 2.0 accounts, see [Creating an Account Using Microsoft Azure OAuth 2.0](#create-oauth). The account configuration wizard supports automatic and manual configurations for Sending and Receiving emails.
8487

8588
{{% alert color="info" %}}
8689
You can configure either your primary email account or shared mailbox in the wizard, but not both (primary and shared) at the same time. To add a primary and a shared mailbox, go through the wizard twice; first to configure your primary account, and then to configure the shared mailbox. You can choose to only configure a shared mailbox, although your primary email account is needed to configure it.
@@ -254,22 +257,40 @@ If no email accounts are configured then you can create new OAuth configutation
254257

255258
#### 4.7.1 OAuth Provider Configuration Details {#oauth-config-details}
256259

257-
To configure OAuth provider, the following details are required:
260+
To configure OAuth provider for the Authentication Code Flow, the following details are required:
258261

259262
* **Client ID** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
260263
* **Client Secret** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
261-
* **Callback operation path** – enter any string, based on which the callback URL will be auto-generated
264+
* **Callback Path** – enter any string, based on which the callback URL will be auto-generated
262265
* **Callback URL** – the URL where the OAuth provider will redirect with the authorization code, and configured on Azure portal as callback/redirect URI
263266

264-
#### 4.7.2 Settings in the Microsoft Azure Portal
267+
To configure OAuth provider for Client Credential code grant flow, the following details are required:
268+
* **Client ID** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
269+
* **Client Secret** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
270+
* **Tenant ID** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
271+
272+
#### 4.7.2 Settings in the Microsoft Azure Portal (Authentication Code Flow)
265273

266274
To register your app in the Azure Portal, follow Microsoft's Tutorial [Register an app with Azure Active Directory](https://docs.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory). While registering, set the redirect/callback URI as **Callback URL** mentioned while configuring [OAuth Provider Configuration Details](#oauth-config-details).
267275

268276
This connector contains functionality of sending and receiving emails, so during the OAuth process the connector will ask for permissions for sending and receiving email.
269277

270278
On the [Azure portal](https://portal.azure.com/), ensure that you have the following permissions enabled under **API permissions** tab on the sidebar:
271279

272-
{{< figure src="/attachments/appstore/connectors/email-connector/app_permissions.png" >}}
280+
{{< figure src="/attachments/appstore/connectors/email-connector/app-permissions.png" >}}
281+
282+
#### 4.7.3 Settings in the Microsoft Azure Portal (Client Credentials Flow)
283+
284+
To register your app in the Azure Portal, follow Microsoft's [Register an app with Azure Active Directory](https://docs.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory).
285+
286+
This connector contains functionality of sending and receiving emails, so Office 365 Exchange Online related APIs need to be given permission along with Admin consent.
287+
288+
* On the [Azure portal](https://portal.azure.com/), ensure that you have the following permissions enabled under **API permissions** tab on the sidebar:
289+
290+
{{< figure src="/attachments/appstore/connectors/email-connector/client-cred-api-permissions.png" >}}
291+
292+
* Admin status is given on the added API permissions.
293+
* Tenant admin must register the Azure application's service principal in Exchange via Exchange Online PowerShell. Follow the steps in [Register service principals in Exchange](https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#register-service-principals-in-exchange).
273294

274295
### 4.8 Queuing Emails
275296

0 commit comments

Comments
 (0)