Skip to main content
Aug 1, 2016 6:26 PM UTC
Question

configuring Windchill extension for ThingWorx 6.5

Document - CS222750

 

Document Information

TypeArticle
Date Created  12-Nov-2015
Date Last Updated29-Jul-2016

 

 

Document Details

TitleConfiguring the PTC Windchill extension for ThingWorx and IIS
Description
Applies To
  • ThingWorx 6.5
Cause
ResolutionThis text goes into the PTC Windchill® Extension
for ThingWorx® Guide: Appendix A “Example Configuration Using SSL for Secure Communications”; and replaces the existing step 9.
  • Configure Windchill to trust ThingWorx
  1. Export the ThingWorx certificate from the ThingWorxKeyStore.jks.
    1. Export in pfx format making sure to specify a password
  2. Add the ThingWorx certificate to the Windows Servers list of trusted CA Certificates
    1. Click Start, and then click Run....
    2. Type mmc, and then click OK. The Microsoft Management Console (Console) window opens.
    3. In the Console1 window, click the File menu, and then select Add/Remove Snap-in.
    4. In the Add or Remove Snap-in window, select Certificates, and then click Add.
    5. In the Certificates snap-in window, select Computer Account, and then click Next.
    6. In the Select Computer window, select Local Computer, and then click Finish.
    7. In the Add or Remove Snap-in window, click OK.
    8. In the Console1 window, click + to expand the folder.
    9. Right-click Trusted Root Certification Authorities, mouse-over All Tasks, and then click Import.
    10. In the Certificate Import Wizard window, click Next.
    11. Click Browse to find the intermediate certificate file.
    12. In the Open window, change the file extension filter to Personal Information Exchange (*.pfx, *.p12), select the file exported in step 9.1, and then click Open
    13. In the Certificate Import Wizard window, click Next.
    14. Input the Password specified at Step 9.a.i above, click Next.
    15. Select Place all certificates in the following store, and if Trusted Root Certification Authorities is not set in the store box then press Browse and then select that store.  Click Next.
    16. Click Finish.
    17. Click OK.
    18. Close the Console 1 window, and then click No to remove the console settings.
  3. Work around authentication issue.  The Windchill Extension submits credentials in the header of the requests to work around issues with ThingWorx and Anonymous connections.  The standard PTC HTTP server ignores these credentials but IIS does not.
    1. Create a local user with the username "notused" and the password "notused"
  4. Configure IIS to Accept SSL Connection
    1. Open IIS Manager
    2. In the Connections pane select the Web Site that holds Windchill
    3. In the middle panel double click SSL Settings
    4. Tick the Require SSL checkbox
    5. Set Client certificates to Accept
    6. In the Actions pane select Apply
    7. Restart IIS
  5. Configure Windchill to trust the ThingWorx certificate.
    1. You need the name of the ThingWorx certificate, this is available from the jks
    2. Edit <windchill-home>/codebase/WEB-INF/web.xml.
    3. Find the line pair <filter-name>TrustedSSLAuthFilter</filtername> and <filter-class>wt.httpgw.filter.TrustedAuthFilter</filter-class>.
    4. Add an additional <init-param> element after existing one:
<init-param>
<param-name>trustedSubjectPattern.1</param-name>
<param-value>Certificate Name</param-value>
</init-param>