Primeiras etapas

Como cadastrar uma Conta da AWS

1. Abra https://portal.aws.amazon.com/billing/signup.

2. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

   Quando você se inscreve para uma Conta da AWS, um Usuário raiz da conta da AWS é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.

Proteger o Usuário raiz da conta da AWS

1. Faça login no Console de gerenciamento da AWS como o proprietário da conta ao escolher a opção Usuário-raiz e inserir o endereço de e-mail da Conta da AWS. Na próxima página, insira a senha.

   Para obter ajuda ao fazer login usando o usuário-raiz, consulte Fazer login como usuário-raiz no Guia do usuário do Início de Sessão da AWS.

2. Habilite a autenticação multifator (MFA) para o usuário-raiz.

   Para obter instruções, consulte Habilitar um dispositivo MFA virtual para sua Conta da AWS de usuário-raiz (console) no Guia do usuário do IAM.

Criar um usuário com acesso administrativo

1. Habilita o Centro de Identidade do IAM.

   Para obter instruções, consulte Habilitar o AWS IAM Identity Center no Guia do usuário do AWS IAM Identity Center.

2. No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.

   Para obter um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como a fonte de identidade, consulte Configurar o acesso dos usuários com o Diretório do Centro de Identidade do IAM padrão no Guia do usuário do AWS IAM Identity Center.

Iniciar sessão como o usuário com acesso administrativo

• Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.

  Para obter ajuda para fazer login usando um usuário do Centro de Identidade do IAM, consulte Fazer login no portal de acesso da AWS, no Guia do usuário do Início de Sessão da AWS.

Atribuir acesso a usuários adicionais

1. No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.

   Para obter instruções, consulte Criar um conjunto de permissões no Guia do usuário do AWS IAM Identity Center.

2. Atribua usuários a um grupo e, em seguida, atribua o acesso de autenticação única ao grupo.

   Para obter instruções, consulte Adicionar grupos no Guia do usuário do AWS IAM Identity Center.

Para criar uma política do AWS IoT

1. Para criar uma política do IAM, você precisa saber sua região da AWS e o número da conta da AWS.

   Para localizar o número da conta da AWS, abra o Console de Gerenciamento da AWS, localize e expanda o menu abaixo do nome da conta no canto superior direito e selecione Minha conta. O ID da conta é exibido em Account Settings (Configurações da conta).

   Para encontrar a região da AWS para sua conta da AWS, use a AWS Command Line Interface. Para instalar a AWS CLI, siga as instruções no Guia do usuário da AWS Command Line Interface. Depois de instalar a AWS CLI, abra uma janela de prompt de comando e digite o seguinte comando:

   aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   O resultado deve ser semelhante ao seguinte:

   {
       "endpointAddress": "xxxxxxxxxxxxxx-ats.iot.us-west-2.amazonaws.com"
   }

   Neste exemplo, a região é us-west-2.

   nota

   Recomendamos o uso de endpoints do ATS, conforme mostrado no exemplo.

2. Navegue até o console do AWS IoT.

3. No painel de navegação, escolha Secure (Seguro), Policies (Políticas) e Create (Criar).

4. Insira um nome para identificar a política.

5. Na seção Add statements (Adicionar instruções), escolha Advanced mode (Modo avançado). Copie e cole o seguinte JSON na janela do editor de política. (Substitua aws-region e aws-account por sua região e seu ID de conta da AWS.)

   JSON

   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iot:Connect",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Publish",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Receive",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           }
       ]
   }
   

   Essa política concede as seguintes permissões:

   iot:Connect

   Concede ao dispositivo permissão para se conectar ao agente de mensagem da AWS IoT com qualquer ID de cliente.

   iot:Publish

   Concede ao dispositivo permissão para publicar uma mensagem MQTT em qualquer tópico MQTT.

   iot:Subscribe

   Concede ao dispositivo permissão para assinar o filtro de tópico MQTT.

   iot:Receive

   Concede ao dispositivo permissão para receber mensagens do agente de mensagem da AWS IoT em qualquer tópico MQTT.

6. Escolha Criar.

Para criar uma coisa do IoT, chave privada e certificado para o dispositivo

1. Navegue até o console do AWS IoT.

