# Conceitos básicos do AWS IoT Wireless É possível começar a usar o AWS IoT Wireless cadastrando-se em uma Conta da AWS e seguindo as etapas para criar um usuário do IAM. Após o cadastro, é possível utilizar o Console de gerenciamento da AWS, a API do AWS IoT Wireless ou a AWS CLI para integrar os dispositivos e gateways Sidewalk e LoRaWAN. Ao integrar dispositivos, considere uma forma de descrever e marcar os recursos para ajudar a identificá-los mais facilmente. Os tópicos a seguir mostram como começar a usar o AWS IoT Wireless. **Topics** + [Configurar o AWS IoT Wireless](setting-up-iotwireless.md) + [Descrever os recursos do AWS IoT Wireless](iotwireless-describe-resources.md) # Configurar o AWS IoT Wireless 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 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 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 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 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 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 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 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* # Descrever os recursos do AWS IoT Wireless Antes de começar a usar a integração de dispositivos LoRaWAN ou Sidewalk, considere a convenção de nomenclatura dos dispositivos, dos gateways e do destino. O AWS IoT Wireless oferece várias opções para identificar os recursos criados. Embora os recursos do AWS IoT Wireless recebam uma ID exclusiva quando são criados, essa ID não é descritiva nem pode ser alterada após a criação do recurso. Para tornar a seleção, a identificação e o gerenciamento dos recursos mais conveniente, atribua um nome, adicione uma descrição e anexe tags e valores de tags à maioria dos recursos do AWS IoT Wireless. + **[Nomes e descrição dos recursos](#wireless-describe-resource-names)** Para dispositivos, gateways e perfis, o nome do recurso é um campo opcional que você pode alterar após a criação do recurso. O nome aparece nas listas exibidas nas páginas do hub de recursos. Para destinos, dê um nome exclusivo para a conta da AWS e Região da AWS. Não é possível alterar o nome do destino depois que o recurso de destino é criado. Embora um nome possa ter até 256 caracteres, o espaço de exibição no hub de recursos é limitado. Certifique-se de que a parte distintiva do nome apareça nos primeiros 20 a 30 caracteres, se possível. + **[Tags de recursos](#wireless-describe-resource-tags)** As tags são pares de chave/valor de metadados que podem ser anexados aos recursos da AWS. Você escolhe as chaves de tag e os valores correspondentes. Gateways, destinos e perfis podem ter até 50 tags anexadas a eles. Os dispositivos não são compatíveis com tags. ## Nomes e descrição dos recursos **Suporte ao recurso AWS IoT Wireless para nome** | Recurso | Suporte ao campo de nome | | --- | --- | | Destino | O nome é uma ID exclusiva do recurso e não pode ser alterado. | | Dispositivo sem fio | O nome é um descritor opcional do recurso e pode ser alterado. | | Gateway LoRaWAN | O nome é um descritor opcional do recurso e pode ser alterado. | | Perfil | O nome é um descritor opcional do recurso e pode ser alterado. | O campo de nome aparece nas listas do hub de recursos; no entanto, o espaço é limitado e, portanto, somente os primeiros 15 a 30 caracteres do nome podem estar visíveis. Ao selecionar nomes para os recursos, considere como você deseja que eles identifiquem os recursos e como serão exibidos no console. **Descrição** Os recursos de destino, dispositivo e gateway também oferecem suporte a um campo de descrição, que pode aceitar até 2.048 caracteres. O campo de descrição aparece somente na página de detalhes do recurso individual. Embora o campo de descrição possa conter muitas informações, ele aparece somente na página de detalhes do recurso e pode não ser conveniente para digitalização no contexto de vários recursos. ## Tags de recursos **Suporte de recursos do AWS IoT Wireless para tags da AWS** | Recurso | Suporte a tags da AWS | | --- | --- | | Destino | Você pode adicionar até 50 tags da AWS ao recurso. | | Dispositivo sem fio | Esse recurso não é compatível com tags da AWS. | | Gateway LoRaWAN | Você pode adicionar até 50 tags da AWS ao recurso. | | Perfil | Você pode adicionar até 50 tags da AWS ao recurso. | Tags são palavras ou frases que funcionam como metadados que você pode usar para identificar e organizar os recursos da AWS. Você pode pensar na chave de tag como uma categoria de informações e no valor de tag como um valor específico nessa categoria. Por exemplo, você pode ter um valor de tag de *cor* e dar a alguns recursos um valor de *azul* para essa tag e a outros um valor de *vermelho*. Com isso, você pode usar o [Editor de tag](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) no console da AWS para encontrar os recursos com um valor de tag de *cor* de *azul*. Para obter mais informações sobre marcação no AWS IoT Wireless, consulte [Marcando seus Recursos AWS IoT Wireless](tagging-iotwireless.md). Para ter mais informações sobre tags e estratégias de marcação, consulte [Editor de tags](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html).