Create and Configure OAuth App for Graph in Azure

  • Updated

To create a Graph Azure application for Riva:

  1. Register an application.

  2. Configure the authentication.

  3. Set the API permissions.

Step 1: Register an Application

  1. Log in to the Azure portal as your company's Riva connection user, for example, our-Riva-admin@our-domain.com.

  2. From the Portal, select App Registrations, and click New Registration.

  3. In the Name field, enter the application's title. 

  4. At the bottom of the pane, select Register.

AzureGraphConnection.png

Result: The application is created.

GraphIds.png

  1. Locate the Application (client) ID and the Directory (Tenant) ID, and copy them.

    Note: It will be used as the Client ID and Tenant ID in the connection.

Step 2: Configure the Authentication

Authentication Tab

  1. On the left menu, under Manage, select the Authentication tab.

  2. Under Platform Configurations, select Add a Platform.

  3. On the Configure platforms pane that appears to the right, select Mobile and desktop applications.

  4. On the Configure Desktop + devices pane that appears, below Custom redirect URIs, add a custom URI.

    Note: The custom URI can be whatever you want & it will be used as the Redirect URL in the connection later. (Example - myapp://auth)

  5. At the bottom of the pane, select Configure.

    KB-2225-Authentication--Configure-Desktop-and-devices-.png

Certificates & Secrets Tab

  1. On the left menu, select the Certificates & Secrets tab.

  2. On the Certificates & Secrets pane that appears to the right, below Client Secrets, select New Client Secret.

  3. Enter a name for the client secret, set the expiry date, and select Add.

    Note: Setting  a custom expiry beyond 24 months is not applicable. 

GraphClientSecret.png

  • Copy the Value to a secure place. Note: It will be used as the Client Secret in the connection.
WARNING: After leaving this page, you can no longer retrieve this value.

 

Step 3: Set the API Permissions

  1. On the left menu, select the API permissions tab.

  2. Select Add a Permission, and then select Microsoft Graph and Application Permissions.

    1. To know more about permissions required by Riva or to limit permissions, click here

      KB-2225--API-Permissions.png
    2. On the permissions list, select Calendars.ReadWriteMail.ReadWrite, and User.Read.All and then select Add permissions.

      1.  User.Read is a delegated permission and is added by default, and is assigned automatically on app creation; all others are application permissions.

  3. Select the Grant admin access for [the name of your app] check box, and then click Yes.

GraphGrantConset.png

  • The Status on all of the permissions will be set to "Granted for [the name of your app]".

GraphConsent.png

Was this article helpful?

/