Version: Omada Identity on-premises 16.0.0

Web.config configuration settings

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

Component	Configuration file
Enterprise Server	`Web.config`
Timer Service	`Omada.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 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 Enterprise Server settings that can either be set in the config file:

Setting	Type	Description
`PswEncryptionKey`	String	Specifies the encryption key used to encrypt and decrypt strings. It is important that the key is the same as you use for Omada Provisioning Service.
`ConnStr`	String	Specifies the connection string to the ES SQL database. If you host several environments on the same machine, this should point to the master database.
`SolutionName`	String	Specifies the value of the solution name presented in the web page title.
`CommandTimeout`	Integer	Specifies the timeout (number of seconds) for certain SQL commands.
`LoadBalancerNodeEnabled`	Boolean	Specifies the response returned by the Load balancer page. Possible values are True and False.
`SessionTimeout`	Integer	Specifies the authentication timeout (number of minutes) for Forms, 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.