New: the AI firewall watches the whole platform and explains each incident in plain words. See how it works

Device security alerts

Every security notice Hermetry sends about your devices, who receives it, when it is sent, and what to do about it.

This page is for organisation owners and administrators. It lists the security notices Hermetry sends about your devices, when each one is sent, and what to do when you get it. It also explains what Hermetry watches without telling you.

Who receives them and where

  • The notices go to the organisation’s active owners and administrators. Other members do not get them.
  • They arrive as notifications: in the bell and through the channels each person has chosen in their preferences.
  • Credential, rate-limit and certificate recovery notices open the device’s page when you select it.
  • Notices are limited so a fault does not flood you: the daily certificate notices come at most once a day, credential and rate-limit notices at most once an hour per device.

Certificate notices

These concern devices that log in with an X.509 certificate from the Hermetry device CA, such as licensed devices.

NoticeWhen it is sentWhat to do
Device certificates expire soonOnce a day, while certificates of your devices expire within the Expiry warning (days) and no newer certificate has replaced them. One notice with the count. The warning is 30 days by default; set 30 to 180 in Device Certificate Settings.Check that the devices are online: they renew by themselves. On the device page, Renew certificate is offered when fewer than 30 days are left.
Devices did not renew their certificatesHermetry sent cert.renew to the devices 7 or more days ago and no new certificate exists. Once a day, with the count. Selecting it opens the certificate list.Check that the devices are online and run current firmware, or renew them from the device page.
A device asks for a new certificateA device asked for a new certificate while its current one is still valid. That may be a repaired device, or a clone. The request stays open for 7 days.On the device page, Approve only if you reset or repaired the device. Otherwise Reject: the device keeps its current certificate and gets nothing new.

A certificate that expires anyway is refused at login with CONNACK 5, and the device has to go through recovery. See Device certificates and Root certificates and certificate changes.

Credential notices

These concern every device that logs in to the MQTT broker, whatever its credential.

NoticeWhen it is sentWhat to do
Device … logged in from a new networkThe device logged in over MQTT from another network than at its previous login. A network is the /24 of an IPv4 address or the /48 of an IPv6 address; each device’s last network is remembered for 30 days. The notice says when the login came without TLS, because the credential then crossed the network in clear.If the device did not move, someone else may hold its credential: rotate it. Move devices on plain MQTT to TLS (port 8883).
Two places are using the credential of device …The device’s session was taken over again and again: by default more than 5 times within 60 seconds. When the takeovers come from two networks, logins from the network that started them are refused for 60 seconds (CONNACK 3), then counting starts again. Within one network nothing is refused; the notice is only a report.Rotate the device’s credential and check where the device is installed. Give every device its own credential. If both logins are the same device, check that its client closes the old connection before it reconnects.

Limit notices

Rate limits also protect you from a broken or hijacked device. See Device transport security.

NoticeWhen it is sentWhat to do
Device … is over its rate limitThe device sends more than its device profile allows. The extra messages are acknowledged and dropped. At most once an hour per device.Fix the device’s send rate, or raise the profile’s Limits.
Your IoT devices are over the plan’s rate limitYour devices together send more than your plan allows.Lower the send rates, or see Plans and the IoT add-on.
Your IoT devices are at the plan’s connected-device limitDevices were refused at login because the plan’s limit of devices connected at once was reached.Disconnect devices you do not use, or change the plan.

Ownership and provisioning notices

NoticeWhen it is sentWhat to do
A device released itself from your accountSomeone used the Release button on a licensed device’s own Cloud page. The device is back in the factory pool; its history stays in your account.If nobody in your team did this, contact support. You can switch off Allow release from the device on the Ownership tab of your other devices.
A device was released by platform supportPlatform support released one of your devices, with a reason. Its history stays in your account.Nothing, unless you did not expect it.
Devices waiting in quarantineEach night, when devices that provisioned themselves with a profile key have waited in quarantine longer than the set number of days (7 by default, 1 to 30).Activate the devices you know. If you do not know them, revoke the provisioning key. See Quarantine for self-registered devices.

What is not a notice

Some protections act without telling you, because they work per address or per login rather than per device.

ProtectionWhat happensWhere you see it
Address blockBy default, more than 10 failed logins from one address within 5 minutes block that address for 60 seconds, for every device behind it (CONNACK 3, HTTP 429).The block itself is not shown: the devices behind the address cannot connect for that time. A wrong password for a device’s username is on that device’s Log tab; fix that device’s credentials.
Username back-offBy default, more than 5 failed MQTT basic logins with one username from one network within 15 minutes refuse that username for 15 seconds, doubling with each further failure up to 5 minutes. A successful login resets it.The back-off itself is not shown: the device is refused until it ends. The wrong passwords that caused it are on the device’s Log tab.
Login refusalsA refused login that can be tied to a device is recorded on that device as Login refused with its reason, repeats within 5 minutes folded into one line with a count. An unknown username, an unknown token or an unknown, revoked or expired certificate is not recorded. The reason is never sent to the device.The device’s Log tab. For refusals it does not show, work through A device does not connect.

Hermetry’s operators are alerted about platform-wide patterns that no single organisation could see: floods of failed device logins, many blocked addresses, failed logins concentrated in one client network, provisioning keys that may have leaked, and revocations that do not reach every broker node at once. You do not need to act on these.

A short response plan

  1. Open the device from the notice and read its recent connections and refused logins on its Log tab.
  2. If a credential may be in other hands, rotate it. For a certificate that may be copied, revoke it with the reason Key compromise.
  3. If the device is no longer in service, revoke its credential or delete the device.
  4. Check the audit log for credential and certificate changes. See What is audited.