Install the Microsoft Flow Connector

The awisto Office Integration can be integrated with Microsoft Flow. Once the integration is complete, Flow can utilize awisto OfficeIntegration to create documents. The required steps to complete the installation are described within this documentation.

Step 1 - Create the Azure AD Application

As first step you need to create an Azure AD Application for the usage of awisto OfficeIntegration within your environment.

  1. Navigate to Azure Portal and sign-in
  2. Select Azure Active Directory, App registrations
  3. Click New application registration
  4. The Application Type must be set to Web app / API
  5. Sign-on URL should be set to https://europe-001.consent.azure-apim.net/redirect

Create Application
Open the Azure Active Directory within your Azure Portal and create a new application.

Afterwards you should check the Reply URL. As you have already specified during creation of the application, the following URL should already be set as Reply URL https://europe-001.consent.azure-apim.net/redirect

ReplyURL
The reply URLs should already be set

Step 2 - Request Permissions from Users

When you access your application from withing Microsoft Flow, you need to access awisto OfficeIntegration and such request permission to do so.

  1. Navigate to Required permissions
  2. Select awisto OfficeIntegration as API
  3. Tick the checkbox left to Access awisto OfficeIntegration
  4. Click Select and Done

Permission to access awisto OfficeIntegration
Request permission to access awisto OfficeIntegration

awisto OfficeIntegration Swagger is the wrong permission

You may see two APIs named awisto OfficeIntegration. Be sure to not select the API that request Access awisto OfficeIntegration Swagger permission.

Step 3 - Edit Manifest

  1. Click Manifest
  2. Click Edit
  3. Look for oauth2AllowImplicitFlow and change the value to true

Allow oauth2AllowImplicitFlow
Per default oauth2AllowImplicitFlow is set to false, change it to true to allow the usage of oauth2AllowImplicitFlow

Step 4 - Get Application ID and Secret

You will need the information you specified here within Microsoft Flow. First you need to notice the application id of the created application.

AppID
Extract the Application ID from the overview screen

Second, you need to add a new password to the secrets.

Add a Secret
Second you need to add a secret

Important

For security reasons do not store the secret. Create a new secret if you need it again.

Step 3 - Create a Custom Connector within Microsoft Flow

  1. Create a new connector from Import an OpenAPI from URL
  2. Name is awisto OfficeIntregration
  3. Specify https://officeintegration.awisto.cloud/swagger/docs/officeintegration as URL
  4. To proceed, you have to click the blue icon

Create Connection
Create custom connector from Import an OpenAPI from URL

Swagger
Import swagger definition by URL and press arrow afterwards

General Information

Within General Information, you need specify the following settings

Setting Value
Image You can download an icon here
Icon background color #004769
Description awisto OfficeIntegration is your one-click document automation solution for Microsoft Dynamics 365.
Schema HTTPS
Host officeintegration.awisto.cloud
Base URL /

GeneralInformation
Update the General Information with the settings above

Security

Within the security setting you need to configure these settings as described within the screenshot below

Setting Value
Authentication type OAuth 2.0
Identity Provider Azure Active Directory
Client id The application id, you have extracted within the fourth step
Client Secret The secret you have created within the fourth step
Login URL https://login.windows.net
Tenant ID common
Ressource URL https://officeintegration.awisto.cloud
Scope user_impersonation
Redirect URL do not change

SecuritySetting
Required security settings

Complete

Click in Create connector. Congratulations, you have completed the installation.

Settings
Installation complete