03 March 2025

Edit Website Configuration Files

You can edit website .config files used by ebs, although some sections of .config files might require decryption.

You must adjust installer settings so that any changes made to .config files are not overwritten during an upgrade.

Edit website configuration files for:

To configure Identity Services for ebs: ontrack Hub and ebs: ontrack Learner Hub, make the following changes to the web.config file.

Standard install locations:

  • \Program Files\tribal_instance\ebs4\TribalTech.EBS.Agent5\web.config for ebs: ontrack Hub

  • \Program Files\tribal_instance\ebs4\OntrackLearner\web.config for ebs: ontrack Learner Hub

To use external authentication, set:

  • system.web\Authentication mode to 'None'

To use Dual Authentication, set:

  • system.web\Authentication mode to 'Forms'

  • appSettings\EnableIdentityServer to 'Y'

  • appSettings\IdentityServerCookieDomain to match the ontrack domain name, usually the domain name specified in the <authentication><forms> section (for example: tribalgroup.net)

  • appSettings\EnableDualAuthentication to 'Y' to offer the choice of using ebs or external credentials

  • appSettings\IdentityServerClientSecret to the client secret generated in the authentication provider

You must adjust installer settings so that any changes made to .config files are not overwritten during an upgrade.

To configure Identity Services for ebs: ontrack Teaching and Learning, make the following changes to the web.config file.

  • Standard install location:

    • (\Program Files\tribal_instance\ebs4\estWeb\web.config

  • If solely using external authentication, set:

    • system.web\Authentication mode to 'None'

  • To use Dual Authentication, set:

    • system.web\Authentication mode to 'Forms'

Make the following changes to the appSettings.config file.

  • Standard install location:

    • \Program Files\tribal_instance\ebs4\estWeb\appSettings.config

  • Set:

    • appSettings\EnableIdentityServer to 'Y'

    • appSettings\IdentityServerCookieDomain to match the current domain name

    • appSettings\EnableDualAuthentication to 'Y' if wishing to offer the choice of using ebs or external credentials

    • appSettings\IdentityServerClientSecret to the client secret generated in the authentication provider

You must adjust installer settings so that any changes made to .config files are not overwritten during an upgrade.

Refer to Communities for further information about decryption and encryption of .config files.