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. Don't lose the secret as Cirrent does not store it and cannot provide it later. (If you do lose the secret you will need to delete the device and add it again with a new secret). You also associate the device to a device type, so that the correct configuration file can be generated for the device.
The device id and its secret are stored on the device, so that they can be used by the WCM to authenticate the device on ZipKey networks and onto the Cirrent cloud.
The characters that are valid in a device id are the following:
A-Z, a-z, 0-9, !$%*+-,=?^_~|
Device ids are case-sensitive.
The device secret can be up to 64 characters long, and may contain the same characters as the device ids. If you don't specify the device secret, Cirrent can generate one for you, which you will need to store on the device.
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.