Project Concept

Extensions enable you to quickly and easily add new functionality to an IoT solution. Extensions can be service (function/method) libraries, connector templates, functional widgets, and more.

These pointers and steps will enable you to maintain focus on development of your own application and still utilize the power of ThingWorx for other purposes at the same time.

When to Utilize:

  • You have your own login from outside of ThingWorx but you want to leverage ThingWorx user management​
  • You are using an identity provider other than ThingWorx
  • You need to support passing of credentials in headers/query string parameters which ThingWorx doesn’t support out-of-the-box


Whether you would like ThingWorx to handle the security for your application, have an application you want ThingWorx to pump data into, or would just like to utilize ThingWorx features in your own application, external authentication can be a great way to integrate your application with ThingWorx. This guide will focus in on how to create an authentication middle man between a system you have already developed (or are in the middle of creating) and connect it to the ThingWorx Platform. In a provided demo website, you will login (with the provided credentials) and validate your user profile and password with ThingWorx. This setup shows the simple integration between ThingWorx and an application you would like to connect to the ThingWorx Platform.

Project Info

Type Tutorial
Level Intermediate
Est. Time 60 Minutes
Published January 09, 2019
Author Jason Johnson

You'll learn how to

    • Install the Eclipse plugin and extension SDK
    • Create authentication application
    • Build and import an extension
Register to Start Project

Things used in this project


This guide may be completed within any environment in which you have access to the ThingWorx Foundation server.

This includes both the 30-day hosted evaluation server, as well as the 120-day downloadable trial. You can use either Gradle or Ant to build your ThingWorx Extension Project.

Before you start, ensure you have the following software installed.

Completed Example:
You are provided a complete example that can be utilized as a reference for completion as you go through the guide or for insight into how the following steps can be completed.

NOTE: If you use Gradle as the build tool, in your Eclipse application, download the Gradle STS IDE plugin from Help->Eclipse Marketplace, then restart your workspace. This plugin does not work with all versions of Eclipse.

Software components:
Previous knowledge:


  • Step 1: Completed Example
  • Step 2: Understanding Authenticators
  • Step 3: Download Plugin and SDK
  • Step 4: Install and Configure
  • Step 5: Create Extension Project
  • Step 6: Build Extension
  • Step 7: Import Extension
  • Step 8: Integrating Custom Authentication
  • Step 9: Next Steps