Installation

General

This document provides guidance on installing and configuring the OAuth2 Graph API App.

Prerequisites

System and Version

System	Version
Novacura Flow Server	6.14
Novacura Flow Studio	6.14
Connectors	REST Service

Installation Components

Service	Link
Microsoft Graph API Reference: List Messages	https://docs.microsoft.com/en-us/graph/api/user-list-messages?view=graph-rest-1.0&tabs=http
Microsoft Graph API Reference: List Attachments	https://docs.microsoft.com/en-us/graph/api/message-list-attachments?view=graph-rest-1.0&tabs=http
Microsoft OAuth 2.0 Authorization Code FLow	https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow

Azure Services

Microsoft Graph

Create an App Registration for reading emails and attachments in a unified inbox. The App Registration needs Mail.Read permissions to be able to access the mailbox.

You will need to add additional permissions if you plan to utilize more functionality against the Graph API in other workflows.

Read more in the how-to guides Create App Registration and Limit Permissions to a Specific Mailbox.

• Navigate to the registered Microsoft Graph application's Authentication page

• Add ncflow://authenticate value to Mobile and desktop applications' Redirect URIs' list

• Add https://web.novacuraflow.com/ value to Mobile and desktop applications' Redirect URIs' list

The ncflow://ncflowsuccess value is needed instead, if it is used External App Launcher integration call back.

• For this Flow to work to read your attachments of your mailbox, two REST APIs are used: List Messages and List Attachments.

• Please read up on the Permissions needed to use this API at the respective links.

Flow Connectors

REST Connector

Microsoft Graph API

A REST Connector Project must be set up to utilize Microsoft Graph APIs.

Create a new REST Service Connector named "Microsoft Graph REST" and import the configuration file "Microsoft Graph REST.ncrcp." For more information see Import a REST Configuration.

• Enter a Base Address https://graph.microsoft.com

• Set up the parameters for OAuth2 authentication

Parameter	Value	Description	Required
Enabledb	Checked✔️	To enable OAuth2 Authentication in REST connector
Access Token URLec	https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token	URL to get token
Auth URLR	https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize	URL to authorize
Client ID	{client_id}	The Application (client) ID that the Azure portal – App registrations experience assigned to your app.
Client Secret	{client_secret}	The application secret that you created in the app registration portal for your app. You shouldn't use the application secret in a native app or single page app because client_secrets stored on devices or web pages are not reliable.
Scope	https://graph.microsoft.com/.default	For ID tokens, must be updated to include the ID token scopes - openid, and optionally profile and email.
Extra query parameters	{"login_hint": "[email protected]", "prompt": "login"}	To add extra paramters if needed. It has to be in JSON format.

Installation

Make sure that you have created all services, connectors, and Flow properties before importing the workflows.

1. Import Workflows

Import workflows in the file "Outlook Attachment Component 2.0.0.wap".

For additional details see Import Workflows.

2. Setting Menu Roles

Together with the imported workflows there will also be a menu. Connect the menu to your roles to make them available for users.

For details see Setting Menu Roles.

3. Publishing Workflows

Within the Server Contents Window right-click on the Form Recognizer folder and select “Publish”. This process can take a few minutes but once complete, a Publish Successful message will be displayed.

If you receive any errors during the publication of the workflow. Please review the error detail and consult your support contact with the relevant information.

The workflows will now be available to execute on your chosen Flow client.

For details see Publishing Workflows.