Configurar o controle de acesso para recursos de Atualização de Dispositivo

Para que os usuários acessem a Atualização de Dispositivo do Azure para Hub IoT, você deve conceder a eles acesso à conta e à instância da Atualização de Dispositivo. Você também deve conceder à entidade de serviço de Atualização de Dispositivo acesso ao hub IoT vinculado para que ele possa gerenciar atualizações e coletar informações. Este artigo descreve como conceder o acesso necessário usando o RBAC (controle de acesso baseado em função) do Azure no portal do Azure ou na CLI do Azure.

Pré-requisitos

• Função de Proprietário ou Administrador de Acesso de Usuário em sua assinatura do Azure.
• Uma conta e instância de Atualização de Dispositivo configuradas com um hub IoT.
• Para executar comandos da CLI do Azure, o ambiente Bash no Azure Cloud Shell ou na CLI do Azure é instalado localmente.

Configurar o controle de acesso para a conta de Atualização de Dispositivo

As seguintes funções estão disponíveis para atribuir acesso à Atualização de Dispositivo:

• Administrador de atualização de dispositivo
• Leitor de atualização de dispositivo
• Administrador de conteúdo de atualização de dispositivo
• Leitor de conteúdo de atualização de dispositivo
• Administrador de implantações de atualização de dispositivo
• Leitor de implantações de atualização de dispositivo

Para obter mais informações, consulte RBAC (controle de acesso baseado em função) do Azure e Atualização de dispositivo.

Portal do Azure

1. Na sua conta de Atualização de Dispositivo no portal do Azure, selecione Controlo de acesso (IAM) no menu de navegação e, em seguida, selecione Adicionar atribuição de função.

   

2. No separador Função, selecione uma função de Atualização de Dispositivo nas opções disponíveis e, em seguida, selecione Seguinte.

   

3. Na guia Membros, selecione Selecionar membros e adicione os usuários ou grupos aos quais você deseja atribuir a função.

   

4. Selecione Rever + atribuir.

5. Reveja as novas atribuições de função e selecione Rever + atribuir novamente.

6. O RBAC do Azure adiciona as atribuições de função, e os membros selecionados agora podem usar a Atualização de Dispositivo de dentro do seu Hub IoT.

CLI do Azure

Use o comando az role assignment create para configurar o controle de acesso para sua conta de Atualização de Dispositivo. No comando, substitua os seguintes espaços reservados por suas próprias informações:

• <role>: A função de Atualização de Dispositivo que está a atribuir.
• <user_or_group: O usuário ou grupo ao qual você deseja atribuir a função.
• <account_id>: O ID de recurso da conta de Atualização de Dispositivo à qual conceder acesso. Você pode obter o ID do recurso usando az iot du account show e consultando o valor do ID com az iot du account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_or_group> --scope <account_id>

Configurar o acesso ao hub IoT para a entidade de serviço de Atualização de Dispositivo

A Atualização de Dispositivo se comunica com o Hub IoT para gerenciar implantações e atualizações e obter informações sobre dispositivos. Para habilitar essa comunicação, você precisa conceder à entidade de segurança do serviço Atualização de Dispositivo do Azure acesso ao hub IoT com a função de Colaborador de Dados do Hub IoT.

Portal do Azure

1. Na sua instância de Atualização de Dispositivo no portal do Azure, selecione o hub IoT conectado à instância.

   

2. Na página Hub IoT, selecione Controle de Acesso (IAM) no menu de navegação esquerdo.

3. Selecione Adicionar>Adicionar atribuição de função.

   

4. Na guia Função, selecione Colaborador de Dados do Hub IoT e selecione Avançar.

   

5. No separador Membros, selecione Utilizador, grupo ou entidade de serviço para Atribuir acesso a e, em seguida, selecione Selecionar membros.

6. Na tela Selecionar membros, procure e selecione Atualização de Dispositivo do Azure e selecione Selecionar.

   

7. Selecione Rever + atribuir e, em seguida, selecione Rever + atribuir novamente.

Para validar que você definiu as permissões corretamente:

1. No portal do Azure, navegue até o hub IoT conectado à sua instância de Atualização de Dispositivo.
2. Selecione Controle de acesso (IAM) no menu de navegação à esquerda.
3. Selecione Verificar acesso.
4. Selecione Usuário, grupo ou entidade de serviço e procure e selecione Atualização de Dispositivo do Azure.
5. Verifique se a função de Colaborador de Dados do Hub IoT está listada em Atribuições de função.

CLI do Azure

Use o comando az role assignment create para criar uma atribuição de função para a entidade de serviço de Atualização de Dispositivo do Azure.

No comando, substitua <resource_id> pelo ID do recurso do seu hub IoT. Você pode recuperar o ID do recurso usando o comando az iot hub show e consultando o valor do ID com az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

Conteúdos relacionados

• RBAC (controle de acesso baseado em função) do Azure e Atualização de Dispositivo
• Referência de comando para atribuição de função az