Skip to content

A scalable AWS IoT administration tool for importing pre-provisioned X.509 certificates to AWS IoT Core. Thingpress enables secure device onboarding by importing certificates from secure elements and trusted platform modules, while automatically creating and associating AWS IoT Things, Policies, Thing Types, and Thing Groups.

License

Notifications You must be signed in to change notification settings

aws-iot-builder-tools/thingpress

Thingpress

Coverage pylint samlint sambuild

Thingpress is an AWS IoT administration tool. Customers often choose to design IoT devices that have pre-provisioned x.509 certificates. Secure element and trusted platform module manufacturers inject x.509 certificates to these chips in secure manufacturing facilities. The same x.509 certificates must be registered to AWS IoT for devices to authenticate. Thingpress imports these certificates to AWS IoT in a scalable way such that you can import hundreds of thousands, if not millions, of certificates per day.

Thingpress does more than simply import certificates. Devices must be authorized for actions and ideally participate in IoT fleet management. Thingpress automatically creates an AWS IoT Thing in the AWS IoT Registry based on the certificate CN value (common practice). Thingpress optionally attaches AWS IoT Policy (authorization), Thing Type (fleet management), and Thing Group (fleet management). The objects you associate reflect application design and device lifecycle goals. There is more information in the Getting Started section to help guide you.

Thingpress supports manifests from three vendors and programmatically generated certificates. The following is the list of vendors in alphabetical order, associated pre-provisioned certificate parts, and Thingpress documentation for each vendor.

Vendor Components Thingpress
Documentation
Espressif Systems ESP32-S3 Thingpress for Espressif
Infineon Technologies SA Optiga Trust M Express Thingpress for Infineon
Microchip Technology Inc. Trust&Go ATECC608B with TLS Thingpress for Microchip
Generated Certificates Programmatically generated certificates Thingpress for Generated Certificates

Development Roadmap

See our Development Roadmap for information about upcoming features and development priorities.

Getting started

Thingpress is a tool used for production environment preparation. Careful AWS IoT preparation can provide many benefits throughout the device lifecycle. At scale (i.e., hundreds of thousands of devices), adjustments to object attachments (i.e. Thing Group and Thing Type) can be a daunting task.

  1. Familiarize yourself with the following topics: x.509 client certificates, AWS IoT Core policies, AWS IoT Things (device registry), IoT Thing Types, and IoT Thing Group.
  2. Become familiar with any planning activity for your chosen vendor: Espressif, Infineon, Microchip, or Generated Certificates.
  3. Evaluate service API call limits. Although Thingpress recovers from API throttling to not lose data, avoid API throttling in the first place to optimize processing time.
  4. Prepare and test artifacts to be associated with the import. Verify that the effective policy on the device is exactly what want. Policies may be adjusted later, but testing may highlight adjustments to Thing Group hierarchies.
  5. Install Thingpress with required and vendor specific parameters. Multiple Thingpress installations may be required - for example, if you have multiple product lines, each having a different IoT Thing Type and Group.
  6. Invoke the processing by uploading the vendor supplied certificate manifest to the vendor specific S3 bucket. Typically, the batch speed is approximately 100,000 certificates per hour, including all requested object associations.

About

A scalable AWS IoT administration tool for importing pre-provisioned X.509 certificates to AWS IoT Core. Thingpress enables secure device onboarding by importing certificates from secure elements and trusted platform modules, while automatically creating and associating AWS IoT Things, Policies, Thing Types, and Thing Groups.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 7