Changing Info*Engine Request Validation Properties
As part of your installation, Windchill solutions automatically set the value for the secret.text2 and secret.text properties in the ie.properties file to large randomly-generated strings containing a mixture of digits and mixed case characters. These values are automatically encrypted and stored in the Windchill keystore so they are not readable. Both properties are used to sign and validate requests between Info*Engine components to verify their authenticity.
The values that are set through the installation should be sufficiently unique that there should be no real need to reset these property values. If you choose to reset the values, you can use the following instructions. The instructions specifically reference secret.text2, however, you can use the same instructions to change the secret.text property.
Setting the secret.text2 property in the ie.properties file provides an arbitrary text string, similar to a password, that is used to sign outgoing requests and validate incoming requests. Similar to other service-specific Info*Engine properties, the property names must include a prefix of the runtime service name of the service to which the property applies. If it is unclear what the full name of your property should be, examine the contents of the <Windchill>/codebase/WEB-INF/ie.properties file to see the automatically generated properties created by the installers. For security reasons, PTC suggests that the secret properties be placed only in ie.properties files and not in LDAP configuration. When multiple, separate installations are involved, and you want to allow communications between services, the secret property values for all services involved must be duplicated between all ie.properties files so that systems generating requests can properly sign them.
Use the following procedure to change the value of the secret.text2 property in the ie.properties file:
1. Determine the value to assign the secret.text2 property. PTC recommends using a secret.text value between 6 and 18 characters. The ie.properties file is located in the <Windchill>/codebase/WEB-INF directory.
2. Use the xconfmanager to change the secret.text2 property to a value of your choice and to update the site.xconf file.
From a windchill shell, execute the following command:
xconfmanager -p -s
"<runTimeServiceName>.secret.text2=<your_secret_value>" -t "<Windchill>\codebase\WEB-INF\ieStructProperties.txt"
Where <your_secret_value> is an arbitrary text string and <Windchill> is the location where Windchill is installed.
Any change you make to the secret.text2 property value must also be applied to the configuration of any remote services that will make requests into your Windchill system. Likewise, any similar configuration for remote Windchill systems, or out-of-process adapters, that your system will communicate with must be duplicated in your ie.properties file.