Administración de organizaciones de IoT Central
Las organizaciones permiten definir una jerarquía que se usa para administrar qué usuarios pueden ver qué dispositivos de la aplicación de IoT Central. El rol del usuario determina sus permisos en los dispositivos que ven y las experiencias a las que pueden acceder. Use organizaciones para implementar una aplicación multiinquilino.
Las organizaciones son una característica opcional que proporciona más control sobre los usuarios y roles de la aplicación.
Las organizaciones son jerárquicas:
Al crear la primera jerarquía de una organización, se ve que el nombre de la aplicación está en la raíz. Cada organización que se agrega se convierte en una organización secundaria u hoja. Las jerarquías de una organización usan la herencia. Por ejemplo, en la jerarquía del diagrama anterior:
- Los usuarios de Adatum Solar tienen acceso a los dispositivos de Estados Unidos, Canadá, Europa y América Latina.
- Los usuarios de Contoso tienen acceso a todos los dispositivos de todas las organizaciones de la jerarquía.
Los usuarios de organizaciones del mismo nivel no pueden ver los dispositivos de los demás.
Cuando se proporciona a los usuarios acceso a la aplicación, cuanto más arriba en la jerarquía se les asigne acceso, más pueden ver y administrar. La organización controla los dispositivos que el usuario puede ver. El rol define lo que un usuario puede hacer, como crear, leer y eliminar dispositivos.
En la captura de pantalla siguiente se muestra la definición de jerarquía de una organización en IoT Central:
Para obtener información sobre cómo administrar las organizaciones mediante la API REST de IoT Central, consulte Uso de la API REST de IoT Central para administrar organizaciones.
Crear una jerarquía
Para empezar a usar organizaciones, debe definir la jerarquía de la organización. Cada organización de la jerarquía actúa como un contenedor lógico donde se colocan dispositivos, se guardan paneles y grupos de dispositivos y se invita a usuarios. Para crear las organizaciones, vaya a la sección Permisos de la aplicación IoT Central, seleccione la pestaña Organizaciones y seleccione + Nuevo o use el menú contextual de una organización existente. Para crear una o varias organizaciones a la vez, seleccione + Agregar otra organización:
Sugerencia
La configuración inicial de las organizaciones debe realizarla un miembro del rol Administrador de aplicaciones.
Para reasignar una organización a un nuevo elemento primario, seleccione Editar y elija el nuevo elemento primario.
Para eliminar una organización, debe eliminar o mover a otra organización los elementos asociados, como paneles, dispositivos, usuarios, grupos de dispositivos y trabajos.
Sugerencia
También puede usar la API REST para crear y administrar organizaciones.
Asignación de dispositivos
Después de definir la jerarquía de la organización, asigne los dispositivos a organizaciones. Cada dispositivo pertenece únicamente a una sola organización, así que elija la adecuada en la jerarquía.
Cuando cree un nuevo dispositivo en la aplicación, asígnelo a una organización de la jerarquía:
Para asignar o reasignar un dispositivo existente a una organización, seleccione el dispositivo en la lista de dispositivos y luego seleccione Organización:
Sugerencia
Puede ver a qué organización pertenece un dispositivo en la lista de dispositivos. Use la herramienta de filtro de la lista de dispositivos para mostrar los dispositivos de una organización determinada.
Al reasignar un dispositivo a otra organización, los datos del dispositivo permanecen con la organización en función del tiempo de ingesta de datos. Por ejemplo:
- Un dispositivo forma parte de la organización Contoso/Customer1 de los días uno a siete, luego se mueve a la organización Contoso/Customer4 el día ocho.
- El día nueve, los usuarios de Contoso/Customer4 pueden ver datos de los días ocho y nueve.
- El día nueve, los usuarios de Contoso/Customer1 pueden ver datos de los días uno a siete.
Registro de un dispositivo por primera vez
Los dispositivos pueden registrarse automáticamente en la aplicación de IoT Central sin necesidad de agregarse primero a la lista de dispositivos. En este caso, IoT Central agrega el dispositivo a la organización raíz de la jerarquía. Luego se puede reasignar el dispositivo a otra organización.
En lugar de esto, puede usar la característica de importación de CSV para registrar dispositivos de forma masiva en la aplicación y asignarlos a organizaciones. Para obtener más información, vea Importación de dispositivos.
Puertas de enlace
Las puertas de enlace y los dispositivos de bajada se asignan a las organizaciones. No tiene que asignar una puerta de enlace y sus dispositivos de bajada asociados a la misma organización. Si los asigna a organizaciones diferentes, es posible que un usuario pueda ver la puerta de enlace pero no los dispositivos de bajada, o los dispositivos de bajada pero no la puerta de enlace.
Roles
Al crear la primera organización de la aplicación, IoT Central agrega tres nuevos roles a la aplicación: Administrador de organización,Operador de organización y Visor de organización. Estos roles son necesarios, ya que un usuario de la organización no puede acceder a determinadas capacidades de toda la aplicación, como planes de precios, personalización de marca y colores, tokens de API e información de grupos de inscripción de toda la aplicación.
Puede usar estos roles cuando invite a usuarios a una organización de la aplicación.
Roles personalizados de organización
Para crear un rol personalizado para los usuarios de la organización, cree un nuevo rol y elija el tipo de rol Organización:
Luego seleccione los permisos del rol.
Invitar a usuarios
Después de crear la jerarquía de la organización y de asignar dispositivos a organizaciones, invite a usuarios a la aplicación y asígnelos a organizaciones.
Para invitar a un usuario, vaya a Permisos > Usuarios. Escriba la dirección de correo electrónico, la organización a la que está asignado y los roles de los que es miembro. La organización que seleccione filtra la lista de roles disponibles para asegurarse de que se asigne al usuario a un rol válido:
Puede asignar el mismo usuario a varias organizaciones. El usuario puede tener un rol diferente en cada organización a la que esté asignado:
| Nombre | Role | Organización |
|---|---|---|
| user1@contoso.com | Administrador de organización | Aplicación personalizada |
| user1@contoso.com | Visor de organización | Aplicación personalizada |
Al invitar a un nuevo usuario, debe compartir la dirección URL de la aplicación con él y pedirle que inicie sesión. Una vez que haya iniciado sesión por primera vez, la aplicación aparece en la página Mis aplicaciones del usuario.
Para acceder a la aplicación por primera vez, un usuario invitado debe ir primero a la aplicación mediante el vínculo que recibe del administrador. La aplicación no aparece en la página Mis aplicaciones del sitio de IoT Central de Azure.
Uso de organizaciones
Después de crear la jerarquía de la organización, puede usar organizaciones en áreas de la aplicación, como:
- Paneles de la organización que muestran información a los usuarios sobre los dispositivos de su organización.
- Grupos de dispositivos de dispositivos de organizaciones concretas.
- Manifiestos de implementación de IoT Edge para manifiestos de implementación asociados a organizaciones concretas.
- Análisis de dispositivos de organizaciones concretas.
- Trabajos que administran de forma masiva dispositivos de organizaciones concretas.
Organización predeterminada
Sugerencia
Se trata de una preferencia personal que solo se aplica a usted.
Puede establecer una organización como predeterminada para usarla en la aplicación como preferencia personal. La organización predeterminada se convierte en la opción predeterminada cada vez que se elige una organización, por ejemplo, cuando se agrega un nuevo usuario o un dispositivo a la aplicación de IoT Central.
Para establecer la organización predeterminada, seleccione Configuración en la barra de menús superior:
Incorporación de organizaciones a una aplicación existente
Una aplicación puede contener dispositivos, usuarios y experiencias, como paneles, grupos de dispositivos y trabajos, antes de agregar una jerarquía de organización.
Al empezar a agregar organizaciones, todos los dispositivos, usuarios y experiencias existentes permanecen asociados a la organización raíz de la aplicación:
- Puede reasignar dispositivos a una nueva organización.
- Puede asignar usuarios a una nueva organización y desasignarlos de la raíz.
- Puede volver a crear experiencias, como paneles, grupos de dispositivos y trabajos, y asociarlas a organizaciones de la jerarquía.
Límites
Se aplican los límites siguientes a las organizaciones:
- La jerarquía no puede tener más de cinco niveles de profundidad.
- El número total de organizaciones no puede ser superior a 200. Cada nodo de la jerarquía cuenta como una organización.
Pasos siguientes
Ahora que ha aprendido a administrar organizaciones de Azure IoT Central, el siguiente paso que se sugiere es aprender a exportar datos de IoT a destinos en la nube mediante Blob Storage.