Aplicativo de demonstração de integrações gerenciadas

nota

Essa implementação do AWS IoT Hub SDK no Raspberry Pi é um projeto de demonstração destinado apenas para fins de aprendizado e teste e não deve ser usada em ambientes de produção. Para fins desta demonstração, defina as seguintes configurações para facilitar o desenvolvimento:

AWS armazenamento de credenciais: somente para fins de demonstração, as credenciais e os certificados são armazenados em um local acessível para facilitar o teste e o desenvolvimento. Os ambientes de produção devem usar soluções de armazenamento seguro AWS Secrets Manager, como o Systems Manager Parameter Store. Eles devem implementar a criptografia em repouso e seguir as diretrizes AWS IoT de segurança.

Privilégios de contêiner: a demonstração é executada com privilégios elevados para permitir acesso irrestrito aos recursos do host e simplificar os fluxos de trabalho de desenvolvimento. Na produção, os contêineres devem operar com os privilégios mínimos necessários.

Configuração da ponte de rede: a demonstração usa uma configuração de ponte de rede que expõe o tráfego interno da rede para facilitar a depuração e o monitoramento. Em ambientes de produção, implemente o isolamento e a segmentação adequados da rede para evitar o acesso não autorizado ao tráfego interno da rede.

Permissões do dispositivo USB: o acesso irrestrito ao dispositivo USB é ativado para facilitar a conexão dos periféricos de desenvolvimento e dos dispositivos de teste. Para produção, implemente controles e validação rígidos de dispositivos USB para evitar ataques de falsificação de dispositivos.

Essas configurações permitem testes diretos e não devem ser usadas em ambientes de produção. Ao implantar na produção, siga as melhores práticas de segurança para evitar o comprometimento do sistema host e o acesso não autorizado às credenciais.

O aplicativo de demonstração é um aplicativo de demonstração baseado em React que apresenta recursos de integrações gerenciadas para gerenciamento de dispositivos domésticos inteligentes. Este aplicativo demonstra a integração, controle e monitoramento de dispositivos Z-Wave e Zigbee por meio de uma interface web moderna.

Pré-requisitos

• Cadastre-se para criar uma AWS conta.

• Crie um armário de credenciais e adicione o armário de credenciais ao seu hub.

• Configuração completa de integração do Hub.

• Node.js 18+ e npm.

• Instale a versão mais recente do a AWS CLI partir da Referência de AWS CLI Comandos de Integrações Gerenciadas.

• Navegador web moderno (Chrome, Firefox, Safari, Edge)

Instale e configure o aplicativo

1. Baixe o aplicativo de demonstração de integrações gerenciadas.

2. Extraia o pacote:

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

3. Instale as dependências:

   npm install

4. Crie um .env arquivo no diretório raiz:

   # 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

5. Crie e inicie o aplicativo:

   npm start

6. Acesse o aplicativo em:

   http://localhost:3000

Para obter informações sobre preços, consulte a seção Integrações gerenciadas na página de preços do Gerenciamento de AWS IoT dispositivos.