Employee Directory Descripción general
Un directorio muestra datos de todos los empleados, por lo que suele evaluarse con más atención que otros elementos web. Este artículo describe, para la versión actual de Vitextra Employee Directory, qué lee el producto, dónde guarda la configuración y los datos personales y qué sale del navegador. Complementa con información específica de Employee Directory el artículo KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD.
El paquete contiene tres elementos web: Employee Directory, Employee Directory (Entra ID) y New Employees. Salvo indicación contraria, la información se aplica a los tres. Los datos expuestos proceden del código fuente del producto.
Resumen para evaluadores de seguridad
| Pregunta | Respuesta |
|---|---|
| ¿Dónde se procesan los datos de personas? | En el navegador del usuario conectado, en la página de SharePoint o en el cliente de Microsoft Teams |
| ¿Con qué identidad? | La del usuario conectado. Todos los permisos de Microsoft Graph son delegados; no hay cuenta de servicio ni acceso exclusivo de aplicación |
| ¿Qué lee? | Perfiles del directorio, fotos, presencia, disponibilidad, responsable, subordinados directos y colaboradores habituales de Microsoft Graph; perfiles, aptitudes y documentos recientes mediante la búsqueda de SharePoint |
| ¿Escribe en Microsoft 365? | Lee datos de empleados; al editar un elemento web, su configuración se guarda en la página de SharePoint |
| ¿Dónde se guarda la configuración? | En las propiedades del elemento web en la página; la configuración predeterminada opcional de la aplicación personal de Teams se guarda por inquilino en vitextra.com |
| ¿Qué conserva el navegador? | Favoritos en todos los elementos web y una caché comprimida del directorio solo para Employee Directory (Entra ID), en el almacenamiento local |
| ¿Qué reciben los servicios Vitextra? | Identificadores de comprobación de licencia, configuración guardada de la aplicación personal de Teams y telemetría de uso. No reciben datos del directorio, perfiles, fotos, presencia ni calendario |
| Residencia de datos | Microsoft 365 es el origen de los datos del directorio y de perfiles. La caché del navegador, los favoritos y los archivos descargados también contienen copias en los dispositivos de los usuarios; Vitextra no copia ni indexa el directorio |
Qué lee Employee Directory
Los elementos web llaman directamente desde el navegador a Microsoft Graph y a SharePoint Search REST API con un token del usuario conectado. Leen los datos siguientes. La columna Permiso indica el permiso delegado de Microsoft Graph del que depende la función.
| Datos | Origen | Permiso | Uso |
|---|---|---|---|
| Cuentas y atributos de perfil: nombre, puesto, departamento, empresa, oficina, correo, teléfonos, dirección, identificador y tipo de empleado, estado de cuenta, tipo de usuario, fecha de creación, licencias, atributos de extensión locales y atributos personalizados añadidos por el editor | Microsoft Graph /users | User.Read.All | Lista, búsquedas, refinadores, filtros, New Employees |
| Detalles de una persona: acerca de mí, intereses, aptitudes, centros educativos y proyectos anteriores | Microsoft Graph /users/{id} | User.Read.All | Panel de detalles |
| Responsable y subordinados directos | Microsoft Graph /users/{id}/manager, /directReports, /me/manager, /me/directReports | User.Read.All | Columna de responsable, panel de detalles y filtro del equipo propio |
| Fotos de perfil | Microsoft Graph /users/{id}/photo/$value | User.Read.All | Tarjetas, lista y panel de detalles |
| Miembros de roles de directorio y lista de grupos | Microsoft Graph /directoryRoles, /groups | Directory.Read.All | Condiciones por rol y grupo |
| Presencia y mensaje de ausencia | Microsoft Graph /users/{id}/presence | Presence.Read.All | Indicador de presencia |
| Disponibilidad y horario laboral de hoy | Microsoft Graph /me/calendar/getSchedule | Calendars.Read | Disponibilidad y hora local del panel de detalles |
| Personas con las que más colabora el usuario | Microsoft Graph /me/people | People.Read | Filtro rápido de colaboradores habituales |
| Perfiles de usuario | Búsqueda de SharePoint, resultados de personas | Ninguno; derechos de búsqueda propios | Origen Perfiles de usuario de Employee Directory |
| Aptitudes | Búsqueda de SharePoint, resultados de personas | Ninguno; derechos de búsqueda propios | Búsqueda por aptitudes |
| Documentos recientes de una persona | Búsqueda de SharePoint de los cinco documentos de ese autor ordenados por fecha de última modificación | Ninguno; derechos de búsqueda propios | Documentos recientes del panel de detalles |
El paquete solicita los permisos y un administrador global los aprueba una sola vez. Consulte KB10360. Cómo aprobar los permisos de la API de Microsoft Graph para las soluciones de Vitextra en el centro de administración de SharePoint. KB10463. Permisos de Microsoft Graph necesarios para Employee Directory explica cada permiso por función.
Como cada solicitud se ejecuta con la identidad del usuario conectado:
- El acceso depende del token delegado. Los datos disponibles dependen de los permisos de API aprobados y de los derechos efectivos del usuario conectado. Las personas y los atributos mostrados pueden diferir de los de otra interfaz de Microsoft 365.
- La búsqueda de SharePoint aplica filtrado de seguridad. Los perfiles ocultos de la libreta de direcciones se excluyen salvo que se active Mostrar usuarios ocultos. Documentos recientes solo muestra documentos que el usuario puede abrir.
- Los calendarios solo muestran disponibilidad. Disponibilidad indica el estado de cada intervalo de media hora: libre, provisional, ocupado o fuera de la oficina. No muestra asuntos ni ubicaciones de reuniones.
📝 Nota
Las cuentas de invitado se excluyen de la lista principal de Entra ID: Employee Directory (Entra ID) las filtra en el navegador y el origen Graph de Employee Directory, en la consulta. Los resultados de perfiles de SharePoint dependen del índice de búsqueda y de la consulta. Los filtros rápidos personales usan listas separadas; el elemento web Entra ID las cruza con el directorio cargado después de aplicar las exclusiones y el filtro predefinido.
Employee Directory lee datos de empleados
Los elementos web no modifican perfiles de empleados, cuentas del directorio ni elementos del calendario, y no crean listas de SharePoint. La lectura requiere los permisos correspondientes de Microsoft Graph y SharePoint. Al editar un elemento web, su configuración se guarda en la página de SharePoint; para ello se necesita permiso para editar esa página.
Los usuarios pueden guardar datos del directorio en su propio dispositivo de dos maneras:
- Exportación: si está activada la opción de hoja de cálculo de Microsoft Excel en Exportar, el usuario puede descargar los resultados como employee-directory.xlsx. El archivo se genera en el navegador y contiene las columnas visibles, excepto foto y presencia.
- vCard: Descargar vCard guarda la tarjeta de contacto de una persona como archivo.
Chatear en Teams, Llamar en Teams y Enviar correo electrónico solo abren Teams o el programa de correo del usuario. El elemento web no envía mensajes por sí mismo.
Dónde se guarda la configuración
Propiedades del elemento web. Todos los ajustes del panel de propiedades -origen, columnas, filtros, diseño, filtros rápidos y acciones- se guardan en las propiedades del elemento web dentro de la página, en Páginas del sitio. Se versionan con la página y son legibles para quienes tengan acceso de lectura a ella. Contienen configuración, no registros de empleados.
Configuración predeterminada de la aplicación personal de Teams. En SharePoint, el panel de propiedades de Employee Directory y Employee Directory (Entra ID) incluye un grupo para la aplicación personal de Teams. Indica: «Puede guardar la configuración actual como predeterminada para su inquilino. La aplicación personal de Microsoft Teams usa esta configuración». Guardar configuración envía los ajustes actuales a vitextra.com, donde se guardan para el identificador del inquilino y el identificador de producto del elemento web. Al abrirse como aplicación personal de Teams, y no como pestaña de canal, el elemento web lee el registro y lo aplica sobre sus propiedades.
El registro guardado contiene únicamente los ajustes siguientes:
| Área | Employee Directory | Employee Directory (Entra ID) |
|---|---|---|
| Origen de datos | Origen, consulta predefinida, mostrar usuarios ocultos, mostrar solo usuarios con departamento | Opciones de exclusión y condiciones del filtro |
| Columnas y búsqueda | Columnas y cuáles permiten búsquedas, atributos personalizados, cuadro de búsqueda y texto de marcador, búsqueda por aptitudes | Columnas y cuáles permiten búsquedas, atributos personalizados, cuadro de búsqueda, navegación A–Z y búsqueda por aptitudes |
| Diseño | Vista, vista compacta, campos y tamaño de tarjeta, agrupación, ordenación, tamaño de página, paginación, máximo de elementos, total de resultados y panel de detalles | Vista, vista compacta, campos y tamaño de tarjeta, agrupación, ordenación, tamaño de página, mostrar todos los elementos y total de resultados |
| Panel de refinamiento | Activación, posición y refinadores | Activación, posición y refinadores |
| Panel de detalles | Disponibilidad, hora local y horario laboral, documentos recientes | Disponibilidad, hora local y horario laboral, documentos recientes |
| Acciones y filtros | Seis acciones de menú contextual y acciones rápidas, cuatro filtros rápidos y opción de exportación | Seis acciones de menú contextual y acciones rápidas, cuatro filtros rápidos y opción de exportación |
El título y los demás interruptores de Panel, correspondientes al responsable, subordinados directos, acerca de mí, intereses y aptitudes, no se guardan en ese registro. New Employees no tiene configuración predeterminada de Teams.
❗ Importante
El registro no contiene datos del directorio, pero sí todo lo que el editor escriba en los ajustes: por ejemplo, un departamento en un filtro, el texto de una consulta predefinida o nombres de atributos personalizados. No introduzca datos personales en estos ajustes. Para dejar de usar la configuración predeterminada de Teams, guarde otra configuración adecuada o solicite a soporte de Vitextra que elimine el registro del inquilino.
Favoritos en el navegador
El filtro de favoritos guarda en el almacenamiento local las personas marcadas con Agregar a favoritos. Consulte KB10214. Filtros rápidos de Employee Directory: Mi departamento, Mi equipo, Personas con las que trabajo y Favoritos. No escribe en Microsoft 365 ni envía estos datos a Vitextra.
- Clave.
Vitextra.EmployeeDirectory.Favorites.<object ID>, donde el identificador de objeto es el del usuario conectado en Microsoft Entra ID. Cada usuario del mismo perfil de navegador tiene una lista separada. - Contenido. Una instantánea de los atributos de perfil y personalizados cargados para cada persona marcada. Antes de guardar se eliminan presencia, objeto del responsable, licencias asignadas, grupos y roles. La copia permanece hasta que se elimina el favorito. Employee Directory muestra estas copias; Employee Directory (Entra ID) usa sus identificadores para seleccionar los registros actuales cargados que cumplen las exclusiones y el filtro predefinido. Por tanto, un favorito guardado puede no ser visible.
- Ámbito. Los elementos web Employee Directory del mismo dominio de SharePoint y perfil de navegador comparten la lista. Los cambios se notifican a otras pestañas mediante el evento de almacenamiento. Otro elemento web de la misma página puede necesitar una recarga.
- Sin sincronización entre dispositivos. Los favoritos no se transfieren a otro dispositivo, navegador o perfil. Teams tiene su propio almacenamiento, por lo que sus favoritos son independientes de los del navegador.
- Eliminación. Quitar de favoritos elimina una persona. Borrar los datos del sitio de SharePoint elimina todos los favoritos; véase Borrar los datos del navegador.
Caché del directorio de Entra ID
Para abrirse rápidamente en inquilinos grandes, Employee Directory (Entra ID) carga toda la lista de usuarios desde Microsoft Graph y la conserva en el almacenamiento local.
- Clave.
Vitextra.EmployeeDirectory.Data. El valor es un documento JSON comprimido con la hora de carga y la lista de usuarios. - Contenido. Los atributos de perfil devueltos por Microsoft Graph, incluidos los responsables cuando se solicitan. Las cuentas de invitado permanecen en la caché, pero no se muestran. Las cuentas bloqueadas se excluyen si Excluir usuarios bloqueados está activado; si está desactivado, pueden permanecer en la caché y aparecer en la lista.
- Actualización. En la siguiente visita se muestra la caché inmediatamente. Si tiene más de 24 horas, la lista se recarga de Microsoft Graph en segundo plano. La barra sobre los resultados indica la antigüedad de los datos y ofrece Actualizar para recargar de inmediato. Cambiar exclusiones o atributos personalizados también recarga la lista. El umbral de 24 horas se comprueba al cargar la caché; no es un temporizador periódico ni un intervalo de actualización garantizado. Si falla la actualización y ya hay una lista no vacía con fecha de carga, se conserva visible con una advertencia. Sin esos datos, se muestra un error de carga. La caché almacenada solo se sustituye tras cargar y guardar los datos correctamente en el navegador.
- Ámbito. Una caché por perfil de navegador y dominio de SharePoint, sin separación por usuario o elemento web. Si falla el guardado, la lista actual sigue disponible, pero puede conservarse una copia anterior. Solo se necesita una carga completa en la siguiente visita cuando no hay una caché utilizable.
Employee Directory, con ambos orígenes, y New Employees no conservan una caché del directorio. Consultan Microsoft 365 cada vez que se abre la página. Las fotos solo se mantienen en memoria mientras la página permanece abierta.
❗ Importante
En equipos compartidos o quioscos, la siguiente persona que use el mismo perfil de navegador puede leer la caché, que contiene teléfonos y direcciones de todos los empleados, entre otros atributos. Asigne una cuenta de Windows o perfil de navegador a cada persona, utilice ventanas privadas o aplique una directiva que borre los datos al cerrar el navegador.
Borrar los datos del navegador
Los usuarios y administradores pueden eliminar favoritos y caché en cualquier momento:
- En el navegador de un usuario. Borre las cookies y los datos del dominio de SharePoint, por ejemplo
https://contoso.sharepoint.com, en la configuración del navegador. Se eliminan favoritos, caché y cookies de inicio de sesión; SharePoint solicitará iniciar sesión de nuevo. - Una clave concreta. Abra las herramientas de desarrollo de Edge o Chrome con F12. Seleccione Application > Local storage > su dominio de SharePoint y elimine
Vitextra.EmployeeDirectory.DataoVitextra.EmployeeDirectory.Favorites.<object ID>. - Solo la caché. Pulse Actualizar para solicitar datos actuales. Esto no elimina la copia almacenada; solo se sustituye si la carga y el guardado finalizan correctamente.
- En Microsoft Teams. El cliente tiene almacenamiento propio. Utilice el procedimiento de Microsoft para borrar la caché de Teams.
- En varios dispositivos. Utilice navegación privada o una directiva que borre los datos al salir en equipos compartidos.
Qué se envía a Vitextra y Application Insights
Ninguna solicitud a Vitextra contiene registros de empleados, atributos de perfil, fotos, presencia, calendario, favoritos ni términos de búsqueda. Solo se envía lo siguiente:
| Finalidad | Datos enviados | Destino |
|---|---|---|
| Comprobación de licencia | Identificador del inquilino, identificador de objeto del usuario conectado, dirección del sitio (en Teams, host de SharePoint), identificador de producto y nombre y versión del elemento web | vitextra.com |
| Configuración de aplicación personal de Teams | Al pulsar Guardar configuración: identificadores de inquilino y producto y los ajustes enumerados. Al abrirse la aplicación personal: identificadores de inquilino y producto para leer el registro | vitextra.com |
| Telemetría de uso | Un evento «Load Web Part» por representación: nombre y versión, identificador y dirección del sitio, identificador de objeto del usuario, idioma del sitio e interfaz y si se ejecuta en Teams. En errores: nombre del elemento web, identificador y versión de solución, dirección del sitio y detalles del error | Azure Application Insights |
| Archivos del producto | Solicitudes normales de archivos para los scripts | static.vitextra.com |
El usuario se identifica mediante el identificador de objeto de la cuenta, un GUID, y no por nombre o correo. El SDK de Application Insights añade su contexto técnico estándar, como un identificador de sesión anónimo e información del navegador. El estado de licencia aparece en Acerca de. Si vitextra.com no es accesible, los elementos web siguen funcionando.
📝 Nota
La Política de privacidad describe el tratamiento de identificadores de licencia y telemetría por Vitextra. Vitextra no recibe el contenido del directorio.
Hosts de red que deben permitirse
Si se restringen las conexiones salientes, los navegadores y clientes de Teams necesitan acceso HTTPS a:
- el dominio de SharePoint (
<tenant>.sharepoint.com) ygraph.microsoft.com: datos de directorio, perfiles, búsquedas, presencia y calendario; static.vitextra.com: scripts; obligatorio para cargar los elementos web;vitextra.com: comprobación de licencia y configuración de la aplicación personal de Teams;dc.services.visualstudio.com: telemetría opcional de Application Insights; si se bloquea, los elementos web siguen funcionando;spoprod-a.akamaihd.nety las redes CDN de Microsoft ya utilizadas por SharePoint: iconos de tipo de archivo de documentos recientes e iconos Fluent UI;teams.microsoft.com: solo al seleccionar Chatear en Teams, Llamar en Teams o Programar una reunión.
Protección de datos y RGPD
- Responsable y encargado del tratamiento. Los datos del directorio pertenecen a su inquilino de Microsoft 365. Usted es el responsable y Microsoft el encargado. Employee Directory muestra los datos a usuarios que ya pueden verlos en Microsoft 365.
- Minimización de datos. Los administradores eligen columnas, atributos personalizados y secciones del panel de detalles. Desactive secciones innecesarias, como disponibilidad o documentos recientes, y no añada atributos sensibles.
- Conservación en dispositivos. Los favoritos permanecen hasta que el usuario los elimina o borra los datos del navegador. La caché no tiene un plazo de eliminación automática: cargar una copia de más de 24 horas inicia un intento de actualización en segundo plano. Una carga correcta sustituye la copia almacenada si el almacenamiento del navegador lo permite; si falla, se conserva la copia anterior.
- Derecho de supresión. Una persona eliminada de Microsoft Entra ID desaparece del directorio tras la siguiente carga correcta de datos; no se garantiza su eliminación en 24 horas. Las copias en favoritos permanecen hasta que los usuarios las eliminen. Consulte KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD para los registros de licencia, configuración de Teams y telemetría de Vitextra.
💡 Consejo
Para un cuestionario de seguridad, combine este artículo con KB10463. Permisos de Microsoft Graph necesarios para Employee Directory y KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD. Para un acuerdo de tratamiento de datos, contacte con soporte de Vitextra.
Artículos relacionados
- KB10363. Dónde almacenan sus datos los productos de Vitextra: privacidad, residencia de datos y RGPD
- KB10463. Permisos de Microsoft Graph necesarios para Employee Directory
- KB10360. Cómo aprobar los permisos de la API de Microsoft Graph para las soluciones de Vitextra en el centro de administración de SharePoint
- KB10214. Filtros rápidos de Employee Directory: Mi departamento, Mi equipo, Personas con las que trabajo y Favoritos
