Registering Exchange Integration Manager With Microsoft Identity Platform

Note:

The steps described in this topic are provided for illustration purposes only. Refer to the vendor documentation for detailed instructions about integrating an application with Microsoft identity platform. See Quickstart: Register an application with the Microsoft identity platform and Quickstart: Configure a client application to access a web API on the Microsoft website for more information.

Before you can connect Exchange Integration Manager with Microsoft Entra ID, Exchange Online, or both, you must register Exchange Integration Manager with the Microsoft identity platform first. The Microsoft identity platform provides secure sign-in and authorization for Exchange Integration Manager to access Microsoft Entra ID or Exchange Online through the relevant Web APIs using OAuth 2.0.

To register Exchange Integration Manager with Microsoft identity platform

  1. Sign in to the Azure portal.

  2. If your account gives you access to more than one tenant, select the account you require in the top right corner.

  3. Go to Microsoft Entra ID.

  4. Click App registrations under Manage on the left pane.

    The App registrations page appears.

  5. Click New registration. The Register an application page appears.

  6. Enter a Name for the application — for example “SuiteProjects Pro Exchange Integration Manager” — and select Accounts in this organizational directory only (<Your tenant name> only — Single tenant) under Supported account types.

    "Register an Application" page in Microsoft Azure.
  7. Click Register.

    The Overview page for your new app appears.

    Application Overview page for Exchange Integration Manager in Microsoft Azure.
  8. Copy the Application (client) ID and Directory (tenant) ID and store this information in a safe place. You will need this information when configuring Exchange Integration Manager. See Connecting Exchange Integration Manager with Microsoft Entra ID or Exchange Online.

  9. Click API permissions under Manage on the left pane.

    The API permissions page appears.

  10. Click Add a permission.

    The Request API permissions page appears.

  11. Click Office 365 Exchange Online under APIs my organization uses, then click Application permissions, and under Select permissions:

    • Expand Other permissions and check the full_access_as_app box.

    • Expand Calendars an check the Calendars.Read.All box.

  12. Click Add permissions.

    The API permissions page appears and the application permission full_access_as_app and Calendars.Read.All for the Office 365 Exchange Online API are included in the list of Configured permissions.

  13. Click Add a permission, click Microsoft Graph under Commonly used APIs, click Application permissions, scroll to, and expand User permissions, check the User.Read.All box, and click Add permissions.

    The API permissions page appears and the application permission User.Read.All for the Microsoft Graph API is included in the list of Configured permissions.

  14. Click Grant admin consent for <Your tenant name> and Accept on the consent prompt.

    The API permissions page shows the admin consent status for configured permissions as granted for <Your tenant name>.

    Note:

    You must have administrator privileges to grant admin consent to the permissions configured for the application.

    API Permissions page for Exchange Integration Manager in Microsoft Azure.
  15. Click Certificates & secrets under Manage on the left pane.

    The Certificates & secrets page appears.

  16. Click New client secret.

    The Add a client secret window appears.

  17. Enter a Description and select when the client secret Expires, then click Add.

    The Certificates & secrets page shows the client secret you have added.

    Certificates and Secrets page for Exchange Integration Manager in Microsoft Azure.
  18. Copy the Client secret Value and store it in a safe place. You will need this information when configuring Exchange Integration Manager. See Connecting Exchange Integration Manager with Microsoft Entra ID or Exchange Online.