web.config
file, iisnode configuration for Node.js applications, database connection strings, etc. Everything is configurable via an environment variable except the license file, which is configured via a volume.WFGEN_ADMIN_USERNAME
[email protected]
, then you can set this environment variable to this username and authenticate with it in the container to have administrative access to WorkflowGen.
✏️ Note: If you change this, make sure to update the database as well.wfgen_admin
(default)WFGEN_DATABASE_CONNECTION_STRING
WFGEN_DATABASE_READONLY_
CONNECTION_STRING
WFGEN_AUTH_MODE
adfs
application
(default)auth0
azure-v1
basic
ms-identity-v2
okta
windows
WFGEN_GEN_APP_SYM_ENCRYPT_KEY
ApplicationSecurityPasswordSymmetricEncryptionKey
should be generated if no value is providedY
, the ApplicationSecurityPasswordSymmetricEncryptionKey
is regenerated when the container restarts. It is not compatible for usage in production because the secrets will be encrypted with different keys. Therefore, use Y
only for developing or testing a single container scenario.Y
(default), N
WFGEN_LICENSE_FILE_NAME
C:\licenses
volumeWFGEN_START_SERVICE
all
(default)dir_sync
engine
web_apps
win_services
WFGEN_MACHINE_KEY_VALIDATION_KEY
validationKey
property of the machineKey
element in the web.config
fileWFGEN_MACHINE_KEY_DECRYPTION_KEY
decryptionKey
property of the machineKey
element in the web.config
fileWFGEN_MACHINE_KEY_VALIDATION_ALG
machineKey
element in the web.config
fileHMACSHA256
WFGEN_MACHINE_KEY_DECRYPTION_ALG
machineKey
element in the web.config
fileAES
WFGEN_DEPENDENCY_CHECK_INTERVAL
1000
(1 second)WFGEN_DEPENDENCY_CHECK_RETRIES
10
WFGEN_DEPENDENCY_CHECK_ENABLED
Y
(default), N
WFGEN_GRAPHQL_CORS_ENABLED
Y
(default), N
WFGEN_GRAPHQL_CORS_ALLOWED_ORIGINS
*
web.config
web.config
file is the main point of configuration. Since a container is by definition ephemeral, any changes made in the Configuration Panel would not persist between container restarts. web.config
file, you need to use a specific format for an environment variable that will contain the value of the property you want to set; this format is WFGEN_APP_SETTING_<name>
. ApplicationUrl
property in the web.config
to https://mycorporation.com/wfgen
, you would set the WFGEN_APP_SETTING_ApplicationUrl=https://mycorporation.com/wfgen
environment variable in the container.run
commandweb.config
parameters and their descriptions and possible values, see the Web and Application Configuration Parameters appendix in the WorkflowGen Technical Guide.WFGEN_IISNODE_<node name>_<property name>
. <node name>
with the name of the Node.js application (AUTH
, HOOKS
, GRAPHQL
, or SCIM
).
<property name>
with the name of the property you want to set for the <iisnode/>
XML node in the specific Node.js application's web.config
file.loggingEnabled
property in the Auth application to true
, you would set the environment variable WFGEN_IISNODE_AUTH_loggingEnabled=true
.run
commandWFGEN_ENABLE_IISNODE_OPTION_<node app name>
. Then, you replace <node app name>
with the name of the Node.js application (AUTH
for example) and the value must be one of the following:exposelogs
https://example.com/wfgen/auth/iisnode
if the chosen Node.js application is AUTH
. WFGEN_TRACE_<component>_<option>=<value>
template with <component>
as the name of the component you want to set the option on, <option>
as the name of the option you want to set, and <value>
as the value of the option.WEB_APPS
(web applications)ENGINE
(engine service)DIR_SYNC
(directory synchronization service)NODE
(Node.js components)LEVEL
ActivityTracing
All
Critical
Error
Information
Off
(default)Verbose
Warning
INDENT
4
(maximum: 8
)2
and only trace errors for the engine with an indentation of 0
, you would configure the environment variables as follows:WFGEN_DATABASE_CONNECTION_STRING
environment variable. You can put any string in this variable and its value will be put in WorkflowGen's web.config
file at the MainDbSource
connection string.run
command:WFGEN_DATABASE_READONLY_CONNECTION_STRING
environment variable. It will be added to WorkflowGen's web.config
file as a new entry in the connection strings with the name ReadOnlyDbSource
.run
command:WFGEN_CUSTOM_CONNECTION_STRING_<name>=<connection_string>
. MyDataSource
with the connection string value of MyConnectionString
in the WorkflowGen web.config
, you would specify the following environment variable: WFGEN_CUSTOM_CONNECTION_STRING_MyDataSource=MyConnectionString
.run
command_FILE
and set its value to the path of the file containing the secret. The container will then get the value in the file at the specified path and set the environment variable without the suffix with that value.web.config
to WFG-SOME-LICENSE-KEY
using the environment variable WFGEN_APP_SETTING_ApplicationSerialNumber
, but you want to use a secret for the value. All you have to do is suffix the environment variable name with _FILE
so it becomes WFGEN_APP_SETTING_ApplicationSerialNumber_FILE
. Then, set the value of this variable to the path of the file containing the serial number.WFGEN_APP_SETTING_ApplicationUrl
and WFGEN_APP_SETTING_ApplicationSerialNumber
in order to avoid unwanted behaviors.wfgen_admin
.WFGEN_AUTH_MODE
variable. For configuration instructions, see the WorkflowGen for Azure guide.WFGEN_AUTH_MODE
variable. For configuration instructions, see the WorkflowGen Technical Guide.C:\ProgramData\Docker\volumes\licenses\_data
) managed by Docker. You can get the path to the volume by executing the following command:set-state.ps1
script once.<wfgen appdata>\Templates\server\offline.htm
. If this file is present, it will be taken instead of the default one. If you have a volume for WorkflowGen's data, you can execute the following script: