Gerenciar organizações do IoT Central

As organizações permitem definir uma hierarquia para gerenciar quais usuários podem ver quais dispositivos no aplicativo IoT Central. A função do usuário determina as permissões sobre os dispositivos que ele vê e as experiências que ele pode acessar. Use organizações para implementar um aplicativo com 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 a primeira hierarquia de organização, você verá que o nome do aplicativo está na raiz. Cada organização que você adiciona torna-se numa organização filho ou de nó folha. As hierarquias da organização usam a herança. Por exemplo, na hierarquia mostrada no diagrama anterior:

• Os usuários do Adatum Solar têm acesso a dispositivos nos Estados Unidos, no Canadá, na Europa e na 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 dispositivos uns dos outros.

Quando você dá aos usuários acesso ao aplicativo, quanto mais alto na hierarquia o acesso é atribuído 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, confira 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 de sua organização. Cada organização na hierarquia atua como um contêiner lógico em que você coloca dispositivos, salva painéis e grupos de dispositivos e convida usuários. Para criar suas organizações, acesse a seção Permissões no 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 muitas organizações por vez, selecione + Adicionar outra organização:

Dica

A configuração inicial das organizações deve ser feita por um membro da função Administrador de aplicativos.

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 os itens associados, como painéis, dispositivos, usuários, grupos de dispositivos e trabalhos.

Dica

Você também pode usar a API REST para criar e gerenciar organizações.

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 no aplicativo, atribua-o a uma organização na 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:

Dica

Você pode ver a qual organização um dispositivo pertence na lista de dispositivos. Use a ferramenta de filtro na lista de dispositivos para mostrar dispositivos em uma organização específica.

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/Cliente1 dos dias um a sete e, em seguida, é movido para a organização Contoso/Cliente4 no dia oito.
• No dia nove, os usuários de Contoso/Cliente4 podem ver dados dos dias oito e nove.
• No dia nove, os usuários de Contoso/Cliente1 podem ver dados dos dias um a sete.

Registro do primeiro dispositivo

Os dispositivos podem se registrar no aplicativo IoT Central sem ser adicionados primeiro à 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 no aplicativo e atribuí-los às organizações. Para saber mais, confira Importar dispositivos.

Gateways

Os dispositivos de gateway e downstream são atribuídos às organizações. Você não precisa atribuir um gateway e seus dispositivos downstream associados à mesma organização. Se você os atribuir 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 no aplicativo, o IoT Central adiciona três novas funções no 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 de grupo de inscrição em todo o aplicativo.

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

Funções de organização personalizadas

Para criar uma função personalizada para os usuários de 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 usuários

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

Para convidar um usuário, navegue até Usuários > Permissões. Insira seu endereço de email, a organização à qual ele está atribuído e a função ou as funções das quais o usuário é membro. 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:

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

Nome	Função	Organização
user1@contoso.com	Administrador da organização	Aplicativo personalizado
user1@contoso.com	Visualizador da organização	Aplicativo personalizado

Ao convidar um usuário, você precisa compartilhar a URL do aplicativo com ele e pedir que ele entre. Depois que o usuário fizer login pela primeira vez, o aplicativo aparecerá 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 recebido do administrador. O aplicativo não fica visível na página Meus aplicativos no site do Azure IoT Central até que ocorra a primeira entrada.

Usar organizações

Depois de criar a hierarquia da sua 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 em massa dispositivos em organizações específicas.

Organização padrão

Dica

Essa é uma preferência pessoal que se aplica somente a você.

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

Para definir a organização padrão, selecione Configurações na barra de menus 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 da 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:

• É possível reatribuir dispositivos a uma nova organização.
• Você pode atribuir usuários a uma nova organização e desatribuí-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 se aplicam à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 maior que 200. Cada nó na hierarquia conta como uma organização.

Próximas etapas

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