Trabalhando com AWS IoT em AWS Cloud9 IDE - AWS Cloud9

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

Trabalhando com AWS IoT em AWS Cloud9 IDE

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

AWS IoT pré-requisitos

Para começar a usar o AWS IoT in AWS Cloud9 IDE, certifique-se de que sua AWS Cloud9 configuração Conta da AWS e configuração atendam a todos os requisitos. Para obter informações sobre os Conta da AWS requisitos e as permissões de AWS usuário específicos do AWS IoT serviço, consulte Introdução ao AWS IoT Core no Guia do AWS IoT desenvolvedor.

AWS IoT Coisas

AWS IoT conecta dispositivos Serviços da AWS e AWS recursos. Você pode conectar seus dispositivos AWS IoT usando objetos chamados 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 AWS IoT coisas, consulte Gerenciando dispositivos AWS IoT no Guia do AWS IoT desenvolvedor.

Gerenciando AWS IoT coisas

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

Como criar uma coisa
  1. No AWS Explorer, expanda a seção de serviços de 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 de serviços de 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 de serviços de 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 que essa etapa for concluída, o certificado separado não será mais exibido abaixo do item 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 de serviços de 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.

AWS IoT certificados

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 AWS IoT certificados, consulte Autenticação (IoT) no Guia do AWS IoT desenvolvedor.

Gerenciar certificados

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

Para criar um AWS IoT certificado

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

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

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

  3. Para salvar seu par de RSA chaves e o certificado X.509, selecione um diretório no 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 o seu Conta da AWS, por meio do AWS IoT serviço.

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

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

Como modificar o status de um certificado

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

nota
  • Seu certificado precisa de um status ativo antes que você possa usá-lo para conectar seu dispositivo ao seu AWS IoT serviço.

  • 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 de serviços de 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 de serviços de 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 de serviços de 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 de 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.

AWS IoT políticas

AWS IoT As principais políticas são definidas por meio de JSON documentos. Cada uma deve incluir pelo menos uma instrução. As políticas definem como AWS IoT AWS, e seus dispositivos podem interagir uns com os outros. 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 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

Ele AWS Cloud9 IDE oferece várias maneiras de gerenciar suas políticas AWS IoT de serviço. Essas são as maneiras pelas quais você pode gerenciar ou modificar suas políticas diretamente do AWS Explorer no VS Code:

Para criar uma AWS IoT política
nota

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

  1. No AWS Explorer, expanda a seção de serviços de 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. Insira um nome e siga as instruções para abrir uma caixa de diálogo solicitando que você selecione um JSON documento do seu sistema de arquivos.

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

Para carregar uma nova versão AWS IoT da política

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

nota

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

  1. No AWS Explorer, expanda a seção de serviços de 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 abrir, escolha o JSON arquivo 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.

Para editar uma versão AWS IoT da política

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

  1. No AWS Explorer, expanda a seção de serviços de 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 em AWS Cloud9, escolha 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 emUpload a new policy version.

Como selecionar uma nova versão da política como padrão
  1. No AWS Explorer, expanda a seção de serviços de 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 de serviços de 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).