Trabalhar com o AWS IoT no IDE do AWS Cloud9 - AWS Cloud9
Pré-requisitos da AWS IoTCoisas de AWS IoTCertificados do AWS IoTPolíticas do AWS IoT

AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais

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á.

Trabalhar com o AWS IoT no IDE do AWS Cloud9

Com o AWS IoT no IDE do AWS Cloud9, você pode interagir com o serviço AWS IoT e, ao mesmo tempo, minimizar as interrupções no fluxo de trabalho no AWS Cloud9. Este guia aborda como começar a usar os recursos do serviço AWS IoT que estão disponíveis no IDE do AWS Cloud9. Para obter mais informações, consulte O que é o AWS IoT? no Guia do desenvolvedor do AWS IoT.

Pré-requisitos da AWS IoT

Para começar a usar AWS IoT no IDE do AWS Cloud9, a configuração da Conta da AWS e do AWS Cloud9 deve atender a todos os requisitos. Para obter informações sobre os requisitos da Conta da AWS e as permissões de usuário da AWS específicos do serviço AWS IoT, consulte Getting Started with AWS IoT Core no Guia do desenvolvedor de AWS IoT.

Coisas de AWS IoT

O AWS IoT conecta dispositivos aos Serviços da AWS e aos recursos da AWS. Você pode conectar seus dispositivos ao AWS IoT usando objetos denominados coisas. Um item é uma representação de um dispositivo específico ou entidade lógica. Ela pode ser um dispositivo físico ou sensor (por exemplo, uma lâmpada ou um interruptor em uma parede). Para obter mais informações sobre coisas do AWS IoT, consulte Managing devices with AWS IoT no Guia do desenvolvedor do AWS IoT.

Gerenciar coisas de AWS IoT

O IDE do AWS Cloud9 tem vários recursos que tornam o gerenciamento de coisas eficiente. Para gerenciar suas coisas de AWS IoT, siga estas etapas:

Como criar uma coisa

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Abra o menu de contexto (clique com o botão direito do mouse) da coisa e selecione Create Thing (Criar coisa).

  3. Digite um nome para a coisa no campo Thing Name (Nome da coisa) e siga as instruções.

  4. Quando essa etapa for concluída, um ícone de coisa seguido pelo nome que você especificou ficará visível na seção Thing (Coisa).

Como anexar um certificado a uma coisa

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Things (Coisas), localize a coisa à qual você está anexando o certificado.

  3. Abra o menu de contexto (clique com o botão direito) da coisa e selecione Attach Certificate (Anexar certificado) no menu de contexto, para abrir um seletor de entrada com uma lista de seus certificados.

  4. Na lista, selecione o ID do certificado correspondente ao certificado que você deseja anexar à sua coisa.

  5. Depois de concluir essa etapa, seu certificado estará acessível no AWS Explorer como um item da coisa à qual você o anexou.

Como desanexar um certificado de uma coisa

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Things (Coisas), localize a coisa da qual você deseja desanexar um certificado.

  3. Abra o menu de contexto (clique com o botão direito do mouse) da coisa e selecione Attach Certificate (Anexar certificado).

  4. Depois de concluir essa etapa, o certificado desanexado não será mais exibido abaixo da coisa no AWS Explorer. No entanto, ele ainda pode ser acessado na subseção Certificates (Certificados).

Como excluir uma coisa

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Things (Coisas), localize a coisa que você deseja excluir.

  3. Abra o menu de contexto (clique com o botão direito do mouse) da coisa e selecione Delete Thing (Excluir coisa).

  4. Depois de concluir essa etapa, a coisa excluída não estará mais disponível na subseção Things (Coisas).

    nota

    Você só pode excluir uma coisa que não tenha um certificado anexado.

Certificados do AWS IoT

