arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Microsoft Entra ID Configuration for the WorkflowGen CLI

circle-exclamation

Azure Active Directory (Azure AD) has been renamed Microsoft Entra ID (ME-ID). While the WorkflowGen documentation has been updated to reflect this name change, the WorkflowGen application settings still refer to Azure AD (for example, Azure AD SCIM v2 directory connector).

Likewise, certain ME-ID configuration items in the Azure portal have been renamed and/or moved. The WorkflowGen documentation has been updated accordingly, but still might not be completely accurate in this regard. See the documentation for more information.

hashtag
Prerequisites

  • Make sure to have a licensed copy of WorkflowGen installed and running on an IIS web server in HTTPS secure connection mode.

  • Make sure to have Microsoft Entra ID (ME-ID) administrator access to be able to configure it.

  • Make sure to have provisioned an existing ME-ID user with which you can authenticate to WorkflowGen so that you can use the application afterwards.

  • Make sure to have successfully configured delegated authentication to ME-ID with the Microsoft Identity Platform v2.0 provider on your WorkflowGen instance following the instructions in the section with the WorkflowGen GraphQL API application registered as well.

hashtag
Interactive mode

hashtag
Microsoft Entra ID configuration

This configuration is done in three steps. First, you have to register a new native application in ME-ID. Then, you have to give the application the necessary permissions to access the WorkflowGen GraphQL API. Finally, you have to register the correct callback URLs that will redirect within the native application.

hashtag
Step 1: Register a new native application

  1. In the Azure portal, click App registrations in the Azure services section.

  2. Click New registration, and fill in the properties:

You've now successfully registered your WorkflowGen CLI native application in ME-ID.

hashtag
Step 2: Grant access to the GraphQL API

  1. Click API permissions.

  2. In the Configured permissions section, click Add a permission.

  3. Click My APIs, then select the WorkflowGen GraphQL API application in the list.

hashtag
Review the registration

Take note of the information you'll need later on:

  • A client ID: This is the application (client) ID in the Overview section of your application registration.

  • A tenant ID: This is the directory (tenant) ID in the Overview section of your application registration.

You'll need to give this information to the users who will be using the WorkflowGen CLI.

hashtag
Non-interactive mode

The configuration of non-interactive mode is the same as in the section.

Name: WorkflowGen CLI
  • Supported account types: Accounts in this organizational directory only (Default Directory only - Single tenant) ✏️ Note: Depending on the context, you should choose the right option for your use case for the supported account type value.

  • Redirect URI:

    • Platform: Public client/native (mobile & desktop)

    • Value: http://127.0.0.1:8888/callback

  • ✏️ Note: Port 8888 is defined by default; you can change it if it's already in use on your computer.

  • Click Register at the bottom of the page.

  • Click Delegated permissions and check default under the Permission column.

  • Click Add permissions.

  • On the API permissions page, click Grant admin consent for <your tenant name>, then click Yes.

  • circle-check

    You've now successfully registered the WorkflowGen CLI in Microsoft Entra ID.

    Microsoft Entra ID Authentication
    Microsoft Entra ID Configuration for Server-Side Scripts
    Microsoft Entra IDarrow-up-right