本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 托管集成演示应用程序
<a name="supported-raspberry-demo-app"></a>

**注意**  
 Raspberry Pi 上的 AWS IoT Hub SDK 的实现是一个演示项目，仅用于学习和测试目的，不打算在生产环境中使用。在本演示中，为了便于开发，请设置以下配置：  
 **AWS 凭证存储**：仅出于演示目的，凭证和证书存储在可访问的位置，便于测试和开发。生产环境必须使用安全的存储解决方案 AWS Secrets Manager，例如或 Systems Manager Parameter Store。他们必须实现静态加密，并遵循 AWS IoT 安全准则。  
 **容器权限**：该演示以提升的权限运行，允许不受限制地访问主机资源并简化开发工作流程。在生产环境中，容器应以最低要求的权限运行。  
 **网桥配置**：该演示使用网络桥接配置，该配置可公开内部网络流量，便于调试和监控。在生产环境中，实施适当的网络隔离和分段，以防止未经授权访问内部网络流量。  
 **USB 设备权限**：启用不受限制的 USB 设备访问权限，便于轻松连接开发外围设备和测试设备。在生产环境中，实施严格的 USB 设备控制和验证，以防止设备欺骗攻击。  
 这些配置支持直接测试，不得在生产环境中使用。部署到生产环境时，请遵循安全最佳实践，以防止主机系统受损和未经授权访问凭证。

 该演示应用程序是一个 React-based 演示应用程序，展示了用于智能家居设备管理的托管集成功能。此应用程序通过现代 Web 界面演示设备上线、控制 Z-Wave 和监控 Zigbee 设备。

## 先决条件
<a name="prerequisites-demo-app"></a>
+ [注册一个 AWS 账户](https://docs.aws.amazon.com/iot-mi/latest/devguide/setting-up.html#sign-up-for-aws)。
+  [创建一个凭证柜](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-ss.html#managedintegrations-sdk-v2-cookbook-credential-locker)，[然后将凭证柜添加到您的中心](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-ss.html#managedintegrations-sdk-v2-cookbook-add-to-hub)。
+ 完成 [Hub 入门设置](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-hubsetup.html)。
+ [Node.js 18\+ 还有 npm](https://nodejs.org/en/download)。
+ [AWS CLI 从《托管集成 AWS CLI 命令参考》中](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)安装最新版本的。
+ 现代网络浏览器（Chrome、火狐浏览器、Safari、Edge）

## 安装和配置应用程序
<a name="installation-demo"></a>

1. 下载[托管集成演示应用程序](https://d2no7dt1utuyzo.cloudfront.net/IotMI-HubSDK-DemoApp/1.0.0/IotMI-HubSDK-DemoApp-v1.0.0.tar.gz)。

1. 解压缩包：

   ```
   cd ~/Downloads
   tar -xzf IotMI-HubSDK-DemoApp-v1.0.0.tar.gz
   cd IotManagedIntegrations-DemoApp
   ```

1. 安装依赖项：

   ```
   npm install
   ```

1. 在根目录下创建一个`.env`文件：

   ```
   # AWS Configuration
   REACT_APP_AWS_REGION=your_region
   REACT_APP_AWS_ACCESS_KEY_ID=your_access_key
   REACT_APP_AWS_SECRET_ACCESS_KEY=your_secret_key
   REACT_APP_AWS_SESSION_TOKEN=your_session_token
   
   # IoT Managed Integrations Endpoint
   REACT_APP_IOT_ENDPOINT=https://your-iot-endpoint.amazonaws.com
   
   # Hub Configuration
   REACT_APP_HUB_MANAGED_THING_ID=your_hub_id
   REACT_APP_CREDENTIAL_LOCKER_ID=your_credential_locker_id
   ```

1. 生成并启动应用程序：

   ```
   npm start
   ```

1. 访问该应用程序，网址为：

   ```
   http://localhost:3000
   ```

有关定价信息，请参阅[AWS IoT 设备管理定价页面上的托管集成部分](https://aws.amazon.com/iot-device-management/pricing/)。