Microsoft Graph Integration


About This Integration

IntegrationIntroduction

You can integrate third-party systems with Product name - ev itsm.png in many ways. The method you select will depend on business requirements, architectural and security constraints as well as the characteristics specific to each third-party application or service.

This document describes an integration process that has already been implemented in a customer context. 

To find out more about this integration (e.g. scripts to be used), please contact the Logo - EasyVista.png Consulting & Professional Services team, the Logo - EasyVista.png Support team, or your service provider and integrator.
 

Overview of the integration

Microsoft Graph is used to create a gateway for accessing all data available in Microsoft Cloud Services (Microsoft 365, Windows 10 and Enterprise Mobility + Security). This gateway is especially useful if you want to access cloud data from an automatic workflow creation tool, such as Microsoft Power Automate (formerly known as Microsoft Flow), and if the tool does not provide a standard connector for data access. Open url.png See the use case.

  • You can create a gateway in Microsoft Graph via a logic app created on the MS Azure portal.
  • The logic app uses the MS Graph API to access emails, calendars, contacts, documents, etc.
  • The data can then be read in an automatic workflow creation tool.
     

This integration enables you to create a logic app using the MS Graph API. You can then enable the gateway in your automatic workflow creation tool.

Use case

Access Microsoft Bookings data via Microsoft Power Automate to plan and manage business customer appointments in the tool.

Issue
The Microsoft Bookings connector is not shipped in the standard MS Power Automate version.

Solution

Step-by-Step Integration Process

Prerequisites

Notes

Creating a logic app using the Microsoft Graph API

Step 1: Access the Azure portal.

1. Log in to the Azure portal using your Azure account login.
 

Step 2: Initialize the logic app.

1. Select the Azure Active Directory service.

         Azure Active Directory resource - Selection.png

Tenant information is displayed.

2. Click Copy icon.png to copy the tenant ID (Tenant ID variable) and paste it in your text editor in order to store it temporarily. It will be required when enabling the gateway in your automatic workflow creation tool.

         Azure Active Directory resource - Tenant ID.png
 

Step 3: Register the logic app on the Azure portal.

1. Select App registrations in the left pane and click + New registration.

         App registration - Creation.png

2. Specify the information required for registering the application.

  • Name: Name of the logic app.
             example  MicrosoftBookingBusiness
  • Supported account types: Select the type of account you want to use.
        Open url.png See the description of options.

         App registration - Information.png

3. Click Register.

  • The logic app is created.
  • A list of IDs is displayed.

4. Click Copy icon.png to copy the app ID (Application (client) ID variable) and paste it in your text editor in order to store it temporarily. It will be required when enabling the gateway in your automatic workflow creation tool.

         App registration - App ID.png
 

Step 4: Add MS Graph permissions to access data.

1. Select App permissions in the left pane and click + Add a permission.

         App permissions - Creation.png

The list of Microsoft APIs available is displayed.

2. Select the Microsoft Graph API.

         App permissions - API list.png

3. Select the type of permission for this API.
         Open url.png See the Microsoft documentation called Use the Microsoft Bookings API in Microsoft Graph, Permissions section.

         App permissions - Selection.png

example  For Microsoft Bookings, add Delegated rights

App permissions - Microsoft Booking example.png

4. Filter rights for Microsoft Bookings.

  • Enter the expression, booking in the Select permissions field.
    The list of rights that can be added will appear.
             App permissions - Filter.png
  • Select all of the rights you want.
  • Click Add permissions.
     

Step 5: Create a client secret to be used by the logic app for authentication in Microsoft Bookings.

1. Select Certificates & secrets in the left pane and click + New client secret.

         Secret - Creation.png

2. Specify the information required for creating the client secret.

  • Description: Description of the client secret.
  • Expires: Select the validity end date for the client secret.

         Secret - Information.png

3. Click Add.

4. Click Copy icon.png to copy the value of the client secret (Client secrets > Value variable) and paste it in your text editor in order to store it temporarily. It will be required when enabling the gateway in your automatic workflow creation tool.

         Secret - Key value.png

  • The logic app can now connect to Microsoft Graph.
  • It can be accessed by an automatic workflow creation tool by calling the MS Graph API.

Step 6: Integrate the third-party product using Microsoft Graph.

    Open url.png See the example: Microsoft Bookings integration (via MS Power Automate) using MS Graph.


AccountFreeCreation

How to create a free Azure account

1. Go to the Microsoft Azure website.

2. Click Start free.

         Microsoft Flow - Free account.png

3. Log in to your professional Microsoft account.
         Microsoft Flow - Login account.png

4. Enter the login information.
         Microsoft Flow - Account creation - Identification 1.png

5. Click Next.

6. Tick the I agree box.
         Microsoft Flow - Account creation - Identification 2.png

7. Click Sign up.

Links to other integrations

Tags:
Last modified by Unknown User on 2020/07/29 13:57
Created by Administrator XWiki on 2020/07/29 13:57

Shortcuts

Powered by XWiki ©, EasyVista 2020