Skip to content

Register an application in MindSphere

In order to use any application in MindSphere environment you need to register the application. The registration make your application available and can be accessible via a MindSphere URL.

Prerequisite

  • Before proceeding for registration, it is mandatory to create at least one scope in Roles & Scopes tab for the application.
  • For standard, Fleet Manager plugin and mobile applications: It is only possible to register one version of an application. It is not possible to register another version without deregistering the existing version. You can circumvent this limitation by using different application names.
  • For API applications: it is possible to register two versions but not two revisions of an application.
  • An application cannot be registered, if it does not have any Roles, since this information needs to be provided to the MindSphere Gateway.

User interface

"Application registration" screen:

You can register your application into MindSphere.

Application registration

Procedure for registering an application

To register the application, follow these steps:

  1. In "Dashboard" tab, select your application and click "Register"

    Register

  2. Click "Proceed With Registration", to confirm the application registration.

Additional step for mobile applications:

After registering the mobile application, application credentials are displayed. With these credentials, other application can interact or calls to APIs of mobile application in MindSphere. Also, these credentials provides the security in interacting with other APIs as well. For more information, see Developing Mobile Apps for MindSphere.

  1. After the application is registered successfully, a "client ID" and a "client secret" appear in the pop up window. Save the credentials for future use since they are displayed only once.
    Application Credential
  2. Value of the "client secret" is public for each application. The "Client id" follows the below nomenclature: mobile-client-<tenant>-<app>
  3. In case you want to view the credentials again, you need to de-register and register the application again thereafter, click "Prepare Release". In the "Prepare Release" window, enter the description and click "Submit".

Result

It is now possible to access the application via a link or from Launchpad and the application will also be lauched in a new browser tab.

Application details

Note

Operations Insight plugin, mobile applications and API applications are not visible on Launchpad.

Example:

URL-Schema: <tenantname>-<applicationname>-<tenantname>.<region>.mindsphere.io

Using this official URL, you are redirected to the application.

Next step

  • Test your application in MindSphere.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.


Last update: May 19, 2022