DocumentationWorkfrontWorkfront Guide

Call the MS Graph REST API via the Adobe Workfront Fusion HTTP > Make an OAuth 2.0 request module

Last update: Fri Feb 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

Many Microsoft web services are accessed through the Microsoft Graph API. This article describes how to create a connection to that API, using the Workfront Fusion HTTP > Make an OAuth 2.0 request module.

Access requirements

You must have the following access to use the functionality in this article:

Adobe Workfront plan*
Pro or higher
Adobe Workfront license*
Plan, Work
Adobe Workfront Fusion license**

Current license requirement: No Workfront Fusion license requirement.

Or

Legacy license requirement: Workfront Fusion for Work Automation and Integration

Product

Current product requirement: If you have the Select or Prime Adobe Workfront Plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

To find out what plan, license type, or access you have, contact your Workfront administrator.

For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.

Register Workfront Fusion in the Microsoft Application Registration Portal

To create a connection to the Microsoft Graph REST API, you must first register Adobe Workfront Fusion.

  1. Begin registering a new application as described in Register your app in the Microsoft documentation.

    As part of the registration, Microsoft requires the following information:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Application name Enter a name for the application, such as "My Workfront Fusion application."
    Redirect URL https://app.workfrontfusion.com/oauth/cb/oauth2

  2. When you have completed the app registration, make note of the Application ID.

    note important
    IMPORTANT
    You will need the Application ID to set up your connection in Workfront Fusion.

  3. Generate an Application Secret. Make note of this secret.

    For instructions, see Register your app in the Microsoft documentation.

    note important
    IMPORTANT
    You will need the Application Secret to set up your connection in Workfront Fusion.

  4. Configure the permissions for your application.

    For specifics on locating and configuring these fields, see the “Configure permissions for Microsoft Graph” section in Get access without a user in the Microsoft documentation.

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    What type of permissions does your application require? Select Delegated permissions.
    Select permissions

    Select the following permissions:

    • offline_access

    • openid

    • Any other permissions required by your integrations (Example: User.Read)

    Important: You will need the selected permissions to set up your connection in Workfront Fusion.

  5. Proceed to Configure your MS Graph API connection in Workfront Fusion.

Configure your MS Graph API connection in Workfront Fusion

After you register Workfront Fusion as discussed in Register Workfront Fusion in the Microsoft Application Registration Portal, you can configure your connection in the HTTP >Make an Oauth 2.0 request module.

  1. Add an HTTP >Make an OAuth 2.0 call module to your scenario.

  2. Click Add next to the connection field.

  3. Configure the connection fields as follows:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 layout-auto html-authored no-header
    Connection name Enter a name for the connection.
    Flow type Authorization Code
    Authorize URI https://login.microsoftonline.com/common/oauth2/v2.0/authorize
    Token URI https://login.microsoftonline.com/common/oauth2/v2.0/token
    Scope

    Enter the permissions that you selected in step 4 of Register Workfront Fusion in the Microsoft Application Registration Portal.

    For each scope, click Add and type in the permission.

    Example: offline_access.
    Scope separator SPACE
    Client ID Enter the Application ID from step 2 in Register Workfront Fusion in the Microsoft Application Registration Portal.
    Client Secret Enter the Application Secret that you generated in step 2 in Register Workfront Fusion in the Microsoft Application Registration Portal.
    Authorize parameters

    Add the following Authorize parameters:

    • Key: response_mode Value: query

    • Key: prompt Value: consent
    Access token parameters You do not need to enter anything into this field.
    Refresh token parameters

    1. Click Add.

    2. In the Key field, enter scope.

    3. In the Value field, enter all of the scopes that you entered into the scope field, separated by spaces.

      Example: offline_access openid User.Read
    Custom Headers You do not need to enter anything into this field.
    Token Placement In the header

  4. Click Continue.

  5. In the window that appears, click Accept to complete the connection and return to the module.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43