TokenPropertyAuthenticator Behavior (eMessage Connector)
The TokenPropertyAuthenticator is included in the Axeda Compatibility Extension (ACE) and is used to perform token authentication for Axeda eMessage agent assets against ThingWorx Platform.
How It Works
When an asset attempts to connect with ThingWorx Platform, it provides token and Thing Name information to the eMessage Connector, which directs these values to the TokenPropertyAuthenticator on the ThingWorx Platform for validation. Here are possible results, based on the configuration of the TokenPropertyAuthenticator:
• If the ThingName is not provided, authentication fails.
• If the Axeda Thing specified by the ThingName cannot be found, authentication fails.
• If the token is blank, authentication fails.
• If all of the following conditions are true, the token is written into the Axeda Thing's token property:
◦ The Update Token on First Message parameter of the TokenPropertyAuthenticator is set to true,
◦ The token sent in by the agent is non-empty,
◦ The value of the token property on the Axeda Thing is empty,
• Authentication fails if both of the following conditions are true:
◦ If the Update Token on First Message parameter of the TokenPropertyAuthenticator is set to false
◦ The value of the token property on the Axeda Thing is empty,
• If the specified token does not match the value of the token property on the Axeda Thing, authentication fails.
• If the specified token matches the value of the token property on the Axeda Thing, authentication succeeds.
• If authentication fails, the invalidToken property on the Axeda Thing is set to true only if its value has changed.
• If authentication succeeds, the invalidToken property on the Axeda Thing is set to false, only if the value of the token has changed.
For information on configuring the
TokenPropertyAuthenticator, refer to
Configuring the TokenPropertyAuthenticator (eMessage Connector).
For information on resetting a token, refer to
Resetting a Token.