Introducción
Vitextra Organizational Chart no almacena datos propios de empleados. Toda la información que muestra -nombres, puestos, relaciones jerárquicas, fotografías y presencia- se consulta durante la ejecución en Microsoft Entra ID mediante la API de Microsoft Graph. Para ello, el elemento web necesita un pequeño conjunto de permisos de API que un administrador del inquilino aprueba una sola vez.
Este artículo enumera esos permisos, explica para qué sirve cada uno, indica cómo aprobarlos y describe el aspecto del organigrama cuando falta alguno. Está dirigido a administradores de SharePoint y Microsoft 365 y a responsables de seguridad que deban evaluar el producto antes de implementarlo.
Permisos
Organizational Chart solicita tres permisos delegados de Microsoft Graph:
| Permiso | Uso | Si no se concede |
|---|---|---|
Directory.Read.All | Leer la lista de usuarios y la relación manager de cada cuenta: los datos que permiten construir la jerarquía | La carga del directorio o de los perfiles puede fallar si ningún otro permiso concedido cubre la solicitud |
User.Read.All | Leer los atributos del perfil que aparecen en las tarjetas (puesto, departamento, ubicación de oficina, teléfonos, dirección, etc.) y las fotografías de los empleados | La carga del directorio o de los perfiles puede fallar si ningún otro permiso concedido cubre la solicitud |
Presence.Read.All | Mostrar en cada tarjeta el indicador de presencia de Microsoft Teams (Disponible, Ocupado, Ausente, No molestar, Desconectado) | El organigrama funciona, pero no muestra indicadores de presencia |
Los tres son permisos delegados: el elemento web siempre llama a Microsoft Graph en nombre del usuario que ha iniciado sesión, nunca con una identidad de aplicación propia. Por tanto, el organigrama no muestra información que el visitante no pudiera consultar por sí mismo en el directorio de Microsoft 365; simplemente la presenta de una forma más cómoda.
📝 Nota
Los permisos se solicitan para la entidad de servicio de la aplicación SharePoint Online Client Extensibility, compartida por todas las soluciones SPFx del inquilino. Si otro producto de Vitextra, como Employee Directory, ya tiene aprobado el mismo ámbito, la solicitud de Organizational Chart se concede automáticamente y no aparece como pendiente.
Aprobar los permisos
Las solicitudes de permisos se registran automáticamente al implementar el paquete de Organizational Chart en el catálogo de aplicaciones del inquilino. Para aprobarlas:
- Inicie sesión en el Centro de administración de SharePoint con una cuenta que tenga el rol Administrador global.
- En la navegación izquierda, expanda Avanzadas y seleccione Acceso de API.
- En Solicitudes pendientes, localice las solicitudes del paquete Organizational Chart para el recurso Microsoft Graph:
Directory.Read.All,User.Read.AllyPresence.Read.All. - Seleccione cada solicitud y haga clic en Aprobar. Confirme la aprobación en el panel que se abre.
Los permisos aprobados pasan a la lista Solicitudes aprobadas, donde pueden revisarse o revocarse en cualquier momento.
❗ Importante
La aprobación surte efecto inmediatamente, pero los usuarios que ya tengan abierta la página deben volver a cargarla. Los navegadores también conservan brevemente en caché el resultado anterior de la autorización. Si el organigrama sigue mostrando un error unos minutos después de aprobar los permisos, espere un poco y actualice la página antes de continuar con el diagnóstico.
💡 Consejo
El procedimiento completo de implementación -cargar el paquete en el catálogo de aplicaciones, habilitarlo para todos los sitios y aprobar los permisos- se describe en KB10035. Cómo instalar un producto Vitextra en SharePoint Online.
Qué ocurre cuando falta un permiso
La ausencia de cada permiso produce síntomas distintos, lo que ayuda a diagnosticar el problema:
- Permisos de directorio insuficientes. Si los ámbitos concedidos no cubren la solicitud al directorio, el organigrama no puede cargar los empleados. En lugar del árbol, el elemento web muestra el mensaje Lo sentimos, pero algo fue mal. Actualice la página y vuelva a intentarlo. y un botón Configurar para los editores de la página. Apruebe las solicitudes pendientes y vuelva a cargar la página.
Presence.Read.Allsin aprobar. El organigrama se carga y aparecen todas las tarjetas, pero ninguna fotografía muestra el punto de presencia. Es el estado parcial más habitual: se han aprobado los dos permisos del directorio, pero se ha pasado por alto la solicitud de presencia.- Un permiso se ha revocado después de la implementación. La función correspondiente puede dejar de funcionar. La solicitud se elimina de la página de acceso de API; para volver a aprobarla debe emitirse una nueva solicitud con el mismo recurso y ámbito.
📝 Nota
La presencia también depende de la disponibilidad de Teams para la persona. Si Microsoft Graph no devuelve un estado utilizable, la tarjeta no muestra un indicador de presencia. El estado se obtiene al cargar la tarjeta y no se actualiza de forma continua.
Quién puede ver el organigrama
Como el elemento web utiliza permisos delegados, el acceso al organigrama depende de dos factores:
- Acceso a la página. El visitante debe poder abrir la página de SharePoint o la pestaña de Teams que contiene el elemento web; se aplican los permisos habituales de SharePoint y Teams.
- Acceso al directorio. De forma predeterminada, todos los miembros de la organización pueden leer la información básica del directorio en Microsoft 365, por lo que todos los visitantes con acceso a la página ven el mismo organigrama. Los usuarios invitados, en cambio, no se cargan en el organigrama y normalmente tampoco pueden consultar el directorio completo.
Organizational Chart no añade una capa propia de permisos: no oculta empleados concretos a determinados visitantes ni concede acceso a datos que no pudieran consultar en otros lugares de Microsoft 365. Para excluir por completo determinadas cuentas -cuentas de servicio, buzones compartidos o usuarios de prueba- utilice las opciones de filtrado y exclusión descritas en KB10233. Cómo agregar y configurar el elemento web Organizational Chart.
Tratamiento de los datos
En una revisión de seguridad suelen ser relevantes los siguientes aspectos:
- El navegador del usuario lee los datos de empleados directamente de Microsoft Graph; no se envían a Vitextra ni a servicios de terceros.
- Una copia del directorio cargado se conserva en el almacenamiento local del navegador durante un máximo de 12 horas para agilizar las visitas posteriores; se guarda por instancia del elemento web y navegador y no sale del dispositivo.
- Las fotografías y la presencia se solicitan únicamente para las tarjetas visibles en pantalla y no se conservan en caché más allá de la sesión de la página.
- El elemento web solo se comunica con los servidores de Vitextra para verificar el estado de la licencia del inquilino, cargar recursos estáticos, como iconos, y recopilar telemetría anónima sobre el uso del producto. Estas solicitudes no incluyen datos del directorio.
💡 Consejo
Para obtener una visión general del producto, consulte KB10232. Organizational Chart. Descripción general de la solución. Si faltan empleados en el organigrama a pesar de haber aprobado todos los permisos, consulte KB10236. ¿Por qué falta una persona en Organizational Chart?.
Más información sobre el producto: https://vitextra.com/es/products/org-chart
