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 application in the portal to generate an Application token that is used by the software applications 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 application, do the following:
- On the Developer screen in
the GENERAL group,
click Applications
The Application screen appears. - Click New Application
The Adding application screen appears. - Enter or select the following fields for the
application.
Field Description Name The name of the application that is displayed on Management Portal pages. Description An optional description of the application. 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 application 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 application 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 application 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 application. The platform automatically checks for Subscriptions, Perpetual Licenses and SW Update.
-
Click Add
The newly defined application's page is displayed.
Each organization starts with its own system provided
sample Default Application.
In the above example, two additional applications have been defined for use by Asset Gateways and Enterprise Gateways.
The definition of applications within your organization will depend on how the items in the organization will be accessed and the application characteristics of:
- Roles
- License assignment
- Auto-registration information including the thing definition.