Supported Windchill Connector Types
Add a Windchill connector type to authorize ThingWorx Flow to execute Windchill actions. ThingWorx Flow supports the following connector types for Windchill:
• Basic
• OAuth
◦ OAuth (Named User)
◦ OAuth (Session User)
 |
Before you create a Windchill OAuth connector, ensure that you load Windchill OAuths to the ThingWorx Flow server.
|
|
|
Before you add a Windchill Two-Way SSL connector, ensure that you have already set up ThingWorx and ThingWorx Flow for Windchill Two-Way SSL Connection.
|
Adding a Basic connector
1. Drag any action under Windchill to the canvas, place the pointer on the action, and then click 
or double-click the action.
or double-click the action.2. For Connector Type, select Basic.
3. In the Windchill Basic list, select Add New.
4. Edit the Connector Label field, if you want. Labels are case-sensitive. Do not use spaces, special characters, and leading numbers.
5. In the Windchill url field, specify the URL in the <protocol>://<Windchill FQDN>:<Port>/Windchill format. For example: https://windchilldemo:443/Windchill
6. In the User Name and Password fields, enter the correct user name and password.
7. Click ADD to add the Windchill Basic connector.
Adding an OAuth connector
1. Drag any action under Windchill to the canvas, place the pointer on the action, and then click or double-click the action.
or double-click the action.2. For Connector Type, select OAuth (Named User) or OAuth (Session User).
3. In the Windchill OAuth list, select Add new Windchill login – Named User or Add new Windchill login – Session User.
| | If you have not loaded Windchill OAuths to the ThingWorx Flow server, this option is not available. |
4. Provide your user name and password to log in to Windchill.
5. Review the scope permissions, and click Allow.
6. Edit the Connector Label, if you want. Labels are case-sensitive. Do not use spaces, special characters, and leading numbers.
7. In the Resource URL field, enter your Windchill metadata URL in the <protocol>://<Windchill FQDN>:<Port>/Windchill format. For example: https://windchilldemo:443/Windchill
| | The Resource URL field is available only if you have not specified the RESOURCE_URL parameter while configuring OAuth settings for Windchill. For more information, see Windchill OAuth Parameters. |
8. Click ADD to add the Windchill OAuth connector.
Adding a Two-Way SSL connector
1. Drag any action under Windchill to the canvas, place the pointer on the action, and then click or double-click the action.
or double-click the action.2. For Connector Type, select Two-Way SSL.
3. In the Windchill Two-Way SSL list, select Add New.
4. Edit the Connector Label field, if you want. Labels are case-sensitive. Do not use spaces, special characters, and leading numbers.
5. In the Windchill url field, specify the URL in the <protocol>://<Windchill FQDN>:<Port>/Windchill format. For example: https://windchilldemo:443/Windchill
6. In the Windchill Session Query parameter field, provide the session query parameter that is configured on the Windchill server. The default value is wt.effectiveUid. Contact your Windchill administrator for this value.
7. In the Keystore Path field, enter the absolute path to the KeyStore. The KeyStore can be located in a different machine than ThingWorx Flow, but must be accessible from the ThingWorx Flow machine. Ensure that the KeyStore has file read permissions.
KeyStores in the PKCS12 and JKS format are supported.
| | On Windows, for KeyStores in the PKCS12 format, install OpenSSL and add the OPENSSL_BIN environment variable to point to the path of the OpenSSL executable file. On Windows, for KeyStores in the JKS format, you do not need to install OpenSSL. |
8. In the Keystore Password field, enter the KeyStore password.
9. In the Truststore Path field, enter the absolute path to the TrustStore. The TrustStore can be located in a different machine than ThingWorx Flow, but must be accessible from the ThingWorx Flow machine. Ensure that the TrustStore has file read permissions.
TrustStores in the PKCS12 and JKS format are supported.
10. In the Truststore Password field, enter the TrustStore password.
11. In the SSL Certificate Verification list, select true if you want the Windchill SSL certificate to be verified; otherwise, select false.
Setting SSL Certificate Verification to false is not recommended for a production environment.
12. Click ADD to add the Windchill Two-Way SSL connector.
| | If you update the KeyStore or TrustStore certificate, then you must restart the ThingWorx Flow engine (flow-engine) and lookup (flow-lookup) services. |