Creating an App Token
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:
- On the Developer screen in
the GENERAL group,
click App Tokens
The App Tokens screen appears. - Click New App Token
The Adding App Token screen appears. - Enter or select the following fields for the
App Token.
Field Description Name The name of the App Token that is displayed on Management Portal pages. Description An optional description of the App Token. Auto Registration Thing Definition ID The 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 Tags Tags 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 Tags Security 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.
-
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.