Skip to content
The Things Stack documentation home
Getting Started Concepts Cloud Enterprise Integrations API Hardware
Getting Started Concepts
Cloud Enterprise
Integrations API Hardware
Get The Things Stack

    Recent searches

      Popular pages

      • Getting Started
      • Adding Gateways
      • Adding Devices
      • Payload Formatters
      • Webhooks
      • Authentication

      No results for “”.

      • Check the spelling, or try fewer or more general words.
      • Ask the community on The Things Network Forum
      • Contact support
      ↑↓ to navigate ↵ to open Esc to close

      Hardware

      • Overview
      • Devices
        • Adding Devices
          • Manually adding devices
          • Adding devices in bulk
          • Adding devices with ATECC608 Secure Elements
            • Claim
        • Configuring Devices
        • Concepts
        • Models
        • Troubleshooting Devices
      • Gateways
      • Works with The Things Stack

      Claim

      Updated 20 January 2025 Edit on GitHub
      Copy page
      • View as MarkdownThis page as plain text
      • Open in ChatGPTAsk questions about this page
      • Open in ClaudeAsk questions about this page

      This guide helps device makers to claim Microchip ATECC608 secure elements on The Things Join Server.

      Prerequisites

      1. ATECC608A-TNGLORA or ATECC608B-TNGLORA secure elements. Product details
      2. Device security (manifest) file. You can obtain this from your Microchip Direct order history
      3. Provisioner access to The Things Join Server. Contact The Things Industries support to get access.
      4. The Things Join Server command-line interface (ttjs) installed. See instructions to install ttjs

      Initialize ttjs

      To initialize The Things Join Server CLI ttjs, run the following command:

      ttjs init
      

      This prompts the URL, provisioner credentials and location to save the configuration:

      ✔ Server URL … https://js.cloud.thethings.industries
      ✔ Provisioner username … example
      ✔ Provisioner password … ********************
      ✔ Configuration file … ~/.config/ttjs/config.yaml
      ✔ Save configuration … yes
      

      Verify that your credentials are correct:

      ttjs list
      

      This should return the currently provisioned devices (or [] if there aren’t any).

      Import manifest

      Next, import your manifest file, in this case named manifest.json:

      ttjs import -f microchip-atecc608 manifest.json
      

      This provisions the secure elements in The Things Join Server and returns the generated owner tokens, for example:

      [
        {
          devEUI: "0004A310001AAED6",
          ownerToken: "C05EA29C",
          rootKeysExposed: false,
        },
      ];
      

      The owner token is called claim authentication code in The Things Stack. This is the proof of ownership for claiming devices. See Device Claiming for more information.

      Export root keys

      In case your end devices are to be activated on a LoRaWAN® Network Server that does not support claiming on The Things Join Server, the root keys can be exported:

      ttjs get <dev-eui> --nonces --root-keys
      

      Warning:

      When you export the root keys, they are marked forever as exposed. This reduces the security of the end device. Current and future owners of the device are not guaranteed privacy and secure activation if the keys are not carefully stored.

      This returns the root keys and LoRaWAN nonces (if any):

      {
        devEUI: '0004A310001AAED6',
        ownerToken: 'C05EA29C',
        rootKeysExposed: true,
        nonces: { nextJoinNonce: 2, usedDevNonces: [1836, 10331] },
        rootKeys: {
          appKey: '525746CCF9CF5DE887BE5D836D08B5C9',
          nwkKey: 'CB0F4E236567566D2A976B3DAB2CF7A5'
        }
      }
      

      Note:

      The secure elements are pre-provisioned with JoinEUI 70B3D57ED0000000.

      This allows you to register the devices on any LoRaWAN Network Server that does not support The Things Join Server.

      ← Adding devices with ATECC608 Secure Elements

      On this page

      • Prerequisites
      • Initialize ttjs
      • Import manifest
      • Export root keys

      Sections

      Getting Started

      Concepts

      Cloud

      Enterprise

      Integrations

      API

      Hardware

      Sitemap

      View our Sitemap

      Contributing

      GitHub

      About Us

      The Things Industries

      Privacy Policy

      Cookie settings

      Cookie Settings

      We use cookies to enhance your experience, analyze site traffic and deliver personalized content. Read our Privacy Policy.

      Cookie categories