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.
- Navigate to Azure Portal and sign-in
- Select Azure Active Directory, App registrations
- Click New application registration
- The Application Type must be set to
Web app / API
- Sign-on URL should be set to
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
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.
- Navigate to Required permissions
- Select awisto OfficeIntegration as API
- Tick the checkbox left to Access awisto OfficeIntegration
- 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¶
- Click Manifest
- Click Edit
- Look for
oauth2AllowImplicitFlowand change the value to
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
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¶
- Create a new connector from Import an OpenAPI from URL
- Name is
- 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
Within General Information, you need specify the following settings
|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.|
Update the General Information with the settings above
Within the security setting you need to configure these settings as described within the screenshot below
|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|
|Redirect URL||do not change|
Required security settings
Click in Create connector. Congratulations, you have completed the installation.