Generating a universal link for WorkflowGen Plus v2

Mobile
1

As of WorkflowGen server version 7.16.0, you can generate a universal link to simplify the login process for your WorkflowGen Plus v2 mobile app users. Once you’ve generated the universal link, give it to your users, who can use it to sign into WorkflowGen Plus v2 with the preset sign-in method.

For instructions on how to log in using Azure AD, AD FS 2016 or later, Auth0, Okta, or classic methods, see the WorkflowGen Plus v2 sign-in and authentication topic.

Base URLs

The protocol and hostname base URLs are common to all authentication methods:

Parameter Value
protocol workflowgenplus://
hostname auth.init

Microsoft Azure AD parameters

Parameter Value
provider ms-identity-v2
server_address Your WorkflowGen web application URL (e.g. https://mycompany.com/wfgen)
Note: This value must be URL encoded.
client_id Use the application (client) ID you created in the Azure AD configuration for WorkflowGen Plus v2 (e.g. 4b72dd6c-013e-4a9c-b837-f03a58cb8fd1)
tenant_id Use the directory (tenant) ID you created in the Azure AD configuration for WorkflowGen Plus v2 (e.g. 6g909d00-8580-49a4-9003-a30f6b87ae86)
audience Your WorkflowGen GraphQL API URL (e.g. https://mycompany.com/wfgen/graphql)
Note: This value must be URL encoded.

The universal link should follow this format:

workflowgenplus://auth.init?provider=ms-identity-v2&server_address=https%3A%2F%2Fmycompany.com%2Fwfgen&client_id=4b72dd6c-013e-4a9c-b837-f03a58cb8fd1&tenant_id=6g909d00-8580-49a4-9003-a30f6b87ae86&audience=https%3A%2F%2Fmycompany.com%2Fwfgen%2Fgraphql

Microsoft AD FS parameters

Parameter Value
provider adfs
server_address Your WorkflowGen web application URL (e.g. https://mycompany.com/wfgen)
Note: This value must be URL encoded.
client_id Use the client ID you created in the AD FS 2016 configuration for mobile apps (e.g. 6g909d00-8580-49a4-9003-a30f6b87ae86)
domain The AD FS domain name without the URL protocol (e.g. mycompany.com)
audience Your WorkflowGen GraphQL API URL (e.g. https://mycompany.com/wfgen/graphql).
Note: This value must be URL encoded.

The universal link should follow this format:

workflowgenplus://auth.init?provider=adfs&server_address=https%3A%2F%2Fmycompany.com%2Fwfgen&client_id=6g909d00-8580-49a4-9003-a30f6b87ae86&domain=mycompany.com&audience=https%3A%2F%2Fmycompany.com%2Fwfgen%2Fgraphql

Auth0 parameters

Parameter Value
provider auth0
server_address Your WorkflowGen web application URL (e.g. https://mycompany.com/wfgen)
Note: This value must be URL encoded.
client_id Use the client ID you created in the Auth0 configuration for mobile apps (e.g. 7gdj4hs92y)
domain The Auth0 domain name without the URL protocol (e.g mydomain.auth0.com)
audience Your WorkflowGen GraphQL API URL (e.g. https://mycompany.com/wfgen/graphql).
Note: This value must be URL encoded.

The universal link should follow this format:

workflowgenplus://auth.init?provider=auth0&server_address=https%3A%2F%2Fmycompany.com%2Fwfgen&client_id=7gdj4hs92y&domain=mydomain.auth0.com&audience=https%3A%2F%2Fmycompany.com%2Fwfgen%2Fgraphql

Okta parameters

Parameter Value
provider okta
server_address Your WorkflowGen web application URL (e.g. https://mycompany.com/wfgen)
Note: This value must be URL encoded.
client_id Use the client ID you created in the Okta configuration for mobile apps (e.g. 0o7gdj4hs92yh7)
metadata_url The Okta domain name without the URL protocol (e.g. https://dev-958754.oktapreview.com/oauth2/{AUTH_SERVER_ID}/.well-known/openid-configuration)
Note: This value must be URL encoded.
audience Your WorkflowGen GraphQL API URL (e.g. https://mycompany.com/wfgen/graphql).
Note: This value must be URL encoded.

The universal link should follow this format:

workflowgenplus://auth.init?provider=okta&server_address=https%3A%2F%2Fmycompany.com%2Fwfgen&client_id=0o7gdj4hs92yh7& metadata_url=https%3A%2F%2Fdev-958754.oktapreview.com%2Foauth2%2F{AUTH_SERVER_ID}%2F.well-known%2Fopenid-configuration&audience=https%3A%2F%2Fmycompany.com%2Fwfgen%2Fgraphql