Compartilhar via


Gerenciar registros de dispositivo no portal do Azure

Um registro de dispositivo cria um registro de um único dispositivo ou de um grupo de dispositivos que podem, em algum momento, registrar-se com o DPS (Serviço de Provisionamento de Dispositivos) do Hub IoT do Azure. O registro de inscrição contém a configuração inicial do dispositivo como parte dessa inscrição. Incluído na configuração está o hub IoT ao qual um dispositivo é atribuído ou uma política de alocação que se aplica a um conjunto de hubs IoT. Este artigo mostra como gerenciar registros de dispositivo para seu serviço de provisionamento.

O Serviço de Provisionamento de Dispositivos dá suporte a dois tipos de registros:

Important

Se você tiver problemas para acessar registros do portal do Azure, pode ser porque você tem o acesso à rede pública desabilitado ou regras de filtragem de IP configuradas que bloqueiam o acesso ao portal do Azure. Para saber mais, confira Desabilitar limitações de acesso à rede pública e limitações de regras de filtro IP.

Prerequisites

Criar um grupo de registro

Um grupo de registro é uma entrada para um grupo de dispositivos que compartilham um mecanismo de atestado comum. Recomendamos que você use um grupo de registro para um grande número de dispositivos que compartilham uma configuração inicial ou para dispositivos que vão para o mesmo locatário. Os grupos de registro dão suporte ao certificado X.509 ou ao atestado de chave simétrica .

Para obter um passo a passo que demonstra como criar e usar grupos de registro com certificados X.509, consulte Tutorial: Provisionar dispositivos usando grupos de registro de chaves simétricas.

Para criar um grupo de registro de certificado X.509:

  1. Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.

  2. Selecione Gerenciar registros na seção Configurações do menu de navegação.

  3. Na parte superior da página, selecione Adicionar grupo de registro.

  4. Na guia Registro + provisionamento da página Adicionar grupo de registro, forneça as seguintes informações para configurar os detalhes do grupo de registro:

    Field Description
    Attestation Selecione certificados intermediários X.509 como o mecanismo de atestado se quiser carregar certificados intermediários a serem usados apenas para esse grupo de registro ou selecione certificados X.509 carregados neste Serviço de Provisionamento de Dispositivos se você já carregou certificados intermediários.
    Configurações de certificado X.509 Dependendo do método de atestado escolhido, carregue ou selecione os certificados intermediários primário e secundário para esse grupo de registro.
    Nome do grupo Forneça um nome para o grupo de dispositivos. O nome do grupo de registro é uma cadeia de caracteres que não diferencia maiúsculas de minúsculas (até 128 caracteres) de símbolos alfanumérico e caracteres especiais: '-', '.', '_' e ':'. O último caractere deve ser alfanumérico ou um traço ('-').
    Status do provisionamento Marque a caixa Habilitar este registro se quiser que esse grupo de registro esteja disponível para provisionar dispositivos. Desmarque essa caixa se quiser que o grupo seja desabilitado. Você pode alterar essa configuração mais tarde.
    Política de reprovisionamento Escolha uma política de reprovisionamento que reflita como você deseja que o DPS manipule os dispositivos que solicitam o reprovisionamento. Para obter mais informações, veja as Políticas de reprovisionamento

    Captura de tela que mostra a adição de um grupo de registro para o atestado de certificado X.509.

  5. Selecione Próximo: hubs IoT.

  6. Na guia hubs IoT da página Adicionar grupo de registro, forneça as seguintes informações para determinar para quais hubs IoT o grupo de registro pode provisionar dispositivos:

    Field Description
    Hubs IoT de destino Selecione um ou mais dos hubs IoT vinculados ou adicione um novo link a um hub IoT. Para saber mais sobre como vincular hubs IoT à instância do DPS, confira Como vincular e gerenciar hubs IoT.
    Política de alocação Se você selecionou mais de um hub IoT vinculado, selecione como deseja atribuir dispositivos aos diferentes hubs. Para saber mais sobre políticas de alocação, confira Como usar políticas de alocação.

    Se você selecionou apenas um hub IoT vinculado, recomendamos usar a política de distribuição uniformemente ponderada.

    Captura de tela que mostra a conexão de hubs IoT ao novo grupo de registro.

  7. Selecione Próximo: Configurações do dispositivo

  8. Na guia Configurações do dispositivo da página Adicionar grupo de registro , forneça as seguintes informações para definir como os dispositivos provisionados recentemente são configurados:

    Field Description
    IoT Edge Verifique a habilitação do IoT Edge em dispositivos provisionados se todos os dispositivos provisionados por meio desse grupo executarem o Azure IoT Edge. Desmarque essa caixa se esse grupo for somente para dispositivos não habilitados para IoT Edge. Ou todos os dispositivos de um grupo são compatíveis com o IoT Edge, ou nenhum deles poderá ser.
    Etiquetas de dispositivo Use esta caixa de texto para fornecer as marcas que deseja aplicar aos dispositivos gêmeos dos dispositivos provisionados.
    Propriedades desejadas Use esta caixa de texto para fornecer as propriedades desejadas que você quer aplicar aos dispositivos gêmeos dos dispositivos provisionados.

    Para saber mais, veja Noções básicas e uso de dispositivos gêmeos no Hub IoT.

  9. Selecione Avançar: Revisar + criar.

  10. Na guia Revisar + Criar, verifique todos os valores e, em seguida, selecione Criar.

Criar um registro individual

