Files
pycom-documentation/content/pybytes/integrations/amazon-iot.md
Emmanuel Florent b192705aee manual rework
2019-06-25 17:22:42 +02:00

43 lines
2.5 KiB
Markdown

---
title: "Amazon IoT"
aliases:
- pybytes/integrations/amazon-iot.html
- pybytes/integrations/amazon-iot.md
---
Whenever one of your integrated devices sends a signal to our broker, we republish the binary payload to the endpoint specified for its integration.
## Integrate your devices
Go in the sidebar, click on _New Integration_ and then on _Amazon Web Services_
![New AWS integration](/gitbook/assets/pybytes/integrations/aws/choose-aws.png)
Fill in the form choosing an [AWS region](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html) and your AWS credentials. You can optionally choose to save them inside the local storage for future use. Once you're done, click _Login_
![Fill in the form with AWS keys and choosing a region](/gitbook/assets/pybytes/integrations/aws/aws-login-form.png)
In this step, you have to specify the [AWS group](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) name (just alphanumeric letter, dashes and underscore are allowed), the custom topic and the devices you want to bind to AWS. When you're ready, click _Create_
![AWS group creation](/gitbook/assets/pybytes/integrations/aws/aws-group-creation.png)
If everything's worked as expected, you should be able to see a summary of your integration like the following:
![Creation process result](/gitbook/assets/pybytes/integrations/aws/aws-integration-result.png)
The corresponding AWS Thing and AWS Group has been created as well, you just have to [log in to the console](https://console.aws.amazon.com/console/home?nc2=h_ct&src=header-signin) and choose the same region on AWS. You'll be able to explore groups and things' details.
![AWS things and groups just created](/gitbook/assets/05_aws_integration.png)
The device's name is specified as an attribute of the thing.
![Device's attributes](/gitbook/assets/06_aws_integration.png)
## Final considerations
In order to save the data received by AWS, [you must set up a rule](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html).
You can also test that everything's working with the [AWS IoT MQTT client](https://docs.aws.amazon.com/iot/latest/developerguide/view-mqtt-messages.html).
Please notice that it's not possible to download the private key from AWS once it has been generated, by the way, we securely store it inside our database.
**Warning**: do not delete AWS things or groups directly from AWS user interface, otherwise the integration with Pybytes will stop working. Always use Pybytes interface to delete AWS things or groups.