Gerenciar organizações do IoT Central

As organizações permitem definir uma hierarquia que você usa para gerenciar quais usuários podem ver quais dispositivos em seu aplicativo IoT Central. A função do usuário determina suas permissões sobre os dispositivos que eles veem e as experiências que eles podem acessar. Use organizações para implementar um aplicativo multilocatário.

As organizações são um recurso opcional que oferece mais controle sobre os usuários e funções em seu aplicativo.

As organizações são hierárquicas:

Ao criar sua primeira hierarquia de organização, você vê que o nome do seu aplicativo está na raiz. Cada organização adicionada torna-se uma organização filha ou folha. As hierarquias organizacionais usam herança. Por exemplo, na hierarquia mostrada no diagrama anterior:

• Os usuários da Adatum Solar têm acesso a dispositivos nos Estados Unidos, Canadá, Europa e América Latina.
• Os usuários da Contoso têm acesso a todos os dispositivos em todas as organizações na hierarquia.

Os usuários em organizações irmãs não podem ver os outros dispositivos uns dos outros.

Quando você concede aos usuários acesso ao seu aplicativo, quanto mais alto na hierarquia você atribui acesso a eles, mais eles podem ver e gerenciar. A organização controla os dispositivos que o usuário pode ver. A função define o que um usuário pode fazer, como criar, ler e excluir dispositivos.

A captura de tela a seguir mostra uma definição de hierarquia da organização no IoT Central:

Para saber como gerenciar organizações usando a API REST do IoT Central, consulte Como usar a API REST do IoT Central para gerenciar organizações.

Criar uma hierarquia

Para começar a usar organizações, você precisa definir a hierarquia da organização. Cada organização na hierarquia atua como um contêiner lógico onde você coloca dispositivos, salva painéis e grupos de dispositivos e convida usuários. Para criar suas organizações, vá para a seção Permissões em seu aplicativo IoT Central, selecione a guia Organizações e selecione + Novo ou use o menu de contexto para uma organização existente. Para criar uma ou várias organizações de cada vez, selecione + Adicionar outra organização:

Para reatribuir uma organização a um novo pai, selecione Editar e escolha um novo pai.

Para excluir uma organização, você deve excluir ou mover para outra organização quaisquer itens associados, como painéis, dispositivos, usuários, grupos de dispositivos e trabalhos.

Atribuir dispositivos

Depois de definir a hierarquia da organização, atribua os dispositivos às organizações. Cada dispositivo pertence apenas a uma única organização, portanto, escolha a organização apropriada na hierarquia.

Ao criar um novo dispositivo em seu aplicativo, atribua-o a uma organização em sua hierarquia:

Para atribuir ou reatribuir um dispositivo existente a uma organização, selecione o dispositivo na lista de dispositivos e, em seguida, selecione Organização:

Quando você reatribui um dispositivo a outra organização, os dados do dispositivo permanecem com a organização com base no tempo de ingestão de dados. Por exemplo:

• Um dispositivo faz parte da organização Contoso/Customer1 do primeiro ao sétimo dia e, em seguida, movido para a organização Contoso/Customer4 no oitavo dia.
• No nono dia, os usuários da Contoso/Customer4 podem ver dados dos dias oito e nove.
• No nono dia, os usuários da Contoso/Customer1 podem ver os dados do primeiro ao sétimo dia.

Registro do dispositivo primeiro

Os dispositivos podem se registrar automaticamente com seu aplicativo IoT Central sem primeiro serem adicionados à lista de dispositivos. Nesse caso, o IoT Central adiciona o dispositivo à organização raiz na hierarquia. Em seguida, você pode reatribuir o dispositivo a uma organização diferente.

Em vez disso, você pode usar o recurso de importação CSV para registrar dispositivos em massa com seu aplicativo e atribuí-los às organizações. Para saber mais, consulte Importar dispositivos.

Gateways

