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 Microsoft Entra ID (formerly 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 Entra ID (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 Microsoft Entra ID configuration for WorkflowGen Plus v2 (e.g. 4b72dd6c-013e-4a9c-b837-f03a58cb8fd1 ) |
tenant_id |
Use the directory (tenant) ID you created in the Microsoft Entra ID configuration for WorkflowGen Plus v2 |
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
AD FS 2016 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 WorkflowGen Plus v2 (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 WorkflowGen Plus v2 (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 WorkflowGen Plus v2 (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