Solutions

Property substitutions no longer work in system configuration files in IDM 5.5 and 6.x

Last updated Jul 9, 2018

The purpose of this article is to provide assistance if property substitutions do not work in system configuration files after upgrading to IDM 5.5 or later.


1 reader recommends this article

Symptoms

Variables that have been defined in boot.properties are no longer resolved when configuration data is retrieved with REST calls or openidm.read. For example, using an openidm.read() call with the variable in the form &{idm.variable.name} does not result in the expected property value being substituted and instead the literal &{idm.variable.name} is returned.

Recent Changes

Upgraded to IDM 5.5 or later.

Causes

Changes have been made to how system properties are read and variables are no longer automatically substituted. This change makes it easier to administer configurations via REST since you can now configure one server, retrieve the configuration and push it to another server (previously this was not possible since the variables were automatically substituted meaning what you retrieved could not be applied to other servers). Additionally, this change improves security as there is no longer a risk of exposing substituted values over REST, which could contain sensitive data such as passwords.

Solution

This issue can be resolved by using the identityServer.getProperty method to resolve variables in system configuration files.

See Integrator's Guide › Configuring the ServerIntegrator's Guide › Using Property Value Substitution and Integrator's Guide › The identityServer Variable for further information.

See Also

Release Notes › New Features

Integrator's Guide › Specifying the Startup Configuration

Administering and configuring IDM/OpenIDM

Related Training

N/A

Related Issue Tracker IDs

OPENIDM-8523 (ConfigBootstrapHelper should not read system properties directly)

OPENIDM-8521 (Create an EnvironmentVariablePropertyAccessor)



Copyright and TrademarksCopyright © 2018 ForgeRock, all rights reserved.
Loading...