Skip to content

1.5 Integrate NIMMSTA Cloud Link

NIMMSTA Cloud Link is a service that allows you to connect your NIMMSTA Core application to the NIMMSTA Cloud. This allows to manage all your NIMMSTA hardware with NIMMSTA Cloud. It is required if you want to use Light Tag predictive maintenance or the maintenance contract for Smart Watches.

Setup

To integrate NIMMSTA Cloud Link into your application, follow these steps:

  1. Go to cloud.nimmsta.com and create a new configuration in Software -> Configured Apps. You can just select Windows.
  2. Enable Cloud Link for the configuration and select your tenant to be used.
  3. Enable tenant assignment for Devices to make sure that devices are assigned to your tenant automatically.
  4. Download the .nimmstaconfig file and unzip it.
  5. Option 1: Take out secretkey.json and copy to your application root folder.
  6. Option 2: Call connectionManager.setCloudLinkConfig(CloudLinkConfig(secret = "[SECRET]", tokenUrl = "[TOKEN_URL]"))

Windows app updates

If your Windows application is installed through an installer, treat the application root folder as installer-managed.

For the NIMMSTA Windows Client installer, an update removes the old Program Files application directory before installing the new version. This can also remove manually copied configuration files such as secretkey.json or custom *.nimmstaconfig files`.

Make sure your update package restores secretkey.json to the application root folder after each update, or use connectionManager.setCloudLinkConfig(...) so the Cloud Link configuration is provided explicitly at runtime.

Firewall rules

To allow your app to talk to NIMMSTA Cloud, you need to whitelist the following URL in your firewall: https://backend.cloud.nimmsta.com/* Make sure to allow any wildcard path after the domain, as the Cloud Link service will use different paths for different functionalities.

Done

You're done! Your application is now connected to NIMMSTA Cloud Link and can communicate with the NIMMSTA Cloud. Just try to connect a smart watch or a Light Tag to your application and after roughly 2 minutes, it will appear in your tenant.