

# Configurar o AWS IoT Wireless
<a name="setting-up-iotwireless"></a>

Ao cadastrar-se na AWS, sua Conta da AWS é automaticamente cadastrada em todos os serviços da AWS, incluindo o AWS IoT Wireless. Você será cobrado apenas pelos serviços que usar.

Para configurar o AWS IoT Wireless, utilize as etapas na próxima seção:

**Topics**
+ [Configurar a Conta da AWS](#iotwireless-setup-account)
+ [Instalar o Python e a AWS CLI](#wireless-onboard-prereq)

## Configurar a Conta da AWS
<a name="iotwireless-setup-account"></a>

Antes de utilizar o AWS IoT Core for LoRaWAN ou o AWS IoT Core para Amazon Sidewalk pela primeira vez, execute as tarefas a seguir para configurar a sua Conta da AWS.

**Topics**
+ [Cadastrar-se em uma conta da AWS](#aws-sign-up-iotwireless)
+ [Criar um usuário do IAM](#create-iam-user-iotwireless)
+ [Fazer login como usuário do IAM](#sign-in-iam-user-iotwireless)

### Cadastrar-se em uma conta da AWS
<a name="aws-sign-up-iotwireless"></a>

Se você ainda não tem uma Conta da AWS, siga as etapas a seguir para criar uma.

**Como cadastrar-se para uma Conta da AWS**

1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).

1. Siga as instruções on-line.

   Parte do procedimento de cadastramento envolve o recebimento de uma chamada telefônica e a inserção de um código de verificação no teclado do telefone.

   Quando você se cadastra 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 atributos na conta. Como prática recomendada de segurança, [atribua acesso administrativo a um usuário administrativo](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) e utilize somente o usuário raiz para executar as [tarefas que exigem acesso do usuário raiz](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html).

### Criar um usuário do IAM
<a name="create-iam-user-iotwireless"></a>

Para criar um usuário administrador, selecione uma das opções a seguir.


****  

| Selecionar uma forma de gerenciar o administrador | Para | Por | Você também pode | 
| --- | --- | --- | --- | 
| Centro de Identidade do IAM (Recomendado) | Use credenciais de curto prazo para acessar a AWS.Isso está de acordo com as práticas recomendadas de segurança. Para obter informações sobre as práticas recomendadas, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp) no *Guia do usuário do IAM*. | Seguindo as instruções em [Conceitos básicos](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) no Centro de Identidade do AWS IAM Guia do usuário. | Para configurar o acesso programático, consulte [Configurar a AWS CLI para usar o Centro de Identidade do AWS IAM](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html) no AWS Command Line Interface Guia do usuário. | 
| No IAM (Não recomendado) | Use credenciais de curto prazo para acessar a AWS. | Seguindo as instruções em [Criar o seu primeiro usuário administrador e um grupo de usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) no Guia do usuário do IAM. | Para configurar o acesso programático, consulte [Gerenciamento de chaves de acesso de usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) no Guia do usuário do IAM. | 

### Fazer login como usuário do IAM
<a name="sign-in-iam-user-iotwireless"></a>

Depois de criar um usuário do IAM, você pode fazer login na AWS com seu nome de usuário e senha do IAM.

Antes de fazer login como usuário do IAM, você pode verificar o link de login para usuários do IAM no console do IAM. No painel do IAM, no link de login de usuários do IAM, é possível ver o link de login da sua Conta da AWS. O URL do link de login contém o ID da sua Conta da AWS sem traços (-).

Se você não quiser que o URL do link de login contenha o ID da sua Conta da AWS, crie um alias da conta. Para obter mais informações, consulte [Criação, exclusão e listagem de um alias de Conta da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias) no *Manual do usuário do IAM*.

**Como fazer login como usuário do IAM**

1. Saia do Console de gerenciamento da AWS.

1. Insira o link de login, que inclui seu ID (sem traços) da Conta da AWS ou o alias da Conta da AWS.

   ```
   https://aws_account_id_or_alias.signin.aws.amazon.com/console
   ```

1. Insira o nome e a senha de usuário do IAM que você acabou de criar.

Quando a conexão é estabelecida, a barra de navegação exibe *your\$1user\$1name @ your\$1aws\$1account\$1id*.

## Instalar o Python e a AWS CLI
<a name="wireless-onboard-prereq"></a>

Antes de conectar o dispositivo final LoRaWAN ou Sidewalk, configure a instalação do Python e a AWS CLI. 

**Importante**  
Para realizar todo o fluxo de trabalho de integração para provisionar e registrar seu dispositivo final do Sidewalk, você também deve configurar o HDK e o gateway do Sidewalk. Para obter instruções, consulte [Configuração do kit de desenvolvimento de hardware (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) e [Configuração de um gateway do Sidewalk](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html) na *documentação do Amazon Sidewalk*.

**Topics**
+ [Instale o Python e o Python3-pip](#wireless-prereq-python)
+ [Configurar a AWS CLI](#wireless-prereq-cli)

### Instale o Python e o Python3-pip
<a name="wireless-prereq-python"></a>

Para usar a AWS CLI e o boto3 conforme descrito na seção a seguir, use o Python versão 3.6 ou posterior. Se você quiser integrar seus dispositivos finais usando o console de AWS IoT, você pode pular esta seção e continuar configurando sua Conta da AWS. Para verificar se você já instalou o Python e o Python3-pip, execute os comandos a seguir. Se a execução desses comandos retornar a versão, o Python e o Python3-pip foram instalados corretamente.

```
python3 -V
pip3 --version
```

Se esse comando retornar um erro, pode ser porque o Python não está instalado, ou seu sistema operacional chame o executável Python v3.x de Python3. Nesse caso, substitua todas as instâncias de `python` por `python3` ao executar os comandos. Se ainda produzir um erro, baixe e execute o [instalador do Python](https://www.python.org/downloads/) ou instale o Python, dependendo do seu sistema operacional, conforme descrito abaixo. 

------
#### [ Windows ]

Em sua máquina Windows, baixe o Python no [site do Python](https://www.python.org/downloads/windows/) e execute o instalador para instalar o Python em sua máquina.

------
#### [ Linux ]

Em sua máquina Ubuntu, execute o seguinte comando `sudo` para instalar o Python.

```
sudo apt install python3
sudo apt install python3-pip
```

------
#### [ macOS ]

Em sua máquina Mac, use o Homebrew para instalar o Python. O Homebrew também instala o pip, que então aponta para a versão Python3 instalada.

```
$ brew install python
```

------

### Configurar a AWS CLI
<a name="wireless-prereq-cli"></a>

As etapas a seguir mostram como configurar a AWS CLI e o boto3 (AWS SDK para Python). Para seguir estas etapas, você precisa se cadastrar em uma Conta da AWS e criar um usuário administrativo. Para obter instruções, consulte [Configurar o AWS IoT Wireless](#setting-up-iotwireless).

1. 

**Instalar e configurar a AWS CLI**

   É possível utilizar a AWS CLI para integrar os dispositivos finais do Sidewalk ao AWS IoT Core para Amazon Sidewalk de forma programática. Se você quiser integrar seus dispositivos finais usando o console de AWS IoT, você pode pular esta seção. Abra o [console do AWS IoT Core](https://console.aws.amazon.com/iot/home#/) e vá para a próxima seção para começar a conectar os dispositivos ao AWS IoT Core para Amazon Sidewalk. Para obter instruções sobre como configurar o AWS CLI, consulte [Como instalar e configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

1. 

**Instale o boto3 (SDK da AWS para Python)**

   Os comandos a seguir mostram como instalar o boto3 (SDK da AWS para Python) e a AWS CLI. Você também instalará o botocore, que é necessário para executar o boto3. Para obter instruções detalhadas, consulte [Como instalar o Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation) no *Guia de documentação do Boto3*.
**nota**  
O `awscli` versão `1.26.6` requer a versão PyYAML 3.10 ou posterior, mas não posterior à 5.5.

   ```
   python3 -m pip install botocore-version-py3-none-any.whl
   python3 -m pip install boto3-version-py3-none-any.whl
   ```

1. 

**Configure suas credenciais e a região padrão**

   Configure suas credenciais e a região padrão nos arquivos `~/.aws/credentials` e `~/.aws/config`. A biblioteca boto3 usa essas credenciais para identificar sua Conta da AWS e autorizar chamadas de API. Para obter as instruções de configuração, consulte:
   + [Configuração](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration) no *Guia de documentação do Boto3*
   + [Configurações e configurações do arquivo de credenciais](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html) no *Guia de documentação da AWS CLI*