Configuring the TokenPropertyAuthenticator (eMessage Connector)
The ThingWorx eMessage Connector always checks the tokens provided by the Axeda eMessage agents. The tokens are stored using a token property on the Thing that represents the Axeda asset in ThingWorx. A custom TokenPropertyAuthenticator on the ThingWorx Platform performs token authentication. There are options that you can specify for the TokenPropertyAuthenticator through a Configuration Table in ThingWorx Composer.
 |
The TokenPropertyAuthenticator does NOT authenticate HTTP requests.
|
To configure the TokenPropertyAuthenticator in ThingWorx Composer:
1. In the navigation pane click 
to display the Browse menu, and then select > to display the list of authenticators:
to display the Browse menu, and then select > to display the list of authenticators:2. Select TokenPropertyAuthenticator.
3. Click Configuration to display the configuration for the TokenPropertyAuthenticator.
4. Set values for the configuration properties. The following table lists the properties and their default values, and it provides a brief description of each property.
Property | Default Value | Description |
|---|---|---|
Token Property Name | token | The name of the property on the Axeda eMessage Thing that stores the token. By default, the token is stored in the token property provided with the Thing Templates used by the ACE. |
Token Invalid Property Name | tokenInvalid | The name of the property on the Axeda Thing that indicates if a token is invalid. By default, the value of this property is the tokenInvalid property provided with the Thing Templates used by the ACE. |
Update Token on First Message | The check box is selected. | Determines whether or not the token is updated on the Axeda Thing if the token field is not already set. The very first message that is sent to the ThingWorx Platform with a non-empty token is set as the token for that Axeda agent until the token is cleared or reset. |
5. Click Save.
For information on how authentication works, refer to TokenPropertyAuthenticator Behavior (eMessage Connector).
For information on resetting a token, refer to Resetting a Token.
For information about the exceptions that would necessitate resetting a token, refer to Connector Exception 8: Invalid Thing token property and Connector Exception 9: Blank token property on Thing