Tokens Management

Introduction

A token is the credential needed by the devices to access AssistNow and CellLocate services. Without a valid token the services cannot be accessed and any request will fail with a 400 "bad request" error.

There are two kind of tokens, temporary and permanent. A temporary token is meant for the service evaluation and has a limited lifetime of 90 days whereas the permanent token has no validity constraints as long as it is assigned a valid usage plan. A temporary token can be converted to permanent once the service evaluation is completed and you are ready for the development and deployment of the solution.

You can request your temporary token for the services evaluation here.


In this section

Still need help?

If you need more help or have any questions, please send an email to support@thingstream.io.

Create a new Permanent Token

To be able to create a token for accessing the AssistNow and CellLocate services, you must have a Thingstream domain. Once you log in into the domain you can see the Location Services menu item in the sidebar of the portal. Click on it.


As you enter the tokens management page for the first time you can start generating tokens.

Clicking on the Add Location Thing button will open the creation dialog as shown below

Clicking then in the Generate Tokens button you access to the panel to select the desired tokens.

In the creation dialog you can enter a friendly name for the token and enable the services the token is intended to access. In our example we selected all the services.

After entering the required information and clicking Next, you will be prompted to select the plans that the token will be associated to.

Please note that if you have selected more than one service, you must choose a plan for each service.

Also note that only one developer token is allowed per each domain, so if you have already selected the developer plan for another active token you will not be able to select it again.

When you have created the first tokens you can see and manage them in the tokens management page.

Manage Tokens

Clicking anywhere on the token row will open the token details dialog shown below.

In this dialog you can manage all the aspects of the token.

  • Status: active / deactivated. If a token is active it can be deactivated and vice versa. As you deactivate the token, it will be removed from the currently associated plan and the billing for that token will stop. When you reactivate the token you must choose the plan again.

  • Plan. As your usage of the service changes you might need to change the plan, clicking Change will open the Change Plan dialog that allows you to change the plan for the token.

  • Tags.

  • Activity. On the Activity tab you can check the usage of the token.