Configure Authentication Credentials
HTTP SSL Username and Password
For Windchill to call the Servigistics InService A&DPublish task, the Servigistics InService A&D superadmin credentials are required to authenticate against the Servigistics InService A&D server. The username for Servigistics InService A&D is stored as a Windchill property. The password for Servigistics InService A&D is stored as an encrypted property in Windchill’s secure Key Store.
For further information, see
Encrypted Passwords. The topic details how passwords are encrypted on a
Windchill server.
Shared Credentials for all Hosts
Take these steps to set up Windchill properties that associate a username and password with all Servigistics InService A&D hosts.
To encrypt an Servigistics InService A&D password property for all Servigistics InService A&D hosts:
1. Open a Windchill shell.
2. Run this command (replacing <password> with the superadmin password):
ant –f %WT_HOME%/bin/adminTools/sip/EncryptPasswords.xml encryptPw -DpropertyName=inserviceaad.superAdminUserPassword -Dpassword=<password>
3. Check the output for a report of BUILD SUCCESSFUL. This indicates that the password has been encrypted.
4. Restart the Windchill server (alerting users if needed).
To change the default superadmin username (if you do not want to use the default username superadmin):
1. Using a folder explorer, navigate to the site.xconf file at this location:
<WINDCHILL>/site.xconf
2. Open the file in a text editor and scroll to the end.
3. Add these property entries, replacing <username> with the required superadmin username.
<Property name="inserviceaad.superAdminUserName" overridable="true" value="<username>" targetFile="codebase/config/rules/rules.properties"/>
4. Save the site.xconf file.
5. Open a Windchill shell.
6. Run:
xconfmanager –pF
7. Restart the Windchill server (alerting the appropriate users first).
Individual Credentials for a Host
Take these steps to set up Windchill properties that associate a username and password with a specific Servigistics InService A&D host.
Add the Servigistics InService A&D username password property for a specific host:
1. Using a folder explorer, navigate to the site.xconf file at this location:
<WINDCHILL>/site.xconf
2. Open the file in a text editor and scroll to the end.
3. Add these property entries:
<Property name="inserviceaad.superAdminUserPassword|<host>" overridable="true" value="encrypted.inserviceaad.superAdminUserPassword" targetFile="codebase/config/rules/rules.properties/>
Replace <host> with the Servigistics InService A&D host name, for example inservice.server.com
Replace <username> with the superadmin username.
4. Save the site.xconf file.
5. Open a Windchill shell.
6. Run:
xconfmanager -pF
Add the Servigistics InService A&D password property name to the Valid Properties list:
1. Using a folder explorer, navigate to this file:
<WINDCHILL>/bin/adminTools/sip/validProperties.list
2. Open the file in a text editor, scroll to the end and create a new line.
3. Add this property (replacing <host> with a value):
inserviceaad.superAdminUserPassword|<host>
For example:
inserviceaad.superAdminUserPassword|inservice.server.com
4. Save the file.
To encrypt an Servigistics InService A&D password property for a specific Servigistics InService A&D host:
1. Open a Windchill shell
2. Run the following command, including the quotes around the propertyName value:
ant –f %WT_HOME%/bin/adminTools/sip/EncryptPasswords.xml encryptPw -DpropertyName=”inserviceaad.superAdminUserPassword|<host>” -Dpassword=<password>
◦ Replace <host> with the Servigistics InService A&D host, for example inservice.server.com.
◦ Replace <password> with the superadmin password.
3. Check the output for a report of BUILD SUCCESSFUL This indicates that the password has been encrypted.
4. Restart the Windchill server (alerting the appropriate users first).
Post HTTP SSL Username and Password
The credentials are stored securely in the Windchill Key Store They are used when the Servigistics InService A&DPublish task is called.
A login error is reported as an authentication exception in the Windchill Visualization Service (WVS) logs at the point of publishing.
PTC recommends that you test the username and password configuration on a small test publication to ensure the credentials have been configured correctly.