Skip to main content
Version: 1.7.0

1. Add the device in the portal

Read the Device ID​

Open the Targets section in the hopit Edge web interface: https://localhost:5050/Targets and click CONNECT TO HOPIT PORTAL.

The first step of the wizard shows the Device ID of this machine — 52 uppercase letters and digits derived from its hardware. Copy it with the button next to the field.

info

The Device ID is also shown on the Settings page under License. It is stable for a given machine, so re-installing hopit Edge does not change it.

Create the device in the portal​

Sign in to the hopit Portal, select the subscription in the top bar and add a new device:

  • Device Name: a descriptive name. This also becomes the device name in the Azure IoT Hub.
  • Device ID: the value copied from the Edge device.

Confirm with CREATE. The portal registers the device in the Device Provisioning Service and then shows its Connection String.

Copy the Connection String​

The connection string is a single line that carries the provisioning credentials of this device, its device name and — once one is assigned — its license key. Reveal it with the eye icon, or copy it straight to the clipboard with the copy button.

{"Targets":{"hopit Portal":{"DpsSymmetricKey":"…","DpsIdScope":"…"}},"InsightsCollector":{"DeviceName":"…"},"License":{"LicenseKey":"…"}}
caution

Treat the connection string like a password: anyone holding it can register a device against your subscription. It is shown masked for that reason.

The same string is available later from the device page: open the device, then â‹® -> Connection String.

Assign a license​

Adding a device does not assign a license to it, so a freshly created device's connection string carries no license key — the portal points that out below the string.

You can connect the Edge device right away and assign the license afterwards. The wizard switches on license auto-renewal, so the Edge device claims and activates its license by itself within a minute of one being assigned in the portal. There is no need to copy the connection string a second time.