Device claiming is a mechanism that securely transfers ownership from the device maker to the device owner without transferring LoRaWAN® root keys. This section provides an overview to resources for device makers and device owners.
Who is it for?
It is for device owners who need to claim ownership of their devices.
Typical use cases
- Onboarding a device by scanning its QR code that contains the ownership information.
- Bulk importing devices with ownership information.
How does it work?
Device makers provision devices on a LoRaWAN Join Server that supports claiming. As part of this process, a “claim authentication code” or “owner token” is generated: a proof of ownership.
Device makers send the proof of ownership together with the physical end devices to the owner. There are various ways to transfer the proof of ownership: it can be encoded in a QR code or text printed on the device packaging, or sent as an import file.
Device owners claim the device by scanning the QR code, entering the claim authentication code or importing a file with claim authentication codes. The process of claiming a device using its QR code is integrated in the adding devices flow, while the process of claiming devices using their claim authentication code is explained in the Adding devices in bulk section.
Device claiming works with LoRaWAN Join Servers configured in The Things Stack. By default, The Things Stack Cloud and The Things Stack Sandbox are preconfigured to use The Things Join Server and Semtech Join Server. If you operate The Things Stack Enterprise or Open Source, configure the LoRaWAN Backend Interfaces interoperability repository and the Device Claiming repository accordingly.