AWS IoT Core device provisioning
The information in this page is updated in accordance with 00.07.14 firmware version.
Introduction
This article contains instructions on how to add your Teltonika Networks device to AWS IoT Core. AWS IoT Core is a managed cloud service from Amazon Web Services (AWS) that enables devices to securely connect to AWS and interact with cloud applications and other devices. It provides the infrastructure needed to collect, process, and analyze data from IoT devices without requiring users to manage servers.
In this article we will cover different ways of provisioning your devices (referred to as Things in AWS terminology) to AWS IoT Core.
Prerequisites
To add your devices to AWS IoT Core you will need:
- A Teltonika Networks device running RutOS;
- An internet connection;
- AWS package downloaded from the Package manager (System → Package Manager) or Wiki.
- An AWS account with the necessary privileges.
- Configured domain in AWS IoT → Connect → Domain configurations. More information about domain configuration can be found here: Domain configurations
Device provisioning methods on AWS IoT Core
There are multiple ways to add Things to the IoT Core:
| Provisioning Method | Scalability | Complexity | Best Use Case |
|---|---|---|---|
| Basic provisioning | 🔴 Low | 🟢 Easy | Small-scale IoT projects |
| Provisioning by Claim | 🟡 Medium | 🔴 Complex | Mass-manufactured devices needing unique identities |
| Provisioning by Trusted User | 🟢 High | 🟡 Moderate | Large fleets with manufacturer-trusted certificates |
Basic provisioning
If your project involves only a few Teltonika Networks routers or gateways, the simplest way to provision Things in AWS IoT Core is by adding them individually. The main drawback of this method is that each Thing must be provisioned separately, with its own set of certificates. However, this can also be an advantage, as it provides greater control over each Thing and enhances security by ensuring that certificates are not shared.
AWS
To provision your first device, on AWS open IoT Core service, and on the left side choose Manage → All devices → Things. Press the Create things button:
In the first step, device properties will need to be specified. Only one field is mandatory here - Thing name, although other properties can also be set for easier device management.
After specifying the name, scroll down to the bottom of the page and press Next.
In the next page select what device certificate will be used. We would recommend using Auto-generate a new certificate option for most of the use cases, but other options are also suitable.
In the next step, policies for the generated certificates can be chosen. This policy will apply to the Thing that is currently being added. More information about IoT Core policies can be found in AWS documentation: AWS IoT Core policies
For this example we will use wiki_policy created earlier:
To finish the Thing creation press the Create thing button at the bottom of the page.
You will now be prompted to download the generated device certificates.
NOTE: This is the only chance you'll have to download device certificate and keys, so make sure to save them in a secure location!
And that's it! Your device is now configured on AWS and will show up in the list of devices:
Device configuration
Once the AWS package is installed, head over to Services → Cloud Solutions → AWS and create a new AWS Jobs instance:
NOTE: Instance name must match the Thing's name on the IoT Core service! If there is a mismatch, IoT Jobs will be placed in queue and will not be finished until the correct name is set or the job times out.
In the configuration window:
- Enable the instance;
- Specify the endpoint (configured as mentioned in the Prerequisites section);
- CA file: Upload the AmazonRootCA1.pem file. If you missed to download it earlier, it can be downloaded here: Amazon Trust Services Repository
- Provisioning: Basic provisioning;
- Thing's certificate: Upload the previously downloaded xxxxxxxxxxxx-certificate.pem.crt file;
- Thing's private key: Upload the previously downloaded xxxxxxxxxxxx-private.pem.key file;
The configuration should look as follows:
Press Save & Apply. The Job status should change to Connected in a few seconds:
And that's it! Your device is now successfully connected to AWS IoT Core!
Next steps are described in the AWS IoT Core: Enabling Remote Device Control with AWS IoT Core Jobs article.
* Information on provisioning by Claim and provisioning by Trusted User coming soon!
External links
1. AWS IoT Core
2. What is AWS IoT?