Device ids and secrets
A device ID is a unique identifier. Every ZipKey-enabled device must have a unique id, and must be registered with Cirrent, either via the Device Management Console, or programmatically through the OPS API. That's how we know what product company this device is associated with, and we can authenticate the device onto the ZipKey network and the Cirrent cloud.
When registering a device, you need to provide the unique device ID (such as the MAC address) and a secret. You also associate the device to a device type, so that the correct configuration file can be generated for the device. More details on registering a device are here.
The device id and its secret are stored on the device, so that they can be used by the Cirrent Agent to authenticate the device on ZipKey networks and onto the Cirrent cloud. If you don't specify the device secret, Cirrent can generate one for you, which you will need to store on the device.
The following rules need to be followed for Device ID and Secret:
1. The characters that are valid in a device ID and for device Secret are the following:
A-Z, a-z, 0-9, !$%*+-,=?^_~|
2. Device ids are case-sensitive.
3. The device ID and secret can be up to 64 characters long.
4. The number of characters in Secret need to be divisible by 4.
If you want to see the list of devices you have already registered, go to the Management Center.
Temporary device ids
For some products, there may be no unique identifier on the device, or the unique identifier may not be known until after the product is manufactured. To support these devices, Cirrent has a mechanism that allows products to be onboarded once using a temporary credential. As soon as the device reaches the Cirrent cloud, the device and cloud negotiate a new permanent credential. The temporary credential process is outlined here.
Before you can register a device with Cirrent, you need to define the Device Type, as outlined here. You can delete a Device Type, as long as it has no devices associated with it. Once a device is associated to the Device Type, you can no longer delete the Device Type. Delete the devices first and then you can delete the Device Type.
Once you have registered a device with Cirrent, the device can connect to ZipKey networks and authenticate to the Cirrent cloud. If you delete the device, it will no longer be able to connect to ZipKey networks or talk to the Cirrent cloud.