akenza.io
Search…
The Things Network
This page describes the setup process of the TTN account to be used in akenza
TTN is building an open global LoRaWAN network and communities in every country. Their network servers are free of charge without any restrictions. They also offer paid services and self-hosting options.
The seamless integration from the LoRa network into akenza makes the management of already connected IoT devices and new projects effortless.
The integration does not require an account with the network provider, as this is provided by akenza. When using TTN, there is no monthly fee for devices connected using an akenza integration.

Connecting own account

Please note that the integration of TTN requires an account from The Things Stack. Old accounts can no longer be used to integrate with akenza. To check how to migrate the existing IoT deployment into The Things Stack, please contact their support.
Multiple ways to authenticate your own TTN account are offered.
  • Organization ID and API Key
  • Application ID and API Key
  • User ID and API Key

Organization ID and API Key

The appropriate organization ID and API key need to be provided in order to connect the akenza integration to a specific TTN organization. The API Key has to have all current and further rights. This authentication requires an organization API Key or personal API Key which can be deleted once the integration setup on akenza has been completed. This method will create a new application and an API Key in the newly created application which will then be stored encrypted in akenza for further communication. The API Key in the TTN application should not be deleted, as this may result in breaking the integration that has been set up in akenza.

Application ID and API Key

The appropriate organization ID and API key with the necessary permissions need to be provided in order to connect the akenza integration to a specific TTN organization. Please note that either a personal API Key or an application API Key to authorize using this method can be used. The provided API Key will be stored encrypted in akenza and used for further communication with their servers. This API Key should not be deleted as it will break the integration that has been set up in akenza.
API key TTN

User ID and API Key

To create a new application for the akenza integration, a TTN user ID is necessary to authorize selectively. The API Key has to have all current and further rights.
A personal API Key is needed for authentication, which can be deleted once the integration is completely set up on akenza. The permissions for the personal API Key can be seen below. A new application and an API Key will be created by applying this method. The newly created application will then be stored in akenza, encrypted, for further communication. It is important to not delete the API Key in the TTN application as this would break the integration that has been set up in akenza.
Integration Login
Once the provided credentials are verified, the integration name can be specified.
Enter integration name
Once clicked on the "Create Integration" button, everything will be set up on the TTN servers by akenza.
An Integration in the application or organization will be created (depending on the chosen authentication method) on the TTN servers which is used to forward the IoT device data to akenza. Neither modify this webhook nor delete it since the data will no longer be processed in akenza. Delete this webhook only if you do not wish to process the data in akenza. Other webhook integrations in TTN can be added to forward the data to 3rd party systems in addition or instead.
Webhook TTN
After everything is set up, the integration is created and the initial synchronization is started. This can take a moment, depending on how many devices are already registered on the account.
Once the synchronization was successful, the devices appear in the Asset Inventory Overview. Now the devices can be managed through akenza.
Note that TTN devices must have a name set in order for akenza to work properly
Last modified 5mo ago
Copy link