Os certificados são uma forma comum de criar uma conexão segura entre seus serviços e dispositivos de AWS IoT. Os certificados X.509 são certificados digitais que usam a infraestrutura de chave pública X.509 padrão para associar uma chave pública a uma identidade contida em um certificado. Para obter mais informações sobre certificados de AWS IoT, consulte Authentication (IoT) (Autenticação (Iot) no Guia do desenvolvedor de AWS IoT.

Gerenciar certificados

O kit de ferramentas da AWS oferece várias maneiras de gerenciar seus certificados de AWS IoT diretamente do AWS Explorer. Eles são descritos nas seguintes etapas:

Como criar um certificado de AWS IoT

Um certificado X.509 é usado para se conectar à sua instância de AWS IoT.

  1. No AWS Explorer, expanda a seção do serviço IoT e abra (clique com o botão direito do mouse) Certificates (Certificados).

  2. Para abrir uma caixa de diálogo, selecione Create Certificate (Criar certificado) no menu de contexto.

  3. Para salvar seu par de chaves RSA e o certificado X.509, selecione um diretório em seu sistema de arquivos local.

    nota

    • Os nomes de arquivo padrão contêm o ID do certificado como prefixo.

    • Somente o certificado X.509 é armazenado com sua Conta da AWS, por meio do serviço AWS IoT.

    • Seu par de chaves RSA só pode ser emitido uma vez, salve-o em um local seguro em seu sistema de arquivos quando solicitado.

    • Se o certificado ou o par de chaves não puderem ser salvos em seu sistema de arquivos, o Kit de ferramentas da AWS excluirá o certificado de sua Conta da AWS.

Como modificar o status de um certificado

O status de um certificado individual é exibido ao lado do ID do certificado no AWS Explorer e pode ser definido como ativo, inativo ou revogado.

nota

  • Seu certificado precisa de um status ativo para poder usá-lo a fim de conectar seu dispositivo ao seu serviço AWS IoT.

  • Um certificado inativo pode ser ativado, independentemente de ter sido desativado anteriormente ou estar inativo por padrão.

  • Um certificado que foi revogado não pode ser reativado.

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Certificates (Certificados), localize o certificado que você deseja modificar.

  3. Abra o menu de contexto (clique com o botão direito do mouse) do certificado que exibe as opções de alteração de status disponíveis para esse certificado.

  • Se um certificado tiver o status inativo, selecione activate (ativar) para alterar o status para ativo.

  • Se um certificado tiver o status ativo, selecione deactivate (desativar) para alterar o status para inativo.

  • Se um certificado tiver o status ativo ou inativo, selecione revoke (revogar) para alterar o status para revogado.

nota

Cada uma dessas ações de alteração de status estará disponível se você selecionar um certificado anexado a uma coisa enquanto estiver exibida na subseção Things (Coisas).

Como anexar uma política de IoT a um certificado

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Certificados, localize o certificado que você deseja modificar.

  3. Abra o menu de contexto (clique com o botão direito do mouse) do certificado e selecione Anexar política para abrir um seletor de entrada com uma lista de suas políticas disponíveis.

  4. Selecione a política que você deseja anexar ao certificado.

  5. Quando essa etapa for concluída, a política selecionada será adicionada ao certificado como um item de submenu.

Como anexar uma política de IoT de um certificado

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Na subseção Certificados, localize o certificado que você deseja modificar.

  3. Expanda o certificado e localize a política que você deseja desanexar.

  4. Abra o menu de contexto (clique com o botão direito do mouse) da política e selecione Detach (Desanexar) no menu de contexto.

  5. Quando essa etapa for concluída, a política não estará mais acessível em seu certificado, ela estará disponível na subseção Policy (Política).

Para excluir um certificado

  1. No AWS Explorer, expanda o título do serviço IoT.

  2. Na subseção Certificates (Certificados), localize o certificado que você deseja excluir.

  3. Abra o menu de contexto (clique com o botão direito do mouse) do certificado e selecione Delete Certificate (Excluir certificado) no menu de contexto.

    nota

    Não será possível excluir um certificado se ele estiver anexado a uma coisa ou tiver um status ativo. Você pode excluir um certificado que tenha políticas anexadas.

Políticas do AWS IoT

As políticas do AWS IoT Core são definidas por meio de documentos JSON. Cada uma deve incluir pelo menos uma instrução. As políticas definem como AWS IoT, a AWS e seu dispositivo podem interagir entre si. Para obter mais informações sobre como criar um documento de política, consulte IoT Polices (Políticas de IoT) no Guia do desenvolvedor de AWS IoT.

nota

As políticas nomeadas são versionadas para que você possa revertê-las. No AWS Explorer, suas políticas de IoT estão listadas na subseção Policies (Políticas) do serviço AWS IoT. Você pode visualizar as versões da política expandindo uma política. A versão padrão é indicada por um asterisco (*).

Gerenciamento de políticas

O IDE do AWS Cloud9 oferece várias maneiras de gerenciar suas políticas do serviço AWS IoT. Essas são maneiras de gerenciar ou modificar suas políticas diretamente no AWS Explorer no VS Code:

Como criar uma política do AWS IoT
nota

Você pode criar uma política no AWS Explorer. No entanto, o documento JSON que define a política já deve existir em seu sistema de arquivos.

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Abra o menu de contexto (clique com o botão direito) da subseção Policies (Políticas) e, para abrir o campo de entrada Policy Name (Nome da política), selecione Create Policy from Document (Criar política a partir do documento).

  3. Digite um nome e siga as instruções para abrir uma caixa de diálogo solicitando que você selecione um documento JSON do seu sistema de arquivos.

  4. Selecione o arquivo JSON que contém suas definições de política. A política estará disponível no AWS Explorer após a conclusão.

Como fazer upload de uma nova versão da política de AWS IoT

Você pode criar uma versão de uma política fazendo upload de um documento JSON para a política.

nota

O novo documento JSON deve estar presente em seu sistema de arquivos para criar uma versão com o uso do AWS Explorer.

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Expanda a subseção Policies (Políticas) para ver suas políticas de AWS IoT.

  3. Abra o menu de contexto (clique com o botão direito do mouse) da política que você deseja atualizar e selecione Create new version from Document (Criar versão do documento).

  4. Quando a caixa de diálogo for aberta, selecione o arquivo JSON que contém as atualizações de suas definições de política.

    A nova versão pode ser acessada a partir de sua política no AWS Explorer.

Como editar uma versão de política de AWS IoT

Você pode abrir e editar um documento de política com o uso do AWS Cloud9. Ao terminar de editar o documento, salve-o em seu sistema de arquivos. Depois, faça upload dele para o seu serviço AWS IoT a partir do AWS Explorer.

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Expanda a subseção Policies (Políticas) e localize a política que você deseja atualizar.

  3. Para abrir o Policy Name (Nome da política), selecione Create Policy (Criar política) no Document (Documento).

  4. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja editar.

  5. Para abrir a versão da política no AWS Cloud9, selecione View (Exibir) no menu de contexto para abrir a versão da política.

  6. Quando o documento de política for aberto, edite e salve as alterações.

    nota

    Nesse momento, as alterações feitas na política são salvas somente no sistema de arquivos local. Para atualizar a versão e rastreá-la com o AWS Explorer, repita as etapas em Upload a new policy version.

Como selecionar uma nova versão da política como padrão

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Expanda a subseção Policies (Políticas) e localize a política que você deseja atualizar.

  3. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja definir e selecione Set as Default (Definir como padrão).

    Depois de terminar esse procedimento, a nova versão padrão que você selecionou terá uma estrela ao lado dela.

Para excluir políticas do
nota

Antes de excluir uma política ou uma versão da política, as seguintes condições devem ser atendidas:

  • Não será possível excluir uma política se ela estiver anexada a um certificado.

  • Você não poderá excluir uma política se ela tiver alguma versão não padrão.

  • Você só poderá excluir a versão padrão de uma política se uma nova versão padrão for selecionada ou se toda a política for excluída.

  • Antes de excluir uma política inteira, você deve excluir toda a versão não padrão dessa mesma política.

  1. No AWS Explorer, expanda a seção do serviço IoT.

  2. Expanda a subseção Policies (Políticas) e localize a política que você deseja atualizar.

  3. Expanda a política que você deseja atualizar e abra o menu de contexto (clique com o botão direito do mouse) da versão da política que você deseja excluir e selecione Delete (Excluir).

  4. Quando uma versão é excluída, ela não fica mais visível no AWS Explorer.

  5. Se apenas a versão padrão de uma política for mantida, abra o menu de contexto (clique com o botão direito do mouse) da política principal e selecione Delete (Excluir).