deviceWISE CloudPart 3 - Creating an Application token

If you already have an application token, then you can skip this part and go to deviceWISE Cloud Part 4 - Connecting or Creating a Thing

Create an App Token in the Portal to generate an Application token that is used by the software to connect to the portal.  You also select all the credentials required by a device to auto register and connect to the portal. To create an App Token, do the following:

  1. On the Developer screen in the GENERAL group, click App Tokens
    The App Tokens screen appears.
  2. Click New App Token

    The Adding App Token screen appears.
  3. Enter or select the following fields for the App Token.
    FieldDescription
    NameThe name of the App Token that is displayed on Management Portal pages.
    DescriptionAn optional description of the App Token.
    Auto Registration Thing Definition IDThe thing definition to use when the software application uses the auto registration feature when it connects to the deviceWISE Cloud. The auto registration feature defines a thing for the App Token when it connects to the deviceWISE Cloud for the first time. If "None" is selected, only things that are created from within the portal or previously connected to the portal can connect using this application token.
    Auto Registration TagsTags defined for the Thing when a gateway or a software application uses the auto registration feature. The tags can be used for filtering Things to display on pages.
    Auto Registration Security TagsSecurity tags defined for the thing when the software application uses the auto registration feature. The security tags can be used to limit a role's access to things.
    Roles

    Do one of the following:

    • Select the Org Admin check box to give the App Token the organization administration role
    • Enter one or more roles defined in the organization

    Use of OrgAdmin is NOT recommended unless your specific use case requires access to all APIs. The use of a custom role to restrict API calls to the ones necessary to the application is recommended for improved security. Additionally, the use of security tags and/or JWT tokens is an alternative recommendation for the most secure access.

    License

    When the App Token is for an Asset Gateway or Enterprise Gateway, select the gateway license that can be automatically downloaded to the gateway when it connects to the deviceWISE Cloud.

    It is possible to choose multiple licenses for a given App Token. The platform automatically checks for Subscriptions, Perpetual Licenses and SW Update.

  4. Click Add
    The newly defined App Token's page is displayed.


Each organization starts with its own system provided sample Default App Token.

In the above example, two additional App Tokens have been defined for use by Asset Gateways and Enterprise Gateways.

The definition of App Tokens within your organization will depend on how the items in the organization will be accessed and the App Tokens characteristics of:

  • Roles
  • License assignment
  • Auto-registration information including the thing definition.
For example: If different software applications need to have different roles for the access of items, then multiple App Tokens can be defined - each with the specific role assigned. The software applications connect to the deviceWISE Cloud with the application token assigned for the specific application. One software application might provide view only access of Things. Another application might provide view, write and modify access to Things. A third application might have access to a subset of Things, but not all of the Things within the organization.

Related Topics Link IconRelated Topics