> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS IoT Core

> Connect BonData to AWS IoT Core for device, registry, and telemetry data

AWS IoT Core is a managed cloud service that connects industrial devices and sensors to AWS, managing their registry, security, and message telemetry at scale. With BonData, you can connect to your AWS IoT Core environment to read, enrich, and sync your device and telemetry data within Agent workflows.

## AWS IoT Core IAM Setup

BonData connects to AWS IoT Core using an IAM access key, calling the IoT Device Management and Registry APIs in your chosen region.

### Step 1: Create an IAM User or Access Key

1. Sign in to the [AWS Management Console](https://console.aws.amazon.com/)
2. Open the **IAM** console and go to **Users**
3. Create a dedicated user (for example `bondata-iot`) or select an existing service user
4. Under **Security credentials**, create an **Access key** for programmatic access

### Step 2: Attach a Least-Privilege Policy

1. Attach a policy that grants only the read actions BonData needs, for example `iot:ListThings`, `iot:DescribeThing`, `iot:ListThingGroups`, `iot:GetThingShadow`, and `iot:ListCertificates`
2. Avoid attaching broad managed policies such as `AWSIoTFullAccess`

<Note>
  Follow the principle of least privilege. Scope the IAM policy to the specific IoT read actions and resources BonData requires rather than granting account-wide access.
</Note>

### Step 3: Note Your Region

1. Identify the AWS region hosting your IoT Core endpoint (for example `us-east-1`)
2. BonData directs API calls to this region

### Step 4: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **AWS IoT Core**
2. Enter your **Access Key ID**, **Secret Access Key**, and **Region**
3. Click **Connect**

## Required Fields

| Field             | Description                                                         |
| ----------------- | ------------------------------------------------------------------- |
| Access Key ID     | IAM access key ID for the integration user                          |
| Secret Access Key | IAM secret access key paired with the access key ID                 |
| Region            | AWS region hosting your IoT Core endpoint (for example `us-east-1`) |

## Available Data

Once connected, BonData can sync the following AWS IoT Core data:

* **Things (Devices)** - Registered devices with attributes and metadata
* **Thing Types** - Device type definitions and their searchable attributes
* **Thing Groups** - Static and dynamic groups used to organize devices
* **Device Shadows** - Reported and desired device state documents
* **Topics / Telemetry** - Message topics and device telemetry data
* **Certificates** - Device certificates and their status