You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/appstore/connectors/email-connector.md
+26-5Lines changed: 26 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,6 +17,7 @@ The Email Connector includes the following features:
17
17
18
18
* Configuration of multiple email accounts
19
19
* 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.
20
21
* Supports shared mailboxes using basic and OAuth 2.0 authentication.
21
22
* Digital signatures and encryption
22
23
* Email templates
@@ -80,7 +81,9 @@ When you run your app to use this module for the first time, and earlier data is
80
81
2. Choose if you want to either configure the **Primary** account or **Shared Mailbox**.
81
82
3. Choose the protocols for sending and receiving emails.
82
83
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.
84
87
85
88
{{% alert color="info" %}}
86
89
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
To configure OAuth provider, the following details are required:
260
+
To configure OAuth provider for the Authentication Code Flow, the following details are required:
258
261
259
262
***Client ID** – available on the [Azure portal](https://portal.azure.com/) once you have registered your app
260
263
***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
262
265
***Callback URL** – the URL where the OAuth provider will redirect with the authorization code, and configured on Azure portal as callback/redirect URI
263
266
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)
265
273
266
274
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).
267
275
268
276
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.
269
277
270
278
On the [Azure portal](https://portal.azure.com/), ensure that you have the following permissions enabled under **API permissions** tab on the sidebar:
#### 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:
* 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).
0 commit comments