Configure Authentication Credentials
HTTP SSL Username and Password
For Windchill to call the Arbortext Content Delivery A&DPublish task, the Arbortext Content Delivery A&D superadmin credentials are required to authenticate against the Arbortext Content Delivery A&D server. The username for Arbortext Content Delivery A&D is stored as a Windchill property. The password for Arbortext Content Delivery 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 Arbortext Content Delivery A&D hosts.
To encrypt an Arbortext Content Delivery A&D password property for all Arbortext Content Delivery 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 Arbortext Content Delivery A&D host.
Add the Arbortext Content Delivery 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 Arbortext Content Delivery 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 Arbortext Content Delivery 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 Arbortext Content Delivery A&D password property for a specific Arbortext Content Delivery 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 Arbortext Content Delivery 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 Arbortext Content Delivery 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.