Skip to main content
Version: 4

Configuring an OAuth Client in Azure for accessing Graph API

Adeptia Connect supports the use of Microsoft Graph API in mail activities, including Mail Source, Mail Target, Mail Event, Mail Account, and Mail Notification. To enable access to the Graph API, you must configure an OAuth client in the Azure Portal. This involves registering an application in Azure Active Directory, generating client credentials, and assigning the necessary API permissions.

This guide provides a step-by-step process to help you configure the OAuth client in Azure, ensuring secure and authorized access to Microsoft Graph API for Adeptia Connect.

Registering the application (client)​

  1. Log in to the Azure Portal with an account that has administrative privileges.

  2. From the dashboard, select Azure Active Directory.

  3. In the Azure Active Directory menu, click App Registrations and then click + New registration.

  4. On the Register an application screen, do the following:

    1. In the Name field**,** enter a name for the application you register, for example, SharePoint_Integration.

    2. Under the Supported account types section, select the appropriate option based on the intended audience for your application.

    3. Under the Redirect URI section select Web as the platform and enter the Redirect URI in the following format:
      https://<domain>/rest/oauth/account

  5. Click Register to register the application.
    A page containing the details of the newly registered application opens.

  6. Note the Application (client) ID. This serves as the Client ID.

  7. In the left menu, navigate to Certificates & secrets and do the following:

    1. Click + New client secret.

    2. Provide a description and set an expiration period.

    3. Click Add, and copy the Client Secret displayed.

      WarningEnsure you save it securely, as it won’t be displayed again.

Assigning permissions to the application (client)​

  1. Go to API Permissions in the left menu to configure the API permissions. 
  2. Under Configured permissions, click Add a permission**.

    **
  3. On the Request API permissions screen, in the Microsoft APIs tab, do the following:

    1. Select Microsoft Graph.

    2. Under What type of permissions does your application require? field, select Delegated Permissions if you want to use Authorization Code Grant as the OAuth Grant Type. Else skip to step e. 

    3. Add the following permissions:

      1. Mail.ReadWrite

      2. Mail.Send

    4. Click Add permissions.

    5. Under What type of permissions does your application require? field, select Application Permissions if you want to use Client Credentials Grant as the OAuth Grant Type.

    6. Add the following permissions:

      1. Mail.ReadWrite

      2. Mail.Send

    7. Click Add permissions.

  4. On the page that opens next, click Grant admin consent to apply these permissions.