Skip to main content

Modifying the CommonConfig.xml file

Suggest edit Updated on November 10, 2021
Pega Robot Studio v21 Preview

For existing installations, edit the CommonConfig.xml file to change the Security Token Service values. Perform the following steps:

Note: For Robot Studio, you can edit these settings using the Server options menu.
  1. Open the CommonConfig.xml file in a text editor, such as Notepad.
  2. On the Server name=”IdP” line, replace the value for the baseURL key with the applicable value for your organization. The following is an example:
    <Server name="IdP" enabled=”true” baseURL="https://sts-hostname/OSTS/SecurityTokenService.svc/IWSTrustFeb2005" />
  3. Enter a URL for the baseURL key in this format:
    https://sts-hostname/OSTS/SecurityTokenService.svc/IWSTrustFeb2005
  4. Replace sts-hostname with the host name of your server. The following is an example:
    <Servers>
       ...
       <Server name="IdP" enabled=”true” baseURL="https://sts-hostname/OSTS/SecurityTokenService.svc/IWSTrustFeb2005" />
    </Servers>
  5. Optional: Use the proxyAddress key to define a proxy server that can be used to communicate with the server. To disable system-default proxy settings, enter None for the proxyAddress key. For more information, see Common configuration settings.
    Note: In build 8.0.1058, the AD FS server key in the CommonConfig.xml file was changed to IdP server. The IdP server key is used for Robot Manager. If a legacy system still has the AD FS setting instead of the IdP setting, the system uses the AD FS setting.
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us