Introduction to configuration placeholders
Identity Cloud lets you add placeholders to your configuration so you can reference the value of an ESV variable instead of defining a static value.
For example, if you created an ESV variable with the name esv-email-provider-port
, you could reference its value by adding a placeholder of {"$int" : "&{esv.email.provider.port}"}
to your configuration.
To set a default value in a configuration placeholder, include it after a vertical bar. For example, the following expression sets a default email provider port of 465: {"$int" : "&{esv.email.provider.port|465}"}
. If no ESV is set, the default value of 465 is used instead.
If you add a placeholder to your configuration, and do not set a corresponding ESV or specify a default value, you will not be able to complete a successful promotion.
A configuration property can include a mix of static values and placeholders. For example, if you set esv-hostname
to id
, then &{esv.hostname}.example.com
evaluates to id.example.com
.
Manage placeholders
You can view placeholders in the Identity Cloud admin UI; however, they are read only.
You can manage placeholders using the REST API. Refer to Manage configuration placeholders using the API.