View source for AWS IoT Core device provisioning

__TOC__
 <p style="color:red">The information in this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.14'''] firmware version.</p> 

==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.<br>

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: [https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable.html Domain configurations]

==Device provisioning methods on AWS IoT Core==

There are multiple ways to add Things to the IoT Core:
{| class="wikitable"
|-
! 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:<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-v1.png|border|class=tlt-border]]<br>

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.<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-step1-v1.png|border|class=tlt-border]]<br>

After specifying the name, scroll down to the bottom of the page and press Next.<br>

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.<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-step2-v1.png|border|class=tlt-border]]<br>

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: [https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html AWS IoT Core policies]<br>
For this example we will use '''wiki_policy''' created earlier:<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-step3-v1.png|border|class=tlt-border]]<br>

To finish the Thing creation press the Create thing button at the bottom of the page.<br>
You will now be prompted to download the generated device certificates.<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-certs-v1.png|border|class=tlt-border]]
 '''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:<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-dev_list-v1.png|border|class=tlt-border]]

====Device configuration====
----
Once the AWS package is installed, head over to '''Services → Cloud Solutions → AWS''' and create a new AWS Jobs instance:<br>
[[File:Aws_iot_core_provisioning-basic_provisioning-instance_creation-v1.png|border|class=tlt-border]]
 '''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: [https://www.amazontrust.com/repository/ 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: 
[[File:Aws_iot_core_provisioning-basic_provisioning-instance_configuration-v1.png|border|class=tlt-border]]
Press Save & Apply. The Job status should change to '''Connected''' in a few seconds:
[[File:Aws_iot_core_provisioning-basic_provisioning-connected-v1.png|border|class=tlt-border]]
And that's it! Your device is now successfully connected to AWS IoT Core!<br>
Next steps are described in the [[AWS IoT Core: Enabling Remote Device Control with AWS IoT Core Jobs]] article.<br>

''* Information on '''provisioning by Claim''' and '''provisioning by Trusted User''' coming soon!''
==External links==
1. [https://aws.amazon.com/iot-core/ AWS IoT Core]<br>
2. [https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html What is AWS IoT?]