Skip to main content
Version: Omada Identity on-premises 16.0.1

Web.config configuration settings

Omada recommends using configuration files to configure several of the Enterprise Server (ES) settings. The following configuration files are used across Omada components:

ComponentConfiguration file
ESWeb.config
Timer ServiceOmada.OE.Service.exe.config
Omada Provisioning Service (OPS)Omada.OPS.Service.exe.config
Role and Policy Engine (RoPE)Omada.RoPE.EngineExecutor.exe.config (references ConfigFiles\ConnectionStrings.config, ConfigFiles\AppSettings.config, ConfigFiles\EngineConfiguration.config)
Data Warehouse (ODW)Omada ODW ConnectionString.dtsConfig, Omada ODW WebService.dtsConfig
info

The Data Warehouse uses Microsoft SQL Server Integration Services (SSIS) configuration files (.dtsConfig) located in the ODW installation folder, rather than the .exe.config format used by other Omada Windows services.

The Web.config file allows you to configure several of the ES settings that can either be set in the config file:

SettingTypeDescription
PswEncryptionKeyStringSpecifies the encryption key used to encrypt and decrypt strings. It is important that the key is the same as you use for OPS.
ConnStrStringSpecifies the connection string to the ES Structured Query Language (SQL) database. If you host several environments on the same machine, this should point to the master database.
SolutionNameStringSpecifies the value of the solution name presented in the web page title.
CommandTimeoutIntegerSpecifies the timeout (number of seconds) for certain SQL commands.
LoadBalancerNodeEnabledBooleanSpecifies the response returned by the Load balancer page. Possible values are True and False.
SessionTimeoutIntegerSpecifies the authentication timeout (number of minutes) for Forms, Security Assertion Markup Language (SAML) and OpenID logon, as well as integrated authentication.

The settings should be configured as follows:

<appSettings>
<add key="ConnStr" value=""/>
<add key="CommandTimeout" value=""/>
<add key="SolutionName" value=""/>
<add key="LoadBalancerNodeEnabled" value=""/>
<add key="SessionTimeout" value=""/>
<add key="PswEncryptionKey" value=""/>
</appSettings>

These settings can also be set via the Omada.OE.Service.config file for the timer service.

info

Changing PswEncryptionKey after it has been used to encrypt data should be performed with caution as an incorrect update may lose data or Omada Identity unresponsive.