API keys are used as credentials to access the Cirrent Cloud APIs. In the Management Center you can generate new API keys (API key and API secret) and delete existing API keys. When you generate a key make sure you keep track of the secret, as Cirrent does not keep the secret (we keep a hashed version of the secret so we can check your secret when you call us, but we don't keep the secret itself). If you lose the secret, go back into the Management Center, generate a new key and secret and then update your cloud with the new key and secret.
There are four types of keys:
- SYS Keys - these are used to authenticate your cloud to the Cirrent cloud, whenever you are using the SYS API.
- OPS Keys - these are used to authenticate your cloud to the Cirrent cloud, whenever you are using the OPS API. (The OPS API is used for bulk provisioning of devices during your manufacturing process.)
- APP Keys - these are used for generating tokens that will be used by your mobile app when it talks to the Cirrent cloud (learn more about App tokens here)
- Provisioning Keys - these are keys that are used if you are do not have unique device ids for your devices, and you need to start with a temporary device id, and have Cirrent generate the permanent device id for your device (learn more about using provisioning keys here)
Store the secrets safely. If someone gains access to one of your API keys they could wreak havoc on your account, so you should go back to the Management Console and delete those keys and issue new keys for your account.