As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Experimente o tutorial de conexão AWS IoT Core rápida Neste tutorial, você criará seu primeiro objeto, conectará um dispositivo a ele e observará como ele envia mensagens MQTT. Você deve levar de 15 a 20 minutos para concluir este tutorial. Este tutorial é ideal para pessoas que desejam começar rapidamente AWS IoT para ver como ele funciona em um cenário limitado. Caso esteja procurando por um exemplo que o ajude a começar a explorar mais atributos e serviços, consulte [Explore AWS IoT Core em tutoriais práticos](iot-gs-first-thing.md). Neste tutorial, você baixará e executará um software em um dispositivo que se conecta a um *recurso físico* AWS IoT Core como parte de uma solução de IoT muito pequena. O dispositivo pode ser um dispositivo de IoT, como um Raspberry Pi, como também pode ser um computador que execute Linux, OS e OSX ou Windows. Se você deseja conectar um dispositivo WAN (LoRaWAN) de longo alcance AWS IoT, consulte o tutorial [>Conectando dispositivos e gateways AWS IoT Core à LoRa](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-getting-started.html) WAN. Caso o seu dispositivo seja compatível com um navegador que execute o [console do AWS IoT](https://console.aws.amazon.com//iot/home), recomendamos que você conclua este tutorial nesse dispositivo. **nota** Se o seu dispositivo não tiver um navegador compatível, conclua o tutorial em um computador. Quando o procedimento solicitar que você baixe o arquivo, baixe-o em seu computador e, depois, transfira o arquivo baixado para seu dispositivo através do Secure Copy (SCP) ou de um processo similar. O tutorial requer que o seu dispositivo de IoT se comunique com a porta 8443 no endpoint de dados de dispositivo da sua Conta da AWS. Para testar se ele consegue acessar essa porta, conclua os procedimentos de [Testar a conectividade com o endpoint de dados de um dispositivo](iot-quick-start-test-connection.md). ## Etapa 1. Inicie o tutorial Se possível, realize este procedimento em seu dispositivo; caso contrário, esteja pronto para transferir um arquivo para seu dispositivo mais adiante neste procedimento. Para iniciar o tutorial, inicie uma sessão no [console do AWS IoT](https://console.aws.amazon.com//iot/home). Na página inicial do AWS IoT console, à esquerda, escolha **Conectar** e, em seguida, escolha **Conectar um dispositivo**. ![\[Esta página inicial do AWS IoT console mostra como conectar um dispositivo.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-quick-connect.PNG) ## Etapa 2. Criar um objeto 1. Na seção **Preparar seu dispositivo**, siga as instruções na tela para preparar seu dispositivo para conexão com o AWS IoT. ![\[Como preparar o dispositivo no AWS IoT console.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-prepare-device.png) 1. Na seção **Registrar e proteger seu dispositivo**, selecione **Criar um objeto nova** ou **Selecionar um objeto existente**. No campo **Nome do objeto**, digite o nome do objeto. O nome do objeto usado no exemplo é **TutorialTestThing** **Importante** Verifique o nome de objeto antes de continuar. Não é possível alterar o nome de um objeto depois da criação do objeto. Se você quiser alterar o nome de um objeto, será preciso criar um novo objeto com o nome correto e, em seguida, excluir o objeto com o nome incorreto. Na seção **Configurações adicionais**, personalize ainda mais seu recurso de objeto com as configurações opcionais listadas. Depois de fornecer um nome ao objeto e selecionar as configurações adicionais, selecione **Próximo**. ![\[Use o AWS IoT console para registrar e proteger seu dispositivo.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-register-and-secure-your-device.png) 1. Na seção **Escolher plataforma e SDK**, escolha a plataforma e o idioma do SDK do AWS IoT dispositivo que você deseja usar. Este exemplo usa a Linux/OSX plataforma e o SDK do Python. Assegure-se de ter o python3 e o pip3 instalados no dispositivo de destino antes de avançar para a próxima etapa. **nota** Não deixe de verificar a lista de pré-requisitos de software exigidos pelo SDK escolhido na parte inferior da página do console. É preciso ter o software necessário instalado no computador de destino antes de prosseguir para a próxima etapa. Depois de escolher a plataforma e linguagem do SDK do dispositivo, selecione **Próximo**. ![\[Use o AWS IoT console para escolher a plataforma e o SDK.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-choose-platform-and-SDK.png) ## Etapa 3. Baixe os arquivos no seu dispositivo Essa página aparece após AWS IoT a criação do kit de conexão, que inclui os seguintes arquivos e recursos necessários para seu dispositivo: + Os arquivos de certificado do objeto, para autenticar o dispositivo + Um recurso de política, para autorizar seu objeto a interagir com o AWS IoT + O script para baixar o AWS Device SDK e executar o programa de amostra em seu dispositivo 1. Quando estiver pronto para continuar, selecione o botão **Baixar kit de conexão** para baixar o kit de conexão para a plataforma selecionada anteriormente. ![\[Esta é a página do AWS IoT console para baixar o arquivo de certificado.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-download-connection-kit_1.png) 1. Se estiver executando este procedimento no seu dispositivo, salve o arquivo do kit de conexão em um diretório a partir do qual você consiga executar comandos de linha de comando. Se não estiver executando este procedimento no seu dispositivo, salve o arquivo do kit de conexão em um diretório local e, em seguida, transfira o arquivo para seu dispositivo. 1. Na seção **Descompactar o kit de conexão no seu dispositivo**, digite **unzip connect\$1device\$1package.zip** no diretório onde estão os arquivos do kit de conexão. Se você estiver usando uma janela de PowerShell comando do Windows e o **unzip** comando não funcionar**expand-archive**, **unzip** substitua por e tente usar a linha de comando novamente. 1. Depois de obter o arquivo do kit de conexão em seu dispositivo, prossiga com o tutorial selecionando **Próximo**. ![\[AWS IoT página de download do arquivo do certificado do console após o download do kit de conexão.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-download-connection-kit_2.png) ## Etapa 4: Execute a amostra Este procedimento deve ser realizado em um terminal ou janela de comando no seu dispositivo enquanto você segue as instruções exibidas no console. Os comandos do console são orientados para o sistema operacional selecionado em [Etapa 2. Criar um objeto](#iot-quick-start-configure). As mostradas aqui são para os sistemas Linux/OSX operacionais. 1. Em um terminal ou janela de comando em seu dispositivo, no diretório com o arquivo do kit de conexão, execute as etapas mostradas no AWS IoT console. ![\[AWS IoT página de início rápido de instalação e execução do console.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-run-connection-kit.png) 1. Após inserir o comando da **Etapa 2** no console, você deve poder observar uma saída no terminal ou na janela de comando do dispositivo semelhante à seguinte. Essa saída é oriunda das mensagens que o programa está enviando e das quais recebe de volta do AWS IoT Core. ![\[AWS IoT exemplo de saída de programa de exemplo de início rápido do console.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-connect-console-output-python_updated.png) Enquanto o programa de exemplo estiver em execução, a mensagem de teste `Hello World!` também será exibida. A mensagem de teste é exibida no terminal ou na janela de comando do seu dispositivo. **nota** Para acessar mais informações sobre a assinatura e publicação de tópicos, consulte o código de exemplo do seu SDK escolhido. 1. Para executar o programa de exemplo novamente, repita os comandos da **Etapa 2** no console deste procedimento. 1. (Opcional) Se você quiser ver as mensagens do seu cliente de IoT no [AWS IoT console](https://console.aws.amazon.com//iot/home), abra o [cliente de teste MQTT](https://console.aws.amazon.com//iot/home#/test) na página **Teste** do console. AWS IoT Se você selecionou o SDK de Python, no **cliente de teste MQTT**, em **Filtro de tópicos**, insira o tópico, como por exemplo, **sdk/test/*python***, para assinar as mensagens do seu dispositivo. Os filtros de tópicos diferenciam maiúsculas de minúsculas e dependem da linguagem de programação do SDK selecionada na **Etapa 1**. Para acessar mais informações sobre a assinatura e publicação de tópicos, consulte o exemplo de código do seu SDK escolhido. 1. Depois de assinar no tópico de teste, execute **./start.sh** no seu dispositivo. Para obter mais informações, consulte [Exibir mensagens MQTT com o cliente AWS IoT MQTT](view-mqtt-messages.md). Depois de executar **./start.sh**, aparecerão mensagens no cliente MQTT, semelhantes à seguinte: ``` { "message": "Hello World!" [1] } ``` O número de `sequence` incluído entre `[]` aumenta em um cada vez que uma nova mensagem `Hello World!` é recebida e é interrompido quando você encerra o programa. 1. Para concluir o tutorial e ver um resumo, no AWS IoT console, escolha **Continuar**. ![\[AWS IoT página de conclusão de início rápido do console.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-connect-complete_updated1.png) 1. Um resumo do seu tutorial de conexão AWS IoT rápida aparecerá agora. ![\[AWS IoT página de resumo de início rápido do console.\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/aws-iot-learn-device-is-connected.png) ## Etapa 5. Explore mais Aqui estão algumas ideias para explorar AWS IoT mais depois de concluir o início rápido. + **[Visualize mensagens MQTT no cliente de teste MQTT](https://console.aws.amazon.com/iot/home#/test)** No [console da AWS IoT](https://console.aws.amazon.com//iot/home), é possível abrir o [cliente do MQTT](https://console.aws.amazon.com//iot/home#/test) na página **Teste** do console da AWS IoT . No **cliente de teste MQTT**, assine **\$1** e, em seguida, execute o programa **./start.sh** no seu dispositivo conforme descrito na etapa anterior. Para obter mais informações, consulte [Exibir mensagens MQTT com o cliente AWS IoT MQTT](view-mqtt-messages.md). + **Execute testes em seus dispositivos com o [Device Advisor](https://docs.aws.amazon.com//iot/latest/developerguide/device-advisor.html)** Use o Device Advisor para testar se seus dispositivos podem se conectar e interagir com, de forma segura e confiável. AWS IoT + **[Tutorial interativo](interactive-demo.md)** Para iniciar o tutorial interativo, na página **Learn** do AWS IoT console, no quadro **Veja como AWS IoT funciona**, escolha **Iniciar o tutorial**. + **[Prepare-se para explorar mais tutoriais](iot-gs-first-thing.md)** Esse início rápido fornece apenas uma amostra de AWS IoT. Se você quiser explorar AWS IoT mais e aprender sobre os recursos que a tornam uma poderosa plataforma de soluções de IoT, comece a preparar sua plataforma de desenvolvimento. [Explore AWS IoT Core em tutoriais práticos](iot-gs-first-thing.md) # Testar a conectividade com o endpoint de dados de um dispositivo Este tópico descreve como testar a conexão de um dispositivo com o *endpoint de dados do dispositivo* da sua conta, o endpoint que seus dispositivos de IoT usam para se conectar ao AWS IoT. Execute estes procedimentos no dispositivo que você deseja testar ou com uma sessão de terminal SSH conectada ao dispositivo que você deseja testar. **Topics** + [Localize o endpoint de dados do seu dispositivo](#iot-quick-start-test-connection-endpoint) + [Teste a conexão rapidamente](#iot-quick-start-test-connection-ping) + [Obtenha o aplicativo para testar a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-app) + [Teste a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-test) ## Localize o endpoint de dados do seu dispositivo Este procedimento explica como encontrar o endpoint de dados do dispositivo no [console de AWS IoT](https://console.aws.amazon.com//iot/home) para testar a conexão com seu dispositivo de IoT. **Para localizar o endpoint de dados do seu dispositivo** 1. No [console da AWS IoT](https://console.aws.amazon.com//iot/home), na seção **Conectar**, acesse **Configurações de domínio**. 1. Na página **Configurações de domínio**, acesse o contêiner **Configurações de domínio** e copie o **nome do domínio**. O valor do seu endpoint é exclusivo para você Conta da AWS e é semelhante a este exemplo:`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`. 1. Salve o endpoint de dados do seu dispositivo para usá-lo nos procedimentos seguintes. ## Teste a conexão rapidamente Este procedimento testa a conectividade geral com o endpoint de dados do seu dispositivo, mas não testa a porta específica a serem usadas pelos seus dispositivos. Este teste usa um programa comum e geralmente é suficiente para descobrir se os dispositivos podem se conectar ao AWS IoT. Se quiser testar a conectividade com a porta específica que seus dispositivos usarão, pule este procedimento e avance para [Obtenha o aplicativo para testar a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-app). **Para testar o endpoint de dados do dispositivo rapidamente** 1. Em uma janela de terminal ou linha de comando no seu dispositivo, substitua o endpoint de dados do dispositivo de exemplo (`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`) pelo endpoint de dados do dispositivo da sua conta e, depois, digite este comando. ------ #### [ Linux ] ``` ping -c 5 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com ``` ------ #### [ Windows ] ``` ping -n 5 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com ``` ------ 1. Se `ping` exibir uma saída semelhante à seguinte, ele se conectou ao endpoint de dados do seu dispositivo com êxito. Embora não tenha se comunicado AWS IoT diretamente, ele encontrou o servidor e é provável que ele AWS IoT esteja disponível por meio desse endpoint. ``` PING a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (xx.xx.xxx.xxx) 56(84) bytes of data. 64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=1 ttl=231 time=127 ms 64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=2 ttl=231 time=127 ms 64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=3 ttl=231 time=127 ms 64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=4 ttl=231 time=127 ms 64 bytes from ec2-EXAMPLE-218.eu-west-1.compute.amazonaws.com (xx.xx.xxx.xxx): icmp_seq=5 ttl=231 time=127 ms ``` Se você estiver satisfeito com esse resultado, pode interromper o teste neste ponto. Se você quiser testar a conectividade com a porta específica usada por AWS IoT, avance para [Obtenha o aplicativo para testar a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-app). 1. Se `ping` não retornou uma saída bem-sucedida, verifique o valor do endpoint para se assegurar de que você tenha o endpoint correto e verifique a conexão do dispositivo com a Internet. ## Obtenha o aplicativo para testar a conexão com o endpoint de dados e a porta do seu dispositivo Um teste de conectividade mais minucioso pode ser realizado com `nmap`. Este procedimento realiza testes para averiguar se `nmap` está instalado no seu dispositivo. **Para buscar `nmap` no dispositivo** 1. Em uma janela de terminal ou linha de comando no dispositivo que você quer testar, insira este comando para averiguar se `nmap` está instalado. ``` nmap --version ``` 1. Se uma saída semelhante à seguinte for exibida, `nmap` está instalado e você pode prosseguir para [Teste a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-test). ``` Nmap version 6.40 ( http://nmap.org ) Platform: x86_64-koji-linux-gnu Compiled with: nmap-liblua-5.2.2 openssl-1.0.2k libpcre-8.32 libpcap-1.5.3 nmap-libdnet-1.12 ipv6 Compiled without: Available nsock engines: epoll poll select ``` 1. Caso não veja uma resposta semelhante à mostrada na etapa anterior, será preciso instalar `nmap` no dispositivo. Escolha o procedimento com base no sistema operacional do dispositivo. ------ #### [ Linux ] Para este procedimento, é preciso que você tenha permissão para instalar softwares no computador. **Para instalar o nmap em seu computador Linux** 1. Em uma janela de terminal ou linha de comando no dispositivo, insira o comando correspondente à versão do Linux em execução. 1. Debian ou Ubuntu: ``` sudo apt install nmap ``` 1. CentOS ou RHEL: ``` sudo yum install nmap ``` 1. Teste a instalação com o seguinte comando: ``` nmap --version ``` 1. Se uma saída semelhante à seguinte for exibida, `nmap` está instalado e você pode prosseguir para [Teste a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-test). ``` Nmap version 6.40 ( http://nmap.org ) Platform: x86_64-koji-linux-gnu Compiled with: nmap-liblua-5.2.2 openssl-1.0.2k libpcre-8.32 libpcap-1.5.3 nmap-libdnet-1.12 ipv6 Compiled without: Available nsock engines: epoll poll select ``` ------ #### [ macOS ] Para este procedimento, é preciso que você tenha permissão para instalar softwares no computador. **Para instalar o nmap em seu computador macOS** 1. Em um navegador, abra [https://nmap.org/download\$1macosx](https://nmap.org/download#macosx) e baixe o instalador **estável mais recente**. Quando solicitado, selecione **Abrir com DiskImageInstaller**. 1. Na janela de instalação, transfira o pacote para a pasta **Aplicações**. 1. No **Localizador**, localize o pacote `nmap-xxxx-mpkg` na pasta **Aplicações**. Pressione **Ctrl-click** no pacote e selecione **Abrir** para abrir o pacote. 1. Examine a caixa de diálogo de segurança. Se estiver pronto para instalar **nmap**, selecione **Abrir** para instalar **nmap**. 1. No **Terminal**, teste a instalação com o seguinte comando: ``` nmap --version ``` 1. Se uma saída semelhante à seguinte for exibida, `nmap` está instalado e você pode prosseguir para [Teste a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-test). ``` Nmap version 7.92 ( https://nmap.org ) Platform: x86_64-apple-darwin17.7.0 Compiled with: nmap-liblua-5.3.5 openssl-1.1.1k nmap-libssh2-1.9.0 libz-1.2.11 nmap-libpcre-7.6 nmap-libpcap-1.9.1 nmap-libdnet-1.12 ipv6 Compiled without: Available nsock engines: kqueue poll select ``` ------ #### [ Windows ] Para este procedimento, é preciso que você tenha permissão para instalar softwares no computador. **Para instalar o nmap em seu computador Windows** 1. Em um navegador, abra [https://nmap.org/download\$1windows](https://nmap.org/download#windows) e baixe a versão **estável mais recente** do programa de instalação. Se solicitado, selecione **Salvar arquivo**. Quando o arquivo for baixado, abra-o na pasta de downloads. 1. Quando o download do arquivo de configuração for concluído, abra o **nmap-xxxx-setup.exe** baixado para instalar o aplicativo. 1. Aceite as configurações padrão conforme o programa é instalado. O aplicativo Npcap não é necessário para este teste. É possível desmarcar essa opção se não quiser instalá-la. 1. Em **Command**, teste a instalação com o seguinte comando: ``` nmap --version ``` 1. Se uma saída semelhante à seguinte for exibida, `nmap` está instalado e você pode prosseguir para [Teste a conexão com o endpoint de dados e a porta do seu dispositivo](#iot-quick-start-test-connection-test). ``` Nmap version 7.92 ( https://nmap.org ) Platform: i686-pc-windows-windows Compiled with: nmap-liblua-5.3.5 openssl-1.1.1k nmap-libssh2-1.9.0 nmap-libz-1.2.11 nmap-libpcre-7.6 Npcap-1.50 nmap-libdnet-1.12 ipv6 Compiled without: Available nsock engines: iocp poll select ``` ------ ## Teste a conexão com o endpoint de dados e a porta do seu dispositivo Esse procedimento testa a conexão do seu dispositivo de IoT com o endpoint de dados do dispositivo usando a porta selecionada. **Para testar o endpoint de dados e a porta do seu dispositivo** 1. Em uma janela de terminal ou linha de comando no seu dispositivo, substitua o endpoint de dados do dispositivo de exemplo (`a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com`) pelo endpoint de dados do dispositivo da sua conta e, depois, digite este comando. ``` nmap -p 8443 a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com ``` 1. Se `nmap` exibir uma saída semelhante à seguinte, `nmap` obteve êxito em se conectar ao endpoint de dados do seu dispositivo na porta selecionada. ``` Starting Nmap 7.92 ( https://nmap.org ) at 2022-02-18 16:23 Pacific Standard Time Nmap scan report for a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (xx.xxx.147.160) Host is up (0.036s latency). Other addresses for a3qEXAMPLEsffp-ats.iot.eu-west-1.amazonaws.com (not scanned): xx.xxx.134.144 xx.xxx.55.139 xx.xxx.110.235 xx.xxx.174.233 xx.xxx.74.65 xx.xxx.122.179 xx.xxx.127.126 rDNS record for xx.xxx.147.160: ec2-EXAMPLE-160.eu-west-1.compute.amazonaws.com PORT STATE SERVICE 8443/tcp open https-alt MAC Address: 00:11:22:33:44:55 (Cimsys) Nmap done: 1 IP address (1 host up) scanned in 0.91 seconds ``` 1. Se `nmap` não retornou uma saída bem-sucedida, verifique o valor do endpoint para se assegurar de que você tenha o endpoint correto e verifique a conexão do seu dispositivo com a Internet. É possível testar outras portas no endpoint de dados do dispositivo, como a porta 443, a porta HTTPS primária, substituindo a porta usada na etapa 1, `8443`, pela porta que você quer testar.