Você atribui dispositivos de gateway e downstream às organizações. Não é necessário atribuir um gateway e seus dispositivos downstream associados à mesma organização. Se você atribuí-los a organizações diferentes, é possível que um usuário possa ver o gateway, mas não os dispositivos downstream, ou os dispositivos downstream, mas não o gateway.

Funções

Quando você cria a primeira organização em seu aplicativo, o IoT Central adiciona três novas funções em seu aplicativo: Administrador da organização, Operador da organização e Visualizador da organização. Essas funções são necessárias porque um usuário da organização não pode acessar determinados recursos de todo o aplicativo, como: planos de preços, identidade visual e cores, tokens de API e informações do grupo de inscrição em todo o aplicativo.

Você pode usar essas funções ao convidar usuários para uma organização em seu aplicativo.

Funções personalizadas da organização

Para criar uma função personalizada para os usuários da sua organização, crie uma nova função e escolha o tipo de função Organização:

Em seguida, selecione as permissões para a função.

Convidar utilizadores

Depois de criar a hierarquia da organização e atribuir dispositivos às organizações, convide usuários para seu aplicativo e atribua-os às organizações.

Para convidar um usuário, navegue até Permissões > de usuários. Introduza o respetivo endereço de e-mail, a organização à qual estão atribuídos e a função ou funções de que são membros. A organização selecionada filtra a lista de funções disponíveis para garantir que você atribua o usuário a uma função válida:

Você pode atribuir o mesmo usuário a várias organizações. O usuário pode ter uma função diferente em cada organização à qual está atribuído:

Quando convida um novo utilizador, tem de partilhar o URL da aplicação com ele e pedir-lhe para iniciar sessão. Depois que o usuário entra pela primeira vez, o aplicativo aparece na página Meus aplicativos do usuário.

Para acessar o aplicativo pela primeira vez, um usuário convidado deve primeiro navegar até o aplicativo usando o link que recebe do administrador. O aplicativo não está visível na página Meus aplicativos no site do Azure IoT Central até lá.

Organizações de uso

Depois de criar a hierarquia da organização, você pode usar organizações em áreas do seu aplicativo, como:

• Painéis da organização que mostram informações aos usuários sobre dispositivos em sua organização.
• Grupos de dispositivos para dispositivos em organizações específicas.
• Manifestos de implantação do IoT Edge para manifestos de implantação associados a organizações específicas.
• Análise para dispositivos em organizações específicas.
• Trabalhos que gerenciam dispositivos em massa em organizações específicas.

Organização padrão

Você pode definir uma organização como a organização padrão a ser usada em seu aplicativo como uma preferência pessoal. A organização padrão torna-se a opção padrão sempre que você escolhe uma organização, como quando adiciona um novo usuário ou um dispositivo ao seu aplicativo IoT Central.

Para definir a organização padrão, selecione Configurações na barra de menu superior:

Adicionar organizações a um aplicativo existente

Um aplicativo pode conter dispositivos, usuários e experiências, como painéis, grupos de dispositivos e trabalhos antes de adicionar uma hierarquia de organização.

Quando você começa a adicionar organizações, todos os dispositivos, usuários e experiências existentes permanecem associados à organização raiz no aplicativo:

• Você pode reatribuir dispositivos a uma nova organização.
• Você pode atribuir usuários a uma nova organização e cancelá-los da raiz.
• Você pode recriar experiências como painéis, grupos de dispositivos e trabalhos e associá-los a organizações na hierarquia.

Limites

Os seguintes limites aplicam-se às organizações:

• A hierarquia não pode ter mais de cinco níveis de profundidade.
• O número total de organizações não pode ser superior a 200. Cada nó na hierarquia conta como uma organização.

Próximos passos

Agora que você aprendeu como gerenciar organizações do Azure IoT Central, a próxima etapa sugerida é aprender a exportar dados de IoT para destinos na nuvem usando o Armazenamento de Blob.