Um registro individual é uma entrada para um único dispositivo que pode ser atribuído a um hub IoT. Dispositivos usando certificados X.509, chave simétrica e comprovação TPM são suportados.

Para obter um passo a passo de como criar e usar registros individuais com certificados X.509, consulte Início Rápido: Provisionar um dispositivo de certificado X.509.

Para criar uma inscrição individual de certificado X.509:

  1. Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.

  2. Selecione Gerenciar registros na seção Configurações do menu de recursos.

  3. Selecione a guia Registros individuais e, em seguida, selecione Adicionar registro individual.

    Captura de tela mostrando a opção de adicionar registro individual.

  4. Na guia Registro + provisionamento da página Adicionar registro, forneça as seguintes informações para configurar os detalhes do registro:

    Field Description
    Attestation Selecione certificados de cliente X.509 como o Mecanismo de atestado.
    Configurações de certificado X.509 Carregue um ou dois certificados que serão usados para verificar o dispositivo para esse registro.
    Status do provisionamento Marque a caixa Habilitar este registro se quiser que esse registro esteja disponível para provisionar seu dispositivo. Desmarque essa caixa se quiser que o registro seja desabilitado. Você pode alterar essa configuração mais tarde.
    Política de reprovisionamento Escolha uma política de reprovisionamento que reflita como você deseja que o DPS manipule os dispositivos que solicitam o reprovisionamento. Para obter mais informações, confira Reprovisionar políticas.
  5. Selecione Próximo: hubs IoT.

  6. Na guia Hubs IoT da página Adicionar registro, forneça as seguintes informações para determinar para quais hubs IoT o registro pode provisionar dispositivos:

    Field Description
    Hubs IoT de destino Selecione um ou mais dos hubs IoT vinculados ou adicione um novo link a um hub IoT. Para saber mais sobre como vincular hubs IoT à instância do DPS, confira Como vincular e gerenciar hubs IoT.
    Política de alocação Se você selecionou mais de um hub IoT vinculado, selecione como deseja atribuir dispositivos aos diferentes hubs. Para saber mais sobre políticas de alocação, confira Como usar políticas de alocação.

    Se você selecionou apenas um hub IoT vinculado, recomendamos usar a política de distribuição uniformemente ponderada.
  7. Selecione Próximo: Configurações do dispositivo

  8. Na guia Configurações do dispositivo da página Adicionar registro, forneça as seguintes informações para definir como os dispositivos provisionados recentemente serão configurados:

    Field Description
    ID do Dispositivo Forneça uma ID do dispositivo que será atribuída ao dispositivo provisionado no Hub IoT. Se você não fornecer uma ID de dispositivo, a ID de registro será usada.
    IoT Edge Verifique Habilitar IoT Edge em dispositivos provisionados se o dispositivo provisionado executará o Azure IoT Edge. Desmarque essa caixa se esse registro for para um dispositivo não habilitado para IoT Edge.
    Etiquetas de dispositivo Use esta caixa de texto para fornecer as marcas que você deseja aplicar ao dispositivo gêmeo do dispositivo provisionado.
    Propriedades desejadas Use esta caixa de texto para fornecer as propriedades desejadas que você quer aplicar ao dispositivo gêmeo do dispositivo provisionado.

    Para saber mais, veja Noções básicas e uso de dispositivos gêmeos no Hub IoT.

  9. Selecione Avançar: Revisar + criar.

  10. Na guia Revisar + Criar, verifique todos os valores e, em seguida, selecione Criar.

Atualizar uma entrada de registro

Para atualizar uma entrada de registro existente:

  1. Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.

  2. Selecione Gerenciar registros na seção Configurações do menu de navegação.

  3. Selecione os grupos de registro ou a guia Registros individuais , dependendo se você deseja atualizar um grupo de registro ou um registro individual.

  4. Selecione o nome da entrada de registro que você deseja modificar.

  5. Na página de detalhes da entrada de registro, você pode atualizar todos os itens, exceto o tipo de segurança e as credenciais.

  6. Depois de concluído, selecione Salvar.

Remover um registro de dispositivo

Para remover uma entrada de registro:

  1. Entre no portal do Azure e navegue até instância do Serviço de Provisionamento de Dispositivos.

  2. Selecione Gerenciar registros na seção Configurações do menu de navegação.

  3. Selecione os grupos de registro ou a guia Registros individuais , dependendo se você deseja remover um grupo de registro ou um registro individual.

  4. Selecione a entrada de registro que você deseja remover.

  5. Na parte superior da página, selecione Excluir.

  6. Quando a confirmação for solicitada, selecione Sim.

  7. Depois que a ação for concluída, você verá que sua entrada é removida da lista de registros de dispositivos.

Note

Excluir um grupo de inscrição não exclui os registros de inscrição dos dispositivos no grupo. O DPS usa os registros de inscrição para determinar se o número máximo de registros foi atingido para a instância do DPS. Registros órfãos ainda contam nessa cota. Para obter o número máximo atual de cadastros com suporte para uma instância de DPS, consulte Cotas e limites.

Talvez você queira excluir os registros da inscrição do grupo de inscrição antes de excluir o próprio grupo de inscrição. Você pode ver e gerenciar os registros de registro de um grupo de registro manualmente na guia Registros de Registro do grupo no portal do Azure. Você pode recuperar e gerenciar os registros de inscrição programaticamente usando as APIs REST de Estado de Registro de Dispositivo ou APIs equivalentes nos SDKs do serviço DPS ou usando os comandos da CLI do Azure para inscrição de grupos de registro de IoT DPS.

Próximas etapas