2. No painel de navegação, escolha Manage (Gerenciar) e, depois, Things (Coisas).

3. Se você não tiver nada do IoT registrado na sua conta, a página You don't have any things yet (Você não tem coisas ainda) será exibida. Se você visualizar esta página, selecione Register a thing (Registrar uma coisa). Caso contrário, escolha Criar.

4. Na página Criar AWS IoT objetos, escolha a opção Criar uma único objeto.

5. Na página Add your device to the thing registry (Adicionar seu dispositivo ao registro de coisas), insira um nome para a coisa e escolha Next (Próximo).

6. Na página Add a certificate for your thing (Adicionar um certificado à sua coisa), em One-click certificate creation (Criação do certificado com um clique, escolha Create certificate (Criar certificado).

7. Baixe a chave privada e o certificado escolhendo os links Download para cada um deles.

8. Selecione Activate (Ativar) para ativar o certificado. Os certificados devem ser ativados antes do uso.

9. Escolha Attach a policy (Anexar uma política) para anexar uma política ao certificado que concede ao dispositivo acesso a operações do AWS IoT.

10. Escolha a política que você acabou de criar e escolha Register thing (Registrar coisa).

Para configurar o endpoint da AWS IoT

Você precisa fornecer ao FreeRTOS o endpoint do AWS IoT para que a aplicação em execução em sua placa possa enviar solicitações para o endpoint correto.

1. Navegue até o console do AWS IoT.

2. No painel de navegação à esquerda, escolha Configurações.

   Seu endpoint do AWS IoT é exibido na seção Endpoint de dados do dispositivo. Deve ser semelhante a 1234567890123-ats.iot.us-east-1.amazonaws.com. Anote esse endpoint.

3. No painel de navegação, escolha Manage (Gerenciar) e, depois, Things (Coisas).

   Seu dispositivo deve ter um nome de coisa da AWS IoT. Anote esse nome.

4. Abra o demos/include/aws_clientcredential.h.

5. Especifique valores para as seguintes constantes:

   • #define clientcredentialMQTT_BROKER_ENDPOINT "Your AWS IoT endpoint";

   • #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"

Para configurar a rede Wi-Fi

Se a sua placa estiver conectada à Internet por meio de uma conexão Wi-Fi, será necessário fornecer ao FreeRTOS as credenciais de Wi-Fi para se conectar à rede. Se a placa não oferecer suporte a Wi-Fi, você poderá ignorar estas etapas.

1. demos/include/aws_clientcredential.h.

2. Especifique os valores para as seguintes constantes #define:

   • #define clientcredentialWIFI_SSID "The SSID for your Wi-Fi network"

   • #define clientcredentialWIFI_PASSWORD "The password for your Wi-Fi network"

   • #define clientcredentialWIFI_SECURITY O tipo de segurança da rede Wi-Fi

     Os tipos de segurança válidos são:

     • eWiFiSecurityOpen (Aberto, sem segurança)

     • eWiFiSecurityWEP (segurança WEP)

     • eWiFiSecurityWPA (segurança WPA)

     • eWiFiSecurityWPA2 (segurança WPA2)

Para formatar as credenciais da AWS IoT

O FreeRTOS precisa ter o certificado e das chaves privadas do AWS IoT associados à coisa registrada, além das políticas de permissões, para se comunicar com êxito com a AWS IoT em nome do seu dispositivo.

O FreeRTOS é um projeto de linguagem C e o certificado e a chave privada devem ser formatados especialmente para serem adicionados ao projeto.

1. Em uma janela do navegador, abra tools/certificate_configuration/CertificateConfigurator.html.

2. Em Arquivo PEM do certificado, selecione ID-certificate.pem.crt do qual foi feito download no console do AWS IoT.

3. Em Arquivo PEM da chave privada, selecione ID-private.pem.key do qual foi feito download no console do AWS IoT.

4. Selecione Generate and save aws_clientcredential_keys.h (Gerar e salvar aws_clientcredential_keys.h) e salve o arquivo em demos/include. Isso substitui o arquivo existente no diretório.

   nota

   O certificado e a chave privada são codificados para fins de demonstração somente. Por este motivo, as aplicações devem armazenar esses arquivos em um local seguro.