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

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

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

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

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.

Extract the Application ID from the overview screen

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

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 custom connector from Import an OpenAPI from URL

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	/

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

Required security settings

Complete

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

Installation complete